~ubuntu-branches/ubuntu/trusty/postfix/trusty-updates

« back to all changes in this revision

Viewing changes to html/sendmail.1.html

  • Committer: Package Import Robot
  • Author(s): LaMont Jones, LaMont Jones, localization folks
  • Date: 2014-02-11 07:44:30 UTC
  • mfrom: (58.1.1 sid)
  • Revision ID: package-import@ubuntu.com-20140211074430-kwkoxdz0fbajn0fj
Tags: 2.11.0-1
[LaMont Jones]

* New upstream release: 2.11.0

[localization folks]

* l10n: Updated German translations.  Closes: #734893 (Helge Kreutzmann)

Show diffs side-by-side

added added

removed removed

Lines of Context:
19
19
       <b>sendmail -I</b>
20
20
 
21
21
<b>DESCRIPTION</b>
22
 
       The  Postfix <a href="sendmail.1.html"><b>sendmail</b>(1)</a> command implements the Postfix to
23
 
       Sendmail compatibility interface.  For the sake of compat-
24
 
       ibility with existing applications, some Sendmail command-
25
 
       line options are recognized but silently ignored.
26
 
 
27
 
       By default, Postfix <a href="sendmail.1.html"><b>sendmail</b>(1)</a> reads a message from stan-
28
 
       dard  input until EOF or until it reads a line with only a
29
 
       <b>.</b> character, and arranges  for  delivery.   Postfix  <a href="sendmail.1.html"><b>send-</b></a>
30
 
       <a href="sendmail.1.html"><b>mail</b>(1)</a>  relies  on  the  <a href="postdrop.1.html"><b>postdrop</b>(1)</a>  command to create a
31
 
       queue file in the <b>maildrop</b> directory.
32
 
 
33
 
       Specific command aliases are  provided  for  other  common
34
 
       modes of operation:
35
 
 
36
 
       <b>mailq</b>  List  the  mail  queue.  Each entry shows the queue
37
 
              file ID, message size, arrival  time,  sender,  and
38
 
              the recipients that still need to be delivered.  If
39
 
              mail could not be delivered upon the last  attempt,
40
 
              the  reason  for  failure  is  shown.  The queue ID
41
 
              string is followed by an optional status character:
42
 
 
43
 
              <b>*</b>      The message is in the <b>active</b> queue, i.e. the
44
 
                     message is selected for delivery.
45
 
 
46
 
              <b>!</b>      The message is in the <b>hold</b>  queue,  i.e.  no
47
 
                     further  delivery attempt will be made until
48
 
                     the mail is taken off hold.
49
 
 
50
 
              This mode of operation is implemented by  executing
51
 
              the <a href="postqueue.1.html"><b>postqueue</b>(1)</a> command.
 
22
       The Postfix <a href="sendmail.1.html"><b>sendmail</b>(1)</a> command implements the Postfix to Sendmail com-
 
23
       patibility interface.  For the  sake  of  compatibility  with  existing
 
24
       applications,  some  Sendmail  command-line  options are recognized but
 
25
       silently ignored.
 
26
 
 
27
       By default, Postfix <a href="sendmail.1.html"><b>sendmail</b>(1)</a> reads a  message  from  standard  input
 
28
       until  EOF  or  until  it  reads  a  line  with only a <b>.</b> character, and
 
29
       arranges for delivery.  Postfix <a href="sendmail.1.html"><b>sendmail</b>(1)</a> relies on  the  <a href="postdrop.1.html"><b>postdrop</b>(1)</a>
 
30
       command to create a queue file in the <b>maildrop</b> directory.
 
31
 
 
32
       Specific  command aliases are provided for other common modes of opera-
 
33
       tion:
 
34
 
 
35
       <b>mailq</b>  List the mail queue. Each entry shows the queue file ID, message
 
36
              size,  arrival  time, sender, and the recipients that still need
 
37
              to be delivered.  If mail could not be delivered upon  the  last
 
38
              attempt, the reason for failure is shown. The queue ID string is
 
39
              followed by an optional status character:
 
40
 
 
41
              <b>*</b>      The message is in the <b>active</b> queue, i.e. the  message  is
 
42
                     selected for delivery.
 
43
 
 
44
              <b>!</b>      The  message is in the <b>hold</b> queue, i.e. no further deliv-
 
45
                     ery attempt will be made until  the  mail  is  taken  off
 
46
                     hold.
 
47
 
 
48
              This   mode   of  operation  is  implemented  by  executing  the
 
49
              <a href="postqueue.1.html"><b>postqueue</b>(1)</a> command.
52
50
 
53
51
       <b>newaliases</b>
54
 
              Initialize the alias database.  If no input file is
55
 
              specified (with the <b>-oA</b>  option,  see  below),  the
56
 
              program  processes  the  file(s) specified with the
57
 
              <b><a href="postconf.5.html#alias_database">alias_database</a></b>  configuration  parameter.   If   no
58
 
              alias  database type is specified, the program uses
59
 
              the type specified with  the  <b><a href="postconf.5.html#default_database_type">default_database_type</a></b>
60
 
              configuration parameter.  This mode of operation is
61
 
              implemented by running the <a href="postalias.1.html"><b>postalias</b>(1)</a> command.
62
 
 
63
 
              Note: it may take a minute or so  before  an  alias
64
 
              database  update  becomes visible. Use the "<b>postfix</b>
65
 
              <b>reload</b>" command to eliminate this delay.
66
 
 
67
 
       These and other features can be selected by specifying the
68
 
       appropriate combination of command-line options. Some fea-
