1DOVECOT-LDA(1)                      Dovecot                     DOVECOT-LDA(1)
2
3
4

NAME

6       dovecot-lda - Dovecot's local mail delivery agent
7

SYNOPSIS

9       dovecot-lda [-ek] [-a address] [-c config_file] [-d username] [-f enve‐
10       lope_sender] [-m mailbox] [-o setting=value] [-p path]
11

DESCRIPTION

13       The dovecot-lda is a local mail delivery agent which takes mail from an
14       MTA  and  delivers  it to a user's mailbox, while keeping Dovecot index
15       files up to date.
16
17       Main features of the dovecot-lda are:
18
19       *   Mailbox indexing during mail  delivery,  providing  faster  mailbox
20           access later
21
22       *   Quota enforcing by the quota plugin
23
24       *   Sieve language support by the Pigeonhole sieve plugin
25

OPTIONS

27       Options accepted by dovecot-lda:
28
29       -a address
30              Destination  address (e.g. user+ext@domain). Default is the same
31              as username.
32
33       -c config_file
34              Alternative configuration file path.
35
36       -d username
37              Destination username.  If given, the user information is  looked
38              up from userdb.  Typically used with virtual users, but not nec‐
39              essarily with system users.
40
41       -e     If mail gets rejected, write the rejection reason to stderr  and
42              exit  with  status  77  (EX_NOPERM).   The  default is to send a
43              rejection mail ourself.
44
45       -f envelope_sender
46              Envelope sender address.
47
48       -k     Don't clear all environment at startup.
49
50       -m mailbox
51              Destination mailbox (default is INBOX).  If the mailbox  doesn't
52              exist, it will not be created (unless the lda_mailbox_autocreate
53              setting is set to yes).  If a message couldn't be saved  to  the
54              mailbox for any reason, it's delivered to INBOX instead.
55
56       -o setting=value
57              Overrides  the  configuration  setting  from  /etc/dovecot/dove‐
58              cot.conf and from the userdb with the given value.  In order  to
59              override  multiple settings, the -o option may be specified mul‐
60              tiple times.
61
62       -p path
63              Path to the mail to be delivered instead of reading from  stdin.
64              If  using  maildir the file is hard linked to the destination if
65              possible.  This allows a single mail to be delivered to multiple
66              users  using  hard links, but currently it also prevents deliver
67              from updating cache file so it shouldn't be used  unless  really
68              necessary.
69

EXIT STATUS

71       dovecot-lda will exit with one of the following values:
72
73       0   Delivery was successful. (EX_OK)
74
75       64  Invalid parameter given. (EX_USAGE)
76
77       77  -e  option  was used and mail was rejected.  Typically this happens
78           when user is over quota and quota_full_tempfail = no is configured.
79           (EX_NOPERM)
80
81       75  A  temporary failure. This is returned for almost all failures. See
82           the log file for details. (EX_TEMPFAIL)
83

FILES

85       /etc/dovecot/dovecot.conf
86              Dovecot's main configuration file.
87
88       /etc/dovecot/conf.d/10-mail.conf
89              Mailbox locations and namespaces.
90
91       /etc/dovecot/conf.d/15-lda.conf
92              LDA specific settings.
93
94       /etc/dovecot/conf.d/90-plugin.conf
95              Plugin specific settings.
96
97       /etc/dovecot/conf.d/90-quota.conf
98              Quota configuration.
99

REPORTING BUGS

101       Report bugs, including doveconf -n output, to the Dovecot Mailing  List
102       <dovecot@dovecot.org>.   Information  about reporting bugs is available
103       at: http://dovecot.org/bugreport.html
104

SEE ALSO

106       doveadm(1), dovecot(1), doveconf(1), dsync(1)
107
108       Related MTA specific documentation:
109
110       Postfix:
111              postconf(5), transport(5), pipe(8)
112
113       Exim:
114
115       The accept router
116              http://exim.org/exim-html-current/doc/html/spec_html/ch16.html
117
118       Generic options for transports
119              http://exim.org/exim-html-current/doc/html/spec_html/ch24.html
120
121       The pipe transport
122              http://exim.org/exim-html-current/doc/html/spec_html/ch29.html
123
124
125
126Dovecot v2.2                      2011-01-16                    DOVECOT-LDA(1)
Impressum