summaryrefslogtreecommitdiffstats
path: root/contrib/lukemftpd/src/ftpd.8
diff options
context:
space:
mode:
Diffstat (limited to 'contrib/lukemftpd/src/ftpd.8')
-rw-r--r--contrib/lukemftpd/src/ftpd.848
1 files changed, 25 insertions, 23 deletions
diff --git a/contrib/lukemftpd/src/ftpd.8 b/contrib/lukemftpd/src/ftpd.8
index 65f993a..5aaadf0 100644
--- a/contrib/lukemftpd/src/ftpd.8
+++ b/contrib/lukemftpd/src/ftpd.8
@@ -1,6 +1,6 @@
-.\" $NetBSD: ftpd.8,v 1.63 2000/12/18 02:32:51 lukem Exp $
+.\" $NetBSD: ftpd.8,v 1.69 2002/02/08 01:30:07 ross Exp $
.\"
-.\" Copyright (c) 1997-2000 The NetBSD Foundation, Inc.
+.\" Copyright (c) 1997-2001 The NetBSD Foundation, Inc.
.\" All rights reserved.
.\"
.\" This code is derived from software contributed to The NetBSD Foundation
@@ -67,7 +67,7 @@
.\"
.\" @(#)ftpd.8 8.2 (Berkeley) 4/19/94
.\"
-.Dd December 18, 2000
+.Dd October 13, 2001
.Dt FTPD 8
.Os
.Sh NAME
@@ -149,7 +149,7 @@ The default is the hostname associated with the IP address that
is listening on.
This ability (with or without
.Fl h ) ,
-in conjunction with
+in conjunction with
.Fl c Ar confdir ,
is useful when configuring
.Sq virtual
@@ -257,7 +257,7 @@ style
file suitable for input into a third-party log analysis tool with a command
similar to:
.Dl "grep 'xferlog: ' /var/log/xferlog | \e"
-.Dl "\ \ \ sed -e 's/^.*xferlog: //' > wuxferlog"
+.Dl "\ \ \ sed -e 's/^.*xferlog: //' \*[Gt] wuxferlog"
.El
.Pp
The file
@@ -394,8 +394,7 @@ conventions used by
.Xr csh 1 .
This allows users to utilize the metacharacters
.Dq Li \&*?[]{}~ .
-.Sh User authentication
-.Pp
+.Ss User authentication
.Nm
authenticates users according to five rules.
.Pp
@@ -428,6 +427,10 @@ The user must have a standard shell returned by
If the user's shell field in the password database is empty, the
shell is assumed to be
.Pa /bin/sh .
+As per
+.Xr shells 5 ,
+the user's shell must be listed with full path in
+.Pa /etc/shells .
.It
If directed by the file
.Xr ftpchroot 5
@@ -491,8 +494,7 @@ then the verbose messages displayed at login and upon a
.Sy CWD
command are suppressed.
.El
-.Sh Display file escape sequences
-.Pp
+.Ss Display file escape sequences
When
.Nm
displays various files back to the client (such as
@@ -551,8 +553,7 @@ A
.Dq \&%
character.
.El
-.Sh Setting up a restricted ftp subtree
-.Pp
+.Ss Setting up a restricted ftp subtree
In order that system security is not breached, it is recommended
that the
subtrees for the
@@ -625,6 +626,7 @@ The following
directives should be used:
.Dl "modify guest off"
.Dl "umask guest 0707"
+.Dl "upload guest on"
.Pp
This will result in anonymous users being able to upload files to this
directory, but they will not be able to download them, delete them, or
@@ -661,20 +663,20 @@ login, you can copy/link
.Pa /sbin/nologin
to
.Pa /sbin/ftplogin ,
-and enter
-.Pa /sbin/ftplogin
+and enter
+.Pa /sbin/ftplogin
to
.Pa /etc/shells
to allow logging-in via
.Tn FTP
into the accounts, which must have
-.Pa /sbin/ftplogin
+.Pa /sbin/ftplogin
as login shell.
.Sh FILES
.Bl -tag -width /etc/ftpwelcome -compact
.It Pa /etc/ftpchroot
-List of normal users who should be
-.Xr chroot 2 ed.
+List of normal users whose root directory should be changed via
+.Xr chroot 2 .
.It Pa /etc/ftpd.conf
Configure file conversions and other settings.
.It Pa /etc/ftpusers
@@ -700,17 +702,17 @@ Login history database.
.Xr skey 1 ,
.Xr who 1 ,
.Xr getusershell 3 ,
-.Xr ftpd.conf 5 ,
.Xr ftpchroot 5 ,
+.Xr ftpd.conf 5 ,
.Xr ftpusers 5 ,
.Xr syslogd 8
.Sh STANDARDS
.Nm
-recognizes all commands in
-.Cm RFC 959 ,
-follows the guidelines in
+recognizes all commands in
+.Cm RFC 959 ,
+follows the guidelines in
.Cm RFC 1123 ,
-recognizes all commands in
+recognizes all commands in
.Cm RFC 2228
(although they are not supported yet),
and supports the extensions from
@@ -732,7 +734,7 @@ and
.Cm draft-ietf-ftpext-mlst-11
support was implemented in
.Nx 1.3
-and later releases by Luke Mewburn <lukem@netbsd.org>.
+and later releases by Luke Mewburn \*[Lt]lukem@netbsd.org\*[Gt].
.Sh BUGS
The server must run as the super-user to create sockets with
privileged port numbers (i.e, those less than
@@ -811,7 +813,7 @@ is running on a port greater than
.Dv IPPORT_RESERVED
and the user has logged in as a
.Sq guest
-or
+or
.Sq chroot
user.
.It
OpenPOWER on IntegriCloud