~ubuntu-branches/ubuntu/saucy/postfix/saucy

« back to all changes in this revision

Viewing changes to proto/header_checks

  • Committer: Bazaar Package Importer
  • Author(s): LaMont Jones
  • Date: 2011-02-22 11:20:43 UTC
  • mfrom: (1.1.27 upstream)
  • Revision ID: james.westby@ubuntu.com-20110222112043-c34ht219w3ybrilr
Tags: 2.8.0-2
* a little more lintian cleanup
* Fix missing format strings in smtp-sink.c

Show diffs side-by-side

added added

removed removed

Lines of Context:
10
10
#       \fBnested_header_checks = pcre:/etc/postfix/nested_header_checks\fR
11
11
#       \fBbody_checks = pcre:/etc/postfix/body_checks\fR
12
12
# .sp
 
13
#       \fBmilter_header_checks = pcre:/etc/postfix/milter_header_checks\fR
 
14
# .sp
 
15
#       \fBsmtp_header_checks = pcre:/etc/postfix/smtp_header_checks\fR
 
16
#       \fBsmtp_mime_header_checks = pcre:/etc/postfix/smtp_mime_header_checks\fR
 
17
#       \fBsmtp_nested_header_checks = pcre:/etc/postfix/smtp_nested_header_checks\fR
 
18
#       \fBsmtp_body_checks = pcre:/etc/postfix/smtp_body_checks\fR
 
19
# .sp
13
20
#       \fBpostmap -q "\fIstring\fB" pcre:/etc/postfix/\fIfilename\fR
14
21
#       \fBpostmap -q - pcre:/etc/postfix/\fIfilename\fR <\fIinputfile\fR
15
22
# .fi
26
33
#       the matching process is repeated for the next message header or
27
34
#       message body line.
28
35
#
 
36
#       Note: message headers are examined one logical header at a time,
 
37
#       even when a message header spans multiple lines. Body lines are
 
38
#       always examined one line at a time.
 
39
#
29
40
#       For examples, see the EXAMPLES section at the end of this
30
41
#       manual page.
31
42
#
33
44
#       from worms or viruses; they do not decode attachments, and they do
34
45
#       not unzip archives. See the documents referenced below in the README
35
46
#       FILES section if you need more sophisticated content analysis.
36
 
#
37
 
#       Postfix supports four built-in content inspection classes:
38
 
# .IP \fBheader_checks\fR
 
47
# FILTERS WHILE RECEIVING MAIL
 
48
# .ad
 
49
# .fi
 
50
#       Postfix implements the following four built-in content
 
51
#       inspection classes while receiving mail:
 
52
# .IP "\fBheader_checks\fR (default: empty)"
39
53
#       These are applied to initial message headers (except for
40
54
#       the headers that are processed with \fBmime_header_checks\fR).
41
55
# .IP "\fBmime_header_checks\fR (default: \fB$header_checks\fR)"
54
68
# .sp
55
69
#       With Postfix versions before 2.0, all content after the initial
56
70
#       message headers is treated as body content.
57
 
# .PP
58
 
#       Note: message headers are examined one logical header at a time,
59
 
#       even when a message header spans multiple lines. Body lines are
60
 
#       always examined one line at a time.
 
71
# FILTERS AFTER RECEIVING MAIL
 
72
# .ad
 
73
# .fi
 
74
#       Postfix supports a subset of the built-in content inspection
 
75
#       classes after the message is received:
 
76
# .IP "\fBmilter_header_checks\fR (default: empty)"
 
77
#       These are applied to headers that are added with Milter
 
78
#       applications.
 
79
# .sp
 
80
#       This feature is available in Postfix 2.7 and later.
 
81
# FILTERS WHILE DELIVERING MAIL
 
82
# .ad
 
83
# .fi
 
84
#       Postfix supports all four content inspection classes while
 
85
#       delivering mail via SMTP.
 
86
# .IP "\fBsmtp_header_checks\fR (default: empty)"
 
87
# .IP "\fBsmtp_mime_header_checks\fR (default: empty)"
 
88
# .IP "\fBsmtp_nested_header_checks\fR (default: empty)"
 
89
# .IP "\fBsmtp_body_checks\fR (default: empty)"
 
90
#       These features are available in Postfix 2.5 and later.
61
91
# COMPATIBILITY
62
92
# .ad
63
93
# .fi
170
200
#       use the transport(5) table to direct mail to the discard(8) service.
171
201
# .sp
172
202
#       This feature is available in Postfix 2.0 and later.
 
203
# .sp
 
204
#       This feature is not supported with smtp header/body checks.
173
205
# .IP \fBDUNNO\fR
174
206
#       Pretend that the input line did not match any pattern, and inspect the
175
207
#       next input line. This action can be used to shorten the table search.
209
241
#       features.
210
242
# .sp
211
243
#       This feature is available in Postfix 2.0 and later.
 
244
# .sp
 
245
#       This feature is not supported with smtp header/body checks.
212
246
# .IP "\fBHOLD \fIoptional text...\fR"
213
247
#       Arrange for the message to be placed on the \fBhold\fR queue,
214
248
#       and inspect the next input line.  The message remains on \fBhold\fR
228
262
#       Note: this action affects all recipients of the message.
229
263
# .sp
230
264
#       This feature is available in Postfix 2.0 and later.
 
265
# .sp
 
266
#       This feature is not supported with smtp header/body checks.
231
267
# .IP \fBIGNORE\fR
232
268
#       Delete the current line from the input, and inspect
233
269
#       the next input line.
 
270
# .IP "\fBINFO \fIoptional text...\fR
 
271
#       Log an "info:" record with the \fIoptional text...\fR (or
 
272
#       log a generic text), and inspect the next input line. This
 
273
#       action is useful for routine logging or for debugging.
 
274
# .sp
 
275
#       This feature is available in Postfix 2.8 and later.
234
276
# .IP "\fBPREPEND \fItext...\fR"
235
277
#       Prepend one line with the specified text, and inspect the next
236
278
#       input line.
253
295
# .RE
254
296
# .IP
255
297
#       This feature is available in Postfix 2.1 and later.
 
298
# .sp
 
299
#       This feature is not supported with milter_header_checks.
256
300
# .IP "\fBREDIRECT \fIuser@domain\fR"
257
301
#       Write a message redirection request to the queue file, and
258
302
#       inspect the next input line. After the message is queued,
264
308
#       fire, only the last one is executed.
265
309
# .sp
266
310
#       This feature is available in Postfix 2.1 and later.
 
311
# .sp
 
312
#       This feature is not supported with smtp header/body checks.
267
313
# .IP "\fBREPLACE \fItext...\fR"
268
314
#       Replace the current line with the specified text, and inspect the next
269
315
#       input line.
294
340
#       When no code is specified at the beginning of \fIoptional
295
341
#       text...\fR, Postfix inserts a default enhanced status code of
296
342
#       "5.7.1".
 
343
# .sp
 
344
#       This feature is not supported with smtp header/body checks.
297
345
# .IP "\fBWARN \fIoptional text...\fR
298
 
#       Log a warning with the \fIoptional text...\fR (or log a
299
 
#       generic message), and inspect the next input line. This
 
346
#       Log a "warning:" record with the \fIoptional text...\fR (or
 
347
#       log a generic text), and inspect the next input line. This
300
348
#       action is useful for debugging and for testing a pattern
301
349
#       before applying more drastic actions.
302
350
# BUGS