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