date and time created 88/07/22 16:08:01 by bostic
[unix-history] / usr / src / libexec / ftpd / ftpd.8
index 271e562..7513b6c 100644 (file)
@@ -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.
 .\"
-.\"    @(#)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
@@ -28,23 +28,15 @@ service specification; see
 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,
-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
-will timeout an inactive session after 60 seconds.
+will timeout an inactive session after 15 minutes.
 If the
 .B \-t
 option is specified,
@@ -57,23 +49,30 @@ requests;  case is not distinguished.
 .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
+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'')
+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
+PASV   prepare for server-to-server transfer
 PORT   specify data connection port
+PWD    print the current working directory
 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
+STOU   store a file with a unique 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
-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
+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
@@ -105,6 +109,9 @@ may be performed.
 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
@@ -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"
-ftp(1C),
+ftp(1C), getusershell(3), syslogd(8)
 .SH BUGS
-There is no support for aborting commands.
-.PP
 The anonymous account is inherently dangerous and should
 avoided when possible.
 .PP