]> git.lizzy.rs Git - plan9front.git/blob - sys/man/8/ipserv
add HISTORY to various man pages
[plan9front.git] / sys / man / 8 / ipserv
1 .TH IPSERV 8
2 .SH NAME
3 telnetd, rlogind, rexexec, ftpd, socksd, hproxy \- Internet remote access daemons
4 .SH SYNOPSIS
5 .B ip/telnetd
6 .RB [ -adnptN ]
7 .RB [ -u
8 .IR user ]
9 .PP
10 .B ip/rlogind
11 .PP
12 .B ip/rexexec
13 .PP
14 .B ip/ftpd
15 .RB [ -aAde ]
16 .RB [ -n
17 .IR namepace-file ]
18 .PP
19 .B ip/socksd
20 [
21 .B -x
22 .I inside
23 ] [
24 .B -o
25 .I outside
26 ]
27 .PP
28 .B ip/hproxy
29 .SH DESCRIPTION
30 These programs support remote access across the Internet.  All expect the
31 network connection to be standard input, output, and error.  They are normally
32 started from scripts in
33 .B /rc/bin/service
34 (see
35 .IR listen (8)).
36 .PP
37 .I Telnetd
38 allows login from a remote client.
39 There are three types of login:
40 .TF anonymo
41 .TP
42 .I normal
43 Normal users log in by encrypting and returning a
44 challenge printed by
45 .IR telnetd .
46 The user can use either the
47 .IR netkey
48 program
49 (see
50 .IR passwd (1))
51 or a  SecureNet handheld authenticator to encrypt the challenge.
52 .B /lib/namespace
53 defines the namespace.
54 .TP
55 .I noworld
56 Users in group
57 .B noworld
58 in
59 .BR /adm/users
60 authenticate with a password in the clear.
61 .B /lib/namespace.noworld
62 defines the namespace.
63 .TP
64 .I anonymous
65 User
66 .B none
67 requires no authentication.
68 .B /lib/namespace
69 defines the namespace.
70 .PD
71 .PP
72 .IR Telnetd 's
73 options are:
74 .TP 4
75 .B a
76 allow anonymous login by
77 .B none
78 .TP
79 .B d
80 print debugging to standard error
81 .TP
82 .B p
83 don't originate any telnet control codes
84 .TP
85 .B n
86 turn on local character echoing and imply the
87 .B p
88 option
89 .TP
90 .B t
91 trusted, that is, don't authenticate
92 .TP
93 .B u
94 use
95 .I user
96 as the local account name
97 .TP
98 .B N
99 permit connections by `noworld' users only.
100 .PD
101 .PP
102 .I Rlogind
103 logs in using the BSD remote login protocol.
104 .I Rlogind
105 execs
106 .I telnetd
107 .B -nu
108 after completing its initial handshake.
109 .PP
110 .I Rexexec
111 executes a command locally for a remote client.  It uses the
112 standard Plan 9 authentication (see
113 .IR authsrv (6)).
114 .PP
115 .I Ftpd
116 runs the Internet file transfer protocol.  Users may transfer
117 files in either direction between the local and
118 remote machines.
119 As for
120 .IR telnetd ,
121 there are three types of login:
122 .TF anonymo
123 .TP
124 .I normal
125 Normal users authenticate
126 via the same challenge/response as for
127 .IR telnetd .
128 .BI /usr/ username /lib/namespace.ftp
129 or, if that file does not exist,
130 .B /lib/namespace
131 defines the namespace.
132 .TP
133 .I noworld
134 Users in group
135 .B noworld
136 in
137 .B /adm/users
138 login using a password in the clear.
139 .B /lib/namespace.noworld
140 defines the namespace.
141 .TP
142 .I anonymous
143 Users
144 .B anonymous
145 and
146 .B none
147 require no authentication.
148 The argument to the
149 .B \-n
150 option (default
151 .IR /lib/namespace.ftp )
152 defines the namespace.
153 Anonymous users may only store files in the subtree
154 below
155 .BR /incoming .
156 .PD
157 .PP
158 .IR Ftpd 's
159 options are:
160 .TP 4
161 .B a
162 allow anonymous access
163 .TP
164 .B A
165 allow
166 .I only
167 anonymous access
168 .TP
169 .B d
170 write debugging output to standard error
171 .TP
172 .B e
173 treat any user as anonymous
174 .TP
175 .B n
176 the namespace for anonymous users (default
177 .BR /lib/namespace.ftp )
178 .PP
179 To preserve intended protections in shared file trees,
180 any directory containing a file
181 .I .httplogin
182 is locked by
183 .IR ftpd;
184 see
185 .IR httpd (8).
186 .PP
187 .I Socksd
188 is a SOCKS4 and SOCKS5
189 proxy server allowing non Plan9 machines to access the
190 outside network.
191 The net to use for outgoing calls can be specified
192 with the
193 .B -o
194 .I outside
195 and the internal network is specified with
196 .B -x
197 .I inside
198 (for UDP relay).
199 If not specified,
200 .I inside
201 and
202 .I outside
203 will default to
204 .BR /net .
205 .PP
206 .I Hproxy
207 is a simple HTTP proxy server.
208 .SH FILES
209 .B /lib/namepace
210 .br
211 .BI /usr/ username /lib/namespace.ftp
212 .br
213 .B /lib/namespace.world
214 .br
215 .B /lib/namespace.ftp
216 .SH SOURCE
217 .B /sys/src/cmd/ip/telnetd.c
218 .br
219 .B /sys/src/cmd/ip/rlogind.c
220 .br
221 .B /sys/src/cmd/ip/rexexec.c
222 .br
223 .B /sys/src/cmd/ip/ftpd.c
224 .br
225 .B /sys/src/cmd/ip/socksd.c
226 .br
227 .B /sys/src/cmd/ip/hproxy.c
228 .SH "SEE ALSO"
229 .IR ftpfs (4),
230 .IR pop3 (8)
231 .SH HISTORY
232 .I Hproxy
233 first appeared in 9front (July, 2012).
234 .I Socksd
235 first appeared in 9front (March, 2012).