Copyright (c) 2010-2018 Dovecot authors, see the included COPYING file
DOVECOT-LDA 1 "2011-01-16" "Dovecot v2.3" "Dovecot"
NAME
dovecot-lda - Dovecot\(aqs local mail delivery agent ------------------------------------------------------------------------
SYNOPSIS
dovecot-lda [ -ek ] [-a address] [-c config_file] [-d username] [-f envelope_sender] [-m mailbox] [-o setting=value] [-p path] ------------------------------------------------------------------------
DESCRIPTION
The dovecot-lda is a local mail delivery agent which takes mail from an MTA and delivers it to a user\(aqs mailbox, while keeping Dovecot index files up to date.

Main features of the dovecot-lda are:

4 * Mailbox indexing during mail delivery, providing faster mailbox access later

* Quota enforcing by the quota plugin

* Sieve language support by the Pigeonhole sieve plugin ------------------------------------------------------------------------

OPTIONS
Options accepted by dovecot-lda : -------------------------------------

-a address Destination address (e.g. user+ext@domain). Default is the same as username . -------------------------------------

-c config_file Alternative configuration file path. -------------------------------------

-d username Destination username . If given, the user information is looked up from userdb. Typically used with virtual users, but not necessarily with system users. -------------------------------------

-e If mail gets rejected, write the rejection reason to stderr and exit with status 77 (EX_NOPERM). The default is to send a rejection mail ourself. -------------------------------------

-f envelope_sender Envelope sender address. -------------------------------------

-k Don\(aqt clear all environment at startup. -------------------------------------

-m mailbox Destination mailbox (default is INBOX ). If the mailbox doesn\(aqt exist, it will not be created (unless the lda_mailbox_autocreate setting is set to yes ). If a message couldn\(aqt be saved to the mailbox for any reason, it\(aqs delivered to INBOX instead. ---------------------------------

-o setting = value Overrides the configuration setting from @pkgsysconfdir@/dovecot.conf and from the userdb with the given value . In order to override multiple settings, the -o option may be specified multiple times. -------------------------------------

-p path Path to the mail to be delivered instead of reading from stdin. If using maildir the file is hard linked to the destination if possible. This allows a single mail to be delivered to multiple users using hard links, but currently it also prevents deliver from updating cache file so it shouldn\(aqt be used unless really necessary. ------------------------------------------------------------------------

"EXIT STATUS"
dovecot-lda will exit with one of the following values:

4 0 Delivery was successful. (EX_OK)

64 Invalid parameter given. (EX_USAGE)

77 -e option was used and mail was rejected. Typically this happens when user is over quota and quota_full_tempfail = no is configured. (EX_NOPERM)

75 A temporary failure. This is returned for almost all failures. See the log file for details. (EX_TEMPFAIL) ------------------------------------------------------------------------

FILES

@pkgsysconfdir@/dovecot.conf Dovecot\(aqs main configuration file.

@pkgsysconfdir@/conf.d/10-mail.conf Mailbox locations and namespaces.

@pkgsysconfdir@/conf.d/15-lda.conf LDA specific settings.

@pkgsysconfdir@/conf.d/90-plugin.conf Plugin specific settings.

@pkgsysconfdir@/conf.d/90-quota.conf Quota configuration. ------------------------------------------------------------------------
@INCLUDE:reporting-bugs@ ------------------------------------------------------------------------

SEE ALSO
doveadm (1), dovecot (1), doveconf (1), dsync (1)

Related MTA specific documentation: -------------------------------------

Postfix: postconf (5), transport (5), pipe (8) -------------------------------------

Exim:

"The accept router"
http://exim.org/exim-html-current/doc/html/spec_html/ch16.html
"Generic options for transports"
http://exim.org/exim-html-current/doc/html/spec_html/ch24.html
"The pipe transport"
http://exim.org/exim-html-current/doc/html/spec_html/ch29.html