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