69
 
       tures are controlled by parameters in the <a href="postconf.5.html"><b>main.cf</b></a> configu-
70
 
       ration file.
 
52
              Initialize the alias database.  If no input  file  is  specified
 
53
              (with  the  <b>-oA</b>  option,  see  below), the program processes the
 
54
              file(s) specified with the <b><a href="postconf.5.html#alias_database">alias_database</a></b> configuration  parame-
 
55
              ter.   If  no alias database type is specified, the program uses
 
56
              the type specified with the <b><a href="postconf.5.html#default_database_type">default_database_type</a></b>  configuration
 
57
              parameter.  This mode of operation is implemented by running the
 
58
              <a href="postalias.1.html"><b>postalias</b>(1)</a> command.
 
59
 
 
60
              Note: it may take a minute or so before an alias database update
 
61
              becomes  visible.  Use the "<b>postfix reload</b>" command to eliminate
 
62
              this delay.
 
63
 
 
64
       These and other features can be selected by specifying the  appropriate
 
65
       combination  of  command-line  options. Some features are controlled by
 
66
       parameters in the <a href="postconf.5.html"><b>main.cf</b></a> configuration file.
71
67
 
72
68
       The following options are recognized:
73
69
 
74
70
       <b>-Am</b> (ignored)
75
71
 
76
72
       <b>-Ac</b> (ignored)
77
 
              Postfix  sendmail  uses the same configuration file
78
 
              regardless of whether or not a message is  an  ini-
79
 
              tial submission.
 
73
              Postfix sendmail uses the same configuration file regardless  of
 
74
              whether or not a message is an initial submission.
80
75
 
81
76
       <b>-B</b> <i>body</i><b>_</b><i>type</i>
82
77
              The message body MIME type: <b>7BIT</b> or <b>8BITMIME</b>.
83
78
 
84
 
       <b>-bd</b>    Go  into  daemon  mode.  This  mode of operation is
85
 
              implemented by executing the "<b>postfix  start</b>"  com-
86
 
              mand.
 
79
       <b>-bd</b>    Go  into  daemon  mode. This mode of operation is implemented by
 
80
              executing the "<b>postfix start</b>" command.
87
81
 
88
82
       <b>-bh</b> (ignored)
89
83
 
90
84
       <b>-bH</b> (ignored)
91
85
              Postfix has no persistent host status database.
92
86
 
93
 
       <b>-bi</b>    Initialize  alias database. See the <b>newaliases</b> com-
94
 
              mand above.
95
 
 
96
 
       <b>-bl</b>    Go into daemon mode. To accept only  local  connec-
97
 
              tions   as  with  Sendmail's  <b>-bl</b>  option,  specify
98
 
              "<b><a href="postconf.5.html#inet_interfaces">inet_interfaces</a> = loopback</b>" in the Postfix <a href="postconf.5.html"><b>main.cf</b></a>
99
 
              configuration file.
100
 
 
101
 
       <b>-bm</b>    Read  mail  from  standard  input  and  arrange for
102
 
              delivery.  This is the default mode of operation.
 
87
       <b>-bi</b>    Initialize alias database. See the <b>newaliases</b> command above.
 
88
 
 
89
       <b>-bl</b>    Go into daemon mode. To accept only local  connections  as  with
 
90
              Sendmail's  <b>-bl</b>  option, specify "<b><a href="postconf.5.html#inet_interfaces">inet_interfaces</a> = loopback</b>" in
 
91
              the Postfix <a href="postconf.5.html"><b>main.cf</b></a> configuration file.
 
92
 
 
93
       <b>-bm</b>    Read mail from standard input and arrange for delivery.  This is
 
94
              the default mode of operation.
103
95
 
104
96
       <b>-bp</b>    List the mail queue. See the <b>mailq</b> command above.
105
97
 
106
 
       <b>-bs</b>    Stand-alone SMTP server mode.  Read  SMTP  commands
107
 
              from  standard  input, and write responses to stan-
108
 
              dard output.  In stand-alone SMTP server mode, mail
109
 
              relaying  and other access controls are disabled by
110
 
              default. To enable them, run  the  process  as  the
 
98
       <b>-bs</b>    Stand-alone  SMTP  server mode. Read SMTP commands from standard
 
99
              input, and write responses to standard output.   In  stand-alone
 
100
              SMTP  server  mode,  mail relaying and other access controls are
 
101
              disabled by default. To enable them,  run  the  process  as  the
111
102
              <b><a href="postconf.5.html#mail_owner">mail_owner</a></b> user.
112
103
 
113
 
              This  mode  of  operation is implemented by running
114
 
              the <a href="smtpd.8.html"><b>smtpd</b>(8)</a> daemon.
115
 
 
116
 
       <b>-bv</b>    Do not collect or deliver a message. Instead,  send
117
 
              an  email  report  after  verifying  each recipient
118
 
              address.   This  is  useful  for  testing   address
119
 
              rewriting and routing configurations.
120
 
 
121
 
              This  feature  is  available in Postfix version 2.1
122
 
              and later.
 
104
              This  mode  of  operation is implemented by running the <a href="smtpd.8.html"><b>smtpd</b>(8)</a>
 
105
              daemon.
 
106
 
 
107
       <b>-bv</b>    Do not collect or deliver a  message.  Instead,  send  an  email
 
108
              report  after  verifying each recipient address.  This is useful
 
109
              for testing address rewriting and routing configurations.
 
110
 
 
111
              This feature is available in Postfix version 2.1 and later.
123
112
 
124
113
       <b>-C</b> <i>config</i><b>_</b><i>file</i>
125
114
 
