1 files changed, 106 insertions, 17 deletions
diff --git a/sbin/slattach/slattach.8 b/sbin/slattach/slattach.8
index 217c481..e45ba3c 100644
--- a/sbin/slattach/slattach.8
+++ b/sbin/slattach/slattach.8
@@ -1,5 +1,5 @@
-.\" Copyright (c) 1986, 1991, 1993
-.\"	The Regents of the University of California.  All rights reserved.
+.\" Copyright (c) 1986, 1991 The Regents of the University of California.
+.\" All rights reserved.
 .\"
 .\" Redistribution and use in source and binary forms, with or without
 .\" modification, are permitted provided that the following conditions
@@ -29,17 +29,30 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.\"     @(#)slattach.8	8.2 (Berkeley) 4/1/94
+.\"     from: @(#)slattach.8	6.4 (Berkeley) 3/16/91
 .\"
-.Dd April 1, 1994
+.\"	$Id: slattach.8,v 1.7 1993/10/13 07:16:39 rgrimes Exp $
+.\"
+.Dd April 4, 1993
 .Dt SLATTACH 8
 .Os BSD 4.3
 .Sh NAME
 .Nm slattach
 .Nd attach serial lines as network interfaces
-.Sh SYNOPSIS
+.Sh SYOPNSIS
 .Nm Slattach
-.Ar ttyname Op Ar baudrate
+.Op \-a
+.Op \-c
+.Op \-e exit-command
+.Op \-f
+.Op \-h
+.Op \-l
+.Op \-n
+.Op \-r redial-command
+.Op \-s baudrate
+.Op \-u unit-command
+.Op \-z
+.Ar ttyname 
 .Sh DESCRIPTION
 .Nm Slattach
 is used to assign a tty line to a network interface,
@@ -47,16 +60,53 @@ and to define the network source and destination addresses.
 The following operands are supported by
 .Nm slattach :
 .Bl -tag -width Ar
+.It Ar \-a
+Autoenable the VJ header compression option, if the other end of the link
+is capable of VJ header compression then it will be used otherwise normal
+headers will be used.
+.It Ar \-c
+Enables the VJ header compression option.  Note that both ends of the link
+must be able to use VJ header compression for this to work.
+.It Ar \-e exit-command
+Specifies a command to be invoked within a shell (sh -c exit-command)
+before slattach exits.
+.It Ar \-f
+Disables the invocation of daemon() to run slattach in the background.
+.It Ar \-h
+Turn on cts/rts style flow control on the slip port, by default no flow
+control is done.
+.It Ar \-l
+disable modem control (CLOCAL) and ignore carrier detect on the slip
+port.  By default the redial-command is invoked upon carrier drop and
+slattach aborts if no redial-command is specified.
+.It Ar \-n
+Throw away ICMP packets.  The slip interface will ignore ICMP packets
+to prevent slow lines being saturated by ICMP responses.
+.It Ar \-r redial-command
+Specifies a command to be invoked within a shell (sh -c
+redial-command) whenever carrier is lost on the line.
+.It Ar \-s baudrate
+Specifies the speed of the connection. If not specified, the
+default of 9600 is used.
+.It Ar \-u unit-command
+When the line is switched to slip discipline, run
+.Ql sh \-c unit-command <last> <current> 
+where <last> and <current> are the slip unit numbers when the line was
+last opened and the unit number of the current slip connection
+respecitvely.  The unit number can change after redialing if you are
+using more than one slip line.  Slattach will abort if the unit number
+changes and
+.Ql \-u unit-command
+was not specified.
+.It Ar \-z
+forces redial
+redial-cmd upon startup irrespective of carrier.
 .It Ar ttyname
 Specifies the name of the tty device.
 .Ar Ttyname
-should be a string of the form
-.Ql ttyXX ,
-or
-.Ql /dev/ttyXX .
-.It Ar baudrate
-Specifies the speed of the connection. If not specified, the
-default of 9600 is used.
+should be a string of the form 
+.Ql ttyXX or
+.Ql /dev/ttyXX.
 .El
 .Pp
 Only the super-user may attach a network interface.
@@ -65,19 +115,58 @@ To detach the interface, use
 .Dq Li ifconfig interface-name down
 after killing off the
 .Nm slattach
-process.
+process using
+.Ql kill -INT .
 .Ar Interface-name
 is the name that is shown by
 .Xr netstat 1
+.Pp
+To setup slattach to redial the phone when carrier is lost, use the
+.Ql \-r redial-cmd
+option to specify a script or executable that will reconnect the
+serial line to the slip server.  For example, the script could redial
+the server and log in, etc.
+.Pp
+To reconfigure the network interface in case the slip unit number
+changes, use the
+.Ql \-u unit-cmd
+option to specify a script or executable that will be invoked as 
+.Ql sh \-c unit-cmd old new,
+where old and new are the slip unit numbers before and after
+reconnecting the line.  The unit number can change if you have more
+than one line disconnect at the same time.  The first to succeed in
+reconnecting will get the lowest unit number.
+.Pp
+To kill slattach use
+.Ql kill -INT
+(SIGINT) which causes it to close the tty and exit.
+.Pp
+To force a redial, use
+.Ql kill -HUP
+(SIGHUP) which causes slattach to think carrier was lost and thus invoke 
+.Ql sh -c redial-command
+to reconnect to the server.
+.Pp
+If you use a hard-wired connection rather than a modem, invoke
+slattach with the
+.Ql \-l
+option in order to ignore carrier on the slip line.
 .Sh EXAMPLES
 .Bd -literal -offset indent -compact
 slattach ttyh8
-slattach /dev/tty01 4800
+slattach \-s 4800 /dev/tty01
+slattach \-c \-s 38400 /dev/sio01
+slattach \-r 'kermit -y dial.script >kermit.log 2>&1'
 .Ed
 .Sh DIAGNOSTICS
+Look for error messages in /var/log/messages (slattach is a daemon).
 Messages indicating the specified interface does not exit, the
-requested address is unknown, the user is not privileged and
-tried to alter an interface's configuration.
+requested address is unknown, the user is not privileged and tried to
+alter an interface's configuration are logged there.  Slattach also
+logs failure to set the controlling terminal or failure to install
+signal handlers.  Upon connection and redial the ttyname and baud rate
+are logged and on shutdown the ttyname is logged.
+.Pp
 .Sh SEE ALSO
 .Xr netstat 1 ,
 .Xr netintro 4 ,