autoupdate
[postfix-master.git] / postfix-master / postdrop.1.html
blob2756476d01dd239cdc5d6d6b80821ce9887f79ac
1 <!doctype html public "-//W3C//DTD HTML 4.01 Transitional//EN"
2 "http://www.w3.org/TR/html4/loose.dtd">
3 <html> <head>
4 <meta http-equiv="Content-Type" content="text/html; charset=us-ascii">
5 <title> Postfix manual - postdrop(1) </title>
6 </head> <body> <pre>
7 POSTDROP(1) POSTDROP(1)
9 <b>NAME</b>
10 postdrop - Postfix mail posting utility
12 <b>SYNOPSIS</b>
13 <b>postdrop</b> [<b>-rv</b>] [<b>-c</b> <i>config</i><b>_</b><i>dir</i>]
15 <b>DESCRIPTION</b>
16 The <a href="postdrop.1.html"><b>postdrop</b>(1)</a> command creates a file in the <b>maildrop</b>
17 directory and copies its standard input to the file.
19 Options:
21 <b>-c</b> <i>config</i><b>_</b><i>dir</i>
22 The <a href="postconf.5.html"><b>main.cf</b></a> configuration file is in the named
23 directory instead of the default configuration
24 directory. See also the MAIL_CONFIG environment
25 setting below.
27 <b>-r</b> Use a Postfix-internal protocol for reading the
28 message from standard input, and for reporting sta-
29 tus information on standard output. This is cur-
30 rently the only supported method.
32 <b>-v</b> Enable verbose logging for debugging purposes. Mul-
33 tiple <b>-v</b> options make the software increasingly
34 verbose. As of Postfix 2.3, this option is avail-
35 able for the super-user only.
37 <b>SECURITY</b>
38 The command is designed to run with set-group ID privi-
39 leges, so that it can write to the <b>maildrop</b> queue direc-
40 tory and so that it can connect to Postfix daemon pro-
41 cesses.
43 <b>DIAGNOSTICS</b>
44 Fatal errors: malformed input, I/O error, out of memory.
45 Problems are logged to <b>syslogd</b>(8) and to the standard
46 error stream. When the input is incomplete, or when the
47 process receives a HUP, INT, QUIT or TERM signal, the
48 queue file is deleted.
50 <b>ENVIRONMENT</b>
51 MAIL_CONFIG
52 Directory with the <a href="postconf.5.html"><b>main.cf</b></a> file. In order to avoid
53 exploitation of set-group ID privileges, a non-
54 standard directory is allowed only if:
56 <b>o</b> The name is listed in the standard <a href="postconf.5.html"><b>main.cf</b></a>
57 file with the <b><a href="postconf.5.html#alternate_config_directories">alternate_config_directories</a></b>
58 configuration parameter.
60 <b>o</b> The command is invoked by the super-user.
62 <b>CONFIGURATION PARAMETERS</b>
63 The following <a href="postconf.5.html"><b>main.cf</b></a> parameters are especially relevant
64 to this program. The text below provides only a parameter
65 summary. See <a href="postconf.5.html"><b>postconf</b>(5)</a> for more details including exam-
66 ples.
68 <b><a href="postconf.5.html#alternate_config_directories">alternate_config_directories</a> (empty)</b>
69 A list of non-default Postfix configuration direc-
70 tories that may be specified with "-c <a href="postconf.5.html#config_directory">config_direc</a>-
71 <a href="postconf.5.html#config_directory">tory</a>" on the command line, or via the MAIL_CONFIG
72 environment parameter.
74 <b><a href="postconf.5.html#config_directory">config_directory</a> (see 'postconf -d' output)</b>
75 The default location of the Postfix <a href="postconf.5.html">main.cf</a> and
76 <a href="master.5.html">master.cf</a> configuration files.
78 <b><a href="postconf.5.html#import_environment">import_environment</a> (see 'postconf -d' output)</b>
79 The list of environment parameters that a Postfix
80 process will import from a non-Postfix parent
81 process.
83 <b><a href="postconf.5.html#queue_directory">queue_directory</a> (see 'postconf -d' output)</b>
84 The location of the Postfix top-level queue direc-
85 tory.
87 <b><a href="postconf.5.html#syslog_facility">syslog_facility</a> (mail)</b>
88 The syslog facility of Postfix logging.
90 <b><a href="postconf.5.html#syslog_name">syslog_name</a> (see 'postconf -d' output)</b>
91 The mail system name that is prepended to the
92 process name in syslog records, so that "smtpd"
93 becomes, for example, "postfix/smtpd".
95 <b><a href="postconf.5.html#trigger_timeout">trigger_timeout</a> (10s)</b>
96 The time limit for sending a trigger to a Postfix
97 daemon (for example, the <a href="pickup.8.html"><b>pickup</b>(8)</a> or <a href="qmgr.8.html"><b>qmgr</b>(8)</a> dae-
98 mon).
100 Available in Postfix version 2.2 and later:
102 <b><a href="postconf.5.html#authorized_submit_users">authorized_submit_users</a> (static:anyone)</b>
103 List of users who are authorized to submit mail
104 with the <a href="sendmail.1.html"><b>sendmail</b>(1)</a> command (and with the privi-
105 leged <a href="postdrop.1.html"><b>postdrop</b>(1)</a> helper command).
107 <b>FILES</b>
108 /var/spool/postfix/<a href="QSHAPE_README.html#maildrop_queue">maildrop</a>, <a href="QSHAPE_README.html#maildrop_queue">maildrop queue</a>
110 <b>SEE ALSO</b>
111 <a href="sendmail.1.html">sendmail(1)</a>, compatibility interface
112 <a href="postconf.5.html">postconf(5)</a>, configuration parameters
113 syslogd(8), system logging
115 <b>LICENSE</b>
116 The Secure Mailer license must be distributed with this
117 software.
119 <b>AUTHOR(S)</b>
120 Wietse Venema
121 IBM T.J. Watson Research
122 P.O. Box 704
123 Yorktown Heights, NY 10598, USA
125 POSTDROP(1)
126 </pre> </body> </html>