dovecot-lda(1) [debian man page]

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 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'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  neces-
	      sarily 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.

       -o setting=value
	      Overrides  the  configuration setting from /etc/dovecot/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 pos-
	      sible.   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 avail-
       able 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.1							    2011-01-16							    DOVECOT-LDA(1)

DOVECONF(1)							      Dovecot							       DOVECONF(1)

NAME

       doveconf - Dovecot's configuration dumping utility

SYNOPSIS

       doveconf [-adnNSx] [-c config-file] [-f filter] [-m module]
       doveconf [-n] [-c config-file] section_name ...
       doveconf [-h] [-c config-file] [-f filter] setting_name ...

DESCRIPTION

       doveconf reads and parses Dovecot's configuration files and converts them into a simpler format used by the rest of Dovecot. All standalone
       programs, such as dovecot(1) and dovecot-lda(1), will first get their settings by executing doveconf.

       For system administrators, doveconf is mainly useful for dumping the configuration in easy human readable output.

OPTIONS

       -a     Show all settings with their currently configured values.

       -c config-file
	      read configuration from the given config-file.  By default /etc/dovecot/dovecot.conf will be used.

       -d     Show the setting's default value instead of the one currently configured.

       -f filter
	      Show the matching configuration for the specified filter condition.  The filter option string has to be given  as  name=value  pair.
	      For multiple filter conditions the -f option can be supplied multiple times.
	      Possible names for the filter are:

	      lname  The local hostname, e.g. mail.example.com.  This will only match hostnames which were configured like:
		     local_name mail.example.com { # special settings }

	      local  The server's hostname or IP address.  This will also match hostnames which were configured like:
		     local imap.example.net { # special settings }

	      protocol, service
		     The protocol, e.g. imap or pop3

	      remote The client's hostname or IP address.

       -h     Hide the setting's name, show only the setting's value.

       -m module
	      Show only settings for the given module.
	      e.g.  imap, imap-login, lmtp, pop3 or pop3-login

       -n     Show only settings with non-default values.

       -N     Show settings with non-default values and explicitly set default values.

       -S     Dump settings in simplified machine parsable/readable format.

       -x     Expand  configuration  variables	(e.g.  $mail_plugins  => quota) and show file contents (from e.g. ssl_cert = </etc/ssl/certs/dove-
	      cot.pem).

       section_name
	      Show only the current configuration of one or more specified sections.

       setting_name
	      Show only the setting of one or more setting_name(s) with the currently configured value. You can show a setting	inside	a  section
	      using '/' as the section separator, e.g.	service/imap/executable.

EXAMPLE

       When Dovecot was configured to use different settings for some networks/subnets it is possible to show which settings will be applied for a
       specific connection.

       doveconf -f local=10.0.0.110 -f remote=10.11.1.2 -f service=pop3 -n

       doveconf can be also used to convert v1.x configuration files into v2.x format.

       doveconf -n -c /oldpath/dovecot.conf > /etc/dovecot/dovecot.conf.new

       This example shows how to ask doveconf for a global setting and a protocol specific setting.  The second command uses also the  -h  option,
       in order to hide the setting's name.

       doveconf mail_plugins
       mail_plugins = quota
       doveconf -h -f protocol=imap mail_plugins
       quota imap_quota

       This example demonstrates how to dump a whole configuration section.

       doveconf dict
       dict {
	 quota = pgsql:/etc/dovecot/dovecot-dict-sql.conf.ext
       }

       Or how to dump only the quota dict:

       doveconf dict/quota
       dict/quota = pgsql:/etc/dovecot/dovecot-dict-sql.conf.ext

REPORTING BUGS

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

SEE ALSO

       doveadm(1), dovecot(1), dovecot-lda(1), dsync(1)

Dovecot v2.2							    2012-01-29							       DOVECONF(1)