Debian Codegraph @

upstream/debian-unstable/man8/telnetlogin.8

raw
1 .\" Copyright (c) 2000 David A. Holland.
2 .\" All rights reserved.
3 .\"
4 .\" Redistribution and use in source and binary forms, with or without
5 .\" modification, are permitted provided that the following conditions
6 .\" are met:
7 .\" 1. Redistributions of source code must retain the above copyright
8 .\" notice, this list of conditions and the following disclaimer.
9 .\" 2. Redistributions in binary form must reproduce the above copyright
10 .\" notice, this list of conditions and the following disclaimer in the
11 .\" documentation and/or other materials provided with the distribution.
12 .\" 3. All advertising materials mentioning features or use of this software
13 .\" must display the following acknowledgement:
14 .\" This product includes software developed by David A. Holland.
15 .\" 4. Neither the name of the Author nor the names of any 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 AUTHOR AND ANY 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 AUTHOR OR ANY 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 .\" $Id: telnetlogin.8,v 1.2 2004-11-07 15:47:43 ianb Exp $
32 .\"
33 .Dd April 12, 2000
34 .Dt TELNETLOGIN 8
35 .Os "Linux NetKit (0.17)"
36 .Sh NAME
37 .Nm telnetlogin
38 .Nd login wrapper for telnetd
39 .Sh SYNOPSIS
40 .Nm telnetlogin
41 .Op Fl h Ar host
42 .Op Fl p
43 .Op Fl f Ar username
44 .Op Ar username
45 .Sh DESCRIPTION
46 .Nm telnetlogin
47 is a setuid wrapper that runs
48 .Xr login 1 .
49 It is meant to be invoked by
50 .Xr telnetd 8 ;
51 the idea is to remove the necessity of running telnetd as root.
52 .Pp
53 .Nm telnetlogin
54 should be installed mode 4750, user root, group telnetd. Then,
55 telnetd may be run from
56 .Pa /etc/inetd.conf
57 as user ``nobody'', group ``telnetd'', and with the option
58 .Fl L Ar path-to-telnetlogin .
59 .Pp
60 .Nm telnetlogin
61 accepts only the subset of options to
62 .Xr login 1
63 shown above, in the order listed. This is the order
64 .Xr telnetd 8
65 normally provides them in.
66 .Nm telnetlogin
67 also does sanity checks on the environment variables
68 .Ev TERM ,
69 and
70 .Ev REMOTEHOST .
71 It also insists that the standard input, output, and error streams are
72 open on a terminal, and that it is the process group leader of the
73 foreground process of that terminal. After checking all of these
74 conditions, checking the values of the above environment variables for
75 reasonable values, resetting signal handlers, and so forth, it execs
76 login.
77 .Sh SEE ALSO
78 .Xr login 1 ,
79 .Xr inetd.conf 5 ,
80 .Xr inetd 8 ,
81 .Xr telnetd 8
82 .Sh RESTRICTIONS
83 .Pp
84 THIS IS PRESENTLY EXPERIMENTAL CODE; USE WITH CAUTION.
85 .Sh HISTORY
86 .Nm telnetlogin
87 was written during the development of NetKit 0.17.