Skip site navigation (1)Skip section navigation (2)

  
 
  

home | help
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 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't clear all environment at startup.

     -m mailbox
	    Destination mailbox (default is INBOX).  If the mailbox doesn't  ex-
	    ist,  it will not be created (unless the lda_mailbox_autocreate set-
	    ting 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  /usr/local/etc/dove-
	    cot/dovecot.conf and from the userdb with the given value.	In order
	    to override multiple settings, the -o option may be specified multi-
	    ple 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 possi-
	    ble.  This allows a single mail to be delivered  to  multiple  users
	    using hard links, but currently it also prevents deliver from updat-
	    ing 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_NOP-
	 ERM)

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

FILES
     /usr/local/etc/dovecot/dovecot.conf
	    Dovecot's main configuration file.

     /usr/local/etc/dovecot/conf.d/10-mail.conf
	    Mailbox locations and namespaces.

     /usr/local/etc/dovecot/conf.d/15-lda.conf
	    LDA specific settings.

     /usr/local/etc/dovecot/conf.d/90-plugin.conf
	    Plugin specific settings.

     /usr/local/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)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=deliver&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help