← Back to branch summary

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

« back to all changes in this revision

Viewing changes to man/man5/header_checks.5

  • 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:
man/man5/header_checks.5
14
14
\fBnested_header_checks = pcre:/etc/postfix/nested_header_checks\fR
15
15
\fBbody_checks = pcre:/etc/postfix/body_checks\fR
16
16
.sp
 
17
\fBmilter_header_checks = pcre:/etc/postfix/milter_header_checks\fR
 
18
.sp
 
19
\fBsmtp_header_checks = pcre:/etc/postfix/smtp_header_checks\fR
 
20
\fBsmtp_mime_header_checks = pcre:/etc/postfix/smtp_mime_header_checks\fR
 
21
\fBsmtp_nested_header_checks = pcre:/etc/postfix/smtp_nested_header_checks\fR
 
22
\fBsmtp_body_checks = pcre:/etc/postfix/smtp_body_checks\fR
 
23
.sp
17
24
\fBpostmap -q "\fIstring\fB" pcre:/etc/postfix/\fIfilename\fR
18
25
\fBpostmap -q - pcre:/etc/postfix/\fIfilename\fR <\fIinputfile\fR
19
26
.fi
32
39
the matching process is repeated for the next message header or
33
40
message body line.
34
41
 
 
42
Note: message headers are examined one logical header at a time,
 
43
even when a message header spans multiple lines. Body lines are
 
44
always examined one line at a time.
 
45
 
35
46
For examples, see the EXAMPLES section at the end of this
36
47
manual page.
37
48
 
39
50
from worms or viruses; they do not decode attachments, and they do
40
51
not unzip archives. See the documents referenced below in the README
41
52
FILES section if you need more sophisticated content analysis.
42
 
 
43
 
Postfix supports four built-in content inspection classes:
44
 
.IP \fBheader_checks\fR
 
53
.SH "FILTERS WHILE RECEIVING MAIL"
 
54
.na
 
55
.nf
 
56
.ad
 
57
.fi
 
58
Postfix implements the following four built-in content
 
59
inspection classes while receiving mail:
 
60
.IP "\fBheader_checks\fR (default: empty)"
45
61
These are applied to initial message headers (except for
46
62
the headers that are processed with \fBmime_header_checks\fR).
47
63
.IP "\fBmime_header_checks\fR (default: \fB$header_checks\fR)"
60
76
.sp
61
77
With Postfix versions before 2.0, all content after the initial
62
78
message headers is treated as body content.
63
 
.PP
64
 
Note: message headers are examined one logical header at a time,
65
 
even when a message header spans multiple lines. Body lines are
66
 
always examined one line at a time.
 
79
.SH "FILTERS AFTER RECEIVING MAIL"
 
80
.na
 
81
.nf
 
82
.ad
 
83
.fi
 
84
Postfix supports a subset of the built-in content inspection
 
85
classes after the message is received:
 
86
.IP "\fBmilter_header_checks\fR (default: empty)"
 
87
These are applied to headers that are added with Milter
 
88
applications.
 
89
.sp
 
90
This feature is available in Postfix 2.7 and later.
 
91
.SH "FILTERS WHILE DELIVERING MAIL"
 
92
.na
 
93
.nf
 
94
.ad
 
95
.fi
 
96
Postfix supports all four content inspection classes while
 
97
delivering mail via SMTP.
 
98
.IP "\fBsmtp_header_checks\fR (default: empty)"
 
99
.IP "\fBsmtp_mime_header_checks\fR (default: empty)"
 
100
.IP "\fBsmtp_nested_header_checks\fR (default: empty)"
 
101
.IP "\fBsmtp_body_checks\fR (default: empty)"
 
102
These features are available in Postfix 2.5 and later.
67
103
.SH "COMPATIBILITY"
68
104
.na
69
105
.nf
159
195
use the transport(5) table to direct mail to the discard(8) service.
160
196
.sp
161
197
This feature is available in Postfix 2.0 and later.
 
198
.sp
 
199
This feature is not supported with smtp header/body checks.
162
200
.IP \fBDUNNO\fR
163
201
Pretend that the input line did not match any pattern, and inspect the
164
202
next input line. This action can be used to shorten the table search.
198
236
features.
199
237
.sp
200
238
This feature is available in Postfix 2.0 and later.
 
239
.sp
 
240
This feature is not supported with smtp header/body checks.
201
241
.IP "\fBHOLD \fIoptional text...\fR"
202
242
Arrange for the message to be placed on the \fBhold\fR queue,
203
243
and inspect the next input line.  The message remains on \fBhold\fR
217
257
Note: this action affects all recipients of the message.
218
258
.sp
219
259
This feature is available in Postfix 2.0 and later.
 
260
.sp
 
261
This feature is not supported with smtp header/body checks.
220
262
.IP \fBIGNORE\fR
221
263
Delete the current line from the input, and inspect
222
264
the next input line.
 
265
.IP "\fBINFO \fIoptional text...\fR
 
266
Log an "info:" record with the \fIoptional text...\fR (or
 
267
log a generic text), and inspect the next input line. This
 
268
action is useful for routine logging or for debugging.
 
269
.sp
 
270
This feature is available in Postfix 2.8 and later.
223
271
.IP "\fBPREPEND \fItext...\fR"
224
272
Prepend one line with the specified text, and inspect the next
225
273
input line.
242
290
.RE
243
291
.IP
244
292
This feature is available in Postfix 2.1 and later.
 
293
.sp
 
294
This feature is not supported with milter_header_checks.
245
295
.IP "\fBREDIRECT \fIuser@domain\fR"
246
296
Write a message redirection request to the queue file, and
247
297
inspect the next input line. After the message is queued,
253
303
fire, only the last one is executed.
254
304
.sp
255
305
This feature is available in Postfix 2.1 and later.
 
306
.sp
 
307
This feature is not supported with smtp header/body checks.
256
308
.IP "\fBREPLACE \fItext...\fR"
257
309
Replace the current line with the specified text, and inspect the next
258
310
input line.
283
335
When no code is specified at the beginning of \fIoptional
284
336
text...\fR, Postfix inserts a default enhanced status code of
285
337
"5.7.1".
 
338
.sp
 
339
This feature is not supported with smtp header/body checks.
286
340
.IP "\fBWARN \fIoptional text...\fR
287
 
Log a warning with the \fIoptional text...\fR (or log a
288
 
generic message), and inspect the next input line. This
 
341
Log a "warning:" record with the \fIoptional text...\fR (or
 
342
log a generic text), and inspect the next input line. This
289
343
action is useful for debugging and for testing a pattern
290
344
before applying more drastic actions.
291
345
.SH BUGS