deliver

DOVECOT-LDA(1)                      Dovecot                     DOVECOT-LDA(1)

NAME
       dovecot-lda - Dovecot's local mail delivery agent

SYNOPSIS
       dovecot-lda [-ek] [-a address] [-c config_file] [-d username] [-f enve-
       lope_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'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 ac-
           cess 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 re-
              jection 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.

       -o setting=value
              Overrides  the  configuration  setting  from  /etc/dovecot/dove-
              cot.conf and from the userdb with the given value.  In order  to
              override  multiple settings, the -o option may be specified mul-
              tiple 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't be used  unless  really
              necessary.

EXIT STATUS
       dovecot-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 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

Dovecot v2.3                      2011-01-16                    DOVECOT-LDA(1)