1.\" Copyright (c) 1990, 1991, 1993 2.\" The Regents of the University of California. All rights reserved. 3.\" 4.\" Redistribution and use in source and binary forms, with or without 5.\" modification, are permitted provided that the following conditions 6.\" are met: 7.\" 1. Redistributions of source code must retain the above copyright 8.\" notice, this list of conditions and the following disclaimer. 9.\" 2. Redistributions in binary form must reproduce the above copyright 10.\" notice, this list of conditions and the following disclaimer in the 11.\" documentation and/or other materials provided with the distribution. 12.\" 3. Neither the name of the University nor the names of its contributors 13.\" may be used to endorse or promote products derived from this software 14.\" without specific prior written permission. 15.\" 16.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND 17.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 18.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 19.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE 20.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 21.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 22.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 23.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 24.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 25.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 26.\" SUCH DAMAGE. 27.\" 28.\" @(#)startslip.1 8.1 (Berkeley) 6/5/93 29.\" $FreeBSD: src/sbin/startslip/startslip.1,v 1.16.2.5 2002/06/20 23:09:11 charnier Exp $ 30.\" $DragonFly: src/sbin/startslip/startslip.1,v 1.2 2003/06/17 04:27:34 dillon Exp $ 31.\" 32.Dd June 5, 1993 33.Dt STARTSLIP 1 34.Os 35.Sh NAME 36.Nm startslip 37.Nd dial up and login to a slip server 38.Sh SYNOPSIS 39.Nm 40.Op Fl d 41.Op Fl b Ar speed 42.Oo 43.Fl s Ar string1 44.Op Fl s Ar string2 Op Ar ...\& 45.Oc 46.Op Fl h 47.Op Fl l 48.Op Fl L 49.Op Fl A Ar annexname 50.Op Fl U Ar upscript 51.Op Fl D Ar downscript 52.Op Fl t Ar script_timeout 53.Op Fl W Ar maxtries 54.Op Fl w Ar retry_pause 55.Op Fl K Ar keepalive 56.Op Fl O Ar outfill 57.Op Fl S Ar unit 58.Ar device user password 59.Sh DESCRIPTION 60The 61.Nm 62utility opens the specified 63.Ar device . 64Once carrier is asserted (if modem control is enabled) 65.Nm 66attempts to login as the specified 67.Ar user 68with the given 69.Ar password . 70Standard login: & Password: scheme assumed unless Annex option 71specified (see 72.Fl A ) . 73If successful, it puts the device into the slip line discipline, 74calls 75.Ar upscript 76and goes to wait mode. 77If carrier drops (modem control enabled) or a 78.Dv SIGHUP 79is sent to 80.Nm , 81it closes the device, calls 82.Ar downscript 83and attempts to repeat the dialup and login sequence. 84If a 85.Dv SIGTERM 86is send to 87.Nm , 88it closes the device, calls 89.Ar downscript 90and exits. 91When 92.Nm 93called twice on the same device, previous copy killed by a 94.Dv SIGTERM 95before any operation. 96.Pp 97The following options are available: 98.Bl -tag -width indent 99.It Fl d 100Print out debugging information. 101.It Fl b Ar speed 102Determine the baud rate used for 103.Ar device , 104default value is 9600. 105.It Fl t Ar script_timeout 106Set login script timeout in seconds, default value is 90. 107.It Fl w Ar retry_pause 108Set connecting retry pause in seconds (increased from one retry to another), 109default value is 60. 110.It Fl W Ar maxtries 111Set maximum number of connection retries for one session, 112default value is 6. 113Value 0 means infinite count. 114.It Fl s Ar stringN 115The optional 116.Ar stringN 117is written to 118.Ar device . 119Return character is added automatically. 120For a dialup modem, 121the string is used to specify a dial sequence. 122No string written by default. 123You can specify several 124.Fl s Ar stringN 125arguments to use with each try, f.e. several host phone numbers. 126.It Fl A Ar annexname 127The 128.Nm 129utility assumes it is connecting to a Xylogics Annex box and engages in an 130appropriate dialog using the 131.Ar user 132and 133.Ar password 134arguments. 135The 136.Ar annexname 137argument is a string that is used to match against the Annex prompt 138to determine when a connection has been established. 139.It Fl h 140Use hardware (CTS/RTS) flow control for 141.Ar device . 142Default value is no flow control. 143.It Fl l 144Disable modem control (waiting for carrier and carrier drop sense) for 145.Ar device . 146Modem control is enabled by default. 147.It Fl U Ar upscript 148Specify a script to run when a SLIP interface becomes connected. This may 149contain 150.Xr ifconfig 8 , 151.Xr route 8 , 152and other appropriate commands. The arguments that 153are passed to the script are "slX up". 154Default value is 155.Pa /sbin/ifconfig . 156Dial sequence number (see 157.Fl s ) 158passed via 159.Ev LINE 160environment variable. 161.It Fl D Ar downscript 162Specify a script to run when a SLIP connection goes away. The arguments that 163are passed to the script are "slX down". Default value is 164.Pa /sbin/ifconfig . 165Dial sequence number (see 166.Fl s ) 167passed via 168.Ev LINE 169environment variable. 170.It Fl K Ar keepalive 171Set SLIP "keep alive" timeout in seconds. 172If FRAME_END not received during this 173time period, a reconnect will occur. 174Active "out fill" timeout expected from other 175side. 176Default value is no timeout. 177.It Fl O Ar outfill 178Set SLIP "out fill" timeout in seconds. 179It causes at least one FRAME_END 180to be sent during this timeout. 181Needed for "keep alive" timeout on other side. 182Default value is no timeout. 183.It Fl S Ar unit 184Set SLIP unit number directly. 185Use with caution, no check for two 186interfaces with same number made. 187Default is dynamic assignment. 188.It Fl L 189Use uucp-style device locking. 190You need it unless you start 191.Nm 192from external program which already does uucp locking. 193Default case is no uucp locking to satisfy such programs. 194.El 195.Sh FILES 196.Bl -tag -width /var/run/startslip.<device>.pid -compact 197.It Pa /var/run/startslip.<device>.pid 198pid stored here 199.It Pa /usr/share/examples/startslip/* 200.El 201.Sh SEE ALSO 202.Xr uustat 1 , 203.Xr slattach 8 , 204.Xr sliplogin 8 205.Sh HISTORY 206The 207.Nm 208appeared in 209.Bx 4.4 . 210