126
115
       <b>-C</b> <i>config</i><b>_</b><i>dir</i>
127
 
              The path name of the Postfix <a href="postconf.5.html"><b>main.cf</b></a>  file,  or  of
128
 
              its  parent  directory. This information is ignored
129
 
              with Postfix versions before 2.3.
 
116
              The path name of the Postfix <a href="postconf.5.html"><b>main.cf</b></a>  file,  or  of  its  parent
 
117
              directory.  This  information  is  ignored with Postfix versions
 
118
              before 2.3.
130
119
 
131
 
              With all Postfix versions, you can specify a direc-
132
 
              tory  pathname  with  the  MAIL_CONFIG  environment
133
 
              variable to override the location of  configuration
134
 
              files.
 
120
              With all Postfix versions, you can specify a directory  pathname
 
121
              with  the MAIL_CONFIG environment variable to override the loca-
 
122
              tion of configuration files.
135
123
 
136
124
       <b>-F</b> <i>full</i><b>_</b><i>name</i>
137
 
              Set  the  sender full name. This overrides the NAME
138
 
              environment variable, and is used  only  with  mes-
139
 
              sages that have no <b>From:</b> message header.
 
125
              Set the sender full name. This overrides  the  NAME  environment
 
126
              variable, and is used only with messages that have no <b>From:</b> mes-
 
127
              sage header.
140
128
 
141
129
       <b>-f</b> <i>sender</i>
142
 
              Set  the  envelope  sender  address.  This  is  the
143
 
              address where delivery problems are sent  to.  With
144
 
              Postfix versions before 2.1, the <b>Errors-To:</b> message
145
 
              header overrides the error return address.
146
 
 
147
 
       <b>-G</b>     Gateway (relay) submission, as opposed  to  initial
148
 
              user  submission.   Either do not rewrite addresses
149
 
              at all, or update  incomplete  addresses  with  the
150
 
              domain information specified with <b>remote_header_re-</b>
151
 
              <b>write_domain</b>.
152
 
 
153
 
              This option is ignored before Postfix version  2.3.
 
130
              Set the envelope sender  address.  This  is  the  address  where
 
131
              delivery problems are sent to. With Postfix versions before 2.1,
 
132
              the  <b>Errors-To:</b>  message  header  overrides  the  error   return
 
133
              address.
 
134
 
 
135
       <b>-G</b>     Gateway  (relay)  submission, as opposed to initial user submis-
 
136
              sion.  Either do not rewrite addresses at all, or update  incom-
 
137
              plete  addresses  with  the  domain  information  specified with
 
138
              <b><a href="postconf.5.html#remote_header_rewrite_domain">remote_header_rewrite_domain</a></b>.
 
139
 
 
140
              This option is ignored before Postfix version 2.3.
154
141
 
155
142
       <b>-h</b> <i>hop</i><b>_</b><i>count</i> (ignored)
156
 
              Hop  count limit. Use the <b><a href="postconf.5.html#hopcount_limit">hopcount_limit</a></b> configura-
157
 
              tion parameter instead.
158
 
 
159
 
       <b>-I</b>     Initialize alias database. See the <b>newaliases</b>  com-
160
 
              mand above.
161
 
 
162
 
       <b>-i</b>     When  reading  a message from standard input, don't
163
 
              treat a line with only a <b>.</b> character as the end  of
164
 
              input.
 
143
              Hop count limit. Use the <b><a href="postconf.5.html#hopcount_limit">hopcount_limit</a></b> configuration  parameter
 
144
              instead.
 
145
 
 
146
       <b>-I</b>     Initialize alias database. See the <b>newaliases</b> command above.
 
147
 
 
148
       <b>-i</b>     When  reading  a message from standard input, don't treat a line
 
149
              with only a <b>.</b> character as the end of input.
165
150
 
166
151
       <b>-L</b> <i>label</i> (ignored)
167
 
              The  logging  label. Use the <b><a href="postconf.5.html#syslog_name">syslog_name</a></b> configura-
168
 
              tion parameter instead.
 
152
              The logging label. Use the <b><a href="postconf.5.html#syslog_name">syslog_name</a></b>  configuration  parameter
 
153
              instead.
169
154
 
170
155
       <b>-m</b> (ignored)
171
156
              Backwards compatibility.
172
157
 
173
158
       <b>-N</b> <i>dsn</i> (default: 'delay, failure')
174
 
              Delivery  status  notification   control.   Specify
175
 
              either  a  comma-separated list with one or more of
176
 
              <b>failure</b> (send notification  when  delivery  fails),
177
 
              <b>delay</b> (send notification when delivery is delayed),
178
 
              or <b>success</b> (send notification when the  message  is
179
 
              delivered);  or specify <b>never</b> (don't send any noti-
180
 
              fications at all).
 
159
              Delivery  status  notification  control. Specify either a comma-
 
160
              separated list with one or more of  <b>failure</b>  (send  notification
 
161
              when  delivery fails), <b>delay</b> (send notification when delivery is
 
162
              delayed), or <b>success</b> (send  notification  when  the  message  is
 
163
              delivered);  or  specify  <b>never</b> (don't send any notifications at
 
164
              all).
181
165
 
182
166
              This feature is available in Postfix 2.3 and later.
183
167
 
185
169
              Backwards compatibility.
186
170
 
187
171
       <b>-oA</b><i>alias</i><b>_</b><i>database</i>
188
 
              Non-default  alias  database.  Specify  <i>pathname</i> or
189
 
              <i>type</i>:<i>pathname</i>. See <a href="postalias.1.html"><b>postalias</b>(1)</a> for details.
 
