1 .\" Copyright (c) 1990, 1991, 1993
2 .\" The Regents of the University of California. All rights reserved.
4 .\" Redistribution and use in source and binary forms, with or without
5 .\" modification, are permitted provided that the following conditions
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.
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
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 $
37 .Nd dial up and login to a slip server
44 .Op Fl s Ar string2 Op Ar ...\&
51 .Op Fl D Ar downscript
52 .Op Fl t Ar script_timeout
54 .Op Fl w Ar retry_pause
58 .Ar device user password
62 utility opens the specified
64 Once carrier is asserted (if modem control is enabled)
66 attempts to login as the specified
70 Standard login: & Password: scheme assumed unless Annex option
73 If successful, it puts the device into the slip line discipline,
76 and goes to wait mode.
77 If carrier drops (modem control enabled) or a
81 it closes the device, calls
83 and attempts to repeat the dialup and login sequence.
88 it closes the device, calls
93 called twice on the same device, previous copy killed by a
97 The following options are available:
98 .Bl -tag -width indent
100 Print out debugging information.
102 Determine the baud rate used for
104 default value is 9600.
105 .It Fl t Ar script_timeout
106 Set login script timeout in seconds, default value is 90.
107 .It Fl w Ar retry_pause
108 Set connecting retry pause in seconds (increased from one retry to another),
111 Set maximum number of connection retries for one session,
113 Value 0 means infinite count.
119 Return character is added automatically.
121 the string is used to specify a dial sequence.
122 No string written by default.
123 You can specify several
125 arguments to use with each try, f.e. several host phone numbers.
126 .It Fl A Ar annexname
129 utility assumes it is connecting to a Xylogics Annex box and engages in an
130 appropriate dialog using the
137 argument is a string that is used to match against the Annex prompt
138 to determine when a connection has been established.
140 Use hardware (CTS/RTS) flow control for
142 Default value is no flow control.
144 Disable modem control (waiting for carrier and carrier drop sense) for
146 Modem control is enabled by default.
148 Specify a script to run when a SLIP interface becomes connected. This may
152 and other appropriate commands. The arguments that
153 are passed to the script are "slX up".
156 Dial sequence number (see
160 environment variable.
161 .It Fl D Ar downscript
162 Specify a script to run when a SLIP connection goes away. The arguments that
163 are passed to the script are "slX down". Default value is
165 Dial sequence number (see
169 environment variable.
170 .It Fl K Ar keepalive
171 Set SLIP "keep alive" timeout in seconds.
172 If FRAME_END not received during this
173 time period, a reconnect will occur.
174 Active "out fill" timeout expected from other
176 Default value is no timeout.
178 Set SLIP "out fill" timeout in seconds.
179 It causes at least one FRAME_END
180 to be sent during this timeout.
181 Needed for "keep alive" timeout on other side.
182 Default value is no timeout.
184 Set SLIP unit number directly.
185 Use with caution, no check for two
186 interfaces with same number made.
187 Default is dynamic assignment.
189 Use uucp-style device locking.
190 You need it unless you start
192 from external program which already does uucp locking.
193 Default case is no uucp locking to satisfy such programs.
196 .Bl -tag -width /var/run/startslip.<device>.pid -compact
197 .It Pa /var/run/startslip.<device>.pid
199 .It Pa /usr/share/examples/startslip/*