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
40 .Nd dial up and login to a slip server
47 .Op Fl s Ar string2 Op Ar ...\&
54 .Op Fl D Ar downscript
55 .Op Fl t Ar script_timeout
57 .Op Fl w Ar retry_pause
61 .Ar device user password
66 Once carrier is asserted (if modem control is enabled)
68 attempts to login as the specified
72 Standard login: & Password: scheme assumed unless Annex option
75 If successful, it puts the device into the slip line discipline,
78 and goes to wait mode.
79 If carrier drops (modem control enabled) or a
83 it closes the device, calls
85 and attempts to repeat the dialup and login sequence.
90 it closes the device, calls
95 called twice on the same device, previous copy killed by a
99 The following options are available:
100 .Bl -tag -width indent
103 prints out debugging information about what it is trying to do.
105 Determine the baud rate used for
107 default value is 9600.
108 .It Fl t Ar script_timeout
109 Set login script timeout in seconds, default value is 90.
110 .It Fl w Ar retry_pause
111 Set connecting retry pause in seconds (increased from one retry to another),
114 Set maximum number of connection retries for one session,
116 Value 0 means infinite count.
122 Return character is added automatically.
124 the string is used to specify a dial sequence.
125 No string written by default.
126 You can specify several
128 arguments to use with each try, f.e. several host phone numbers.
129 .It Fl A Ar annexname
131 assumes it is connecting to a Xylogics Annex box and engages in an
132 appropriate dialog using the
139 argument is a string that is used to match against the Annex prompt
140 to determine when a connection has been established.
142 Use hardware (CTS/RTS) flow control for
144 Default value is no flow control.
146 Disable modem control (waiting for carrier and carrier drop sense) for
148 Modem control is enabled by default.
150 Specify a script to run when a SLIP interface becomes connected. This may
154 and other appropriate commands. The arguments that
155 are passed to the script are "slX up".
158 Dial sequence number (see
162 environment variable.
163 .It Fl D Ar downscript
164 Specify a script to run when a SLIP connection goes away. The arguments that
165 are passed to the script are "slX down". Default value is
167 Dial sequence number (see
171 environment variable.
172 .It Fl K Ar keepalive
173 Set SLIP "keep alive" timeout in seconds.
174 If FRAME_END not received during this
175 time period, a reconnect will occur.
176 Active "out fill" timeout expected from other
178 Default value is no timeout.
180 Set SLIP "out fill" timeout in seconds.
181 It causes at least one FRAME_END
182 to be sent during this timeout.
183 Needed for "keep alive" timeout on other side.
184 Default value is no timeout.
186 Set SLIP unit number directly.
187 Use with caution, no check for two
188 interfaces with same number made.
189 Default is dynamic assignment.
191 Use uucp-style device locking.
192 You need it unless you start
194 from external program which already does uucp locking.
195 Default case is no uucp locking to satisfy such programs.
198 .Bl -tag -width /var/run/startslip.<device>.pid -compact
199 .It Pa /var/run/startslip.<device>.pid
201 .It Pa /usr/share/examples/startslip/*