Network Working Group A. Bhushan Request for Comments: 414 MIT-MAC Updates: RFC 354, RFC 385 29 November 1972 NIC: 12406 FILE TRANSFER PROTOCOL (FTP) STATUS AND FURTHER COMMENTS A number of HOSTs have working server and user FTPs now. The following reflects the status of FTP implementations to the best of my knowledge: BBN(A and B), SRI-ARC, UTAH, CASE, USC-ISI, CCA, MIT-AI MIT- Mathlab, MIT-DMCG, CMU, AMES-67, and SU-AI have fully functionning server and user FTPs. MIT-Multics has user and server FTPs but the server does not listen on socket 3 (it can be started by normal login and the command ftp_server). UCSB will soon have user and server FTP's. The servers at all the TENEX systems are more or less identical (developed by Bob Clements at BBN). The servers at MIT-AI and MIT-ML are also identical (developed by Pitts Jarvis of MAC). Others currently involved with FTP include Arvola Chan (AC@MIT-DMCG), Ken Pogran (Multics), Greg Hicks (HICKS@UTAH), Wayne Hathaway (AMES-67), Ralph Gorin (SU-AI), Rick Werme (CMU), and Ron Stoughton (UCSB). The User-FTP or the user interface to FTP is where desirable and interesting features can be put in. An example of such a features is the BBN (and other TENEXes) "SNDMSG USER@HOST" feature which allows a local user to send messages (or mail) to other network users. If the remote host is not up, the message is stored as "--UNSENT-MAIL-- USERHOST" in the user's directory and a background job periodically checks for such files to send mail. MIT-AI and MIT-ML have a "TRANS" command which allows convenient transfer of files. At MIT-DMCG we have developed under the "CALICO" subsystem, generalized commands which allow local users to send mail, copy files efficiently, and list users and directories over the network in a manner similar to local usage (that is without having to explicitly connect, login, and send commands to a remote HOST). We also allow TELNET, FTP, and RJS users to automatically "login" and perform other command sequences from an "initial" file. It should be noted that file transfer between PDP-10's in "Image 36" is an order of magnitude faster (and more efficient) than in "ASCII 8". Note also that it is useful to provide a "Quote" or "talk" mode in user-FTP, to enable a user to input commands directly to the FTP server (i.e. commands not implemented in user-FTP). It is desirable
that user and server FTP features and desirable modes of usage be documented and reported via the RFC mechanism. The following suggestions and additions pertain to the File Transfer Protocol as stated in NWG/RFC 354 and NWG/RFC 385. After receiving comments to this RFC, I will have the three RFC's combined into a single document and have it issued as the ARPANET Official File Transfer Protocol, very soon. It should however be noted that FTP is an open-ended protocol with room for experimentation. New commands, reply codes, data representation types, and file structures may be defined in future. If two sites agree, they can define their own experimental set of commands, data types, file structures, and/or transfer modes. Such additions to the protocol should be well documented and clearly specified so that other sites can also make use of the same. 1) The FTP assumes line-at-a-time interaction with local acho. The server is not obliged to provide remote echo and may ignore TELNET control characters. A server however should not give error or bad response on receiving TELNET control characters. The server does not explicitly provide any editing capability such as character delete or line kill characters. All editing is assumed to be local. TIP users should use FTP in line mode and send both <CR> and <LF> (by TIP commands @T O L and @I L). In such a mode the TIP user can flush his current input line by the flush command (@F). The server should respond to the TELNET "SYNCH" by flushing the current command line and waiting for user input such as an "ABOR" command. Other commands such as "BYE" or "STAT" may also constitute an acceptable input. 2) Commands such as "STAT" which will produce more than one line of output over the TELNET connection, require some way of positively indicating the end of status information. It is proposed that a "200 status complete" reply give a positive indication for end of status information. The reply to STAT should begin with a line starting with 1xx (where x=digit), with the following lines not having a digit as their first character, and the status ending with the 200 reply. (Note that the requirement of three spaces is dropped in favour of the less restrictive requirement of the first character not being a digit.) This change would make operations much easier for both user and server FTPs. 3) A reminder that BYE<CR><LF> is legal. A space after a command name is not required if there is a null argument.
4) The following response are proposed to the "STAT" and "LIST" commands (this was not clearly specified specially for the null argument case). Responses to "STAT" and "LIST" shall always be over the TELNET and Data connections, respectively. The "LIST" command with null argument should produce a list of files in user's current working or default directory. The "STAT" command with null argument should (as suggested by Wayne Hathaway) produce tha status of all file transfer parameters (user, byte, size, data type, transfer mode, and file structure) if used between file transfers (i.e. no transfer in progress). If STAT is sent during a file transfer operation (accompanied with TELNET synch), the server should respond with the status of the operation in progress. If the argument of the "LIST" and "STAT" commands is a pathname, then a list associated with that pathname should be sent. 5) Two new commands are hereby proposed. First is a "HELP" command which should send to the user helpful hints about using the server and its implementation status (news). The information will be sent over the TELNET connection starting with type 100 reply and ending with a type 200 reply (completion). It is suggested that the use of this command and the "MAIL" and "BYE" commands be allowed without the user having to "login" (i.e., supplying valid user, password, and account). The other command (suggested by Bob Clements) is a new directory listing command called "NLST" which sends only the names of files (as valid pathname strings separated by CRLF) and no other useful but confusing information, so that it is possible to copy a whole directory automatically using this command and the store and retrieve commands. The syntax and format of this command is identical to the "LIST" command (for some HOSTs they may be identical commands). 6) Although the minimum implementation does not require the TYPE, BYTE, MODE, and STRU commands, it is suggested that these commands be accepted with the default values by even those having a minimum implementation. This would avoid some of the "ugly" error responses to input such as "TYPE A" and "STRU F", when these are perfectly acceptable to the server. 7) In using the "MLFL" and "LIST" commands, it is the user's (or user-FTP's) responsibility to ensure that the TYPE is ASCII (8-bit bytes). If the TYPE is other than ASCII, the server may send an error response and refuse the command. The user (or user-FTP) should therefore send the server "TYPE A" command if type is other than ASCII before sending the "MLFL" or "LIST" type commands.
8) A useful suggestion is to allow multiple user names in the "MAIL" and "MLFL" commands. Often a user wishes to send the same mail to a number of users at particular site. It would be very convenient if he can do this by doing a single transfer and command. It is strongly urged that server sites implement this option. 9) Another suggestion that has been made is to standardize pathname syntax in FTP. It appears that subdirectories will soon be introduced in the TENEX system. Perhaps that will have some bearing on the standard pathname syntax. The requirements of any pathname standard scheme are that it should allow convenient use of local pathname conventions, and not conflict with it. A reasonable proposal seems to be to have the standard pathname start with a special character such as ">" (as in Multics), and to use this special character to separate the elements of a pathname. If the special character happens to ba valid part of a pathname element, use the literal quote convention of "'>" (single quote to precede the special character). Examples of pathnames under this convention would be: >udd>CNet>Doe>foo_bar (for Multics) >DSK>JFD>foo bar (for ITS) >DOE>foo.bar1 (for TENEX) 10) The requirement of account numbers by TENEXes has caused a certain problems for automatons using FTP, under the present reply code sequences. Therefore two new reply codes are defined to handle the account requirement. A reply code of "331 Enter Account" shall be used if an account is required as part of user "login" sequence. A reply code of "433 Cannot store files without valid account. Enter account." be used if an account is required only for a particular operation such as store. 11) The following suggestions made by Wayne Hathaway (RFC forthcoming) seem reasonable and should be included in the Protocol: i) The following End-of-Record condition should be explicit on last record, and not implied in an End-of-File. This change would simplify server implementation and improve reliability (better error control). ii) Implementors of user-FTP's should note that it is trivial for them to implement record structures in ASCII type and Stream mode (the default CRLF convention for end-of-record). All user-FTPs should allow store or retrieve of record structured files with ASCII type and stream mode.
iii) It is possible to send record strutured "print-file" types (in addition to ASCII type) in either stream or text modes. (RFC 354 was not clear on this issue). iv) The TELNET synch mechanism should be extended to other commands such as BYE and STAT in addition to ABOR. v) Comments are invited on the desirability of NOOP, CLSE, and SRVR commands. In my opinion a STAT command with null argument serves the purpose of NOOP (to see if server is still alive), and BYE serves the purpose of CLSE (USER command should be used to change user name). SRVR is a useful command. 12) Bob Clements raised the old issued of error detection and control again. To handle this we can define two new descriptor codes in the Block mode, one that signals start of block check, and the other that indicates end of block check (and includes the block check bytes). These codes may be ignored by any site not wishing to implement the error detection scheme. Your comments on the error check scheme and the desirability of its inclusion in FTP are solicited. [This RFC was put into machine readable form for entry] [into the online RFC archives by Helene Morin, Via Genie, 12/99]