summaryrefslogtreecommitdiff
path: root/gnu/dist/postfix/html/cleanup.8.html
blob: 01827927a484f0de2431406f382cc50178478aef (plain)
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
199
200
<html> <head> </head> <body> <pre>



CLEANUP(8)                                             CLEANUP(8)


<b>NAME</b>
       cleanup - canonicalize and enqueue Postfix message

<b>SYNOPSIS</b>
       <b>cleanup</b> [generic Postfix daemon options]

<b>DESCRIPTION</b>
       The <b>cleanup</b> daemon processes inbound mail, inserts it into
       the <b>incoming</b> mail queue, and informs the queue manager  of
       its arrival.

       The <b>cleanup</b> daemon always performs the following transfor-
       mations:

       <b>o</b>      Insert missing message  headers:  (<b>Resent-</b>)  <b>From:</b>,
              <b>To:</b>, <b>Message-Id:</b>, and <b>Date:</b>.

       <b>o</b>      Extract envelope recipient addresses from (<b>Resent-</b>)
              <b>To:</b>, <b>Cc:</b> and <b>Bcc:</b> message headers when  no  recipi-
              ents are specified in the message envelope.

       <b>o</b>      Transform  envelope  and  header  addresses  to the
              standard <i>user@fully-qualified-domain</i> form  that  is
              expected  by  other Postfix programs.  This task is
              delegated to the <a href="trivial-rewrite.8.html"><b>trivial-rewrite</b>(8)</a> daemon.

       <b>o</b>      Eliminate duplicate envelope recipient addresses.

       The following address transformations are optional:

       <b>o</b>      Optionally,  rewrite  all   envelope   and   header
              addresses  according  to  the mappings specified in
              the <a href="canonical.5.html"><b>canonical</b>(5)</a> lookup tables.

       <b>o</b>      Optionally, masquerade  envelope  sender  addresses
              and  message  header  addresses (i.e. strip host or
              domain information below all domains listed in  the
              <b>masquerade</b><i>_</i><b>domains</b> parameter, except for user names
              listed  in  <b>masquerade</b><i>_</i><b>exceptions</b>).   Address  mas-
              querading does not affect envelope recipients.

       <b>o</b>      Optionally, expand envelope recipients according to
              information found in the <a href="virtual.5.html"><b>virtual</b>(5)</a> lookup  tables.

       The  <b>cleanup</b>  daemon performs sanity checks on the content
       of each message. When it finds a problem,  by  default  it
       returns  a  diagnostic status to the client, and leaves it
       up to the client to deal with the problem.  Alternatively,
       the  client  can  request the <b>cleanup</b> daemon to bounce the
       message back to the sender in case of trouble.

<b>STANDARDS</b>
       <a href="http://www.faqs.org/rfcs/rfc822.html">RFC 822</a> (ARPA Internet Text Messages)




                                                                1





CLEANUP(8)                                             CLEANUP(8)


<b>DIAGNOSTICS</b>
       Problems and transactions are logged to <b>syslogd</b>(8).

<b>BUGS</b>
       Table-driven rewriting rules make it hard  to  express  <b>if</b>
       <b>then</b> <b>else</b> and other logical relationships.

<b>CONFIGURATION</b> <b>PARAMETERS</b>
       The  following  <b>main.cf</b> parameters are especially relevant
       to this program. See the Postfix <b>main.cf</b> file  for  syntax
       details  and  for  default  values. Use the <b>postfix</b> <b>reload</b>
       command after a configuration change.

<b>Content</b> <b>filtering</b>
       <b>body</b><i>_</i><b>checks</b>
              Lookup tables with content filters for message body
              lines.   These  filters see physical lines one at a
              time, in chunks of at most line_length_limit bytes.

       <b>header</b><i>_</i><b>checks</b>
              Lookup  tables  with  content  filters  for message
              header lines.  These filters  see  logical  headers
              one at a time, including headers that span multiple
              lines.

<b>Miscellaneous</b>
       <b>always</b><i>_</i><b>bcc</b>
              Address to send a copy of each message that  enters
              the system.

       <b>hopcount</b><i>_</i><b>limit</b>
              Limit the number of <b>Received:</b> message headers.

       <b>recipients</b><i>_</i><b>witheld</b><i>_</i><b>header</b>
              The header line that is inserted when no recipients
              were specified in (Resent-)To: or (Resent-)Cc: mes-
              sage headers.

<b>Address</b> <b>transformations</b>
       <b>empty</b><i>_</i><b>address</b><i>_</i><b>recipient</b>
              The  destination  for  undeliverable  mail from &lt;&gt;.
              This substitution is done before all other  address
              rewriting.

       <b>canonical</b><i>_</i><b>maps</b>
              Address mapping lookup table for sender and recipi-
              ent addresses in envelopes and headers.

       <b>recipient</b><i>_</i><b>canonical</b><i>_</i><b>maps</b>
              Address  mapping  lookup  table  for  envelope  and
              header recipient addresses.

       <b>sender</b><i>_</i><b>canonical</b><i>_</i><b>maps</b>
              Address  mapping  lookup  table  for  envelope  and



                                                                2





CLEANUP(8)                                             CLEANUP(8)


              header sender addresses.

       <b>masquerade</b><i>_</i><b>domains</b>
              List of domains that hide  their  subdomain  struc-
              ture.

       <b>masquerade</b><i>_</i><b>exceptions</b>
              List  of user names that are not subject to address
              masquerading.

       <b>virtual</b><i>_</i><b>maps</b>
              Address mapping lookup table for envelope recipient
              addresses.

<b>Resource</b> <b>controls</b>
       <b>duplicate</b><i>_</i><b>filter</b><i>_</i><b>limit</b>
              Limit  the  number  of envelope recipients that are
              remembered.

       <b>header</b><i>_</i><b>size</b><i>_</i><b>limit</b>
              Limit the amount of memory in bytes used to process
              a message header.

<b>SEE</b> <b>ALSO</b>
       <a href="canonical.5.html">canonical(5)</a> canonical address lookup table format
       <a href="qmgr.8.html">qmgr(8)</a> queue manager daemon
       syslogd(8) system logging
       <a href="trivial-rewrite.8.html">trivial-rewrite(8)</a> address rewriting
       <a href="virtual.5.html">virtual(5)</a> virtual address lookup table format

<b>FILES</b>
       /etc/postfix/canonical*, canonical mapping table
       /etc/postfix/virtual*, virtual mapping table

<b>LICENSE</b>
       The  Secure  Mailer  license must be distributed with this
       software.

<b>AUTHOR(S)</b>
       Wietse Venema
       IBM T.J. Watson Research
       P.O. Box 704
       Yorktown Heights, NY 10598, USA














                                                                3


</pre> </body> </html>