172
              Non-default alias database. Specify <i>pathname</i>  or  <i>type</i>:<i>pathname</i>.
 
173
              See <a href="postalias.1.html"><b>postalias</b>(1)</a> for details.
190
174
 
191
175
       <b>-O</b> <i>option=value</i> (ignored)
192
 
              Set the named <i>option</i> to <i>value</i>. Use  the  equivalent
193
 
              configuration parameter in <a href="postconf.5.html"><b>main.cf</b></a> instead.
 
176
              Set  the named <i>option</i> to <i>value</i>. Use the equivalent configuration
 
177
              parameter in <a href="postconf.5.html"><b>main.cf</b></a> instead.
194
178
 
195
179
       <b>-o7</b> (ignored)
196
180
 
197
181
       <b>-o8</b> (ignored)
198
 
              To send 8-bit or binary content, use an appropriate
199
 
              MIME encapsulation and specify the  appropriate  <b>-B</b>
200
 
              command-line option.
 
182
              To send 8-bit or binary content, use an appropriate MIME  encap-
 
183
              sulation and specify the appropriate <b>-B</b> command-line option.
201
184
 
202
 
       <b>-oi</b>    When  reading  a message from standard input, don't
203
 
              treat a line with only a <b>.</b> character as the end  of
204
 
              input.
 
185
       <b>-oi</b>    When  reading  a message from standard input, don't treat a line
 
186
              with only a <b>.</b> character as the end of input.
205
187
 
206
188
       <b>-om</b> (ignored)
207
 
              The  sender  is  never  eliminated  from alias etc.
208
 
              expansions.
 
189
              The sender is never eliminated from alias etc. expansions.
209
190
 
210
191
       <b>-o</b> <i>x value</i> (ignored)
211
 
              Set option <i>x</i> to <i>value</i>. Use the equivalent  configu-
212
 
              ration parameter in <a href="postconf.5.html"><b>main.cf</b></a> instead.
 
192
              Set option <i>x</i> to <i>value</i>. Use the equivalent configuration  parame-
 
193
              ter in <a href="postconf.5.html"><b>main.cf</b></a> instead.
213
194
 
214
195
       <b>-r</b> <i>sender</i>
215
 
              Set  the  envelope  sender  address.  This  is  the
216
 
              address where delivery problems are sent  to.  With
217
 
              Postfix versions before 2.1, the <b>Errors-To:</b> message
218
 
              header overrides the error return address.
 
196
              Set  the  envelope  sender  address.  This  is the address where
 
197
              delivery problems are sent to. With Postfix versions before 2.1,
 
198
              the   <b>Errors-To:</b>  message  header  overrides  the  error  return
 
199
              address.
219
200
 
220
201
       <b>-R</b> <i>return</i>
221
 
              Delivery  status  notification  control.    Specify
222
 
              "hdrs"  to  return  only  the header when a message
223
 
              bounces, "full" to return a full copy (the  default
224
 
              behavior).
 
202
              Delivery status notification control.  Specify "hdrs" to  return
 
203
              only  the header when a message bounces, "full" to return a full
 
204
              copy (the default behavior).
225
205
 
226
 
              The  <b>-R</b>  option  specifies  an upper bound; Postfix
227
 
              will return only the header, when a full copy would
228
 
              exceed the <a href="postconf.5.html#bounce_size_limit">bounce_size_limit</a> setting.
 
206
              The <b>-R</b> option specifies an upper bound; Postfix will return only
 
207
              the  header, when a full copy would exceed the <a href="postconf.5.html#bounce_size_limit">bounce_size_limit</a>
 
208
              setting.
229
209
 
230
210
              This option is ignored before Postfix version 2.10.
231
211
 
232
 
       <b>-q</b>     Attempt to deliver all queued mail. This is  imple-
233
 
              mented by executing the <a href="postqueue.1.html"><b>postqueue</b>(1)</a> command.
 
212
       <b>-q</b>     Attempt to deliver all queued mail. This is implemented by  exe-
 
213
              cuting the <a href="postqueue.1.html"><b>postqueue</b>(1)</a> command.
234
214
 
235
 
              Warning:  flushing  undeliverable  mail  frequently
236
 
              will result in poor  delivery  performance  of  all
237
 
              other mail.
 
215
              Warning:  flushing  undeliverable mail frequently will result in
 
216
              poor delivery performance of all other mail.
238
217
 
239
218
       <b>-q</b><i>interval</i> (ignored)
240
 
              The   interval   between   queue   runs.   Use  the
241
 
              <b><a href="postconf.5.html#queue_run_delay">queue_run_delay</a></b> configuration parameter instead.
 
219
              The interval between queue runs. Use the <b><a href="postconf.5.html#queue_run_delay">queue_run_delay</a></b> config-
 
220
              uration parameter instead.
242
221
 
243
222
       <b>-qI</b><i>queueid</i>
244
 
              Schedule immediate delivery of mail with the speci-
245
 
              fied  queue ID.  This option is implemented by exe-
246
 
              cuting the <a href="postqueue.1.html"><b>postqueue</b>(1)</a> command, and  is  available
247
 
              with Postfix version 2.4 and later.
 
223
              Schedule immediate delivery of mail with the specified queue ID.
 
224
              This option is implemented by executing  the  <a href="postqueue.1.html"><b>postqueue</b>(1)</a>  com-
 
225
              mand, and is available with Postfix version 2.4 and later.
248
226
 
249
227
       <b>-qR</b><i>site</i>
250
 
              Schedule  immediate  delivery  of  all mail that is
