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. All advertising materials mentioning features or use of this software
13 .\" must display the following acknowledgement:
14 .\" This product includes software developed by the University of
15 .\" California, Berkeley and its contributors.
16 .\" 4. Neither the name of the University nor the names of its contributors
17 .\" may be used to endorse or promote products derived from this software
18 .\" without specific prior written permission.
20 .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
21 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
22 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
23 .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
24 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
25 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
26 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
27 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
28 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
29 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
32 .\" @(#)startslip.1 8.1 (Berkeley) 6/5/93
33 .\" $FreeBSD: src/sbin/startslip/startslip.1,v 1.16.2.5 2002/06/20 23:09:11 charnier Exp $
34 .\" $DragonFly: src/sbin/startslip/startslip.1,v 1.2 2003/06/17 04:27:34 dillon Exp $
41 .Nd dial up and login to a slip server
48 .Op Fl s Ar string2 Op Ar ...\&
55 .Op Fl D Ar downscript
56 .Op Fl t Ar script_timeout
58 .Op Fl w Ar retry_pause
62 .Ar device user password
66 utility opens the specified
68 Once carrier is asserted (if modem control is enabled)
70 attempts to login as the specified
74 Standard login: & Password: scheme assumed unless Annex option
77 If successful, it puts the device into the slip line discipline,
80 and goes to wait mode.
81 If carrier drops (modem control enabled) or a
85 it closes the device, calls
87 and attempts to repeat the dialup and login sequence.
92 it closes the device, calls
97 called twice on the same device, previous copy killed by a
101 The following options are available:
102 .Bl -tag -width indent
104 Print out debugging information.
106 Determine the baud rate used for
108 default value is 9600.
109 .It Fl t Ar script_timeout
110 Set login script timeout in seconds, default value is 90.
111 .It Fl w Ar retry_pause
112 Set connecting retry pause in seconds (increased from one retry to another),
115 Set maximum number of connection retries for one session,
117 Value 0 means infinite count.
123 Return character is added automatically.
125 the string is used to specify a dial sequence.
126 No string written by default.
127 You can specify several
129 arguments to use with each try, f.e. several host phone numbers.
130 .It Fl A Ar annexname
133 utility assumes it is connecting to a Xylogics Annex box and engages in an
134 appropriate dialog using the
141 argument is a string that is used to match against the Annex prompt
142 to determine when a connection has been established.
144 Use hardware (CTS/RTS) flow control for
146 Default value is no flow control.
148 Disable modem control (waiting for carrier and carrier drop sense) for
150 Modem control is enabled by default.
152 Specify a script to run when a SLIP interface becomes connected. This may
156 and other appropriate commands. The arguments that
157 are passed to the script are "slX up".
160 Dial sequence number (see
164 environment variable.
165 .It Fl D Ar downscript
166 Specify a script to run when a SLIP connection goes away. The arguments that
167 are passed to the script are "slX down". Default value is
169 Dial sequence number (see
173 environment variable.
174 .It Fl K Ar keepalive
175 Set SLIP "keep alive" timeout in seconds.
176 If FRAME_END not received during this
177 time period, a reconnect will occur.
178 Active "out fill" timeout expected from other
180 Default value is no timeout.
182 Set SLIP "out fill" timeout in seconds.
183 It causes at least one FRAME_END
184 to be sent during this timeout.
185 Needed for "keep alive" timeout on other side.
186 Default value is no timeout.
188 Set SLIP unit number directly.
189 Use with caution, no check for two
190 interfaces with same number made.
191 Default is dynamic assignment.
193 Use uucp-style device locking.
194 You need it unless you start
196 from external program which already does uucp locking.
197 Default case is no uucp locking to satisfy such programs.
200 .Bl -tag -width /var/run/startslip.<device>.pid -compact
201 .It Pa /var/run/startslip.<device>.pid
203 .It Pa /usr/share/examples/startslip/*