date and time created 88/07/22 16:08:01 by bostic

[unix-history] / usr / src / libexec / ftpd / ftpd.8

diff --git a/usr/src/libexec/ftpd/ftpd.8 b/usr/src/libexec/ftpd/ftpd.8
index 271e562..7513b6c 100644 (file)
--- a/usr/src/libexec/ftpd/ftpd.8
+++ b/usr/src/libexec/ftpd/ftpd.8
@@ -1,10 +1,10 @@
-.\" Copyright (c) 1983 Regents of the University of California.
+.\" Copyright (c) 1985 Regents of the University of California.

 .\" All rights reserved.  The Berkeley software License Agreement
 .\" specifies the terms and conditions for redistribution.
 .\"
 .\" All rights reserved.  The Berkeley software License Agreement
 .\" specifies the terms and conditions for redistribution.
 .\"

-.\"    @(#)ftpd.8      5.1 (Berkeley) %G%
+.\"    @(#)ftpd.8      6.4 (Berkeley) %G%

 .\"
 .\"

-.TH FTPD 8C "4 March 1983"
+.TH FTPD 8C "April 27, 1985"

 .UC 5
 .SH NAME
 ftpd \- DARPA Internet File Transfer Protocol server
 .UC 5
 .SH NAME
 ftpd \- DARPA Internet File Transfer Protocol server


@@ -28,23 +28,15 @@ service specification; see
 If the 
 .B \-d
 option is specified,
 If the 
 .B \-d
 option is specified,

-each socket created will have debugging turned
-on (SO_DEBUG).  With debugging enabled, the system
-will trace all TCP packets sent and received on a
-socket.  The program
-.IR trpt (8C)
-may then be used to interpret the packet traces.
+debugging information is written to the syslog.

 .PP
 If the
 .B \-l
 option is specified,
 .PP
 If the
 .B \-l
 option is specified,

-each ftp session is logged on the standard output.
-This allows a line of the form 
-`/etc/ftpd -l > /tmp/ftplog''
-to be used to conveniently maintain a log of ftp sessions.
+each ftp session is logged in the syslog.

 .PP
 The ftp server
 .PP
 The ftp server

-will timeout an inactive session after 60 seconds.
+will timeout an inactive session after 15 minutes.

 If the
 .B \-t
 option is specified,
 If the
 .B \-t
 option is specified,


@@ -57,23 +49,30 @@ requests;  case is not distinguished.
 .nf
 .ta \w'Request        'u
 \fBRequest     Description\fP
 .nf
 .ta \w'Request        'u
 \fBRequest     Description\fP

+ABOR   abort previous command

 ACCT   specify account (ignored)
 ALLO   allocate storage (vacuously)
 APPE   append to a file
 ACCT   specify account (ignored)
 ALLO   allocate storage (vacuously)
 APPE   append to a file

+CDUP   change to parent of current working directory

 CWD    change working directory
 DELE   delete a file
 HELP   give help information
 LIST   give list files in a directory (``ls -lg'')
 CWD    change working directory
 DELE   delete a file
 HELP   give help information
 LIST   give list files in a directory (``ls -lg'')

+MKD    make a directory

 MODE   specify data transfer \fImode\fP
 NLST   give name list of files in directory (``ls'')
 NOOP   do nothing
 PASS   specify password
 MODE   specify data transfer \fImode\fP
 NLST   give name list of files in directory (``ls'')
 NOOP   do nothing
 PASS   specify password

+PASV   prepare for server-to-server transfer

 PORT   specify data connection port
 PORT   specify data connection port

+PWD    print the current working directory

 QUIT   terminate session
 RETR   retrieve a file
 QUIT   terminate session
 RETR   retrieve a file

+RMD    remove a directory

 RNFR   specify rename-from file name
 RNTO   specify rename-to file name
 STOR   store a file
 RNFR   specify rename-from file name
 RNTO   specify rename-to file name
 STOR   store a file

+STOU   store a file with a unique name

 STRU   specify data transfer \fIstructure\fP
 TYPE   specify data transfer \fItype\fP
 USER   specify user name
 STRU   specify data transfer \fIstructure\fP
 TYPE   specify data transfer \fItype\fP
 USER   specify user name


@@ -84,9 +83,14 @@ XPWD print the current working directory
 XRMD   remove a directory
 .fi
 .PP
 XRMD   remove a directory
 .fi
 .PP

-The remaining ftp requests specified in Internet RFC 765 are
+The remaining ftp requests specified in Internet RFC 959 are

 recognized, but not implemented.
 .PP
 recognized, but not implemented.
 .PP

+The ftp server will abort an active file transfer only when the
+ABOR command is preceded by a Telnet "Interrupt Process" (IP)
+signal and a Telnet "Synch" signal in the command Telnet stream,
+as described in Internet RFC 959.
+.PP

 .I Ftpd
 interprets file names according to the ``globbing''
 conventions used by
 .I Ftpd
 interprets file names according to the ``globbing''
 conventions used by


@@ -105,6 +109,9 @@ may be performed.
 The user name must not appear in the file
 .IR /etc/ftpusers .
 .IP 3)
 The user name must not appear in the file
 .IR /etc/ftpusers .
 .IP 3)

+The user must have a standard shell returned by 
+.IR getusershell (3).
+.IP 4)

 If the user name is ``anonymous'' or ``ftp'', an
 anonymous ftp account must be present in the password
 file (user ``ftp'').  In this case the user is allowed
 If the user name is ``anonymous'' or ``ftp'', an
 anonymous ftp account must be present in the password
 file (user ``ftp'').  In this case the user is allowed


@@ -142,10 +149,8 @@ Make this directory mode 777 and owned by ``ftp''.  Users
 should then place files which are to be accessible via the
 anonymous account in this directory.
 .SH "SEE ALSO"
 should then place files which are to be accessible via the
 anonymous account in this directory.
 .SH "SEE ALSO"

-ftp(1C),
+ftp(1C), getusershell(3), syslogd(8)

 .SH BUGS
 .SH BUGS

-There is no support for aborting commands.
-.PP

 The anonymous account is inherently dangerous and should
 avoided when possible.
 .PP
 The anonymous account is inherently dangerous and should
 avoided when possible.
 .PP