Relay-Version: version B 2.10 5/3/83; site utzoo.UUCP Path: utzoo!watmath!clyde!cbosgd!ulysses!bellcore!decvax!decwrl!pyramid!pesnta!amd!amdcad!lll-crg!seismo!brl-adm!ron From: ron@brl-adm.UUCP Newsgroups: mod.sources.doc Subject: rfc821 (6 of 8) Message-ID: <719@brl-adm.ARPA> Date: Mon, 19-May-86 00:00:18 EDT Article-I.D.: brl-adm.719 Posted: Mon May 19 00:00:18 1986 Date-Received: Sat, 24-May-86 22:26:03 EDT Distribution: net Organization: Ballistic Research Lab Lines: 580 Approved: RON@BRL.ARPA RFC 821 August 1982 Simple Mail Transfer Protocol APPENDIX D X.25 Transport service It may be possible to use the X.25 service [7] as provided by the Public Data Networks directly, however, it is suggested that a reliable end-to-end protocol such as TCP be used on top of X.25 connections. Postel [Page 47] August 1982 RFC 821 Simple Mail Transfer Protocol APPENDIX E Theory of Reply Codes The three digits of the reply each have a special significance. The first digit denotes whether the response is good, bad or incomplete. An unsophisticated sender-SMTP will be able to determine its next action (proceed as planned, redo, retrench, etc.) by simply examining this first digit. A sender-SMTP that wants to know approximately what kind of error occurred (e.g., mail system error, command syntax error) may examine the second digit, reserving the third digit for the finest gradation of information. There are five values for the first digit of the reply code: 1yz Positive Preliminary reply The command has been accepted, but the requested action is being held in abeyance, pending confirmation of the information in this reply. The sender-SMTP should send another command specifying whether to continue or abort the action. [Note: SMTP does not have any commands that allow this type of reply, and so does not have the continue or abort commands.] 2yz Positive Completion reply The requested action has been successfully completed. A new request may be initiated. 3yz Positive Intermediate reply The command has been accepted, but the requested action is being held in abeyance, pending receipt of further information. The sender-SMTP should send another command specifying this information. This reply is used in command sequence groups. 4yz Transient Negative Completion reply The command was not accepted and the requested action did not occur. However, the error condition is temporary and the action may be requested again. The sender should [Page 48] Postel RFC 821 August 1982 Simple Mail Transfer Protocol return to the beginning of the command sequence (if any). It is difficult to assign a meaning to "transient" when two different sites (receiver- and sender- SMTPs) must agree on the interpretation. Each reply in this category might have a different time value, but the sender-SMTP is encouraged to try again. A rule of thumb to determine if a reply fits into the 4yz or the 5yz category (see below) is that replies are 4yz if they can be repeated without any change in command form or in properties of the sender or receiver. (E.g., the command is repeated identically and the receiver does not put up a new implementation.) 5yz Permanent Negative Completion reply The command was not accepted and the requested action did not occur. The sender-SMTP is discouraged from repeating the exact request (in the same sequence). Even some "permanent" error conditions can be corrected, so the human user may want to direct the sender-SMTP to reinitiate the command sequence by direct action at some point in the future (e.g., after the spelling has been changed, or the user has altered the account status). The second digit encodes responses in specific categories: x0z Syntax -- These replies refer to syntax errors, syntactically correct commands that don't fit any functional category, and unimplemented or superfluous commands. x1z Information -- These are replies to requests for information, such as status or help. x2z Connections -- These are replies referring to the transmission channel. x3z Unspecified as yet. x4z Unspecified as yet. x5z Mail system -- These replies indicate the status of the receiver mail system vis-a-vis the requested transfer or other mail system action. The third digit gives a finer gradation of meaning in each category specified by the second digit. The list of replies Postel [Page 49] August 1982 RFC 821 Simple Mail Transfer Protocol illustrates this. Each reply text is recommended rather than mandatory, and may even change according to the command with which it is associated. On the other hand, the reply codes must strictly follow the specifications in this section. Receiver implementations should not invent new codes for slightly different situations from the ones described here, but rather adapt codes already defined. For example, a command such as NOOP whose successful execution does not offer the sender-SMTP any new information will return a 250 reply. The response is 502 when the command requests an unimplemented non-site-specific action. A refinement of that is the 504 reply for a command that is implemented, but that requests an unimplemented parameter. The reply text may be longer than a single line; in these cases the complete text must be marked so the sender-SMTP knows when it can stop reading the reply. This requires a special format to indicate a multiple line reply. The format for multiline replies requires that every line, except the last, begin with the reply code, followed immediately by a hyphen, "-" (also known as minus), followed by text. The last line will begin with the reply code, followed immediately by , optionally some text, and . For example: 123-First line 123-Second line 123-234 text beginning with numbers 123 The last line In many cases the sender-SMTP then simply needs to search for the reply code followed by at the beginning of a line, and ignore all preceding lines. In a few cases, there is important data for the sender in the reply "text". The sender will know these cases from the current context. [Page 50] Postel RFC 821 August 1982 Simple Mail Transfer Protocol APPENDIX F Scenarios This section presents complete scenarios of several types of SMTP sessions. A Typical SMTP Transaction Scenario This SMTP example shows mail sent by Smith at host USC-ISIF, to Jones, Green, and Brown at host BBN-UNIX. Here we assume that host USC-ISIF contacts host BBN-UNIX directly. The mail is accepted for Jones and Brown. Green does not have a mailbox at host BBN-UNIX. ------------------------------------------------------------- R: 220 BBN-UNIX.ARPA Simple Mail Transfer Service Ready S: HELO USC-ISIF.ARPA R: 250 BBN-UNIX.ARPA S: MAIL FROM: R: 250 OK S: RCPT TO: R: 250 OK S: RCPT TO: R: 550 No such user here S: RCPT TO: R: 250 OK S: DATA R: 354 Start mail input; end with . S: Blah blah blah... S: ...etc. etc. etc. S: . R: 250 OK S: QUIT R: 221 BBN-UNIX.ARPA Service closing transmission channel Scenario 1 ------------------------------------------------------------- Postel [Page 51] August 1982 RFC 821 Simple Mail Transfer Protocol Aborted SMTP Transaction Scenario ------------------------------------------------------------- R: 220 MIT-Multics.ARPA Simple Mail Transfer Service Ready S: HELO ISI-VAXA.ARPA R: 250 MIT-Multics.ARPA S: MAIL FROM: R: 250 OK S: RCPT TO: R: 250 OK S: RCPT TO: R: 550 No such user here S: RSET R: 250 OK S: QUIT R: 221 MIT-Multics.ARPA Service closing transmission channel Scenario 2 ------------------------------------------------------------- [Page 52] Postel RFC 821 August 1982 Simple Mail Transfer Protocol Relayed Mail Scenario ------------------------------------------------------------- Step 1 -- Source Host to Relay Host R: 220 USC-ISIE.ARPA Simple Mail Transfer Service Ready S: HELO MIT-AI.ARPA R: 250 USC-ISIE.ARPA S: MAIL FROM: R: 250 OK S: RCPT TO:<@USC-ISIE.ARPA:Jones@BBN-VAX.ARPA> R: 250 OK S: DATA R: 354 Start mail input; end with . S: Date: 2 Nov 81 22:33:44 S: From: John Q. Public S: Subject: The Next Meeting of the Board S: To: Jones@BBN-Vax.ARPA S: S: Bill: S: The next meeting of the board of directors will be S: on Tuesday. S: John. S: . R: 250 OK S: QUIT R: 221 USC-ISIE.ARPA Service closing transmission channel Postel [Page 53] August 1982 RFC 821 Simple Mail Transfer Protocol Step 2 -- Relay Host to Destination Host R: 220 BBN-VAX.ARPA Simple Mail Transfer Service Ready S: HELO USC-ISIE.ARPA R: 250 BBN-VAX.ARPA S: MAIL FROM:<@USC-ISIE.ARPA:JQP@MIT-AI.ARPA> R: 250 OK S: RCPT TO: R: 250 OK S: DATA R: 354 Start mail input; end with . S: Received: from MIT-AI.ARPA by USC-ISIE.ARPA ; 2 Nov 81 22:40:10 UT S: Date: 2 Nov 81 22:33:44 S: From: John Q. Public S: Subject: The Next Meeting of the Board S: To: Jones@BBN-Vax.ARPA S: S: Bill: S: The next meeting of the board of directors will be S: on Tuesday. S: John. S: . R: 250 OK S: QUIT R: 221 USC-ISIE.ARPA Service closing transmission channel Scenario 3 ------------------------------------------------------------- [Page 54] Postel RFC 821 August 1982 Simple Mail Transfer Protocol Verifying and Sending Scenario ------------------------------------------------------------- R: 220 SU-SCORE.ARPA Simple Mail Transfer Service Ready S: HELO MIT-MC.ARPA R: 250 SU-SCORE.ARPA S: VRFY Crispin R: 250 Mark Crispin S: SEND FROM: R: 250 OK S: RCPT TO: R: 250 OK S: DATA R: 354 Start mail input; end with . S: Blah blah blah... S: ...etc. etc. etc. S: . R: 250 OK S: QUIT R: 221 SU-SCORE.ARPA Service closing transmission channel Scenario 4 ------------------------------------------------------------- Postel [Page 55] August 1982 RFC 821 Simple Mail Transfer Protocol Sending and Mailing Scenarios First the user's name is verified, then an attempt is made to send to the user's terminal. When that fails, the messages is mailed to the user's mailbox. ------------------------------------------------------------- R: 220 SU-SCORE.ARPA Simple Mail Transfer Service Ready S: HELO MIT-MC.ARPA R: 250 SU-SCORE.ARPA S: VRFY Crispin R: 250 Mark Crispin S: SEND FROM: R: 250 OK S: RCPT TO: R: 450 User not active now S: RSET R: 250 OK S: MAIL FROM: R: 250 OK S: RCPT TO: R: 250 OK S: DATA R: 354 Start mail input; end with . S: Blah blah blah... S: ...etc. etc. etc. S: . R: 250 OK S: QUIT R: 221 SU-SCORE.ARPA Service closing transmission channel Scenario 5 ------------------------------------------------------------- [Page 56] Postel