251
 
              queued for the named <i>site</i>. This option accepts only
252
 
              <i>site</i>  names  that are eligible for the "fast flush"
253
 
              service,  and  is  implemented  by  executing   the
254
 
              <a href="postqueue.1.html"><b>postqueue</b>(1)</a> command.  See <a href="flush.8.html"><b>flush</b>(8)</a> for more infor-
255
 
              mation about the "fast flush" service.
 
228
              Schedule  immediate  delivery of all mail that is queued for the
 
229
              named <i>site</i>. This option accepts only <i>site</i> names that are  eligi-
 
230
              ble  for the "fast flush" service, and is implemented by execut-
 
231
              ing the <a href="postqueue.1.html"><b>postqueue</b>(1)</a> command.  See <a href="flush.8.html"><b>flush</b>(8)</a> for more information
 
232
              about the "fast flush" service.
256
233
 
257
234
       <b>-qS</b><i>site</i>
258
 
              This command is not  implemented.  Use  the  slower
259
 
              "<b>sendmail -q</b>" command instead.
260
 
 
261
 
       <b>-t</b>     Extract  recipients from message headers. These are
262
 
              added to any recipients specified  on  the  command
263
 
              line.
264
 
 
265
 
              With  Postfix  versions  prior  to 2.1, this option
266
 
              requires that no recipient addresses are  specified
267
 
              on the command line.
 
235
              This  command  is  not implemented. Use the slower "<b>sendmail -q</b>"
 
236
              command instead.
 
237
 
 
238
       <b>-t</b>     Extract recipients from message headers. These are added to  any
 
239
              recipients specified on the command line.
 
240
 
 
241
              With Postfix versions prior to 2.1, this option requires that no
 
242
              recipient addresses are specified on the command line.
268
243
 
269
244
       <b>-U</b> (ignored)
270
245
              Initial user submission.
271
246
 
272
247
       <b>-V</b> <i>envid</i>
273
 
              Specify the envelope ID for notification by servers
274
 
              that support DSN.
 
248
              Specify the envelope ID for notification by servers that support
 
249
              DSN.
275
250
 
276
251
              This feature is available in Postfix 2.3 and later.
277
252
 
278
253
       <b>-XV</b> (Postfix 2.2 and earlier: <b>-V</b>)
279
 
              Variable  Envelope  Return  Path. Given an envelope
280
 
              sender address of the  form  <i>owner-listname</i>@<i>origin</i>,
281
 
              each  recipient  <i>user</i>@<i>domain</i>  receives  mail with a
282
 
              personalized envelope sender address.
 
254
              Variable  Envelope Return Path. Given an envelope sender address
 
255
              of the form <i>owner-listname</i>@<i>origin</i>,  each  recipient  <i>user</i>@<i>domain</i>
 
256
              receives mail with a personalized envelope sender address.
283
257
 
284
 
              By  default,  the  personalized   envelope   sender
285
 
              address  is  <i>owner-listname</i><b>+</b><i>user</i><b>=</b><i>domain</i>@<i>origin</i>. The
286
 
              default <b>+</b> and <b>=</b> characters  are  configurable  with
287
 
              the  <b><a href="postconf.5.html#default_verp_delimiters">default_verp_delimiters</a></b>  configuration parame-
288
 
              ter.
 
258
              By  default,  the personalized envelope sender address is <i>owner-</i>
 
259
              <i>listname</i><b>+</b><i>user</i><b>=</b><i>domain</i>@<i>origin</i>. The default <b>+</b> and <b>=</b> characters  are
 
260
              configurable   with  the  <b><a href="postconf.5.html#default_verp_delimiters">default_verp_delimiters</a></b>  configuration
 
261
              parameter.
289
262
 
290
263
       <b>-XV</b><i>xy</i> (Postfix 2.2 and earlier: <b>-V</b><i>xy</i>)
291
 
              As <b>-XV</b>, but uses <i>x</i> and  <i>y</i>  as  the  VERP  delimiter
292
 
              characters,  instead  of  the  characters specified
293
 
              with  the   <b><a href="postconf.5.html#default_verp_delimiters">default_verp_delimiters</a></b>   configuration
294
 
              parameter.
 
264
              As <b>-XV</b>, but uses <i>x</i> and  <i>y</i>  as  the  VERP  delimiter  characters,
 
265
              instead of the characters specified with the <b><a href="postconf.5.html#default_verp_delimiters">default_verp_delim</a>-</b>
 
266
              <b><a href="postconf.5.html#default_verp_delimiters">iters</a></b> configuration parameter.
295
267
 
296
 
       <b>-v</b>     Send  an email report of the first delivery attempt
297
 
              (Postfix versions 2.1  and  later).  Mail  delivery
298
 
              always  happens in the background. When multiple <b>-v</b>
299
 
              options  are  given,  enable  verbose  logging  for
300
 
              debugging purposes.
 
268
       <b>-v</b>     Send an email report of the first delivery attempt (Postfix ver-
 
269
              sions  2.1 and later). Mail delivery always happens in the back-
 
270
              ground. When multiple <b>-v</b> options are given, enable verbose  log-
 
271
              ging for debugging purposes.
301
272
 
302
273
       <b>-X</b> <i>log</i><b>_</b><i>file</i> (ignored)
303
 
              Log  mailer  traffic.  Use  the <b><a href="postconf.5.html#debug_peer_list">debug_peer_list</a></b> and
304
 
              <b><a href="postconf.5.html#debug_peer_level">debug_peer_level</a></b> configuration parameters  instead.
 
