User FTP Documentation
RFC 412

Document Type RFC - Unknown (November 1972; No errata)
Last updated 2013-03-02
Stream Legacy
Formats plain text pdf html bibtex
Stream Legacy state (None)
Consensus Boilerplate Unknown
RFC Editor Note (None)
IESG IESG state RFC 412 (Unknown)
Telechat date
Responsible AD (None)
Send notices to (None)
Work Information Center # 12404                                 G. Hicks
Request for Comments # 412                                      Utah

                         User FTP Documentation

     The attached document is the HELP file for the Utah-10
implementation of the User FTP Process. This is what the user has
typed on his console when he types 'HELP<cr>', and as such is the only
documention produced to date.

                                                                [Page 1]
User FTP Documentation                          Detailed Command Listing

                         FTP User Documentation
                           November 27, 1972

I. Control Characters

      There are several control characters that have meaning to the FTP
Process. First, the abort character is <control-z> (SUB), next for
editing, only <control-r>, <control-a>, <control-h>, <control-v>,
<control-w>, <alt-mode>, <eol>, <space>, <control-x> and <rub-out> have
any meaning, <control-a> (SOH) and <control-h> (BS) are the character
delete keys. <control-w> is the word delete character, Note: When dowing
the ' funktion, this character will delete the entire line typed.
<control-v> says take the next character literally. <alt-mode> (ESC)
terminates the command giving helpful noise words, <eol> and <space> are
terminators also. These last two will give no command completion or
noise words. All three echo as a space however.  <control-x> (CAN) and
<rub-out> (DEL) are the command abort characters. <control-r> (DC2) will
retype the line as the command interpreter sees it. When using the ?  as
a prompter, for initial commands, it will type-out all commands that
begin with that particular character string.  If it is typed in a sub-
command field, it will type out the prompt message only if it is the
first character typed. At all other times, it will be accepted as part
of the typed string.

II. General Information

      The FTP user process is designed to make transferring files from
one host on the ARPANET to another much easier than it has been up until
now. To this end, the command language was designed to be as natural as

      The command interpreter is, of course, part of this idea.
Therefore, to help the user as much as possible, there are several ways
to find out what is expected in the form of commands, file-names, user-
names, etc. When the user has typed nothing, typing a ? will cause the
interpreter to type out all the commands that are available to the user.
If the user has typed anything at all, then it will respond with all
commands that begin with the particular character string.

      So that the command language was as easy to learn as possible, the
command interpreter will 'see' nothing that is not part of a legal
command. If the user types anything that is not expected, the character
is not echoed and a bell is echoed instead.

                                                                [Page 2]
User FTP Documentation                          Detailed Command Listing

III. Brief Command Listing

      The commands that are expected and their syntax are listed below.
NOTE: UPPER and lower case letters are identical.

D<decimal host number>
<octal host number>
;<any string> (useful for comments to a person that is
linked to you)
MODE <mode name>
RETREIVE <remote file> (to) <local file>
GET <remote file> (to) <local file>
SEND <local file> (to) <remote file>
STORE <local file> (to) <remote file>
APPEND <local file> (to) <remote file>
RENAME <remote file> (to be) <new remote file name>
DELETE <remote file>
COPY <direction descriptor> <file group> (to) <file group>
     (see detailed description below)
LIST <file group> (to file) <local file name>
ALLOCATE <decimal number of bytes>
   foreign host)
HOST <any valid ARPANET host name or number>
USER <remote user name>
PASSWORD <password for remote user's name>
ACCOUNT <string or number for remote user's name>
STATUS (see description of status command below)
LOGIN <user name> <password> <optional account> <to host>
BYTE <decimal byte size>
TYPE <type descriptor>
STRUCTURE <structure descriptor>

                                                                [Page 3]
User FTP Documentation                          Detailed Command Listing

IV. Detailed Description of the Commands

         The commands and their syntax are described in greater detail
   blow. The words in parenthesis are noise words.  NOTE: upper and
   lower case are identical. Unless otherwise noted in the command
   description, all commands described are implemented.

<host name> or <host number>
   Performs the ICP to the indicated host with explanatory remarks if
   the ICP is not possible.

MODE <mode descriptor>
   Sets the mode of the data transfer connection according to the
Show full document text