Subject: Re: bin/33923: slattach(8) can't attach sl(4) interface
To: None <gnats-admin@netbsd.org, netbsd-bugs@netbsd.org,>
From: Izumi Tsutsui <tsutsui@ceres.dti.ne.jp>
List: netbsd-bugs
Date: 07/08/2006 02:35:03
The following reply was made to PR bin/33923; it has been noted by GNATS.

From: Izumi Tsutsui <tsutsui@ceres.dti.ne.jp>
To: christos@zoulas.com
Cc: gnats-bugs@NetBSD.org, gnats-admin@NetBSD.org,
	netbsd-bugs@NetBSD.org, tsutsui@ceres.dti.ne.jp
Subject: Re: bin/33923: slattach(8) can't attach sl(4) interface
Date: Sat, 8 Jul 2006 11:33:36 +0900

 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