274
              Log mailer traffic. Use the <b><a href="postconf.5.html#debug_peer_list">debug_peer_list</a></b> and <b><a href="postconf.5.html#debug_peer_level">debug_peer_level</a></b>
 
275
              configuration parameters instead.
305
276
 
306
277
<b>SECURITY</b>
307
 
       By  design,  this  program  is not set-user (or group) id.
308
 
       However, it must  handle  data  from  untrusted,  possibly
309
 
       remote,  users.   Thus,  the  usual precautions need to be
310
 
       taken against malicious inputs.
 
278
       By design, this program is not set-user (or group) id. However, it must
 
279
       handle  data  from  untrusted, possibly remote, users.  Thus, the usual
 
280
       precautions need to be taken against malicious inputs.
311
281
 
312
282
<b>DIAGNOSTICS</b>
313
 
       Problems are logged to  <b>syslogd</b>(8)  and  to  the  standard
314
 
       error stream.
 
283
       Problems are logged to <b>syslogd</b>(8) and to the standard error stream.
315
284
 
316
285
<b>ENVIRONMENT</b>
317
286
       <b>MAIL_CONFIG</b>
321
290
              Enable verbose logging for debugging purposes.
322
291
 
323
292
       <b>MAIL_DEBUG</b> (value does not matter)
324
 
              Enable debugging with an external command, as spec-
325
 
              ified  with  the   <b><a href="postconf.5.html#debugger_command">debugger_command</a></b>   configuration
326
 
              parameter.
 
293
              Enable debugging with an external command, as specified with the
 
294
              <b><a href="postconf.5.html#debugger_command">debugger_command</a></b> configuration parameter.
327
295
 
328
 
       <b>NAME</b>   The  sender  full name. This is used only with mes-
329
 
              sages that have no <b>From:</b> message header.  See  also
330
 
              the <b>-F</b> option above.
 
296
       <b>NAME</b>   The  sender full name. This is used only with messages that have
 
297
              no <b>From:</b> message header. See also the <b>-F</b> option above.
331
298
 
332
299
<b>CONFIGURATION PARAMETERS</b>
333
 
       The  following  <a href="postconf.5.html"><b>main.cf</b></a> parameters are especially relevant
334
 
       to this program.  The text below provides only a parameter
335
 
       summary.  See <a href="postconf.5.html"><b>postconf</b>(5)</a> for more details including exam-
336
 
       ples.
 
300
       The following <a href="postconf.5.html"><b>main.cf</b></a> parameters are especially relevant to  this  pro-
 
301
       gram.   The  text  below  provides  only a parameter summary. See <a href="postconf.5.html"><b>post-</b></a>
 
302
       <a href="postconf.5.html"><b>conf</b>(5)</a> for more details including examples.
337
303
 
338
304
<b>COMPATIBILITY CONTROLS</b>
339
305
       Available with Postfix 2.9 and later:
340
306
 
341
307
       <b><a href="postconf.5.html#sendmail_fix_line_endings">sendmail_fix_line_endings</a> (always)</b>
342
 
              Controls how the Postfix sendmail command  converts
343
 
              email  message line endings from &lt;CR&gt;&lt;LF&gt; into UNIX
344
 
              format (&lt;LF&gt;).
 
308
              Controls how the Postfix sendmail command converts email message
 
309
              line endings from &lt;CR&gt;&lt;LF&gt; into UNIX format (&lt;LF&gt;).
345
310
 
346
311
<b>TROUBLE SHOOTING CONTROLS</b>
347
 
       The <a href="DEBUG_README.html">DEBUG_README</a> file gives examples  of  how  to  trouble
348
 
       shoot a Postfix system.
 
312
       The  <a href="DEBUG_README.html">DEBUG_README</a> file gives examples of how to trouble shoot a Postfix
 
313
       system.
349
314
 
350
315
       <b><a href="postconf.5.html#debugger_command">debugger_command</a> (empty)</b>
351
 
              The external command to execute when a Postfix dae-
352
 
              mon program is invoked with the -D option.
 
316
              The external command to execute when a Postfix daemon program is
 
317
              invoked with the -D option.
353
318
 
354
319
       <b><a href="postconf.5.html#debug_peer_level">debug_peer_level</a> (2)</b>
355
 
              The increment  in  verbose  logging  level  when  a
356
 
              remote  client  or  server matches a pattern in the
357
 
              <a href="postconf.5.html#debug_peer_list">debug_peer_list</a> parameter.
 
320
              The  increment  in verbose logging level when a remote client or
 
321
              server matches a pattern in the <a href="postconf.5.html#debug_peer_list">debug_peer_list</a> parameter.
358
322
 
359
323
       <b><a href="postconf.5.html#debug_peer_list">debug_peer_list</a> (empty)</b>
360
 
              Optional list of remote client or  server  hostname
361
 
              or  network address patterns that cause the verbose
362
 
              logging level to increase by the  amount  specified
363
 
              in $<a href="postconf.5.html#debug_peer_level">debug_peer_level</a>.
 
324
              Optional list of remote client or  server  hostname  or  network
 
325
              address  patterns  that  cause  the  verbose  logging  level  to
 
326
              increase by the amount specified in $<a href="postconf.5.html#debug_peer_level">debug_peer_level</a>.
364
327
 
365
328
<b>ACCESS CONTROLS</b>
366
329
       Available in Postfix version 2.2 and later:
367
330
 
368
331
       <b><a href="postconf.5.html#authorized_flush_users">authorized_flush_users</a> (<a href="DATABASE_README.html#types">static</a>:anyone)</b>
369
 
              List  of  users  who  are  authorized  to flush the
