Now understand "host!login:" style prompts additionly.

Add -t to specify login script timeout.
Add -w to specify retry wait time.
Describe -p option.
Now understand several -s sections (for several host phone numbers).
Remove -F sw (software flow control), it is impossible with slip.
Change -F hw (hardware flow control) option to -h as in slattach,
we don't need option with argument for only one case.
Call downscript on SIGTERM.
Improve debug diagnostic.
Allow startslip work with several slip lines without killing each other.
Unlink pid file on exit.
Skip \r and \0 in login script parsing instead making them \n.
Use absolute path to default script (/sbin/ifconfig).
Call up/down script in background to prevent hang on them.

1 files changed, 49 insertions, 16 deletions

diff --git a/sbin/startslip/startslip.1 b/sbin/startslip/startslip.1
index 8a9dd3d..1996ab2 100644
--- a/sbin/startslip/startslip.1
+++ b/sbin/startslip/startslip.1
@@ -41,11 +41,17 @@
 .Nm startslip
 .Op Fl d
 .Op Fl b Ar speed
-.Op Fl s Ar string
+[
+.Fl s Ar string1
+.Op Fl s Ar string2 Op Ar ...
+]
+.Op Fl h
 .Op Fl A Ar annexname
-.Op Fl F Ar flowcontrol
 .Op Fl U Ar upscript
 .Op Fl D Ar downscript
+.Op Fl p Ar father_pause
+.Op Fl t Ar script_timeout
+.Op Fl w Ar retry_pause
 .Ar device user passwd
 .Sh DESCRIPTION
 .Nm Startslip
@@ -59,11 +65,25 @@ attempts to login as the specified
 with the given
 .Ar password .
 If successful, it puts the device into the slip line discipline.
-If carrier drops and a
+If carrier drops or a
 .Dv SIGHUP
 is sent to
 .Nm startslip ,
-it closes the device and attempts to repeat the dialup and login sequence.
+it closes the device, calls
+.Ar downscript
+and attempts to repeat the dialup and login sequence.
+If a
+.Dv SIGTERM
+is send to
+.Nm startslip ,
+it closes the device, calls
+.Ar downscript
+and exits.
+When
+.Nm startslip
+called twice on the same device, previous copy killed by a
+.Dv SIGTERM
+before any operation.
 .Pp
 Available options:
 .Bl -tag -width Ar
@@ -73,13 +93,26 @@ prints out debugging information about what it is trying to do.
 .It Fl b Ar speed
 Determines the baud rate used for
 .Ar device .
-.It Fl s Ar string
+Default value is 9600.
+.It Fl t Ar script_timeout
+Set login script timeout in seconds, default value is 90.
+.It Fl w Ar retry_pause
+Set retry pause in seconds (increased from one try to another),
+default value is 60.
+.It Fl p Ar father_pause
+Set after fork father pause in seconds, default is no pause there.
+.It Fl s Ar string1
 The optional
 .Ar string
 is written to
 .Ar device .
+Return character is added automatically.
 For a dialup modem,
 the string is used to specify a dial sequence.
+Default string is return character.
+You can specify several
+.Fl s Ar stringN
+arguments to use with each try, f.e. several host phone numbers.
 .It Fl A Ar annexname
 .Nm Startslip
 assumes it is connecting to a Xylogics Annex box and engages in an
@@ -92,25 +125,25 @@ The
 .Ar annexname
 argument is a string that is used to match against the Annex prompt
 to determine when a connection has been established.
-.It Fl F Ar flowcontrol
-Determines the type of flow control used on
+.It Fl h
+Use hardware (CTS/RTS) flow control for
 .Ar device .
-Choices for
-.Ar flowcontrol
-are
-``none'' for no flow control (the default),
-``hw'' for hardware RTS/CTS flow control and
-``sw'' for software XON/XOFF flow control.
+Default value is no flow control.
 .It Fl U Ar upscript
 Specifies a script to run when a SLIP interface becomes connected.  This may
 contain ifconfig, route, and other appropriate commands.  The arguments that
-are passed to the script are "slX up".
+are passed to the script are "slX up". Default value is "/sbin/ifconfig".
 .It Fl D Ar downscript
 Specifies a script to run when a SLIP connection goes away.  The arguments that
-are passed to the script are "slX down".
+are passed to the script are "slX down". Default value is "/sbin/ifconfig".
 .El
+.Sh FILES
+.Bl -tag -width /var/run/startslip-<device>.pid -compact
+.It Pa /var/run/startslip-<device>.pid
+pid stored here
 .Sh SEE ALSO
-.Xr sliplogin 8
+.Xr sliplogin 8 ,
+.Xr slattach 8
 .Sh HISTORY
 The
 .Nm startslip