diff options
Diffstat (limited to 'doc/rfc/rfc479.txt')
-rw-r--r-- | doc/rfc/rfc479.txt | 283 |
1 files changed, 283 insertions, 0 deletions
diff --git a/doc/rfc/rfc479.txt b/doc/rfc/rfc479.txt new file mode 100644 index 0000000..c42a550 --- /dev/null +++ b/doc/rfc/rfc479.txt @@ -0,0 +1,283 @@ + + + + + + +Network Working Group James E. White (JEW) +Request for Comments: 479 SRI-ARC +NIC: 14948 March 8, 1973 + + + Use of FTP by the NIC Journal + + At the Network Mail Meeting (see -- 14317,) the NIC outlined it's + requirements for implementing FTP Journal delivery and submission. + + It had always been our thinking that those two services should rely + upon the File Transfer Protocol's MLFL command for their + implementation. + + Prior to the meeting, we had envisioned that, in the case of + submission, for example, the user would embed what parameters the NIC + required (e.g., an indication that this piece of mail was to be + journalized, a list of NIC idents, etc.) in the USERNAME field of the + MLFL command, in a way that was transparent to his FTP user process, + and that SRI-ARC's FTP server process would parse the 'user name' for + the parameters and internally invoke the Journal System with them and + the text of the mail as arguments. + + Our goal (which this scheme would have satisfied) was to provide + the desired services while confining software changes to our own + system and, in particular, to avoid requiring that user FTP + processes or the File Transfer Protocol itself be modified. + + It was, however, the consensus of those present at the meeting that + it was preferable to modify FTP in such a way that all required + parameters could be explicitly declared, rather than require that + they be hidden within what purported to be simply a user name. + + The intent of this RFC is to list what we (the NIC) believe were the + new FTP commands it was agreed should be defined in support of mail + submission and delivery. Actually, we've done some massaging after + thinking about the issues for awhile, and so this is really a + description of what we'd like to see included in the File Transfer + Protocol (following the lines of thought which developed at the + meeting), along with a short description of how the NIC would use + them. + + Some of the commands currently make sense only if issued TO the NIC's + FTP server process (as opposed to anybody else's) and others only if + issued BY the NIC's FTP user process (as opposed to anybody else's). + This is true because currently only the NIC plans to offer mail + + + + + +White [Page 1] + +RFC 479 Use of FTP by the NIC Journal March 1973 + + + forwarding and recording (i.e., the Journal System) as a service. + However, other hosts may in the future desire to implement a similar + service, at which time these special commands will have wider use. + + Conceptually, all of these commands are sub-commands of a new MAIL + command, but the intent for the moment is not to define their + position within the FTP dialogue nor their syntax, but simply to + describe them conceptually. Details of syntax and use are left to + the FTP Interest Group which meets 16-MAR-73 in Boston (see -- + 14333,). + + The new sub-commands are described below. Bracketed fields are + optional; slash denotes a choice of two or more alternatives. + + (1) TITLE title + + Where 'title' is a character string describing for the human + reader the contents of the mail. + + (2) USER-READABLE-AUTHOR author + + Where 'author' identifies the author of the mail to the human + reader. This may be a nickname, or any other identifier with + which the human sender chooses to sign his mail. + + (3) PROCESS-READABLE-AUTHOR last, first initial (ident) + + Where the author's name (and ident if known) is made available + to the server in a form it can hope to parse (if need be). + + This sub-command is important to the NIC, providing a basis for + locating the author in the NIC's Ident files. + + (4) FOR-ACKNOWLEDGMENT-AUTHOR username hostname + + Where 'username' and 'hostname' define the sender in a way + useful in acknowledging delivery (of forwarded mail). + + The acknowledgment will itself be a piece of mail sent from + the NIC to 'username' at 'hostname'. + + It's important, conceptually, to note the NIC's unique role + here. Normally, acceptance of the mail by the server would + constitute acknowledgment of delivery. But, in the case of + Journal submission, the NIC acts only as a forwarding agent, + and hence delivery of mail by the sender to SRI-ARC isn't + + + + + +White [Page 2] + +RFC 479 Use of FTP by the NIC Journal March 1973 + + + really delivery at all -- only submission. Final delivery + occurs when the NIC transmits a copy of the mail to each of its + addressees; hence the need for this special kind of + acknowledgment. + + Note that this sub-command and the previous two constitute + different renderings of the sender's name. + + (5) ACKNOWLEDGMENT-DETAILS + DEFAULT / (COMPLETION / FAILURE / PERIODIC interval + GIVEUP time + TERSE / VERBOSE) + + The value of the first parameter (ignoring 'DEFAULT' for the + moment) determines the conditions under which acknowledgment + will be made to the sender: + + -- upon completion, whether delivery was successful or timed + out for one or more addressees, + + -- only if delivery failed for one or more addressees, or + + -- periodically until delivery is complete. + + The value of the second parameter determines the time after + which delivery attempts will be discontinued. + + The value of the third parameter determines how detailed -- in + some as yet unspecified sense -- an acknowledgment will be + returned. + + A verbose acknowledgment might, in the case of delivery + failure, include a copy of the text of the message, or, for + mail sent by citation (see item 10 below), a pointer to it. + + If DEFAULT is specified (in which case, FOR-ACKNOWLEDGMENT- + AUTHOR should not be specified, and 'DEFAULT' applies to it, + too), the NIC will extract a set of default values from its + Ident files, provided that a PROCESS-READABLE-AUTHOR subcommand + is present and the sender's NIC Ident can be inferred from it; + otherwise, the NIC will apply a set of (as yet unspecified) + system defaults. + + The NIC's Ident files will be modified to contain, for each + user known to it, the kind of acknowledgment the user + usually wants (i.e., his default) and the username and + hostname that define the destination for such + acknowledgments. These last two pieces of information will + + + +White [Page 3] + +RFC 479 Use of FTP by the NIC Journal March 1973 + + + also be used in delivering mail to the user if he has + requested Network delivery (as opposed to Online (at the + NIC) or hardcopy). + + (6) ADDRESSEES-ARE name1, name2, ... + + This sub-command identifies the recipient(s) of the mail. In + general, 'namei' will be the name by which the recipient is + known locally in the server's system. + + The NIC's server FTP process will permit 'namei' to be any of + the following: + + -- a NIC Ident (designating either an individual or a + group), + + -- username hostname, where 'username' is the name by which + the addressee is known at host 'hostname', or + + -- lastname, firstname initial , which the NIC will attempt + to parse and then locate in its Ident files. + + Note that now the possibility of multiple addressees is + explicitly admitted by the Protocol, but the meaning of 'useri' + (to the server) is left server-dependent. + + (7) MAIL-CLASS + BULK/POSTCARD + SPECIAL-DELIVERY/FIRST-CLASS + + The first parameter makes a statement about the size of the + mail, and the server may choose to use it to decide how and + where to store he mail for the addressee. + + The second parameter makes a statement about the importance of + the mail, and the server may choose to expedite delivery (e.g., + interrupt the user if he's logged in) for SPECIAL-DELIVERY + mail. + + (8) RECORD [identifier] [miscellaneous] + + This is the command to the server to record the mail. + 'Identifier' allows the sender the option of specifying a pre- + assigned identifier if he has one; if this field is not + present, the server assigns one. + + 'Miscellaneous' includes any server-dependent parameters which + the server may require or allow. + + + +White [Page 4] + +RFC 479 Use of FTP by the NIC Journal March 1973 + + + When this command is issued to the NIC, it will be taken as a + command to Journalize the mail, and 'identifier' may be: + + NIC number [RFC number] + + The NIC may allow 'miscellaneous' to contain such information + as comments, keywords, etc. + + (9) PRESERVED-AT hostname AS identifier + + This is not a command but a statement of fact which the FTP + server will presumably relay to the user as it does the + information contained in (for example) the TITLE command. + + The implication is that a copy of this piece of mail has been + preserved at 'hostname' and is retrievable -- on a long-term + basis -- with 'identifier'. 'Identifier' might, in general, be + a pathname. + + When the NIC delivers Journal articles through the Net, it will + include this sub-command, and 'identifier' will be a NIC + number, and 'hostname' of course 'SRI-ARC' or 'NIC'. + + (10) TEXT text + FILE pathname hostname + + One of these two sub-commands is used to actually transmit the + mail: the first transmits the text of the mail, the second a + pointer to it (leaving open to the FTP server (or his user) the + option of retrieving the text of the mail from the specified + host). + + The NIC will transmit mail created within NLS with 'Submit + File' using the FILE command, and mail created with 'Submit + Message' using the TEXT command. For mail entering the SRI- + ARC system via its FTP server process, the NIC will employ the + same command in delivery as was used in submission. + + + + + + [ This RFC was put into machine readable form for entry ] + [ into the online RFC archives by Hannes Faestermann 12/97 ] + + + + + + + +White [Page 5] + |