1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
|
#ifndef _REC_TYPE_H_INCLUDED_
#define _REC_TYPE_H_INCLUDED_
/*++
/* NAME
/* rec_type 3h
/* SUMMARY
/* Postfix record types
/* SYNOPSIS
/* #include <rec_type.h>
/* DESCRIPTION
/* .nf
/*
* System library.
*/
#include <ctype.h>
#include <stdlib.h>
/*
* Diagnostic codes, not real record lookup results.
*/
#define REC_TYPE_EOF -1 /* no record */
#define REC_TYPE_ERROR -2 /* bad record */
/*
* A queue file or IPC mail message consists of a sequence of typed records.
* The first record group contains time stamp, full name, sender envelope
* information, and optionally contains recipient information. The second
* record group contains data records with the message content. The last
* record group is optional; it contains information extracted from message
* headers, such as recipients, errors-to and return-receipt.
*
* Note: REC_TYPE_FILT and REC_TYPE_CONT are encoded with the same 'L'
* constant, and it is too late to change that now.
*/
#define REC_TYPE_SIZE 'C' /* first record, created by cleanup */
#define REC_TYPE_TIME 'T' /* arrival time, required */
#define REC_TYPE_CTIME 'c' /* create time, optional */
#define REC_TYPE_FULL 'F' /* full name, optional */
#define REC_TYPE_INSP 'I' /* inspector transport */
#define REC_TYPE_FILT 'L' /* loop filter transport */
#define REC_TYPE_FROM 'S' /* sender, required */
#define REC_TYPE_DONE 'D' /* delivered recipient, optional */
#define REC_TYPE_RCPT 'R' /* todo recipient, optional */
#define REC_TYPE_ORCP 'O' /* original recipient, optional */
#define REC_TYPE_DRCP '/' /* canceled recipient, optional */
#define REC_TYPE_WARN 'W' /* warning message time */
#define REC_TYPE_ATTR 'A' /* named attribute for extensions */
#define REC_TYPE_KILL 'K' /* killed record */
#define REC_TYPE_RDR '>' /* redirect target */
#define REC_TYPE_FLGS 'f' /* cleanup processing flags */
#define REC_TYPE_DELAY 'd' /* cleanup delay upon arrival */
#define REC_TYPE_MESG 'M' /* start message records */
#define REC_TYPE_CONT 'L' /* long data record */
#define REC_TYPE_NORM 'N' /* normal data record */
#define REC_TYPE_DTXT 'w' /* padding (was: deleted data) */
#define REC_TYPE_XTRA 'X' /* start extracted records */
#define REC_TYPE_RRTO 'r' /* return-receipt, from headers */
#define REC_TYPE_ERTO 'e' /* errors-to, from headers */
#define REC_TYPE_PRIO 'P' /* priority */
#define REC_TYPE_PTR 'p' /* pointer indirection */
#define REC_TYPE_VERP 'V' /* VERP delimiters */
#define REC_TYPE_DSN_RET '<' /* DSN full/hdrs */
#define REC_TYPE_DSN_ENVID 'i' /* DSN envelope id */
#define REC_TYPE_DSN_ORCPT 'o' /* DSN orig rcpt address */
#define REC_TYPE_DSN_NOTIFY 'n' /* DSN notify flags */
#define REC_TYPE_MILT_COUNT 'm'
#define REC_TYPE_END 'E' /* terminator, required */
/*
* What I expect to see in a "pure recipient" sequence at the end of the
* initial or extracted envelope segments, respectively. When a queue file
* contains pure recipient sequences only, then the queue manager will not
* have to read all the queue file records before starting delivery. This is
* often the case with list mail, where such optimization is desirable.
*
* XXX These definitions include the respective segment terminators to avoid
* special cases in the cleanup(8) envelope and extracted record processors.
*/
#define REC_TYPE_ENV_RECIPIENT "MDRO/Kon"
#define REC_TYPE_EXT_RECIPIENT "EDRO/Kon"
/*
* The types of records that I expect to see while processing different
* record groups. The first member in each set is the record type that
* indicates the end of that record group.
*
* XXX A records in the extracted segment are generated only by the cleanup
* server, and are not supposed to be present in locally submitted mail, as
* this is "postfix internal" information. However, the pickup server has to
* allow for the presence of A records in the extracted segment, because it
* can be requested to re-process already queued mail with `postsuper -r'.
*
* Note: REC_TYPE_FILT and REC_TYPE_CONT are encoded with the same 'L'
* constant, and it is too late to change that now.
*/
#define REC_TYPE_ENVELOPE "MCTcFILSDRO/WVA>K<ion"
#define REC_TYPE_CONTENT "XLNw"
#define REC_TYPE_EXTRACT "EDRO/PreAFIL>Kon"
/*
* The subset of inputs that the postdrop command allows.
*/
#define REC_TYPE_POST_ENVELOPE "MFSRVAin"
#define REC_TYPE_POST_CONTENT "XLN"
#define REC_TYPE_POST_EXTRACT "EAR"
/*
* The record at the start of the queue file specifies the message content
* size (number of bytes between the REC_TYPE_MESG and REC_TYPE_XTRA meta
* records), data offset (offset of the first REC_TYPE_NORM or REC_TYPE_CONT
* text record), recipient count, and queue manager hints. These are all
* fixed-width fields so they can be updated in place. Queue manager hints
* are defined in qmgr_user.h
*
* See also: REC_TYPE_PTR_FORMAT below.
*/
#define REC_TYPE_SIZE_FORMAT "%15ld %15ld %15ld %15ld %15ld %15ld"
#define REC_TYPE_SIZE_CAST1 long /* Vmailer extra offs - data offs */
#define REC_TYPE_SIZE_CAST2 long /* Postfix 1.0 data offset */
#define REC_TYPE_SIZE_CAST3 long /* Postfix 1.0 recipient count */
#define REC_TYPE_SIZE_CAST4 long /* Postfix 2.1 qmgr flags */
#define REC_TYPE_SIZE_CAST5 long /* Postfix 2.4 content length */
#define REC_TYPE_SIZE_CAST6 long /* Postfix 3.0 smtputf8 flags */
/*
* The warn record specifies when the next warning that the message was
* deferred should be sent. It is updated in place by qmgr, so changing
* this value when there are deferred messages in the queue is dangerous!
*/
#define REC_TYPE_WARN_FORMAT "%15ld" /* warning time format */
#define REC_TYPE_WARN_ARG(tv) ((long) (tv))
#define REC_TYPE_WARN_SCAN(cp, tv) ((tv) = atol(cp))
/*
* Time information is not updated in place, but it does have complex
* formatting requirements, so we centralize things here.
*/
#define REC_TYPE_TIME_FORMAT "%ld %ld"
#define REC_TYPE_TIME_ARG(tv) (long) (tv).tv_sec, (long) (tv).tv_usec
#define REC_TYPE_TIME_SCAN(cp, tv) \
do { \
const char *_p = cp; \
(tv).tv_sec = atol(_p); \
while (ISDIGIT(*_p)) \
_p++; \
(tv).tv_usec = atol(_p); \
} while (0)
/*
* Pointer records are used to edit a queue file in place before it is
* committed. When a record is appended or modified, we patch it into the
* existing record stream with a pointer to storage in a heap after the
* end-of-message marker; the new content is followed by a pointer record
* back to the existing record stream.
*
* We need to have a few dummy pointer records in place at strategic places
* (after the last recipient, after the last header) so that we can always
* append recipients or append/modify headers without having to move message
* segment terminators.
*
* We also need to have a dummy PTR record at the end of the content, so that
* we can always replace the message content without having to move the
* end-of-message marker.
*
* A dummy PTR record has a null argument.
*
* See also: REC_TYPE_SIZE_FORMAT above.
*/
#define REC_TYPE_PTR_FORMAT "%15ld"
#define REC_TYPE_PTR_PAYL_SIZE 15 /* Payload only, excludes record header. */
/*
* Programmatic interface.
*/
extern const char *rec_type_name(int);
/* LICENSE
/* .ad
/* .fi
/* The Secure Mailer license must be distributed with this software.
/* AUTHOR(S)
/* Wietse Venema
/* IBM T.J. Watson Research
/* P.O. Box 704
/* Yorktown Heights, NY 10598, USA
/*--*/
#endif
|
