ipserv 4.3 KB

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