1.\"	$OpenBSD: slattach.8,v 1.13 2003/06/02 20:06:17 millert Exp $
2.\"	$NetBSD: slattach.8,v 1.12 1995/03/18 15:01:12 cgd Exp $
3.\"
4.\" Copyright (c) 1986, 1991, 1993
5.\"	The Regents of the University of California.  All rights reserved.
6.\"
7.\" Redistribution and use in source and binary forms, with or without
8.\" modification, are permitted provided that the following conditions
9.\" are met:
10.\" 1. Redistributions of source code must retain the above copyright
11.\"    notice, this list of conditions and the following disclaimer.
12.\" 2. Redistributions in binary form must reproduce the above copyright
13.\"    notice, this list of conditions and the following disclaimer in the
14.\"    documentation and/or other materials provided with the distribution.
15.\" 3. Neither the name of the University nor the names of its contributors
16.\"    may be used to endorse or promote products derived from this software
17.\"    without specific prior written permission.
18.\"
19.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
20.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
21.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
22.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
23.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
24.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
25.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
26.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
27.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
28.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
29.\" SUCH DAMAGE.
30.\"
31.\"     @(#)slattach.8	8.2 (Berkeley) 4/1/94
32.\"
33.Dd April 1, 1994
34.Dt SLATTACH 8
35.Os
36.Sh NAME
37.Nm slattach
38.Nd attach serial lines as network interfaces
39.Sh SYNOPSIS
40.Nm slattach
41.Op Fl hm
42.Op Fl s Ar baudrate
43.Ar ttyname
44.Sh DESCRIPTION
45.Nm
46is used to assign a tty line to a network interface,
47and will attach the named tty line to the first
48available slipdevice that is configured and up.
49The following operands are supported by
50.Nm slattach :
51.Bl -tag -width Ar
52.It Fl h
53Turn on RTS/CTS flow control.
54By default, no flow control is done.
55.It Fl m
56Maintain modem control signals after closing the line.
57Specifically, this disables HUPCL.
58.It Fl s Ar baudrate
59Specifies the speed of the connection.
60If not specified, the default of 9600 is used.
61.It Ar ttyname
62Specifies the name of the tty device.
63.Ar ttyname
64should be a string of the form
65.Dq ttyXX ,
66or
67.Dq /dev/ttyXX .
68.El
69.Pp
70In addition, the following flags to
71.Xr ifconfig 8
72control various properties of the link:
73.Bl -tag -width Ar
74.It Ar link0
75Turn on Van Jacobsen header compression.
76.It Ar -link0
77Turn off header compression.
78.It Ar link1
79Don't pass through ICMP packets.
80.It Ar -link1
81Do pass through ICMP packets.
82.It Ar link2
83If a packet with a compressed header is received, automatically enable
84compression of outgoing packets.
85.It Ar -link2
86Don't auto-enable compression.
87.El
88.Pp
89Only the superuser may attach a network interface.
90.Pp
91To detach the interface, use
92.Dq Li ifconfig interface-name down
93after killing off the
94.Nm
95process.
96.Ar interface-name
97is the name that is shown by
98.Xr netstat 1 .
99.Sh EXAMPLES
100.Bd -literal -offset indent -compact
101# ifconfig sl0 10.0.0.1 10.0.0.2 link0 link2 up
102# slattach ttyh8
103# ifconfig sl1 192.168.0.1 192.168.0.2 link0 up
104# slattach \-s 4800 /dev/tty01
105.Ed
106.Sh DIAGNOSTICS
107Messages indicating the specified interface does not exist, the
108requested address is unknown, the user is not privileged and
109tried to alter an interface's configuration.
110.Sh SEE ALSO
111.Xr netstat 1 ,
112.Xr netintro 4 ,
113.Xr ifconfig 8 ,
114.Xr rc 8
115.Sh HISTORY
116The
117.Nm
118command appeared in
119.Bx 4.3 .
120