Debian Codegraph @

upstream/opensuse-tumbleweed/man8/slattach.8

raw
1 .TH SLATTACH 8 "2025-09-10" "net\-tools" "Linux System Administrator's Manual"
2
3 .SH NAME
4 slattach \- attach a network interface to a serial line
5
6 .SH SYNOPSIS
7 .SY slattach
8 .RB [ \-dehlLmnqv "] [" \-c
9 .I command
10 .RB "] [" \-p
11 .I proto
12 .RB "] [" \-s
13 .IR speed "] [" tty ]
14
15 .SH DESCRIPTION
16 .B Slattach
17 is a tiny program that can be used to put a normal terminal
18 ("serial") line into one of several "network" modes, thus allowing
19 you to use it for point-to-point links to other computers.
20
21 .SH OPTIONS
22 .TP
23 .I tty
24 Path to a serial device like
25 .IR /dev/ttyS* ", " /dev/cua* " or " /dev/ptmx
26 to spawn a new pseudo tty.
27 .TP
28 \fB\-c\fP \fIcommand\fP
29 Execute
30 .I command
31 when the line is hung up. This can be used to run scripts or re-establish
32 connections when a link goes down.
33 .TP
34 .B \-d
35 Enable debugging output. Useful when determining why a given
36 setup doesn't work.
37 .TP
38 .B \-h
39 Exit when the carrier is lost. This works on both /dev/tty and /dev/cua
40 devices by directly monitoring the carrier status every 15 seconds.
41 .TP
42 .B \-v
43 Enable verbose output. Useful in shell scripts.
44 .TP
45 .B \-q
46 Operate in quiet mode - no messages at all.
47 .TP
48 .B \-l
49 Create an UUCP-style lockfile for the device in
50 .IR /var/lock .
51 .TP
52 .B \-n
53 Equivalent to the "\fBmesg n\fP" command.
54 .TP
55 .B \-m
56 Do \fBnot\fP initialize the line into 8-bit raw mode.
57 .TP
58 .B \-e
59 Exit right after initializing device, instead of waiting for the
60 line to hang up.
61 .TP
62 .B \-L
63 Enable 3 wire operation. The terminal is moved into CLOCAL mode,
64 carrier watching is disabled.
65 .TP
66 \fB\-p\fP \fIproto\fP
67 Set a specific kind of protocol to use on the line.
68 The default is set to
69 .BR "cslip" ,
70 i.e. compressed SLIP. Other possible values are
71 .B "slip"
72 (normal SLIP),
73 .B "adaptive"
74 (adaptive CSLIP/SLIP),
75 .B "ppp"
76 (Point-to-Point Protocol)
77 and
78 .B "kiss"
79 (a protocol used for communicating with AX.25 packet radio
80 terminal node controllers).
81 The special argument
82 .B "tty"
83 can be used to put the device back into normal serial operation.
84 Using 'ppp' mode normally requires an additional ppp daemon
85 .B pppd
86 to be active on the line. For kiss connections the
87 .B kissattach
88 program should be used.
89 .TP
90 \fB\-s\fP \fIspeed\fP
91 Set a specific line speed, other than the default.
92
93 .P
94 If no arguments are given, the current terminal line (usually: the
95 login device) is used. Otherwise, an attempt is made to claim the
96 indicated terminal port, lock it, and open it.
97
98 .SH FILES
99 .I /dev/cua* /var/lock/LCK.* /dev/ttyS* /dev/ptmx
100
101 .SH SEE ALSO
102 Homepage of the \fInet\-tools\fP project:
103 .UR https://net-tools.sourceforge.io
104 .UE
105
106 .P
107 .BR kissattach (8),
108 .BR dip (8),
109 .BR pppd (8),
110 .BR sliplogin (8)
111
112 .SH AUTHORS
113 Fred N. van Kempen <[email protected]>,
114 .br
115 Alan Cox <[email protected]>,
116 .br
117 Miquel van Smoorenburg <[email protected]>,
118 .br
119 George Shearer <[email protected]>,
120 .br
121 Yossi Gottlieb <[email protected]>,
122 .br
123 Bernd Eckenfels <net\[email protected]>.