📖 NAME
postdrop - Postfix mail posting utility
🚀 Quick Reference
| Use Case | Command | Description |
|---|
| Submit mail to maildrop | postdrop | Creates a file in maildrop directory from stdin |
| Specify config directory | postdrop -c config_dir | Use alternate configuration directory |
| Verbose debugging | postdrop -v | Enable verbose logging (super-user only as of 2.3) |
| Internal protocol | postdrop -r | Use Postfix-internal protocol for reading/status |
📝 SYNOPSIS
postdrop [-rv] [-c config_dir]
📋 DESCRIPTION
The postdrop(1) command creates a file in the maildrop directory and copies its standard input to the file.
Options:
- -c config_dir 📁 The main.cf configuration file is in the named directory instead of the default configuration directory. See also the MAIL_CONFIG environment setting below.
- -r 🔄 Use a Postfix-internal protocol for reading the message from standard input, and for reporting status information on standard output. This is currently the only supported method.
- -v 🐞 Enable verbose logging for debugging purposes. Multiple -v options make the software increasingly verbose. As of Postfix 2.3, this option is available for the super-user only.
🔒 SECURITY
The command is designed to run with set-group ID privileges, so that it can write to the maildrop queue directory and so that it can connect to Postfix daemon processes.
🩺 DIAGNOSTICS
Fatal errors: malformed input, I/O error, out of memory. Problems are logged to syslogd(8) or postlogd(8) and to the standard error stream. When the input is incomplete, or when the process receives a HUP, INT, QUIT or TERM signal, the queue file is deleted.
🌐 ENVIRONMENT
MAIL_CONFIG 📁 Directory with the main.cf file. In order to avoid exploitation of set-group ID privileges, a non-standard directory is allowed only if:
- The name is listed in the standard main.cf file with the alternate_config_directories configuration parameter.
- The command is invoked by the super-user.
⚙️ CONFIGURATION PARAMETERS
The following main.cf parameters are especially relevant to this program. The text below provides only a parameter summary. See postconf(5) for more details including examples.
- alternate_config_directories (empty) 🔄 A list of non-default Postfix configuration directories that may be specified with "-c config_directory" on the command line (in the case of sendmail(1), with the "-C" option), or via the MAIL_CONFIG environment parameter.
- config_directory (see 'postconf -d' output) 📁 The default location of the Postfix main.cf and master.cf configuration files.
- import_environment (see 'postconf -d' output) 🌐 The list of environment parameters that a privileged Postfix process will import from a non-Postfix parent process, or name=value environment overrides.
- queue_directory (see 'postconf -d' output) 📁 The location of the Postfix top-level queue directory.
- syslog_facility (mail) 📝 The syslog facility of Postfix logging.
- syslog_name (see 'postconf -d' output) 🏷️ A prefix that is prepended to the process name in syslog records, so that, for example, "smtpd" becomes "prefix/smtpd".
- trigger_timeout (10s) ⏱️ The time limit for sending a trigger to a Postfix daemon (for example, the pickup(8) or qmgr(8) daemon).
- authorized_submit_users (static:anyone) 🔐 List of users who are authorized to submit mail with the sendmail(1) command (and with the privileged postdrop(1) helper command). (Available in Postfix version 2.2 and later)
- local_login_sender_maps (static:*) 📬 A list of lookup tables that are searched by the UNIX login name, and that return a list of allowed envelope sender patterns separated by space or comma. (Available in Postfix version 3.6 and later)
- empty_address_local_login_sender_maps_lookup_key (<>) 🔑 The lookup key to be used in local_login_sender_maps tables, instead of the null sender address. (Available in Postfix version 3.6 and later)
- recipient_delimiter (empty) ✂️ The set of characters that can separate an email address local-part, user name, or a .forward file name from its extension.
📁 FILES
/var/spool/postfix/maildrop, maildrop queue
📚 SEE ALSO
📜 LICENSE
The Secure Mailer license must be distributed with this software.
👤 AUTHOR(S)
Wietse Venema
IBM T.J. Watson Research
P.O. Box 704
Yorktown Heights, NY 10598, USA
Wietse Venema
Google, Inc.
111 8th Avenue
New York, NY 10011, USA
