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 11:33:36
christos@zoulas.com wrote:

> Right, unlike pppd I don't think that slattach has a way to tell bind to
> slX, or even find what you are bound. So let's fix the man page, for now.

How about this? (maybe needs wizd(8)'fied)
---
Izumi Tsutsui


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 01:51:18 -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 by the
+.Xr ifconfig 8
+command.
+.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's better that the network interfaces are created by the
+.Nm
+command rather than 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 01:51:18 -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,24 @@
 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 the
+.Xr slattach 8
+command 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 the
+.Xr ifconfig 8
+command.
+.Pp
 The
 .Nm
 interface can use Van Jacobson
@@ -80,6 +98,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