370
 
              queue.
 
332
              List of users who are authorized to flush the queue.
371
333
 
372
334
       <b><a href="postconf.5.html#authorized_mailq_users">authorized_mailq_users</a> (<a href="DATABASE_README.html#types">static</a>:anyone)</b>
373
335
              List of users who are authorized to view the queue.
374
336
 
375
337
       <b><a href="postconf.5.html#authorized_submit_users">authorized_submit_users</a> (<a href="DATABASE_README.html#types">static</a>:anyone)</b>
376
 
              List  of  users  who  are authorized to submit mail
377
 
              with the <a href="sendmail.1.html"><b>sendmail</b>(1)</a> command (and with  the  privi-
378
 
              leged <a href="postdrop.1.html"><b>postdrop</b>(1)</a> helper command).
 
338
              List of users who are authorized to submit mail with  the  <a href="sendmail.1.html"><b>send-</b></a>
 
339
              <a href="sendmail.1.html"><b>mail</b>(1)</a> command (and with the privileged <a href="postdrop.1.html"><b>postdrop</b>(1)</a> helper com-
 
340
              mand).
379
341
 
380
342
<b>RESOURCE AND RATE CONTROLS</b>
381
343
       <b><a href="postconf.5.html#bounce_size_limit">bounce_size_limit</a> (50000)</b>
382
 
              The maximal amount of original message text that is
383
 
              sent in a non-delivery notification.
 
344
              The maximal amount of original message text that is  sent  in  a
 
345
              non-delivery notification.
384
346
 
385
347
       <b><a href="postconf.5.html#fork_attempts">fork_attempts</a> (5)</b>
386
 
              The maximal number of attempts to  fork()  a  child
387
 
              process.
 
348
              The maximal number of attempts to fork() a child process.
388
349
 
389
350
       <b><a href="postconf.5.html#fork_delay">fork_delay</a> (1s)</b>
390
 
              The  delay  between  attempts  to  fork()  a  child
391
 
              process.
 
351
              The delay between attempts to fork() a child process.
392
352
 
393
353
       <b><a href="postconf.5.html#hopcount_limit">hopcount_limit</a> (50)</b>
394
 
              The maximal number of  Received:   message  headers
395
 
              that is allowed in the primary message headers.
 
354
              The maximal number of Received:  message headers that is allowed
 
355
              in the primary message headers.
396
356
 
397
357
       <b><a href="postconf.5.html#queue_run_delay">queue_run_delay</a> (300s)</b>
398
 
              The  time between <a href="QSHAPE_README.html#deferred_queue">deferred queue</a> scans by the queue
399
 
              manager; prior to Postfix 2.4 the default value was
400
 
              1000s.
 
358
              The time between <a href="QSHAPE_README.html#deferred_queue">deferred queue</a>  scans  by  the  queue  manager;
 
359
              prior to Postfix 2.4 the default value was 1000s.
401
360
 
402
361
<b>FAST FLUSH CONTROLS</b>
403
 
       The <a href="ETRN_README.html">ETRN_README</a> file describes configuration and operation
404
 
       details for the Postfix "fast flush" service.
 
362
       The  <a href="ETRN_README.html">ETRN_README</a> file describes configuration and operation details for
 
363
       the Postfix "fast flush" service.
405
364
 
406
365
       <b><a href="postconf.5.html#fast_flush_domains">fast_flush_domains</a> ($<a href="postconf.5.html#relay_domains">relay_domains</a>)</b>
407
 
              Optional list of destinations that are eligible for
408
 
              per-destination  logfiles  with mail that is queued
409
 
              to those destinations.
 
366
              Optional list of destinations that are eligible for per-destina-
 
367
              tion logfiles with mail that is queued to those destinations.
410
368
 
411
369
<b>VERP CONTROLS</b>
412
 
       The <a href="VERP_README.html">VERP_README</a> file describes configuration and operation
413
 
       details  of  Postfix  support for variable envelope return
414
 
       path addresses.
 
370
       The  <a href="VERP_README.html">VERP_README</a>  file describes configuration and operation details of
 
371
       Postfix support for variable envelope return path addresses.
415
372
 
416
373
       <b><a href="postconf.5.html#default_verp_delimiters">default_verp_delimiters</a> (+=)</b>
417
374
              The two default VERP delimiter characters.
418
375
 
419
376
       <b><a href="postconf.5.html#verp_delimiter_filter">verp_delimiter_filter</a> (-=+)</b>
420
 
              The characters Postfix accepts  as  VERP  delimiter
421
 
              characters  on the Postfix <a href="sendmail.1.html"><b>sendmail</b>(1)</a> command line
422
 
              and in SMTP commands.
 
377
              The characters Postfix accepts as VERP delimiter  characters  on
 
378
              the Postfix <a href="sendmail.1.html"><b>sendmail</b>(1)</a> command line and in SMTP commands.
423
379
 
424
380
<b>MISCELLANEOUS CONTROLS</b>
425
381
       <b><a href="postconf.5.html#alias_database">alias_database</a> (see 'postconf -d' output)</b>
426
 
              The alias databases for <a href="local.8.html"><b>local</b>(8)</a> delivery that  are
427
 
              updated with "<b>newaliases</b>" or with "<b>sendmail -bi</b>".
 
382
              The  alias databases for <a href="local.8.html"><b>local</b>(8)</a> delivery that are updated with
 
383
              "<b>newaliases</b>" or with "<b>sendmail -bi</b>".
428
384
 
429
385
       <b><a href="postconf.5.html#command_directory">command_directory</a> (see 'postconf -d' output)</b>
