Subject: Re: bin/33923: slattach(8) can't attach sl(4) interface
To: None <christos@zoulas.com>
From: Izumi Tsutsui <tsutsui@ceres.dti.ne.jp>
List: netbsd-bugs
Date: 07/08/2006 14:11:42
Updated one (including some fixes on first wizd(8) pass):
---
Index: sbin/slattach/slattach.8
===================================================================
RCS file: /cvsroot/src/sbin/slattach/slattach.8,v
retrieving revision 1.27
diff -u -r1.27 slattach.8
--- sbin/slattach/slattach.8 7 Aug 2003 10:04:40 -0000 1.27
+++ sbin/slattach/slattach.8 8 Jul 2006 05:06:37 -0000
@@ -29,7 +29,7 @@
.\"
.\" @(#)slattach.8 8.2 (Berkeley) 4/1/94
.\"
-.Dd September 3, 1999
+.Dd July 8, 2006
.Dt SLATTACH 8
.Os
.Sh NAME
@@ -44,8 +44,26 @@
.Ar ttyname
.Sh DESCRIPTION
.Nm
-is used to assign a tty line to a network interface,
-and to define the network source and destination addresses.
+is used to assign a tty line to a network interface which uses asynchronous
+serial lines.
+.Pp
+Currently the
+.Nm
+command is used to attach
+.Xr sl 4
+or
+.Xr strip 4
+interfaces.
+These interfaces have to be created using the
+.Xr ifconfig 8
+.Cm create
+subcommand before the
+.Nm
+command.
+The network source and destination addresses and other interface parameters
+are configured via
+.Xr ifconfig 8 .
+.Pp
The following operands are supported by
.Nm :
.Bl -tag -width Ar
@@ -123,9 +141,9 @@
slattach \-s 4800 /dev/tty01
.Ed
.Sh DIAGNOSTICS
-Messages indicating that the specified interface does not exist, the
-requested address is unknown, or that the user is not privileged but
-tried to alter an interface's configuration.
+Messages indicating that the specified interface is not configured or created,
+the requested address is unknown, or that the user is not privileged
+but tried to alter an interface's configuration.
.Sh SEE ALSO
.Xr netstat 1 ,
.Xr daemon 3 ,
@@ -133,9 +151,27 @@
.Xr sl 4 ,
.Xr strip 4 ,
.Xr ifconfig 8 ,
-.Xr rc 8
+.Xr rc 8 ,
+.Xr sliplogin 8 ,
+.Xr slstats 8
.Sh HISTORY
The
.Nm
command appeared in
.Bx 4.3 .
+.Sh BUGS
+There is no way to specify the interface name (sl%d etc.) to be attached by the
+.Nm
+command.
+There is no way to see which interface is assigned to the specified tty by the
+.Nm
+command, either.
+.Pp
+It would be better if the network interfaces were created by the
+.Nm
+command rather than by using the
+.Xr ifconfig 8
+.Cm create
+subcommand before the
+.Nm
+command.
Index: share/man/man4/sl.4
===================================================================
RCS file: /cvsroot/src/share/man/man4/sl.4,v
retrieving revision 1.11
diff -u -r1.11 sl.4
--- share/man/man4/sl.4 17 Jun 2006 04:58:14 -0000 1.11
+++ share/man/man4/sl.4 8 Jul 2006 05:06:37 -0000
@@ -29,7 +29,7 @@
.\"
.\" From: @(#)lo.4 8.1 (Berkeley) 6/5/93
.\"
-.Dd December 5, 2004
+.Dd July 8, 2006
.Dt SL 4
.Os
.Sh NAME
@@ -45,6 +45,23 @@
network interfaces using the
.Tn SLIP
protocol.
+.Pp
+To use the
+.Nm
+interface, the administrator must first create the interface and assign
+a tty line to it.
+The
+.Nm
+interface is created using the
+.Xr ifconfig 8
+.Cm create
+subcommand, and
+.Xr slattach 8
+is used to assign a tty line to the interface.
+Once the interface is attached, network source and destination addresses and
+other parameters are configured via
+.Xr ifconfig 8 .
+.Pp
The
.Nm
interface can use Van Jacobson
@@ -80,6 +97,8 @@
.Xr inet 4 ,
.Xr intro 4 ,
.Xr ppp 4 ,
+.Xr strip 4 ,
+.Xr ifconfig 8 ,
.Xr slattach 8 ,
.Xr sliplogin 8 ,
.Xr slstats 8