![[BACK]](/cvsweb/icons/back.gif){kind=icon}
Return to sliplogin.8 CVS log ![[TXT]](/cvsweb/icons/text.gif){kind=icon}
![[DIR]](/cvsweb/icons/dir.gif){kind=icon}
Up to [CSRG BSD Unix] / 43BSDReno / usr.sbin / sliplogin|
Return to sliplogin.8 CVS log | Up to [CSRG BSD Unix] / 43BSDReno / usr.sbin / sliplogin |
1.1 root 1: .\" Copyright (c) 1990 The Regents of the University of California.
2: .\" All rights reserved.
3: .\"
4: .\" Redistribution and use in source and binary forms are permitted provided
5: .\" that: (1) source distributions retain this entire copyright notice and
6: .\" comment, and (2) distributions including binaries display the following
7: .\" acknowledgement: ``This product includes software developed by the
8: .\" University of California, Berkeley and its contributors'' in the
9: .\" documentation or other materials provided with the distribution and in
10: .\" all advertising materials mentioning features or use of this software.
11: .\" Neither the name of the University nor the names of its contributors may
12: .\" be used to endorse or promote products derived from this software without
13: .\" specific prior written permission.
14: .\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR IMPLIED
15: .\" WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
16: .\" MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
17: .\"
18: .\" @(#)sliplogin.8 5.2 (Berkeley) 7/1/90
19: .\"
20: .TH SLIPLOGIN 8 "July 1, 1990"
21: .SH NAME
22: sliplogin \- attach a serial line network interface
23: .SH SYNOPSIS
24: .B sliplogin
25: [
26: .I loginname
27: ]
28: .SH DESCRIPTION
29: .B sliplogin
30: is used to turn the terminal line on standard input into
31: a Serial Line IP (SLIP) link to a remote host. To do this, the program
32: searches the file
33: .B /etc/slip.hosts
34: for an entry matching
35: .I loginname
36: (which defaults to the current login name if omitted).
37: If a matching entry is found, the line is configured appropriately
38: for slip (8-bit transparent i/o) and converted to SLIP line
39: discipline. Then a shell script is invoked to initialize the slip
40: interface with the appropriate local and remote IP address,
41: netmask, etc.
42: .PP
43: The usual initialization script is
44: .B /etc/slip.login
45: but, if particular hosts need special initialization, the file
46: .BI /etc/slip.login. loginname
47: will be executed instead if it exists.
48: The script is invoked with the parameters
49: .TP
50: .I slipunit
51: The unit number of the slip interface assigned to this line. E.g.,
52: .B 0
53: for
54: .BR sl0 .
55: .TP
56: .I speed
57: The speed of the line.
58: .TP
59: .I args
60: The arguments from the
61: .B /etc/slip.hosts
62: entry, in order starting with
63: .IR loginname .
64: .PP
65: Only the super-user may attach a network interface. The interface is
66: automatically detached when the other end hangs up or the
67: .B sliplogin
68: process dies. If the kernel slip
69: module has been configured for it, all routes through that interface will
70: also disappear at the same time. If there is other processing a site
71: would like done on hangup, the file
72: .B /etc/slip.logout
73: or
74: .BI /etc/slip.logout. loginname
75: is executed if it exists. It is given the same arguments as the login script.
76: .SS Format of /etc/slip.hosts
77: Comments (lines starting with a `#') and blank lines are ignored.
78: Other lines must start with a
79: .I loginname
80: but the remaining arguments can be whatever is appropriate for the
81: .B slip.login
82: file that will be executed for that name.
83: Arguments are separated by white space and follow normal
84: .BR sh (1)
85: quoting conventions (however,
86: .I loginname
87: cannot be quoted).
88: Usually, lines have the form
89: .RS
90: .I
91: loginname local-address remote-address netmask opt-args
92: .RE
93: where
94: .I local-address
95: and
96: .I remote-address
97: are the IP host names or addresses of the local and remote ends of the
98: slip line and
99: .I netmask
100: is the appropriate IP netmask. These arguments are passed
101: directly to
102: .BR ifconfig (8).
103: .I Opt-args
104: are optional arguments used to configure the line.
105: .SH EXAMPLE
106: The normal use of
107: .B sliplogin
108: is to create a
109: .B /etc/passwd
110: entry for each legal, remote slip site with
111: .B sliplogin
112: as the shell for that entry. E.g.,
113: .RS
114: Sfoo:ikhuy6:2010:1:slip line to foo:/tmp:/etc/sliplogin
115: .RE
116: (Our convention is to name the account used by remote host
117: .I hostname
118: as
119: .IR Shostname .)
120: Then an entry is added to
121: .B slip.hosts
122: that looks like:
123: .RS
124: Sfoo `hostname` foo netmask
125: .RE
126: where
127: .I `hostname`
128: will be evaluated by
129: .B sh
130: to the local host name and
131: .I netmask
132: is the local host IP netmask.
133: .PP
134: Note that
135: .B sliplogin
136: must be setuid to root and, while not a security hole, moral defectives
137: can use it to place terminal lines in an unusable state and/or deny
138: access to legitimate users of a remote slip line. To prevent this,
139: a site can create a group, say
140: .IR slip ,
141: that only the slip login accounts are put in then make sure that
142: .B /etc/sliplogin
143: is in group
144: .I slip
145: and mode 4550 (setuid root, only group
146: .I slip
147: can execute binary).
148: .SH "DIAGNOSTICS"
149: .B sliplogin
150: logs various information to the system log daemon,
151: .BR syslogd (8),
152: with a facility code of
153: .BR daemon .
154: The messages are listed here, grouped by severity level.
155: .SS Err Severity
156: .TP
157: .BI "ioctl (TCGETS): " reason
158: A
159: .SB TCGETS
160: .B ioctl
161: to get the line parameters failed.
162: .TP
163: .BI "ioctl (TCSETS): " reason
164: A
165: .SB TCSETS
166: .B ioctl
167: to set the line parameters failed.
168: .TP
169: .BI "/etc/slip.hosts: " reason
170: The
171: .B /etc/slip.hosts
172: file could not be opened.
173: .TP
174: .BI "access denied for " user
175: No entry for
176: .I user
177: was found in
178: .BR /etc/slip.hosts .
179: .SS Notice Severity
180: .TP
181: .BI "attaching slip unit " unit " for " loginname
182: SLIP unit
183: .I unit
184: was successfully attached.
185: .SH "SEE ALSO"
186: .BR slattach (8),
187: .BR syslogd (8)
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.