1 Description of the custom MIME type "application/x-citadel-delivery-list"
3 This MIME type may be found in the outbound queue room on Citadel systems,
4 which is typically called "__CitadelSMTPspoolout__". The room is flagged as
5 private, but we will eventually hide it even to Aides.
7 Messages in this format contain delivery instructions. Therefore, for each
8 message in the queue to be delivered to one or more recipients, there will be
9 *two* messages in the room: one containing the actual message, and the other
10 containing delivery instructions. It is expected that the instructions
11 message may be replaced at any time (using an Extended ID field) if delivery
12 to only some of the recipients has been accomplished.
14 Citadel keeps reference counts of each message on disk. Therefore if a
15 message contains a mixture of local and remote recipients, there may be two
16 or more references to the message itself, one of them being the one in the
19 A delivery list contains one or more lines of text, each line containing
20 a single instruction (usually a recipient). Fields are separated by the
21 vertical bar character ("|") and there will always be at least one field on
29 Defines the actual message for which we are providing delivery
30 instructions. This instruction must precede all the others. When
31 all deliveries have either succeeded or failed, both the instructions and
32 the copy of the message itself in the queue room should be deleted. The
33 second parameter specifies the message ID in the local database.
36 INSTRUCTION: submitted
37 SYNTAX: submitted|999999999
39 Contains a timestamp designating when this message was first entered into
43 INSTRUCTION: attempted
44 SYNTAX: attempted|999999999
46 Contains a timestamp designating the date/time of the last delivery
53 Citadel does not retry SMTP delivery at a fixed interval. Instead, it
54 starts at a nominal interval (15 minutes by default) and then doubles the
55 interval after each failed attempt. This instruction contains the interval
56 which should currently be followed (and doubled again, if the next delivery
61 SYNTAX: bounceto|Big Bad Sender[@host]
63 Where to send "bounce" messages (delivery status notifications). The
64 contents of the second field are supplied as the "recipient" field to
65 CtdlSaveMsg(), and therefore may be a local username, a user on another
66 Citadel, or an Internet e-mail address.
70 SYNTAX: local|Friko Mumjiboolean|0
72 Indicates the name of a recipient on the local system to which the
73 message must be delivered. Almost never seen because most code delivers
80 Indicates the name of a room on the local system to which the message
81 must be copied. Same implications as 'local'.
85 SYNTAX: remote|friko@mumjiboolean.com|0|delivery status message
87 Names a recipient on a remote system to which the message should be
88 delivered. The third parameter may contain any of the following values:
89 0 = No delivery has yet been attempted
90 2 = Delivery was successful
91 4 = A transient error was experienced ... try again later
92 5 = Delivery to this address failed permanently. The error message
93 should be placed in the fourth field so that a bounce message may
98 SYNTAX: ignet|uncnsrd|Lobby|0|delivery status message
100 Names a room on another Citadel node to which this message needs to be
101 spooled over the network.