Home | History | Annotate | Line # | Download | only in html
      1 <!doctype html public "-//W3C//DTD HTML 4.01 Transitional//EN"
      2         "https://www.w3.org/TR/html4/loose.dtd">
      3 <html> <head>
      4 <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
      5 <link rel='stylesheet' type='text/css' href='postfix-doc.css'>
      6 <title> Postfix manual - postdrop(1) </title>
      7 </head> <body> <pre>
      8 POSTDROP(1)                                                        POSTDROP(1)
      9 
     10 <b><a name="name">NAME</a></b>
     11        postdrop - Postfix mail posting utility
     12 
     13 <b><a name="synopsis">SYNOPSIS</a></b>
     14        <b>postdrop</b> [<b>-rv</b>] [<b>-c</b> <i>config</i><b>_</b><i>dir</i>]
     15 
     16 <b><a name="description">DESCRIPTION</a></b>
     17        The  <a href="postdrop.1.html"><b>postdrop</b>(1)</a>  command  creates a file in the <b>maildrop</b> directory and
     18        copies its standard input to the file.
     19 
     20        Options:
     21 
     22        <b>-c</b> <i>config</i><b>_</b><i>dir</i>
     23               The <a href="postconf.5.html"><b>main.cf</b></a> configuration file is in the named directory instead
     24               of the default configuration directory. See also the MAIL_CONFIG
     25               environment setting below.
     26 
     27        <b>-r</b>     Use a Postfix-internal protocol for  reading  the  message  from
     28               standard input, and for reporting status information on standard
     29               output. This is currently the only supported method.
     30 
     31        <b>-v</b>     Enable verbose  logging  for  debugging  purposes.  Multiple  <b>-v</b>
     32               options  make  the  software increasingly verbose. As of Postfix
     33               2.3, this option is available for the super-user only.
     34 
     35 <b><a name="security">SECURITY</a></b>
     36        The command is designed to run with set-group ID privileges, so that it
     37        can write to the <b>maildrop</b> queue directory and so that it can connect to
     38        Postfix daemon processes.
     39 
     40 <b><a name="diagnostics">DIAGNOSTICS</a></b>
     41        Fatal errors: malformed input, I/O error, out of memory.  Problems  are
     42        logged  to  <b>syslogd</b>(8) or <a href="postlogd.8.html"><b>postlogd</b>(8)</a> and to the standard error stream.
     43        When the input is incomplete, or when the process receives a HUP,  INT,
     44        QUIT or TERM signal, the queue file is deleted.
     45 
     46 <b><a name="environment">ENVIRONMENT</a></b>
     47        MAIL_CONFIG
     48               Directory  with the <a href="postconf.5.html"><b>main.cf</b></a> file. In order to avoid exploitation
     49               of set-group ID privileges, a non-default directory  is  allowed
     50               only if:
     51 
     52               <b>o</b>      The  name  is listed in the default <a href="postconf.5.html"><b>main.cf</b></a> file with the
     53                      <b><a href="postconf.5.html#alternate_config_directories">alternate_config_directories</a></b>  or  <b><a href="postconf.5.html#multi_instance_directories">multi_instance_directo</a>-</b>
     54                      <b><a href="postconf.5.html#multi_instance_directories">ries</a></b> configuration parameter.
     55 
     56               <b>o</b>      The command is invoked by the super-user.
     57 
     58 <b><a name="configuration_parameters">CONFIGURATION PARAMETERS</a></b>
     59        The  following  <a href="postconf.5.html"><b>main.cf</b></a> parameters are especially relevant to this pro-
     60        gram.  The text below provides only  a  parameter  summary.  See  <a href="postconf.5.html"><b>post-</b></a>
     61        <a href="postconf.5.html"><b>conf</b>(5)</a> for more details including examples.
     62 
     63        <b><a href="postconf.5.html#alternate_config_directories">alternate_config_directories</a> (empty)</b>
     64               A list of non-default Postfix configuration directories that may
     65               be specified with "-c <a href="postconf.5.html#config_directory">config_directory</a>" on the command line  (in
     66               the  case  of  <a href="sendmail.1.html"><b>sendmail</b>(1)</a>,  with  the  "-C" option), or via the
     67               MAIL_CONFIG environment parameter.
     68 
     69        <b><a href="postconf.5.html#config_directory">config_directory</a> (see 'postconf -d' output)</b>
     70               The default location of the Postfix <a href="postconf.5.html">main.cf</a> and  <a href="master.5.html">master.cf</a>  con-
     71               figuration files.
     72 
     73        <b><a href="postconf.5.html#import_environment">import_environment</a> (see 'postconf -d' output)</b>
     74               The  list  of  environment  variables  that a privileged Postfix
     75               process will  import  from  a  non-Postfix  parent  process,  or
     76               name=value environment overrides.
     77 
     78        <b><a href="postconf.5.html#queue_directory">queue_directory</a> (see 'postconf -d' output)</b>
     79               The location of the Postfix top-level queue directory.
     80 
     81        <b><a href="postconf.5.html#syslog_facility">syslog_facility</a> (mail)</b>
     82               The syslog facility of Postfix logging.
     83 
     84        <b><a href="postconf.5.html#syslog_name">syslog_name</a> (see 'postconf -d' output)</b>
     85               A  prefix  that  is  prepended  to  the  process  name in syslog
     86               records, so that, for example, "smtpd" becomes "prefix/smtpd".
     87 
     88        <b><a href="postconf.5.html#trigger_timeout">trigger_timeout</a> (10s)</b>
     89               The time limit for sending a trigger to a  Postfix  daemon  (for
     90               example, the <a href="pickup.8.html"><b>pickup</b>(8)</a> or <a href="qmgr.8.html"><b>qmgr</b>(8)</a> daemon).
     91 
     92        Available in Postfix version 2.2 and later:
     93 
     94        <b><a href="postconf.5.html#authorized_submit_users">authorized_submit_users</a> (<a href="DATABASE_README.html#types">static</a>:anyone)</b>
     95               List  of  users who are authorized to submit mail with the <a href="sendmail.1.html"><b>send-</b></a>
     96               <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-
     97               mand).
     98 
     99        Available in Postfix version 3.6 and later:
    100 
    101        <b><a href="postconf.5.html#local_login_sender_maps">local_login_sender_maps</a> (<a href="DATABASE_README.html#types">static</a>:*)</b>
    102               A  list  of  lookup  tables  that are searched by the UNIX login
    103               name, and that return a list of allowed envelope sender patterns
    104               separated by space or comma.
    105 
    106        <b><a href="postconf.5.html#empty_address_local_login_sender_maps_lookup_key">empty_address_local_login_sender_maps_lookup_key</a> (</b>&lt;&gt;<b>)</b>
    107               The  lookup  key  to  be used in <a href="postconf.5.html#local_login_sender_maps">local_login_sender_maps</a> tables,
    108               instead of the null sender address.
    109 
    110        <b><a href="postconf.5.html#recipient_delimiter">recipient_delimiter</a> (empty)</b>
    111               The set of characters that can separate an email address  local-
    112               part, user name, or a .forward file name from its extension.
    113 
    114 <b><a name="files">FILES</a></b>
    115        /var/spool/postfix/<a href="QSHAPE_README.html#maildrop_queue">maildrop</a>, <a href="QSHAPE_README.html#maildrop_queue">maildrop queue</a>
    116 
    117 <b><a name="see_also">SEE ALSO</a></b>
    118        <a href="sendmail.1.html">sendmail(1)</a>, compatibility interface
    119        <a href="postconf.5.html">postconf(5)</a>, configuration parameters
    120        <a href="postlogd.8.html">postlogd(8)</a>, Postfix logging
    121        syslogd(8), system logging
    122 
    123 <b><a name="license">LICENSE</a></b>
    124        The Secure Mailer license must be distributed with this software.
    125 
    126 <b>AUTHOR(S)</b>
    127        Wietse Venema
    128        IBM T.J. Watson Research
    129        P.O. Box 704
    130        Yorktown Heights, NY 10598, USA
    131 
    132        Wietse Venema
    133        Google, Inc.
    134        111 8th Avenue
    135        New York, NY 10011, USA
    136 
    137                                                                    POSTDROP(1)
    138 </pre> </body> </html>
    139