430
 
              The  location  of  all  postfix administrative com-
431
 
              mands.
 
386
              The location of all postfix administrative commands.
432
387
 
433
388
       <b><a href="postconf.5.html#config_directory">config_directory</a> (see 'postconf -d' output)</b>
434
 
              The default location of  the  Postfix  <a href="postconf.5.html">main.cf</a>  and
435
 
              <a href="master.5.html">master.cf</a> configuration files.
 
389
              The default location of the Postfix <a href="postconf.5.html">main.cf</a> and  <a href="master.5.html">master.cf</a>  con-
 
390
              figuration files.
436
391
 
437
392
       <b><a href="postconf.5.html#daemon_directory">daemon_directory</a> (see 'postconf -d' output)</b>
438
 
              The  directory  with  Postfix  support programs and
439
 
              daemon programs.
 
393
              The directory with Postfix support programs and daemon programs.
440
394
 
441
395
       <b><a href="postconf.5.html#default_database_type">default_database_type</a> (see 'postconf -d' output)</b>
442
 
              The default database type for use in <a href="newaliases.1.html"><b>newaliases</b>(1)</a>,
443
 
              <a href="postalias.1.html"><b>postalias</b>(1)</a> and <a href="postmap.1.html"><b>postmap</b>(1)</a> commands.
 
396
              The default database type for use in <a href="newaliases.1.html"><b>newaliases</b>(1)</a>, <a href="postalias.1.html"><b>postalias</b>(1)</a>
 
397
              and <a href="postmap.1.html"><b>postmap</b>(1)</a> commands.
444
398
 
445
399
       <b><a href="postconf.5.html#delay_warning_time">delay_warning_time</a> (0h)</b>
446
 
              The  time after which the sender receives a copy of
447
 
              the message headers of mail that is still queued.
 
400
              The  time  after which the sender receives a copy of the message
 
401
              headers of mail that is still queued.
448
402
 
449
403
       <b><a href="postconf.5.html#enable_errors_to">enable_errors_to</a> (no)</b>
450
 
              Report mail delivery errors to the  address  speci-
451
 
              fied   with  the  non-standard  Errors-To:  message
452
 
              header, instead  of  the  envelope  sender  address
453
 
              (this  feature is removed with Postfix version 2.2,
454
 
              is turned off by default with Postfix version  2.1,
455
 
              and  is  always  turned  on with older Postfix ver-
456
 
              sions).
 
404
              Report mail delivery errors to the address  specified  with  the
 
405
              non-standard  Errors-To: message header, instead of the envelope
 
406
              sender address (this feature is  removed  with  Postfix  version
 
407
              2.2,  is  turned off by default with Postfix version 2.1, and is
 
408
              always turned on with older Postfix versions).
457
409
 
458
410
       <b><a href="postconf.5.html#mail_owner">mail_owner</a> (postfix)</b>
459
 
              The UNIX system account that owns the Postfix queue
460
 
              and most Postfix daemon processes.
 
411
              The UNIX system account that owns the  Postfix  queue  and  most
 
412
              Postfix daemon processes.
461
413
 
462
414
       <b><a href="postconf.5.html#queue_directory">queue_directory</a> (see 'postconf -d' output)</b>
463
 
              The  location of the Postfix top-level queue direc-
464
 
              tory.
 
415
              The location of the Postfix top-level queue directory.
465
416
 
466
417
       <b><a href="postconf.5.html#remote_header_rewrite_domain">remote_header_rewrite_domain</a> (empty)</b>
467
 
              Don't rewrite message headers from  remote  clients
468
 
              at all when this parameter is empty; otherwise, re-
469
 
              write message  headers  and  append  the  specified
470
 
              domain name to incomplete addresses.
 
418
              Don't  rewrite  message  headers from remote clients at all when
 
419
              this parameter is empty; otherwise, rewrite message headers  and
 
420
              append the specified domain name to incomplete addresses.
471
421
 
472
422
       <b><a href="postconf.5.html#syslog_facility">syslog_facility</a> (mail)</b>
473
423
              The syslog facility of Postfix logging.
474
424
 
475
425
       <b><a href="postconf.5.html#syslog_name">syslog_name</a> (see 'postconf -d' output)</b>
476
 
              The  mail  system  name  that  is  prepended to the
477
 
              process name in syslog  records,  so  that  "smtpd"
478
 
              becomes, for example, "postfix/smtpd".
 
426
              The  mail  system  name that is prepended to the process name in
 
427
              syslog records, so that "smtpd"  becomes,  for  example,  "post-
 
428
              fix/smtpd".
479
429
 
480
430
<b>FILES</b>
481
431
       /var/spool/postfix, mail queue
494
444
       syslogd(8), system logging
495
445
 
496
446
<b>README_FILES</b>
 
447
       Use  "<b>postconf <a href="postconf.5.html#readme_directory">readme_directory</a></b>" or "<b>postconf <a href="postconf.5.html#html_directory">html_directory</a></b>" to locate
 
448
       this information.
497
449
       <a href="DEBUG_README.html">DEBUG_README</a>, Postfix debugging howto
498
450
       <a href="ETRN_README.html">ETRN_README</a>, Postfix ETRN howto
499
451
       <a href="VERP_README.html">VERP_README</a>, Postfix VERP howto
500
452
 
501
453
<b>LICENSE</b>
502
 
       The Secure Mailer license must be  distributed  with  this
503
 
       software.
 
454
       The Secure Mailer license must be distributed with this software.
504
455
 
505
456
<b>AUTHOR(S)</b>
506
457
       Wietse Venema