DOVECOT-LDA(1) Dovecot DOVECOT-LDA(1)NAMEdovecot-lda - Dovecot's local mail delivery agent
SYNOPSISdovecot-lda [-ek] [-a address] [-c config_file] [-d username] [-f enve‐
lope_sender] [-m mailbox] [-p path]
DESCRIPTION
The dovecot-lda is a local mail delivery agent which takes mail from an
MTA and delivers it to a user's mailbox, while keeping Dovecot index
files up to date.
Main features of the dovecot-lda are:
* 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 nec‐
essarily 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't clear all environment at startup.
-m mailbox
Destination mailbox (default is INBOX). If the mailbox doesn't
exist, it will not be created (unless the lda_mailbox_autocreate
setting is set to yes). If a message couldn't be saved to the
mailbox for any reason, it's delivered to INBOX instead.
-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't be used unless really
necessary.
EXIT STATUSdovecot-lda will exit with one of the following values:
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
/etc/dovecot/dovecot.conf
Dovecot's main configuration file.
/etc/dovecot/conf.d/10-mail.conf
Mailbox locations and namespaces.
/etc/dovecot/conf.d/15-lda.conf
LDA specific settings.
/etc/dovecot/conf.d/90-plugin.conf
Plugin specific settings.
/etc/dovecot/conf.d/90-quota.conf
Quota configuration.
REPORTING BUGS
Report bugs, including doveconf -n output, to the Dovecot Mailing List
<dovecot@dovecot.org>. Information about reporting bugs is available
at: http://dovecot.org/bugreport.html
SEE ALSOdoveadm(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
Dovecot v2.0 2010-06-22 DOVECOT-LDA(1)
