Network Working Group Keith Moore Internet Draft University of Tennessee Expires: 20 July 1995 Greg Vaudreuil Octel Network Services 20 January 1995 An Extensible Message Format for Delivery Status Notifications draft-ietf-notary-mime-delivery-04.txt Status of this Memo This document is an Internet-Draft. Internet-Drafts are working documents of the Internet Engineering Task Force (IETF), its areas, and its working groups. Note that other groups may also distribute working documents as Internet-Drafts. Internet-Drafts are draft documents valid for a maximum of six months and may be updated, replaced, or obsoleted by other documents at any time. It is inappropriate to use Internet-Drafts as reference material or to cite them other than as ``work in progress.'' To learn the current status of any Internet-Draft, please check the ``1id-abstracts.txt'' listing contained in the Internet- Drafts Shadow Directories on ftp.is.co.za (Africa), nic.nordu.net (Europe), munnari.oz.au (Pacific Rim), ds.internic.net (US East Coast), or ftp.isi.edu (US West Coast). Abstract This memo defines a MIME content-type that may be used by a message transfer agent (MTA) or electronic mail gateway to report the result of an attempt to deliver a message to one or more recipients. This content-type is intended as a machine-processable replacement for the various types of delivery status notifications currently used in Internet electronic mail. Because many messages are sent between the Internet and other messaging systems (such as X.400 or the so-called "LAN-based" systems), the DSN protocol is designed to be useful in a multi-protocol messaging environment. To this end, the protocol described in this memo provides for the carriage of "foreign" addresses and error codes, in addition to those normally used in Internet mail. Additional attributes may also be defined to support "tunneling" of foreign notifications through Internet mail. Moore/Vaudreuil Expires 20 July 1995 [Page 1] Delivery Status Notifications 20 January 1995 1. Introduction This memo defines a MIME [1] content-type for delivery status notifications (DSNs). A DSN can be used to notify the sender of a message of any of several conditions: failed delivery, delayed delivery, successful delivery, or the gatewaying of a message into an environment that may not support DSNs. The "message/delivery-status" content-type defined herein is intended for use within the framework of the "multipart/report" content type defined in [2]. This memo defines only the format of the notifications. An extension to the Simple Message Transfer Protocol (SMTP) [3] to fully support such notifications is the subject of a separate memo [4]. 1.1. Purposes The DSNs defined in this memo are expected to serve several purposes: + Inform human beings of the status of message delivery processing, as well as the reasons for any delivery problems or outright failures, in a manner which is largely language-independent; + Allow mail user agents to keep track of the delivery status of messages sent, by associating returned DSNs with earlier message transmissions; + Allow mailing list expanders to automatically maintain their subscriber lists when delivery attempts repeatedly fail; + Convey delivery and non-delivery notifications resulting from attempts to deliver messages to "foreign" mail systems via a gateway; + Allow "foreign" notifications to be tunneled through a MIME-capable message system and back into the original messaging system that issued the original notification, or even to a third messaging system; + Allow language-independent, yet reasonably precise, indications of the reason for the failure of a message to be delivered (once status codes of sufficient precision are defined); and + Provide sufficient information to remote MTA maintainers (via "trouble tickets") so that they can understand the nature of reported errors. This feature is used in the case that failure to deliver a message is due to the malfunction of a remote MTA and the sender wants to report the problem to the remote MTA administrator. Moore/Vaudreuil Expires 20 July 1995 [Page 2] Delivery Status Notifications 20 January 1995 1.2. Requirements These purposes place the following constraints on the notification protocol: + It must be readable by humans as well as being machine-parsable. + It must provide enough information to allow message senders (or the user agents) to unambiguously associate a DSN with the message that was sent and the original recipient address for which the DSN is issued (if such information is available), even if the message was forwarded to another recipient address. + It must be able to preserve the reason for the success or failure of a delivery attempt in a remote messaging system, using the "language" (mailbox addresses and status codes) of that remote system. + It must also be able to describe the reason for the success or failure of a delivery attempt, independent of any particular human language or of the "language" of any particular mail system. + It must preserve enough information to allow the maintainer of a remote MTA to understand (and if possible, reproduce) the conditions that caused a delivery failure at that MTA. + For any notifications issued by foreign mail systems, which are translated by a mail gateway to the DSN format, the DSN must preserve the "type" of the foreign addresses and error codes, so that these may be correctly interpreted by gateways. A DSN contains a set of per-message fields which identify the message and the transaction during which the message was submitted, along with other fields that apply to all delivery attempts described by the DSN. The DSN also includes a set of per-recipient fields to convey the result of the attempt to deliver the message to each of one or more recipients. 1.3. Terminology A message may be transmitted through several message transfer agents (MTAs) on its way to a recipient. For a variety of reasons, recipient addresses may be rewritten during this process, so each MTA may potentially see a different recipient address. Depending on the purpose for which a DSN is used, different formats of a particular recipient address will be needed. Several DSN fields are defined in terms of the view from a particular MTA in the transmission. The MTAs are assigned the following names: Moore/Vaudreuil Expires 20 July 1995 [Page 3] Delivery Status Notifications 20 January 1995 a. Original MTA The Original MTA is the one to which the message is submitted for delivery by the sender of the message. Note: Each time a message is re-sent to a completely different set of recipients (say to the subscribers of a mailing list), the Original MTA for the new recipients of that message is the one to which the message is initially submitted for delivery to the new list of recipients. b. Reporting MTA For any DSN, the Reporting MTA is the one which is reporting the results of delivery attempts described in the DSN. If the delivery attempts described occurred in a "foreign" (non- Internet) mail system, and the DSN was produced by translating the foreign notice into DSN format, the Reporting MTA will still identify the "foreign" MTA where the delivery attempts occurred. c. Preceding MTA The Preceding MTA is the MTA from which the Reporting MTA received the message, and accepted responsibility for delivery of the message. d. Remote MTA If an MTA determines that it must relay a message to one or more recipients, but the message cannot be transferred to its "next hop" MTA, or if the "next hop" MTA refuses to accept responsibility for delivery of the message to one or more of its intended recipients, the relaying MTA may need to issue a DSN on behalf of the recipients for whom the message cannot be delivered. In this case the relaying MTA is the Reporting MTA, and the "next hop" MTA is known as the Remote MTA. Figure 1 illustrates the relationship between the various MTAs: +-----+ +--------+ +---------+ +---------+ +------+ | | => |Original| => ... => |Preceding| => |Reporting| ===> |Remote| | user| | MTA | | MTA | | MTA | Message-Id: <199407072116.RAA14128@CS.UTK.EDU> Subject: Returned mail: Cannot send message for 5 days To: MIME-Version: 1.0 Content-Type: multipart/report; report-type=delivery-status; boundary="RAA14128.773615765/CS.UTK.EDU" --RAA14128.773615765/CS.UTK.EDU The original message was received at Sat, 2 Jul 1994 17:10:28 -0400 from root@localhost ----- The following addresses had delivery problems ----- (unrecoverable error) ----- Transcript of session follows ----- ... Deferred: Connection timed out with larry.slip.umd.edu. Message could not be delivered for 5 days Message will be deleted from queue --RAA14128.773615765/CS.UTK.EDU content-type: message/delivery-status Final-MTA: dns; cs.utk.edu Original-Recipient: rfc822; louisl@larry.slip.umd.edu Final-Recipient: rfc822; louisl@larry.slip.umd.edu Action: failure Status: 4.0.0 Diagnostic-Code: smtp; 426 (connection timed out) Last-Attempt-Date: Thu, 7 Jul 1994 17:15:49 -0400 --RAA14128.773615765/CS.UTK.EDU content-type: message/rfc822 [original message goes here] --RAA14128.773615765/CS.UTK.EDU-- Moore/Vaudreuil Expires 20 July 1995 [Page 29] Delivery Status Notifications 20 January 1995 11.2 This is another DSN issued by the sender's MTA, which contains details of multiple delivery attempts. Some of these were detected locally, and others by a remote MTA. Date: Fri, 8 Jul 1994 09:21:47 -0400 From: Mail Delivery Subsystem Subject: Returned mail: User unknown To: MIME-Version: 1.0 Content-Type: multipart/report; report-type=delivery-status; boundary="JAA13167.773673707/CS.UTK.EDU" --JAA13167.773673707/CS.UTK.EDU content-type: text/plain; charset=us-ascii ----- The following addresses had delivery problems ----- (unrecoverable error) (unrecoverable error) --JAA13167.773673707/CS.UTK.EDU content-type: message/delivery-status Final-MTA: dns; cs.utk.edu Original-Recipient: rfc822 ; arathib@vnet.ibm.com Final-Recipient: rfc822 ; arathib@vnet.ibm.com Action: failure Status: 5.0.0 (permanent failure) Diagnostic-Code: smtp; 550 ('arathib@vnet.IBM.COM' is not a registered gateway user) Remote-MTA: dns; vnet.ibm.com Original-Recipient: rfc822; johnh@hpnjld.njd.hp.com Final-Recipient: rfc822; johnh@hpnjld.njd.hp.com Action: delayed Status: 4.0.0 (hpnjld.njd.jp.com: host name lookup failure) Original-Recipient: rfc822; wsnell@sdcc13.ucsd.edu Final-Recipient: rfc822; wsnell@sdcc13.ucsd.edu Action: failure Status: 5.0.0 Diagnostic-Code: smtp; 550 (user unknown) Remote-MTA: dns; sdcc13.ucsd.edu --JAA13167.773673707/CS.UTK.EDU content-type: message/rfc822 [original message goes here] --JAA13167.773673707/CS.UTK.EDU-- Moore/Vaudreuil Expires 20 July 1995 [Page 30] Delivery Status Notifications 20 January 1995 11.3 A delivery report generated by Message Router (MAILBUS) and gatewayed by PMDF_MR to a DSN. In this case the gateway did not have sufficient information to supply an original-recipient address. Disclose-recipients: prohibited Date: Fri, 08 Jul 1994 09:21:25 -0400 (EDT) From: Message Router Submission Agent Subject: Status of : Re: Battery current sense To: owner-ups-mib@CS.UTK.EDU Message-id: <01HEGJ0WNBY28Y95LN@mr.timeplex.com> MIME-version: 1.0 content-type: multipart/report; report-type=delivery-status; boundary="[;84229080704991/122306@SYS30]" --[;84229080704991/122306@SYS30] content-type: text/plain Invalid address - nair_s %DIR-E-NODIRMTCH, No matching Directory Entry found --[;84229080704991/122306@SYS30] content-type: message/delivery-status Final-MTA: mailbus; SYS30 Final-Recipient: unknown; nair_s Status: 5.0.0 (unknown permanent failure) Action: failure --[;84229080704991/122306@SYS30]-- Moore/Vaudreuil Expires 20 July 1995 [Page 31] Delivery Status Notifications 20 January 1995 11.4 A delay report from a multiprotocol MTA. Note that there is no returned content, so no third body part appears in the DSN. From: Message-Id: <199407092338.TAA23293@CS.UTK.EDU> Received: from nsfnet-relay.ac.uk by sun2.nsfnet-relay.ac.uk id ; Sun, 10 Jul 1994 00:36:51 +0100 To: owner-info-mime@cs.utk.edu Date: Sun, 10 Jul 1994 00:36:51 +0100 Subject: WARNING: message delayed at "nsfnet-relay.ac.uk" content-type: multipart/report; report-type=delivery-status; boundary=foobar --foobar content-type: text/plain The following message: UA-ID: Reliable PC (... Q-ID: sun2.nsf:77/msg.11820-0 has not been delivered to the intended recipient: thomas@de-montfort.ac.uk despite repeated delivery attempts over the past 24 hours. The usual cause of this problem is that the remote system is temporarily unavailable. Delivery will continue to be attempted up to a total elapsed time of 168 hours, ie 7 days. You will be informed if delivery proves to be impossible within this time. Please quote the Q-ID in any queries regarding this mail. --foobar content-type: message/delivery-status Final-MTA: dns; sun2.nsfnet-relay.ac.uk Final-Recipient: rfc822; thomas@de-montfort.ac.uk Status: 4.0.0 (unknown temporary failure) Action: delayed --foobar-- Moore/Vaudreuil Expires 20 July 1995 [Page 32] Delivery Status Notifications 20 January 1995 11.5 A DSN gatewayed from a X.400 nondelivery notification From: "UK.AC.NSF MTA" To: na-digest-bounces@netlib2.cs.utk.edu Subject: Delivery Report (failure) for sdz009@prime.napier.ac.uk Date: Mon, 11 Jul 1994 02:09:43 +0100 Message-ID: <"sun3.nsfne.309:11.06.94.01.09.27"@nsfnet-relay.ac.uk> content-type: multipart/report; report-type=delivery-status; boundary=foobar --foobar content-type: text/plain This report relates to your message: Subject: NA Digest, V. 94, # 27, Message-ID: <199407031824.OAA23971@localhost>, To: na-digest list:; of Sun, 3 Jul 1994 19:47:56 +0100 Your message was not delivered to sdz009@prime.napier.ac.uk for the following reason: Message timed out --foobar content-type: message/delivery-status Final-MTA: dns; sun3.nsfnet-relay.ac.uk (in /PRMD=uk.ac/ADMD= /C=gb/) Original-Recipient: rfc822; sdz009@prime.napier.ac.uk Final-Recipient: x400; /S=sdz009/OU=prime/O=napier/PRMD=UK.AC/ADMD=+20/C=GB/ Action: failure Status: 4.0.0 Diagnostic-Code: x400 ; 1/5 (unable-to-transfer/maximum-time-expired) X400-Subject-Intermediate-Trace-Information: /PRMD=uk.ac/ADMD= /C=gb/ arrival Sun, 3 Jul 1994 19:47:56 +0100 action Relayed X400-Subject-Intermediate-Trace-Information: /PRMD=uk.ac/ADMD= /C=gb/ arrival Sun, 3 Jul 1994 19:24:03 +0100 action Relayed --foobar content-type: message/rfc822 [returned content] --foobar-- Moore/Vaudreuil Expires 20 July 1995 [Page 33]