freebsd-dev/sbin/slattach/slattach.8

264 lines
7.9 KiB
Groff
Raw Normal View History

Slattach ported from 1.1.5 plus Bruce Evans suggested fix (close FDs and fork before redialing) to prevent dialer from hanging with newer sio.c. Also moved history from the source to the cvs log (here) per David G's suggestion. This compiles but needs testing now... Rich /* * Hacks to support "-a|c|n" flags on the command line which enable VJ * header compresion and disable ICMP. * If this is good all rights go to B & L Jolitz, otherwise send your * comments to Reagan (/dev/null). * * nerd@percival.rain.com (Michael Galassi) 92.09.03 * * Hacked to change from sgtty to POSIX termio style serial line control * and added flag to enable cts/rts style flow control. * * blymn@awadi.com.au (Brett Lymn) 93.04.04 * * Put slattach in it's own process group so it can't be killed * accidentally. Close the connection on SIGHUP and SIGINT. Write a * syslog entry upon opening and closing the connection. Rich Murphey * and Brad Huntting. * * Add '-r command' option: runs 'command' upon recieving SIGHUP * resulting from loss of carrier. Log any errors after forking. * Rich 8/13/93 * * This version of slattach includes many changes by David Greenman, Brian * Smith, Chris Bradley, and me (Michael Galassi). None of them are * represented as functional anywhere outside of RAINet though they do work * for us. Documentation is limited to the usage message for now. If you * make improovments please pass them back. * * Added '-u UCMD' which runs 'UCMD <old> <new>' whenever the slip * unit number changes where <old> and <new> are the old and new unit * numbers, respectively. Also added the '-z' option which forces * invocation of the redial command (-r CMD) upon startup regardless * of whether the com driver claims (sometimes mistakenly) that * carrier is present. Also added '-e ECMD' which runs ECMD before * exiting. * * marc@escargot.rain.com (Marc Frajola) 93/09/10 * * Minor fixes to allow passive SLIP links to work (connections with * modem control that do not have an associated dial command). Added * code to re-check for carrier after dial command has been executed. * Added SIGTERM handler to properly handle normal kill signals. Fixed * bug in logic that caused message about no -u command to be logged * even when -u was specified and the sl number changes. Tried to get * rid of redundant syslog()'s to minimize console log output. Improved * logging of improper command line options or number of command * arguments. Removed spurious newline characters from syslog() calls. * * gjung@gjbsd.franken.de * * sighup_handler changed to set CLOCAL before running redial_cmd. * added flag exiting, so exit_handler is not run twice. Fork * before reopening tty. */
1994-08-23 08:07:17 +00:00
.\" Copyright (c) 1986, 1991 The Regents of the University of California.
.\" All rights reserved.
.\"
.\" Redistribution and use in source and binary forms, with or without
.\" modification, are permitted provided that the following conditions
.\" are met:
.\" 1. Redistributions of source code must retain the above copyright
.\" notice, this list of conditions and the following disclaimer.
.\" 2. Redistributions in binary form must reproduce the above copyright
.\" notice, this list of conditions and the following disclaimer in the
.\" documentation and/or other materials provided with the distribution.
.\" 3. All advertising materials mentioning features or use of this software
.\" must display the following acknowledgement:
.\" This product includes software developed by the University of
.\" California, Berkeley and its contributors.
.\" 4. Neither the name of the University nor the names of its contributors
.\" may be used to endorse or promote products derived from this software
.\" without specific prior written permission.
.\"
.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\" @(#)slattach.8 6.4 (Berkeley) 3/16/91
.\"
.\" $Header: /home/ncvs/src/sbin/slattach/slattach.8,v 1.10 1996/02/17 19:21:40 ache Exp $
Slattach ported from 1.1.5 plus Bruce Evans suggested fix (close FDs and fork before redialing) to prevent dialer from hanging with newer sio.c. Also moved history from the source to the cvs log (here) per David G's suggestion. This compiles but needs testing now... Rich /* * Hacks to support "-a|c|n" flags on the command line which enable VJ * header compresion and disable ICMP. * If this is good all rights go to B & L Jolitz, otherwise send your * comments to Reagan (/dev/null). * * nerd@percival.rain.com (Michael Galassi) 92.09.03 * * Hacked to change from sgtty to POSIX termio style serial line control * and added flag to enable cts/rts style flow control. * * blymn@awadi.com.au (Brett Lymn) 93.04.04 * * Put slattach in it's own process group so it can't be killed * accidentally. Close the connection on SIGHUP and SIGINT. Write a * syslog entry upon opening and closing the connection. Rich Murphey * and Brad Huntting. * * Add '-r command' option: runs 'command' upon recieving SIGHUP * resulting from loss of carrier. Log any errors after forking. * Rich 8/13/93 * * This version of slattach includes many changes by David Greenman, Brian * Smith, Chris Bradley, and me (Michael Galassi). None of them are * represented as functional anywhere outside of RAINet though they do work * for us. Documentation is limited to the usage message for now. If you * make improovments please pass them back. * * Added '-u UCMD' which runs 'UCMD <old> <new>' whenever the slip * unit number changes where <old> and <new> are the old and new unit * numbers, respectively. Also added the '-z' option which forces * invocation of the redial command (-r CMD) upon startup regardless * of whether the com driver claims (sometimes mistakenly) that * carrier is present. Also added '-e ECMD' which runs ECMD before * exiting. * * marc@escargot.rain.com (Marc Frajola) 93/09/10 * * Minor fixes to allow passive SLIP links to work (connections with * modem control that do not have an associated dial command). Added * code to re-check for carrier after dial command has been executed. * Added SIGTERM handler to properly handle normal kill signals. Fixed * bug in logic that caused message about no -u command to be logged * even when -u was specified and the sl number changes. Tried to get * rid of redundant syslog()'s to minimize console log output. Improved * logging of improper command line options or number of command * arguments. Removed spurious newline characters from syslog() calls. * * gjung@gjbsd.franken.de * * sighup_handler changed to set CLOCAL before running redial_cmd. * added flag exiting, so exit_handler is not run twice. Fork * before reopening tty. */
1994-08-23 08:07:17 +00:00
.\"
.Dd April 4, 1993
.Dt SLATTACH 8
.Os BSD 4.3
.Sh NAME
.Nm slattach
.Nd attach serial lines as network interfaces
.Sh SYNOPSIS
1995-09-20 04:53:08 +00:00
.Nm slattach
.Op Fl a
.Op Fl c
.Op Fl e Ar exit-command
.Op Fl f
.Op Fl h
.Op Fl l
.Op Fl n
1995-09-20 04:53:08 +00:00
.Op Fl z
.Op Fl L
.Op Fl r Ar redial-command
.Op Fl s Ar baudrate
.Op Fl u Ar unit-command
.Op Fl K Ar keepalive
.Op Fl O Ar outfill
.Op Fl S Ar unit
Slattach ported from 1.1.5 plus Bruce Evans suggested fix (close FDs and fork before redialing) to prevent dialer from hanging with newer sio.c. Also moved history from the source to the cvs log (here) per David G's suggestion. This compiles but needs testing now... Rich /* * Hacks to support "-a|c|n" flags on the command line which enable VJ * header compresion and disable ICMP. * If this is good all rights go to B & L Jolitz, otherwise send your * comments to Reagan (/dev/null). * * nerd@percival.rain.com (Michael Galassi) 92.09.03 * * Hacked to change from sgtty to POSIX termio style serial line control * and added flag to enable cts/rts style flow control. * * blymn@awadi.com.au (Brett Lymn) 93.04.04 * * Put slattach in it's own process group so it can't be killed * accidentally. Close the connection on SIGHUP and SIGINT. Write a * syslog entry upon opening and closing the connection. Rich Murphey * and Brad Huntting. * * Add '-r command' option: runs 'command' upon recieving SIGHUP * resulting from loss of carrier. Log any errors after forking. * Rich 8/13/93 * * This version of slattach includes many changes by David Greenman, Brian * Smith, Chris Bradley, and me (Michael Galassi). None of them are * represented as functional anywhere outside of RAINet though they do work * for us. Documentation is limited to the usage message for now. If you * make improovments please pass them back. * * Added '-u UCMD' which runs 'UCMD <old> <new>' whenever the slip * unit number changes where <old> and <new> are the old and new unit * numbers, respectively. Also added the '-z' option which forces * invocation of the redial command (-r CMD) upon startup regardless * of whether the com driver claims (sometimes mistakenly) that * carrier is present. Also added '-e ECMD' which runs ECMD before * exiting. * * marc@escargot.rain.com (Marc Frajola) 93/09/10 * * Minor fixes to allow passive SLIP links to work (connections with * modem control that do not have an associated dial command). Added * code to re-check for carrier after dial command has been executed. * Added SIGTERM handler to properly handle normal kill signals. Fixed * bug in logic that caused message about no -u command to be logged * even when -u was specified and the sl number changes. Tried to get * rid of redundant syslog()'s to minimize console log output. Improved * logging of improper command line options or number of command * arguments. Removed spurious newline characters from syslog() calls. * * gjung@gjbsd.franken.de * * sighup_handler changed to set CLOCAL before running redial_cmd. * added flag exiting, so exit_handler is not run twice. Fork * before reopening tty. */
1994-08-23 08:07:17 +00:00
.Ar ttyname
.Sh DESCRIPTION
.Nm Slattach
is used to assign a tty line to a network interface,
and to define the network source and destination addresses.
The following operands are supported by
.Nm slattach :
.Bl -tag -width Ar
.It Fl a
Slattach ported from 1.1.5 plus Bruce Evans suggested fix (close FDs and fork before redialing) to prevent dialer from hanging with newer sio.c. Also moved history from the source to the cvs log (here) per David G's suggestion. This compiles but needs testing now... Rich /* * Hacks to support "-a|c|n" flags on the command line which enable VJ * header compresion and disable ICMP. * If this is good all rights go to B & L Jolitz, otherwise send your * comments to Reagan (/dev/null). * * nerd@percival.rain.com (Michael Galassi) 92.09.03 * * Hacked to change from sgtty to POSIX termio style serial line control * and added flag to enable cts/rts style flow control. * * blymn@awadi.com.au (Brett Lymn) 93.04.04 * * Put slattach in it's own process group so it can't be killed * accidentally. Close the connection on SIGHUP and SIGINT. Write a * syslog entry upon opening and closing the connection. Rich Murphey * and Brad Huntting. * * Add '-r command' option: runs 'command' upon recieving SIGHUP * resulting from loss of carrier. Log any errors after forking. * Rich 8/13/93 * * This version of slattach includes many changes by David Greenman, Brian * Smith, Chris Bradley, and me (Michael Galassi). None of them are * represented as functional anywhere outside of RAINet though they do work * for us. Documentation is limited to the usage message for now. If you * make improovments please pass them back. * * Added '-u UCMD' which runs 'UCMD <old> <new>' whenever the slip * unit number changes where <old> and <new> are the old and new unit * numbers, respectively. Also added the '-z' option which forces * invocation of the redial command (-r CMD) upon startup regardless * of whether the com driver claims (sometimes mistakenly) that * carrier is present. Also added '-e ECMD' which runs ECMD before * exiting. * * marc@escargot.rain.com (Marc Frajola) 93/09/10 * * Minor fixes to allow passive SLIP links to work (connections with * modem control that do not have an associated dial command). Added * code to re-check for carrier after dial command has been executed. * Added SIGTERM handler to properly handle normal kill signals. Fixed * bug in logic that caused message about no -u command to be logged * even when -u was specified and the sl number changes. Tried to get * rid of redundant syslog()'s to minimize console log output. Improved * logging of improper command line options or number of command * arguments. Removed spurious newline characters from syslog() calls. * * gjung@gjbsd.franken.de * * sighup_handler changed to set CLOCAL before running redial_cmd. * added flag exiting, so exit_handler is not run twice. Fork * before reopening tty. */
1994-08-23 08:07:17 +00:00
Autoenable the VJ header compression option, if the other end of the link
is capable of VJ header compression then it will be used otherwise normal
headers will be used.
.It Fl c
Slattach ported from 1.1.5 plus Bruce Evans suggested fix (close FDs and fork before redialing) to prevent dialer from hanging with newer sio.c. Also moved history from the source to the cvs log (here) per David G's suggestion. This compiles but needs testing now... Rich /* * Hacks to support "-a|c|n" flags on the command line which enable VJ * header compresion and disable ICMP. * If this is good all rights go to B & L Jolitz, otherwise send your * comments to Reagan (/dev/null). * * nerd@percival.rain.com (Michael Galassi) 92.09.03 * * Hacked to change from sgtty to POSIX termio style serial line control * and added flag to enable cts/rts style flow control. * * blymn@awadi.com.au (Brett Lymn) 93.04.04 * * Put slattach in it's own process group so it can't be killed * accidentally. Close the connection on SIGHUP and SIGINT. Write a * syslog entry upon opening and closing the connection. Rich Murphey * and Brad Huntting. * * Add '-r command' option: runs 'command' upon recieving SIGHUP * resulting from loss of carrier. Log any errors after forking. * Rich 8/13/93 * * This version of slattach includes many changes by David Greenman, Brian * Smith, Chris Bradley, and me (Michael Galassi). None of them are * represented as functional anywhere outside of RAINet though they do work * for us. Documentation is limited to the usage message for now. If you * make improovments please pass them back. * * Added '-u UCMD' which runs 'UCMD <old> <new>' whenever the slip * unit number changes where <old> and <new> are the old and new unit * numbers, respectively. Also added the '-z' option which forces * invocation of the redial command (-r CMD) upon startup regardless * of whether the com driver claims (sometimes mistakenly) that * carrier is present. Also added '-e ECMD' which runs ECMD before * exiting. * * marc@escargot.rain.com (Marc Frajola) 93/09/10 * * Minor fixes to allow passive SLIP links to work (connections with * modem control that do not have an associated dial command). Added * code to re-check for carrier after dial command has been executed. * Added SIGTERM handler to properly handle normal kill signals. Fixed * bug in logic that caused message about no -u command to be logged * even when -u was specified and the sl number changes. Tried to get * rid of redundant syslog()'s to minimize console log output. Improved * logging of improper command line options or number of command * arguments. Removed spurious newline characters from syslog() calls. * * gjung@gjbsd.franken.de * * sighup_handler changed to set CLOCAL before running redial_cmd. * added flag exiting, so exit_handler is not run twice. Fork * before reopening tty. */
1994-08-23 08:07:17 +00:00
Enables the VJ header compression option. Note that both ends of the link
must be able to use VJ header compression for this to work.
.It Fl e Ar exit-command
1995-09-20 04:53:08 +00:00
Specifies a command to be invoked within a shell
.Ql sh \-c Ar exit-command
before
.Nm slattach
exits.
.It Fl f
1995-09-20 04:53:08 +00:00
Disables the invocation of daemon() to run
.Nm slattach
in the background.
.It Fl h
Slattach ported from 1.1.5 plus Bruce Evans suggested fix (close FDs and fork before redialing) to prevent dialer from hanging with newer sio.c. Also moved history from the source to the cvs log (here) per David G's suggestion. This compiles but needs testing now... Rich /* * Hacks to support "-a|c|n" flags on the command line which enable VJ * header compresion and disable ICMP. * If this is good all rights go to B & L Jolitz, otherwise send your * comments to Reagan (/dev/null). * * nerd@percival.rain.com (Michael Galassi) 92.09.03 * * Hacked to change from sgtty to POSIX termio style serial line control * and added flag to enable cts/rts style flow control. * * blymn@awadi.com.au (Brett Lymn) 93.04.04 * * Put slattach in it's own process group so it can't be killed * accidentally. Close the connection on SIGHUP and SIGINT. Write a * syslog entry upon opening and closing the connection. Rich Murphey * and Brad Huntting. * * Add '-r command' option: runs 'command' upon recieving SIGHUP * resulting from loss of carrier. Log any errors after forking. * Rich 8/13/93 * * This version of slattach includes many changes by David Greenman, Brian * Smith, Chris Bradley, and me (Michael Galassi). None of them are * represented as functional anywhere outside of RAINet though they do work * for us. Documentation is limited to the usage message for now. If you * make improovments please pass them back. * * Added '-u UCMD' which runs 'UCMD <old> <new>' whenever the slip * unit number changes where <old> and <new> are the old and new unit * numbers, respectively. Also added the '-z' option which forces * invocation of the redial command (-r CMD) upon startup regardless * of whether the com driver claims (sometimes mistakenly) that * carrier is present. Also added '-e ECMD' which runs ECMD before * exiting. * * marc@escargot.rain.com (Marc Frajola) 93/09/10 * * Minor fixes to allow passive SLIP links to work (connections with * modem control that do not have an associated dial command). Added * code to re-check for carrier after dial command has been executed. * Added SIGTERM handler to properly handle normal kill signals. Fixed * bug in logic that caused message about no -u command to be logged * even when -u was specified and the sl number changes. Tried to get * rid of redundant syslog()'s to minimize console log output. Improved * logging of improper command line options or number of command * arguments. Removed spurious newline characters from syslog() calls. * * gjung@gjbsd.franken.de * * sighup_handler changed to set CLOCAL before running redial_cmd. * added flag exiting, so exit_handler is not run twice. Fork * before reopening tty. */
1994-08-23 08:07:17 +00:00
Turn on cts/rts style flow control on the slip port, by default no flow
control is done.
.It Fl l
Slattach ported from 1.1.5 plus Bruce Evans suggested fix (close FDs and fork before redialing) to prevent dialer from hanging with newer sio.c. Also moved history from the source to the cvs log (here) per David G's suggestion. This compiles but needs testing now... Rich /* * Hacks to support "-a|c|n" flags on the command line which enable VJ * header compresion and disable ICMP. * If this is good all rights go to B & L Jolitz, otherwise send your * comments to Reagan (/dev/null). * * nerd@percival.rain.com (Michael Galassi) 92.09.03 * * Hacked to change from sgtty to POSIX termio style serial line control * and added flag to enable cts/rts style flow control. * * blymn@awadi.com.au (Brett Lymn) 93.04.04 * * Put slattach in it's own process group so it can't be killed * accidentally. Close the connection on SIGHUP and SIGINT. Write a * syslog entry upon opening and closing the connection. Rich Murphey * and Brad Huntting. * * Add '-r command' option: runs 'command' upon recieving SIGHUP * resulting from loss of carrier. Log any errors after forking. * Rich 8/13/93 * * This version of slattach includes many changes by David Greenman, Brian * Smith, Chris Bradley, and me (Michael Galassi). None of them are * represented as functional anywhere outside of RAINet though they do work * for us. Documentation is limited to the usage message for now. If you * make improovments please pass them back. * * Added '-u UCMD' which runs 'UCMD <old> <new>' whenever the slip * unit number changes where <old> and <new> are the old and new unit * numbers, respectively. Also added the '-z' option which forces * invocation of the redial command (-r CMD) upon startup regardless * of whether the com driver claims (sometimes mistakenly) that * carrier is present. Also added '-e ECMD' which runs ECMD before * exiting. * * marc@escargot.rain.com (Marc Frajola) 93/09/10 * * Minor fixes to allow passive SLIP links to work (connections with * modem control that do not have an associated dial command). Added * code to re-check for carrier after dial command has been executed. * Added SIGTERM handler to properly handle normal kill signals. Fixed * bug in logic that caused message about no -u command to be logged * even when -u was specified and the sl number changes. Tried to get * rid of redundant syslog()'s to minimize console log output. Improved * logging of improper command line options or number of command * arguments. Removed spurious newline characters from syslog() calls. * * gjung@gjbsd.franken.de * * sighup_handler changed to set CLOCAL before running redial_cmd. * added flag exiting, so exit_handler is not run twice. Fork * before reopening tty. */
1994-08-23 08:07:17 +00:00
disable modem control (CLOCAL) and ignore carrier detect on the slip
1995-09-20 04:53:08 +00:00
port. By default the
1996-01-29 23:52:43 +00:00
.Ar redial-command
1995-09-20 04:53:08 +00:00
is invoked upon carrier drop and
.Nm slattach
aborts if no
1996-01-29 23:52:43 +00:00
.Ar redial-command
1995-09-20 04:53:08 +00:00
is specified.
.It Fl n
Slattach ported from 1.1.5 plus Bruce Evans suggested fix (close FDs and fork before redialing) to prevent dialer from hanging with newer sio.c. Also moved history from the source to the cvs log (here) per David G's suggestion. This compiles but needs testing now... Rich /* * Hacks to support "-a|c|n" flags on the command line which enable VJ * header compresion and disable ICMP. * If this is good all rights go to B & L Jolitz, otherwise send your * comments to Reagan (/dev/null). * * nerd@percival.rain.com (Michael Galassi) 92.09.03 * * Hacked to change from sgtty to POSIX termio style serial line control * and added flag to enable cts/rts style flow control. * * blymn@awadi.com.au (Brett Lymn) 93.04.04 * * Put slattach in it's own process group so it can't be killed * accidentally. Close the connection on SIGHUP and SIGINT. Write a * syslog entry upon opening and closing the connection. Rich Murphey * and Brad Huntting. * * Add '-r command' option: runs 'command' upon recieving SIGHUP * resulting from loss of carrier. Log any errors after forking. * Rich 8/13/93 * * This version of slattach includes many changes by David Greenman, Brian * Smith, Chris Bradley, and me (Michael Galassi). None of them are * represented as functional anywhere outside of RAINet though they do work * for us. Documentation is limited to the usage message for now. If you * make improovments please pass them back. * * Added '-u UCMD' which runs 'UCMD <old> <new>' whenever the slip * unit number changes where <old> and <new> are the old and new unit * numbers, respectively. Also added the '-z' option which forces * invocation of the redial command (-r CMD) upon startup regardless * of whether the com driver claims (sometimes mistakenly) that * carrier is present. Also added '-e ECMD' which runs ECMD before * exiting. * * marc@escargot.rain.com (Marc Frajola) 93/09/10 * * Minor fixes to allow passive SLIP links to work (connections with * modem control that do not have an associated dial command). Added * code to re-check for carrier after dial command has been executed. * Added SIGTERM handler to properly handle normal kill signals. Fixed * bug in logic that caused message about no -u command to be logged * even when -u was specified and the sl number changes. Tried to get * rid of redundant syslog()'s to minimize console log output. Improved * logging of improper command line options or number of command * arguments. Removed spurious newline characters from syslog() calls. * * gjung@gjbsd.franken.de * * sighup_handler changed to set CLOCAL before running redial_cmd. * added flag exiting, so exit_handler is not run twice. Fork * before reopening tty. */
1994-08-23 08:07:17 +00:00
Throw away ICMP packets. The slip interface will ignore ICMP packets
to prevent slow lines being saturated by ICMP responses.
1996-01-29 23:52:43 +00:00
.It Fl r Ar redial-command
1995-09-20 04:53:08 +00:00
Specifies a command to be invoked within a shell
.Ql sh \-c Ar redial-command
whenever carrier is lost on the modem line.
Empty
.Ar redial-command
i.e.
.Fl r Qq ""
cause connection reestablishing on leased line
without any external command invoked.
.It Fl s Ar baudrate
Slattach ported from 1.1.5 plus Bruce Evans suggested fix (close FDs and fork before redialing) to prevent dialer from hanging with newer sio.c. Also moved history from the source to the cvs log (here) per David G's suggestion. This compiles but needs testing now... Rich /* * Hacks to support "-a|c|n" flags on the command line which enable VJ * header compresion and disable ICMP. * If this is good all rights go to B & L Jolitz, otherwise send your * comments to Reagan (/dev/null). * * nerd@percival.rain.com (Michael Galassi) 92.09.03 * * Hacked to change from sgtty to POSIX termio style serial line control * and added flag to enable cts/rts style flow control. * * blymn@awadi.com.au (Brett Lymn) 93.04.04 * * Put slattach in it's own process group so it can't be killed * accidentally. Close the connection on SIGHUP and SIGINT. Write a * syslog entry upon opening and closing the connection. Rich Murphey * and Brad Huntting. * * Add '-r command' option: runs 'command' upon recieving SIGHUP * resulting from loss of carrier. Log any errors after forking. * Rich 8/13/93 * * This version of slattach includes many changes by David Greenman, Brian * Smith, Chris Bradley, and me (Michael Galassi). None of them are * represented as functional anywhere outside of RAINet though they do work * for us. Documentation is limited to the usage message for now. If you * make improovments please pass them back. * * Added '-u UCMD' which runs 'UCMD <old> <new>' whenever the slip * unit number changes where <old> and <new> are the old and new unit * numbers, respectively. Also added the '-z' option which forces * invocation of the redial command (-r CMD) upon startup regardless * of whether the com driver claims (sometimes mistakenly) that * carrier is present. Also added '-e ECMD' which runs ECMD before * exiting. * * marc@escargot.rain.com (Marc Frajola) 93/09/10 * * Minor fixes to allow passive SLIP links to work (connections with * modem control that do not have an associated dial command). Added * code to re-check for carrier after dial command has been executed. * Added SIGTERM handler to properly handle normal kill signals. Fixed * bug in logic that caused message about no -u command to be logged * even when -u was specified and the sl number changes. Tried to get * rid of redundant syslog()'s to minimize console log output. Improved * logging of improper command line options or number of command * arguments. Removed spurious newline characters from syslog() calls. * * gjung@gjbsd.franken.de * * sighup_handler changed to set CLOCAL before running redial_cmd. * added flag exiting, so exit_handler is not run twice. Fork * before reopening tty. */
1994-08-23 08:07:17 +00:00
Specifies the speed of the connection. If not specified, the
default of 9600 is used.
.It Fl u Ar unit-command
Slattach ported from 1.1.5 plus Bruce Evans suggested fix (close FDs and fork before redialing) to prevent dialer from hanging with newer sio.c. Also moved history from the source to the cvs log (here) per David G's suggestion. This compiles but needs testing now... Rich /* * Hacks to support "-a|c|n" flags on the command line which enable VJ * header compresion and disable ICMP. * If this is good all rights go to B & L Jolitz, otherwise send your * comments to Reagan (/dev/null). * * nerd@percival.rain.com (Michael Galassi) 92.09.03 * * Hacked to change from sgtty to POSIX termio style serial line control * and added flag to enable cts/rts style flow control. * * blymn@awadi.com.au (Brett Lymn) 93.04.04 * * Put slattach in it's own process group so it can't be killed * accidentally. Close the connection on SIGHUP and SIGINT. Write a * syslog entry upon opening and closing the connection. Rich Murphey * and Brad Huntting. * * Add '-r command' option: runs 'command' upon recieving SIGHUP * resulting from loss of carrier. Log any errors after forking. * Rich 8/13/93 * * This version of slattach includes many changes by David Greenman, Brian * Smith, Chris Bradley, and me (Michael Galassi). None of them are * represented as functional anywhere outside of RAINet though they do work * for us. Documentation is limited to the usage message for now. If you * make improovments please pass them back. * * Added '-u UCMD' which runs 'UCMD <old> <new>' whenever the slip * unit number changes where <old> and <new> are the old and new unit * numbers, respectively. Also added the '-z' option which forces * invocation of the redial command (-r CMD) upon startup regardless * of whether the com driver claims (sometimes mistakenly) that * carrier is present. Also added '-e ECMD' which runs ECMD before * exiting. * * marc@escargot.rain.com (Marc Frajola) 93/09/10 * * Minor fixes to allow passive SLIP links to work (connections with * modem control that do not have an associated dial command). Added * code to re-check for carrier after dial command has been executed. * Added SIGTERM handler to properly handle normal kill signals. Fixed * bug in logic that caused message about no -u command to be logged * even when -u was specified and the sl number changes. Tried to get * rid of redundant syslog()'s to minimize console log output. Improved * logging of improper command line options or number of command * arguments. Removed spurious newline characters from syslog() calls. * * gjung@gjbsd.franken.de * * sighup_handler changed to set CLOCAL before running redial_cmd. * added flag exiting, so exit_handler is not run twice. Fork * before reopening tty. */
1994-08-23 08:07:17 +00:00
When the line is switched to slip discipline, run
.Ql Nm "sh -c" Ar unit-command <old> <new>
1995-09-20 04:53:08 +00:00
where
.Ar <old>
1995-09-20 04:53:08 +00:00
and
.Ar <new>
1995-09-20 04:53:08 +00:00
are the slip unit numbers when the line was
Slattach ported from 1.1.5 plus Bruce Evans suggested fix (close FDs and fork before redialing) to prevent dialer from hanging with newer sio.c. Also moved history from the source to the cvs log (here) per David G's suggestion. This compiles but needs testing now... Rich /* * Hacks to support "-a|c|n" flags on the command line which enable VJ * header compresion and disable ICMP. * If this is good all rights go to B & L Jolitz, otherwise send your * comments to Reagan (/dev/null). * * nerd@percival.rain.com (Michael Galassi) 92.09.03 * * Hacked to change from sgtty to POSIX termio style serial line control * and added flag to enable cts/rts style flow control. * * blymn@awadi.com.au (Brett Lymn) 93.04.04 * * Put slattach in it's own process group so it can't be killed * accidentally. Close the connection on SIGHUP and SIGINT. Write a * syslog entry upon opening and closing the connection. Rich Murphey * and Brad Huntting. * * Add '-r command' option: runs 'command' upon recieving SIGHUP * resulting from loss of carrier. Log any errors after forking. * Rich 8/13/93 * * This version of slattach includes many changes by David Greenman, Brian * Smith, Chris Bradley, and me (Michael Galassi). None of them are * represented as functional anywhere outside of RAINet though they do work * for us. Documentation is limited to the usage message for now. If you * make improovments please pass them back. * * Added '-u UCMD' which runs 'UCMD <old> <new>' whenever the slip * unit number changes where <old> and <new> are the old and new unit * numbers, respectively. Also added the '-z' option which forces * invocation of the redial command (-r CMD) upon startup regardless * of whether the com driver claims (sometimes mistakenly) that * carrier is present. Also added '-e ECMD' which runs ECMD before * exiting. * * marc@escargot.rain.com (Marc Frajola) 93/09/10 * * Minor fixes to allow passive SLIP links to work (connections with * modem control that do not have an associated dial command). Added * code to re-check for carrier after dial command has been executed. * Added SIGTERM handler to properly handle normal kill signals. Fixed * bug in logic that caused message about no -u command to be logged * even when -u was specified and the sl number changes. Tried to get * rid of redundant syslog()'s to minimize console log output. Improved * logging of improper command line options or number of command * arguments. Removed spurious newline characters from syslog() calls. * * gjung@gjbsd.franken.de * * sighup_handler changed to set CLOCAL before running redial_cmd. * added flag exiting, so exit_handler is not run twice. Fork * before reopening tty. */
1994-08-23 08:07:17 +00:00
last opened and the unit number of the current slip connection
1996-01-29 23:52:43 +00:00
respectively. The unit number can change after redialing if you are
1995-09-20 04:53:08 +00:00
using more than one slip line.
When
.Nm slattach
connected first time, it run
.Ql Nm "sh -c" Ar unit-command Nm \-1 Ar <new> .
When
.Nm slattach
disconnected, it run
.Ql Nm "sh -c" Ar unit-command <old> Nm \-1 .
1995-09-20 04:53:08 +00:00
.Nm Slattach
will abort if the unit number
Slattach ported from 1.1.5 plus Bruce Evans suggested fix (close FDs and fork before redialing) to prevent dialer from hanging with newer sio.c. Also moved history from the source to the cvs log (here) per David G's suggestion. This compiles but needs testing now... Rich /* * Hacks to support "-a|c|n" flags on the command line which enable VJ * header compresion and disable ICMP. * If this is good all rights go to B & L Jolitz, otherwise send your * comments to Reagan (/dev/null). * * nerd@percival.rain.com (Michael Galassi) 92.09.03 * * Hacked to change from sgtty to POSIX termio style serial line control * and added flag to enable cts/rts style flow control. * * blymn@awadi.com.au (Brett Lymn) 93.04.04 * * Put slattach in it's own process group so it can't be killed * accidentally. Close the connection on SIGHUP and SIGINT. Write a * syslog entry upon opening and closing the connection. Rich Murphey * and Brad Huntting. * * Add '-r command' option: runs 'command' upon recieving SIGHUP * resulting from loss of carrier. Log any errors after forking. * Rich 8/13/93 * * This version of slattach includes many changes by David Greenman, Brian * Smith, Chris Bradley, and me (Michael Galassi). None of them are * represented as functional anywhere outside of RAINet though they do work * for us. Documentation is limited to the usage message for now. If you * make improovments please pass them back. * * Added '-u UCMD' which runs 'UCMD <old> <new>' whenever the slip * unit number changes where <old> and <new> are the old and new unit * numbers, respectively. Also added the '-z' option which forces * invocation of the redial command (-r CMD) upon startup regardless * of whether the com driver claims (sometimes mistakenly) that * carrier is present. Also added '-e ECMD' which runs ECMD before * exiting. * * marc@escargot.rain.com (Marc Frajola) 93/09/10 * * Minor fixes to allow passive SLIP links to work (connections with * modem control that do not have an associated dial command). Added * code to re-check for carrier after dial command has been executed. * Added SIGTERM handler to properly handle normal kill signals. Fixed * bug in logic that caused message about no -u command to be logged * even when -u was specified and the sl number changes. Tried to get * rid of redundant syslog()'s to minimize console log output. Improved * logging of improper command line options or number of command * arguments. Removed spurious newline characters from syslog() calls. * * gjung@gjbsd.franken.de * * sighup_handler changed to set CLOCAL before running redial_cmd. * added flag exiting, so exit_handler is not run twice. Fork * before reopening tty. */
1994-08-23 08:07:17 +00:00
changes and
.Ql Fl u Ar \%unit-command
Slattach ported from 1.1.5 plus Bruce Evans suggested fix (close FDs and fork before redialing) to prevent dialer from hanging with newer sio.c. Also moved history from the source to the cvs log (here) per David G's suggestion. This compiles but needs testing now... Rich /* * Hacks to support "-a|c|n" flags on the command line which enable VJ * header compresion and disable ICMP. * If this is good all rights go to B & L Jolitz, otherwise send your * comments to Reagan (/dev/null). * * nerd@percival.rain.com (Michael Galassi) 92.09.03 * * Hacked to change from sgtty to POSIX termio style serial line control * and added flag to enable cts/rts style flow control. * * blymn@awadi.com.au (Brett Lymn) 93.04.04 * * Put slattach in it's own process group so it can't be killed * accidentally. Close the connection on SIGHUP and SIGINT. Write a * syslog entry upon opening and closing the connection. Rich Murphey * and Brad Huntting. * * Add '-r command' option: runs 'command' upon recieving SIGHUP * resulting from loss of carrier. Log any errors after forking. * Rich 8/13/93 * * This version of slattach includes many changes by David Greenman, Brian * Smith, Chris Bradley, and me (Michael Galassi). None of them are * represented as functional anywhere outside of RAINet though they do work * for us. Documentation is limited to the usage message for now. If you * make improovments please pass them back. * * Added '-u UCMD' which runs 'UCMD <old> <new>' whenever the slip * unit number changes where <old> and <new> are the old and new unit * numbers, respectively. Also added the '-z' option which forces * invocation of the redial command (-r CMD) upon startup regardless * of whether the com driver claims (sometimes mistakenly) that * carrier is present. Also added '-e ECMD' which runs ECMD before * exiting. * * marc@escargot.rain.com (Marc Frajola) 93/09/10 * * Minor fixes to allow passive SLIP links to work (connections with * modem control that do not have an associated dial command). Added * code to re-check for carrier after dial command has been executed. * Added SIGTERM handler to properly handle normal kill signals. Fixed * bug in logic that caused message about no -u command to be logged * even when -u was specified and the sl number changes. Tried to get * rid of redundant syslog()'s to minimize console log output. Improved * logging of improper command line options or number of command * arguments. Removed spurious newline characters from syslog() calls. * * gjung@gjbsd.franken.de * * sighup_handler changed to set CLOCAL before running redial_cmd. * added flag exiting, so exit_handler is not run twice. Fork * before reopening tty. */
1994-08-23 08:07:17 +00:00
was not specified.
.It Fl z
Slattach ported from 1.1.5 plus Bruce Evans suggested fix (close FDs and fork before redialing) to prevent dialer from hanging with newer sio.c. Also moved history from the source to the cvs log (here) per David G's suggestion. This compiles but needs testing now... Rich /* * Hacks to support "-a|c|n" flags on the command line which enable VJ * header compresion and disable ICMP. * If this is good all rights go to B & L Jolitz, otherwise send your * comments to Reagan (/dev/null). * * nerd@percival.rain.com (Michael Galassi) 92.09.03 * * Hacked to change from sgtty to POSIX termio style serial line control * and added flag to enable cts/rts style flow control. * * blymn@awadi.com.au (Brett Lymn) 93.04.04 * * Put slattach in it's own process group so it can't be killed * accidentally. Close the connection on SIGHUP and SIGINT. Write a * syslog entry upon opening and closing the connection. Rich Murphey * and Brad Huntting. * * Add '-r command' option: runs 'command' upon recieving SIGHUP * resulting from loss of carrier. Log any errors after forking. * Rich 8/13/93 * * This version of slattach includes many changes by David Greenman, Brian * Smith, Chris Bradley, and me (Michael Galassi). None of them are * represented as functional anywhere outside of RAINet though they do work * for us. Documentation is limited to the usage message for now. If you * make improovments please pass them back. * * Added '-u UCMD' which runs 'UCMD <old> <new>' whenever the slip * unit number changes where <old> and <new> are the old and new unit * numbers, respectively. Also added the '-z' option which forces * invocation of the redial command (-r CMD) upon startup regardless * of whether the com driver claims (sometimes mistakenly) that * carrier is present. Also added '-e ECMD' which runs ECMD before * exiting. * * marc@escargot.rain.com (Marc Frajola) 93/09/10 * * Minor fixes to allow passive SLIP links to work (connections with * modem control that do not have an associated dial command). Added * code to re-check for carrier after dial command has been executed. * Added SIGTERM handler to properly handle normal kill signals. Fixed * bug in logic that caused message about no -u command to be logged * even when -u was specified and the sl number changes. Tried to get * rid of redundant syslog()'s to minimize console log output. Improved * logging of improper command line options or number of command * arguments. Removed spurious newline characters from syslog() calls. * * gjung@gjbsd.franken.de * * sighup_handler changed to set CLOCAL before running redial_cmd. * added flag exiting, so exit_handler is not run twice. Fork * before reopening tty. */
1994-08-23 08:07:17 +00:00
forces redial
1995-09-20 04:53:08 +00:00
.Ar redial-command
upon startup irrespective of carrier.
.It Fl L
Use uucp-style device locking. You need it unless you start
.Nm slattach
from external program which already does uucp locking.
Default case is no uucp locking to satisfy such programs.
.It Fl K Ar keepalive
Set SLIP "keep alive" timeout in seconds. If FRAME_END is not received in
this amount of time, re-connect occurs.
The default value is no timeout.
.It Fl O Ar outfill
Set SLIP "out fill" timeout in seconds. It forces at least one FRAME_END
to be sent during this time period, which is necessary for the "keep alive"
timeout on the remote side.
The default value is no timeout.
.It Fl S Ar unit
Set the SLIP unit number directly. Use with caution, because no check is made
for two interfaces with same number.
By default sliplogin dynamically assigns the unit number.
.It Ar ttyname
Specifies the name of the tty device.
.Ar Ttyname
Slattach ported from 1.1.5 plus Bruce Evans suggested fix (close FDs and fork before redialing) to prevent dialer from hanging with newer sio.c. Also moved history from the source to the cvs log (here) per David G's suggestion. This compiles but needs testing now... Rich /* * Hacks to support "-a|c|n" flags on the command line which enable VJ * header compresion and disable ICMP. * If this is good all rights go to B & L Jolitz, otherwise send your * comments to Reagan (/dev/null). * * nerd@percival.rain.com (Michael Galassi) 92.09.03 * * Hacked to change from sgtty to POSIX termio style serial line control * and added flag to enable cts/rts style flow control. * * blymn@awadi.com.au (Brett Lymn) 93.04.04 * * Put slattach in it's own process group so it can't be killed * accidentally. Close the connection on SIGHUP and SIGINT. Write a * syslog entry upon opening and closing the connection. Rich Murphey * and Brad Huntting. * * Add '-r command' option: runs 'command' upon recieving SIGHUP * resulting from loss of carrier. Log any errors after forking. * Rich 8/13/93 * * This version of slattach includes many changes by David Greenman, Brian * Smith, Chris Bradley, and me (Michael Galassi). None of them are * represented as functional anywhere outside of RAINet though they do work * for us. Documentation is limited to the usage message for now. If you * make improovments please pass them back. * * Added '-u UCMD' which runs 'UCMD <old> <new>' whenever the slip * unit number changes where <old> and <new> are the old and new unit * numbers, respectively. Also added the '-z' option which forces * invocation of the redial command (-r CMD) upon startup regardless * of whether the com driver claims (sometimes mistakenly) that * carrier is present. Also added '-e ECMD' which runs ECMD before * exiting. * * marc@escargot.rain.com (Marc Frajola) 93/09/10 * * Minor fixes to allow passive SLIP links to work (connections with * modem control that do not have an associated dial command). Added * code to re-check for carrier after dial command has been executed. * Added SIGTERM handler to properly handle normal kill signals. Fixed * bug in logic that caused message about no -u command to be logged * even when -u was specified and the sl number changes. Tried to get * rid of redundant syslog()'s to minimize console log output. Improved * logging of improper command line options or number of command * arguments. Removed spurious newline characters from syslog() calls. * * gjung@gjbsd.franken.de * * sighup_handler changed to set CLOCAL before running redial_cmd. * added flag exiting, so exit_handler is not run twice. Fork * before reopening tty. */
1994-08-23 08:07:17 +00:00
should be a string of the form
1995-09-20 04:53:08 +00:00
.Ql ttyXX
or
.Ql /dev/ttyXX .
.El
.Pp
Only the super-user may attach a network interface.
.Pp
To detach the interface, use
.Dq Li ifconfig interface-name down
after killing off the
.Nm slattach
Slattach ported from 1.1.5 plus Bruce Evans suggested fix (close FDs and fork before redialing) to prevent dialer from hanging with newer sio.c. Also moved history from the source to the cvs log (here) per David G's suggestion. This compiles but needs testing now... Rich /* * Hacks to support "-a|c|n" flags on the command line which enable VJ * header compresion and disable ICMP. * If this is good all rights go to B & L Jolitz, otherwise send your * comments to Reagan (/dev/null). * * nerd@percival.rain.com (Michael Galassi) 92.09.03 * * Hacked to change from sgtty to POSIX termio style serial line control * and added flag to enable cts/rts style flow control. * * blymn@awadi.com.au (Brett Lymn) 93.04.04 * * Put slattach in it's own process group so it can't be killed * accidentally. Close the connection on SIGHUP and SIGINT. Write a * syslog entry upon opening and closing the connection. Rich Murphey * and Brad Huntting. * * Add '-r command' option: runs 'command' upon recieving SIGHUP * resulting from loss of carrier. Log any errors after forking. * Rich 8/13/93 * * This version of slattach includes many changes by David Greenman, Brian * Smith, Chris Bradley, and me (Michael Galassi). None of them are * represented as functional anywhere outside of RAINet though they do work * for us. Documentation is limited to the usage message for now. If you * make improovments please pass them back. * * Added '-u UCMD' which runs 'UCMD <old> <new>' whenever the slip * unit number changes where <old> and <new> are the old and new unit * numbers, respectively. Also added the '-z' option which forces * invocation of the redial command (-r CMD) upon startup regardless * of whether the com driver claims (sometimes mistakenly) that * carrier is present. Also added '-e ECMD' which runs ECMD before * exiting. * * marc@escargot.rain.com (Marc Frajola) 93/09/10 * * Minor fixes to allow passive SLIP links to work (connections with * modem control that do not have an associated dial command). Added * code to re-check for carrier after dial command has been executed. * Added SIGTERM handler to properly handle normal kill signals. Fixed * bug in logic that caused message about no -u command to be logged * even when -u was specified and the sl number changes. Tried to get * rid of redundant syslog()'s to minimize console log output. Improved * logging of improper command line options or number of command * arguments. Removed spurious newline characters from syslog() calls. * * gjung@gjbsd.franken.de * * sighup_handler changed to set CLOCAL before running redial_cmd. * added flag exiting, so exit_handler is not run twice. Fork * before reopening tty. */
1994-08-23 08:07:17 +00:00
process using
.Ql kill -INT .
.Ar Interface-name
is the name that is shown by
.Xr netstat 1
Slattach ported from 1.1.5 plus Bruce Evans suggested fix (close FDs and fork before redialing) to prevent dialer from hanging with newer sio.c. Also moved history from the source to the cvs log (here) per David G's suggestion. This compiles but needs testing now... Rich /* * Hacks to support "-a|c|n" flags on the command line which enable VJ * header compresion and disable ICMP. * If this is good all rights go to B & L Jolitz, otherwise send your * comments to Reagan (/dev/null). * * nerd@percival.rain.com (Michael Galassi) 92.09.03 * * Hacked to change from sgtty to POSIX termio style serial line control * and added flag to enable cts/rts style flow control. * * blymn@awadi.com.au (Brett Lymn) 93.04.04 * * Put slattach in it's own process group so it can't be killed * accidentally. Close the connection on SIGHUP and SIGINT. Write a * syslog entry upon opening and closing the connection. Rich Murphey * and Brad Huntting. * * Add '-r command' option: runs 'command' upon recieving SIGHUP * resulting from loss of carrier. Log any errors after forking. * Rich 8/13/93 * * This version of slattach includes many changes by David Greenman, Brian * Smith, Chris Bradley, and me (Michael Galassi). None of them are * represented as functional anywhere outside of RAINet though they do work * for us. Documentation is limited to the usage message for now. If you * make improovments please pass them back. * * Added '-u UCMD' which runs 'UCMD <old> <new>' whenever the slip * unit number changes where <old> and <new> are the old and new unit * numbers, respectively. Also added the '-z' option which forces * invocation of the redial command (-r CMD) upon startup regardless * of whether the com driver claims (sometimes mistakenly) that * carrier is present. Also added '-e ECMD' which runs ECMD before * exiting. * * marc@escargot.rain.com (Marc Frajola) 93/09/10 * * Minor fixes to allow passive SLIP links to work (connections with * modem control that do not have an associated dial command). Added * code to re-check for carrier after dial command has been executed. * Added SIGTERM handler to properly handle normal kill signals. Fixed * bug in logic that caused message about no -u command to be logged * even when -u was specified and the sl number changes. Tried to get * rid of redundant syslog()'s to minimize console log output. Improved * logging of improper command line options or number of command * arguments. Removed spurious newline characters from syslog() calls. * * gjung@gjbsd.franken.de * * sighup_handler changed to set CLOCAL before running redial_cmd. * added flag exiting, so exit_handler is not run twice. Fork * before reopening tty. */
1994-08-23 08:07:17 +00:00
.Pp
1995-09-20 04:53:08 +00:00
To setup
.Nm slattach
to redial the phone when carrier is lost, use the
.Fl r Ar redial-command
Slattach ported from 1.1.5 plus Bruce Evans suggested fix (close FDs and fork before redialing) to prevent dialer from hanging with newer sio.c. Also moved history from the source to the cvs log (here) per David G's suggestion. This compiles but needs testing now... Rich /* * Hacks to support "-a|c|n" flags on the command line which enable VJ * header compresion and disable ICMP. * If this is good all rights go to B & L Jolitz, otherwise send your * comments to Reagan (/dev/null). * * nerd@percival.rain.com (Michael Galassi) 92.09.03 * * Hacked to change from sgtty to POSIX termio style serial line control * and added flag to enable cts/rts style flow control. * * blymn@awadi.com.au (Brett Lymn) 93.04.04 * * Put slattach in it's own process group so it can't be killed * accidentally. Close the connection on SIGHUP and SIGINT. Write a * syslog entry upon opening and closing the connection. Rich Murphey * and Brad Huntting. * * Add '-r command' option: runs 'command' upon recieving SIGHUP * resulting from loss of carrier. Log any errors after forking. * Rich 8/13/93 * * This version of slattach includes many changes by David Greenman, Brian * Smith, Chris Bradley, and me (Michael Galassi). None of them are * represented as functional anywhere outside of RAINet though they do work * for us. Documentation is limited to the usage message for now. If you * make improovments please pass them back. * * Added '-u UCMD' which runs 'UCMD <old> <new>' whenever the slip * unit number changes where <old> and <new> are the old and new unit * numbers, respectively. Also added the '-z' option which forces * invocation of the redial command (-r CMD) upon startup regardless * of whether the com driver claims (sometimes mistakenly) that * carrier is present. Also added '-e ECMD' which runs ECMD before * exiting. * * marc@escargot.rain.com (Marc Frajola) 93/09/10 * * Minor fixes to allow passive SLIP links to work (connections with * modem control that do not have an associated dial command). Added * code to re-check for carrier after dial command has been executed. * Added SIGTERM handler to properly handle normal kill signals. Fixed * bug in logic that caused message about no -u command to be logged * even when -u was specified and the sl number changes. Tried to get * rid of redundant syslog()'s to minimize console log output. Improved * logging of improper command line options or number of command * arguments. Removed spurious newline characters from syslog() calls. * * gjung@gjbsd.franken.de * * sighup_handler changed to set CLOCAL before running redial_cmd. * added flag exiting, so exit_handler is not run twice. Fork * before reopening tty. */
1994-08-23 08:07:17 +00:00
option to specify a script or executable that will reconnect the
serial line to the slip server. For example, the script could redial
the server and log in, etc.
.Pp
To reconfigure the network interface in case the slip unit number
changes, use the
1995-09-20 04:53:08 +00:00
.Fl u Ar unit-command
Slattach ported from 1.1.5 plus Bruce Evans suggested fix (close FDs and fork before redialing) to prevent dialer from hanging with newer sio.c. Also moved history from the source to the cvs log (here) per David G's suggestion. This compiles but needs testing now... Rich /* * Hacks to support "-a|c|n" flags on the command line which enable VJ * header compresion and disable ICMP. * If this is good all rights go to B & L Jolitz, otherwise send your * comments to Reagan (/dev/null). * * nerd@percival.rain.com (Michael Galassi) 92.09.03 * * Hacked to change from sgtty to POSIX termio style serial line control * and added flag to enable cts/rts style flow control. * * blymn@awadi.com.au (Brett Lymn) 93.04.04 * * Put slattach in it's own process group so it can't be killed * accidentally. Close the connection on SIGHUP and SIGINT. Write a * syslog entry upon opening and closing the connection. Rich Murphey * and Brad Huntting. * * Add '-r command' option: runs 'command' upon recieving SIGHUP * resulting from loss of carrier. Log any errors after forking. * Rich 8/13/93 * * This version of slattach includes many changes by David Greenman, Brian * Smith, Chris Bradley, and me (Michael Galassi). None of them are * represented as functional anywhere outside of RAINet though they do work * for us. Documentation is limited to the usage message for now. If you * make improovments please pass them back. * * Added '-u UCMD' which runs 'UCMD <old> <new>' whenever the slip * unit number changes where <old> and <new> are the old and new unit * numbers, respectively. Also added the '-z' option which forces * invocation of the redial command (-r CMD) upon startup regardless * of whether the com driver claims (sometimes mistakenly) that * carrier is present. Also added '-e ECMD' which runs ECMD before * exiting. * * marc@escargot.rain.com (Marc Frajola) 93/09/10 * * Minor fixes to allow passive SLIP links to work (connections with * modem control that do not have an associated dial command). Added * code to re-check for carrier after dial command has been executed. * Added SIGTERM handler to properly handle normal kill signals. Fixed * bug in logic that caused message about no -u command to be logged * even when -u was specified and the sl number changes. Tried to get * rid of redundant syslog()'s to minimize console log output. Improved * logging of improper command line options or number of command * arguments. Removed spurious newline characters from syslog() calls. * * gjung@gjbsd.franken.de * * sighup_handler changed to set CLOCAL before running redial_cmd. * added flag exiting, so exit_handler is not run twice. Fork * before reopening tty. */
1994-08-23 08:07:17 +00:00
option to specify a script or executable that will be invoked as
1995-09-20 04:53:08 +00:00
.Ql sh \-c Ar unit-command old new
where
.Ar old
and
.Ar new
are the slip unit numbers before and after
Slattach ported from 1.1.5 plus Bruce Evans suggested fix (close FDs and fork before redialing) to prevent dialer from hanging with newer sio.c. Also moved history from the source to the cvs log (here) per David G's suggestion. This compiles but needs testing now... Rich /* * Hacks to support "-a|c|n" flags on the command line which enable VJ * header compresion and disable ICMP. * If this is good all rights go to B & L Jolitz, otherwise send your * comments to Reagan (/dev/null). * * nerd@percival.rain.com (Michael Galassi) 92.09.03 * * Hacked to change from sgtty to POSIX termio style serial line control * and added flag to enable cts/rts style flow control. * * blymn@awadi.com.au (Brett Lymn) 93.04.04 * * Put slattach in it's own process group so it can't be killed * accidentally. Close the connection on SIGHUP and SIGINT. Write a * syslog entry upon opening and closing the connection. Rich Murphey * and Brad Huntting. * * Add '-r command' option: runs 'command' upon recieving SIGHUP * resulting from loss of carrier. Log any errors after forking. * Rich 8/13/93 * * This version of slattach includes many changes by David Greenman, Brian * Smith, Chris Bradley, and me (Michael Galassi). None of them are * represented as functional anywhere outside of RAINet though they do work * for us. Documentation is limited to the usage message for now. If you * make improovments please pass them back. * * Added '-u UCMD' which runs 'UCMD <old> <new>' whenever the slip * unit number changes where <old> and <new> are the old and new unit * numbers, respectively. Also added the '-z' option which forces * invocation of the redial command (-r CMD) upon startup regardless * of whether the com driver claims (sometimes mistakenly) that * carrier is present. Also added '-e ECMD' which runs ECMD before * exiting. * * marc@escargot.rain.com (Marc Frajola) 93/09/10 * * Minor fixes to allow passive SLIP links to work (connections with * modem control that do not have an associated dial command). Added * code to re-check for carrier after dial command has been executed. * Added SIGTERM handler to properly handle normal kill signals. Fixed * bug in logic that caused message about no -u command to be logged * even when -u was specified and the sl number changes. Tried to get * rid of redundant syslog()'s to minimize console log output. Improved * logging of improper command line options or number of command * arguments. Removed spurious newline characters from syslog() calls. * * gjung@gjbsd.franken.de * * sighup_handler changed to set CLOCAL before running redial_cmd. * added flag exiting, so exit_handler is not run twice. Fork * before reopening tty. */
1994-08-23 08:07:17 +00:00
reconnecting the line. The unit number can change if you have more
than one line disconnect at the same time. The first to succeed in
reconnecting will get the lowest unit number.
.Pp
1995-09-20 04:53:08 +00:00
To kill
.Nm slattach
use
Slattach ported from 1.1.5 plus Bruce Evans suggested fix (close FDs and fork before redialing) to prevent dialer from hanging with newer sio.c. Also moved history from the source to the cvs log (here) per David G's suggestion. This compiles but needs testing now... Rich /* * Hacks to support "-a|c|n" flags on the command line which enable VJ * header compresion and disable ICMP. * If this is good all rights go to B & L Jolitz, otherwise send your * comments to Reagan (/dev/null). * * nerd@percival.rain.com (Michael Galassi) 92.09.03 * * Hacked to change from sgtty to POSIX termio style serial line control * and added flag to enable cts/rts style flow control. * * blymn@awadi.com.au (Brett Lymn) 93.04.04 * * Put slattach in it's own process group so it can't be killed * accidentally. Close the connection on SIGHUP and SIGINT. Write a * syslog entry upon opening and closing the connection. Rich Murphey * and Brad Huntting. * * Add '-r command' option: runs 'command' upon recieving SIGHUP * resulting from loss of carrier. Log any errors after forking. * Rich 8/13/93 * * This version of slattach includes many changes by David Greenman, Brian * Smith, Chris Bradley, and me (Michael Galassi). None of them are * represented as functional anywhere outside of RAINet though they do work * for us. Documentation is limited to the usage message for now. If you * make improovments please pass them back. * * Added '-u UCMD' which runs 'UCMD <old> <new>' whenever the slip * unit number changes where <old> and <new> are the old and new unit * numbers, respectively. Also added the '-z' option which forces * invocation of the redial command (-r CMD) upon startup regardless * of whether the com driver claims (sometimes mistakenly) that * carrier is present. Also added '-e ECMD' which runs ECMD before * exiting. * * marc@escargot.rain.com (Marc Frajola) 93/09/10 * * Minor fixes to allow passive SLIP links to work (connections with * modem control that do not have an associated dial command). Added * code to re-check for carrier after dial command has been executed. * Added SIGTERM handler to properly handle normal kill signals. Fixed * bug in logic that caused message about no -u command to be logged * even when -u was specified and the sl number changes. Tried to get * rid of redundant syslog()'s to minimize console log output. Improved * logging of improper command line options or number of command * arguments. Removed spurious newline characters from syslog() calls. * * gjung@gjbsd.franken.de * * sighup_handler changed to set CLOCAL before running redial_cmd. * added flag exiting, so exit_handler is not run twice. Fork * before reopening tty. */
1994-08-23 08:07:17 +00:00
.Ql kill -INT
(SIGINT) which causes it to close the tty and exit.
.Pp
To force a redial, use
.Ql kill -HUP
1995-09-20 04:53:08 +00:00
(SIGHUP) which causes
.Nm slattach
to think carrier was lost and thus invoke
.Ql sh \-c Ar redial-command
Slattach ported from 1.1.5 plus Bruce Evans suggested fix (close FDs and fork before redialing) to prevent dialer from hanging with newer sio.c. Also moved history from the source to the cvs log (here) per David G's suggestion. This compiles but needs testing now... Rich /* * Hacks to support "-a|c|n" flags on the command line which enable VJ * header compresion and disable ICMP. * If this is good all rights go to B & L Jolitz, otherwise send your * comments to Reagan (/dev/null). * * nerd@percival.rain.com (Michael Galassi) 92.09.03 * * Hacked to change from sgtty to POSIX termio style serial line control * and added flag to enable cts/rts style flow control. * * blymn@awadi.com.au (Brett Lymn) 93.04.04 * * Put slattach in it's own process group so it can't be killed * accidentally. Close the connection on SIGHUP and SIGINT. Write a * syslog entry upon opening and closing the connection. Rich Murphey * and Brad Huntting. * * Add '-r command' option: runs 'command' upon recieving SIGHUP * resulting from loss of carrier. Log any errors after forking. * Rich 8/13/93 * * This version of slattach includes many changes by David Greenman, Brian * Smith, Chris Bradley, and me (Michael Galassi). None of them are * represented as functional anywhere outside of RAINet though they do work * for us. Documentation is limited to the usage message for now. If you * make improovments please pass them back. * * Added '-u UCMD' which runs 'UCMD <old> <new>' whenever the slip * unit number changes where <old> and <new> are the old and new unit * numbers, respectively. Also added the '-z' option which forces * invocation of the redial command (-r CMD) upon startup regardless * of whether the com driver claims (sometimes mistakenly) that * carrier is present. Also added '-e ECMD' which runs ECMD before * exiting. * * marc@escargot.rain.com (Marc Frajola) 93/09/10 * * Minor fixes to allow passive SLIP links to work (connections with * modem control that do not have an associated dial command). Added * code to re-check for carrier after dial command has been executed. * Added SIGTERM handler to properly handle normal kill signals. Fixed * bug in logic that caused message about no -u command to be logged * even when -u was specified and the sl number changes. Tried to get * rid of redundant syslog()'s to minimize console log output. Improved * logging of improper command line options or number of command * arguments. Removed spurious newline characters from syslog() calls. * * gjung@gjbsd.franken.de * * sighup_handler changed to set CLOCAL before running redial_cmd. * added flag exiting, so exit_handler is not run twice. Fork * before reopening tty. */
1994-08-23 08:07:17 +00:00
to reconnect to the server.
.Pp
If you use a hard-wired connection rather than a modem, invoke
1995-09-20 04:53:08 +00:00
.Nm slattach
with the
.Fl l
Slattach ported from 1.1.5 plus Bruce Evans suggested fix (close FDs and fork before redialing) to prevent dialer from hanging with newer sio.c. Also moved history from the source to the cvs log (here) per David G's suggestion. This compiles but needs testing now... Rich /* * Hacks to support "-a|c|n" flags on the command line which enable VJ * header compresion and disable ICMP. * If this is good all rights go to B & L Jolitz, otherwise send your * comments to Reagan (/dev/null). * * nerd@percival.rain.com (Michael Galassi) 92.09.03 * * Hacked to change from sgtty to POSIX termio style serial line control * and added flag to enable cts/rts style flow control. * * blymn@awadi.com.au (Brett Lymn) 93.04.04 * * Put slattach in it's own process group so it can't be killed * accidentally. Close the connection on SIGHUP and SIGINT. Write a * syslog entry upon opening and closing the connection. Rich Murphey * and Brad Huntting. * * Add '-r command' option: runs 'command' upon recieving SIGHUP * resulting from loss of carrier. Log any errors after forking. * Rich 8/13/93 * * This version of slattach includes many changes by David Greenman, Brian * Smith, Chris Bradley, and me (Michael Galassi). None of them are * represented as functional anywhere outside of RAINet though they do work * for us. Documentation is limited to the usage message for now. If you * make improovments please pass them back. * * Added '-u UCMD' which runs 'UCMD <old> <new>' whenever the slip * unit number changes where <old> and <new> are the old and new unit * numbers, respectively. Also added the '-z' option which forces * invocation of the redial command (-r CMD) upon startup regardless * of whether the com driver claims (sometimes mistakenly) that * carrier is present. Also added '-e ECMD' which runs ECMD before * exiting. * * marc@escargot.rain.com (Marc Frajola) 93/09/10 * * Minor fixes to allow passive SLIP links to work (connections with * modem control that do not have an associated dial command). Added * code to re-check for carrier after dial command has been executed. * Added SIGTERM handler to properly handle normal kill signals. Fixed * bug in logic that caused message about no -u command to be logged * even when -u was specified and the sl number changes. Tried to get * rid of redundant syslog()'s to minimize console log output. Improved * logging of improper command line options or number of command * arguments. Removed spurious newline characters from syslog() calls. * * gjung@gjbsd.franken.de * * sighup_handler changed to set CLOCAL before running redial_cmd. * added flag exiting, so exit_handler is not run twice. Fork * before reopening tty. */
1994-08-23 08:07:17 +00:00
option in order to ignore carrier on the slip line.
.Sh EXAMPLES
.Bd -literal -offset indent -compact
1995-09-20 04:53:08 +00:00
slattach ttyd8
slattach \-s 4800 /dev/ttyd1
slattach \-c \-s 38400 /dev/cuaa1
Slattach ported from 1.1.5 plus Bruce Evans suggested fix (close FDs and fork before redialing) to prevent dialer from hanging with newer sio.c. Also moved history from the source to the cvs log (here) per David G's suggestion. This compiles but needs testing now... Rich /* * Hacks to support "-a|c|n" flags on the command line which enable VJ * header compresion and disable ICMP. * If this is good all rights go to B & L Jolitz, otherwise send your * comments to Reagan (/dev/null). * * nerd@percival.rain.com (Michael Galassi) 92.09.03 * * Hacked to change from sgtty to POSIX termio style serial line control * and added flag to enable cts/rts style flow control. * * blymn@awadi.com.au (Brett Lymn) 93.04.04 * * Put slattach in it's own process group so it can't be killed * accidentally. Close the connection on SIGHUP and SIGINT. Write a * syslog entry upon opening and closing the connection. Rich Murphey * and Brad Huntting. * * Add '-r command' option: runs 'command' upon recieving SIGHUP * resulting from loss of carrier. Log any errors after forking. * Rich 8/13/93 * * This version of slattach includes many changes by David Greenman, Brian * Smith, Chris Bradley, and me (Michael Galassi). None of them are * represented as functional anywhere outside of RAINet though they do work * for us. Documentation is limited to the usage message for now. If you * make improovments please pass them back. * * Added '-u UCMD' which runs 'UCMD <old> <new>' whenever the slip * unit number changes where <old> and <new> are the old and new unit * numbers, respectively. Also added the '-z' option which forces * invocation of the redial command (-r CMD) upon startup regardless * of whether the com driver claims (sometimes mistakenly) that * carrier is present. Also added '-e ECMD' which runs ECMD before * exiting. * * marc@escargot.rain.com (Marc Frajola) 93/09/10 * * Minor fixes to allow passive SLIP links to work (connections with * modem control that do not have an associated dial command). Added * code to re-check for carrier after dial command has been executed. * Added SIGTERM handler to properly handle normal kill signals. Fixed * bug in logic that caused message about no -u command to be logged * even when -u was specified and the sl number changes. Tried to get * rid of redundant syslog()'s to minimize console log output. Improved * logging of improper command line options or number of command * arguments. Removed spurious newline characters from syslog() calls. * * gjung@gjbsd.franken.de * * sighup_handler changed to set CLOCAL before running redial_cmd. * added flag exiting, so exit_handler is not run twice. Fork * before reopening tty. */
1994-08-23 08:07:17 +00:00
slattach \-r 'kermit -y dial.script >kermit.log 2>&1'
.Ed
.Sh DIAGNOSTICS
1995-09-20 04:53:08 +00:00
Look for error messages in /var/log/messages (
.Nm slattach
is a daemon).
Messages indicating the specified interface does not exit, the
Slattach ported from 1.1.5 plus Bruce Evans suggested fix (close FDs and fork before redialing) to prevent dialer from hanging with newer sio.c. Also moved history from the source to the cvs log (here) per David G's suggestion. This compiles but needs testing now... Rich /* * Hacks to support "-a|c|n" flags on the command line which enable VJ * header compresion and disable ICMP. * If this is good all rights go to B & L Jolitz, otherwise send your * comments to Reagan (/dev/null). * * nerd@percival.rain.com (Michael Galassi) 92.09.03 * * Hacked to change from sgtty to POSIX termio style serial line control * and added flag to enable cts/rts style flow control. * * blymn@awadi.com.au (Brett Lymn) 93.04.04 * * Put slattach in it's own process group so it can't be killed * accidentally. Close the connection on SIGHUP and SIGINT. Write a * syslog entry upon opening and closing the connection. Rich Murphey * and Brad Huntting. * * Add '-r command' option: runs 'command' upon recieving SIGHUP * resulting from loss of carrier. Log any errors after forking. * Rich 8/13/93 * * This version of slattach includes many changes by David Greenman, Brian * Smith, Chris Bradley, and me (Michael Galassi). None of them are * represented as functional anywhere outside of RAINet though they do work * for us. Documentation is limited to the usage message for now. If you * make improovments please pass them back. * * Added '-u UCMD' which runs 'UCMD <old> <new>' whenever the slip * unit number changes where <old> and <new> are the old and new unit * numbers, respectively. Also added the '-z' option which forces * invocation of the redial command (-r CMD) upon startup regardless * of whether the com driver claims (sometimes mistakenly) that * carrier is present. Also added '-e ECMD' which runs ECMD before * exiting. * * marc@escargot.rain.com (Marc Frajola) 93/09/10 * * Minor fixes to allow passive SLIP links to work (connections with * modem control that do not have an associated dial command). Added * code to re-check for carrier after dial command has been executed. * Added SIGTERM handler to properly handle normal kill signals. Fixed * bug in logic that caused message about no -u command to be logged * even when -u was specified and the sl number changes. Tried to get * rid of redundant syslog()'s to minimize console log output. Improved * logging of improper command line options or number of command * arguments. Removed spurious newline characters from syslog() calls. * * gjung@gjbsd.franken.de * * sighup_handler changed to set CLOCAL before running redial_cmd. * added flag exiting, so exit_handler is not run twice. Fork * before reopening tty. */
1994-08-23 08:07:17 +00:00
requested address is unknown, the user is not privileged and tried to
1995-09-20 04:53:08 +00:00
alter an interface's configuration are logged there.
.Nm Slattach
also logs failure to set the controlling terminal or failure to install
Slattach ported from 1.1.5 plus Bruce Evans suggested fix (close FDs and fork before redialing) to prevent dialer from hanging with newer sio.c. Also moved history from the source to the cvs log (here) per David G's suggestion. This compiles but needs testing now... Rich /* * Hacks to support "-a|c|n" flags on the command line which enable VJ * header compresion and disable ICMP. * If this is good all rights go to B & L Jolitz, otherwise send your * comments to Reagan (/dev/null). * * nerd@percival.rain.com (Michael Galassi) 92.09.03 * * Hacked to change from sgtty to POSIX termio style serial line control * and added flag to enable cts/rts style flow control. * * blymn@awadi.com.au (Brett Lymn) 93.04.04 * * Put slattach in it's own process group so it can't be killed * accidentally. Close the connection on SIGHUP and SIGINT. Write a * syslog entry upon opening and closing the connection. Rich Murphey * and Brad Huntting. * * Add '-r command' option: runs 'command' upon recieving SIGHUP * resulting from loss of carrier. Log any errors after forking. * Rich 8/13/93 * * This version of slattach includes many changes by David Greenman, Brian * Smith, Chris Bradley, and me (Michael Galassi). None of them are * represented as functional anywhere outside of RAINet though they do work * for us. Documentation is limited to the usage message for now. If you * make improovments please pass them back. * * Added '-u UCMD' which runs 'UCMD <old> <new>' whenever the slip * unit number changes where <old> and <new> are the old and new unit * numbers, respectively. Also added the '-z' option which forces * invocation of the redial command (-r CMD) upon startup regardless * of whether the com driver claims (sometimes mistakenly) that * carrier is present. Also added '-e ECMD' which runs ECMD before * exiting. * * marc@escargot.rain.com (Marc Frajola) 93/09/10 * * Minor fixes to allow passive SLIP links to work (connections with * modem control that do not have an associated dial command). Added * code to re-check for carrier after dial command has been executed. * Added SIGTERM handler to properly handle normal kill signals. Fixed * bug in logic that caused message about no -u command to be logged * even when -u was specified and the sl number changes. Tried to get * rid of redundant syslog()'s to minimize console log output. Improved * logging of improper command line options or number of command * arguments. Removed spurious newline characters from syslog() calls. * * gjung@gjbsd.franken.de * * sighup_handler changed to set CLOCAL before running redial_cmd. * added flag exiting, so exit_handler is not run twice. Fork * before reopening tty. */
1994-08-23 08:07:17 +00:00
signal handlers. Upon connection and redial the ttyname and baud rate
are logged and on shutdown the ttyname is logged.
.Pp
.Sh FILES
.Pa /var/run/slattach.<tty>.pid ,
.Pp
with
1995-09-20 04:53:08 +00:00
.Ar tty
replaced by the terminal path name component of
.Ar ttyname .
This file contains the numerical process ID of the
.Nm slattach
process and can be examined by scripts in oder to send a signal to
1995-09-20 04:53:08 +00:00
.Nm slattach .
.Sh SEE ALSO
.Xr startslip 1 ,
.Xr sliplogin 8 ,
.Xr netstat 1 ,
.Xr netintro 4 ,
.Xr ifconfig 8 ,
1995-09-20 04:53:08 +00:00
.Xr rc 8 ,
.Xr uustat 1 ,
/usr/share/examples/slattach
.Sh HISTORY
The
.Nm
command appeared in
.Bx 4.3 .