doveconf

Langue: en

Version: 2010-06-26 (fedora - 01/12/10)

Section: 1 (Commandes utilisateur)

NAME

doveconf - Dovecotaqs configuration dumping utility

SYNOPSIS

doveconf [-anNx] [-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 Dovecotaqs 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.
-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 serveraqs 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 clientaqs hostname or IP address.
-h
Hide the settingaqs name, show only the settingaqs 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.
-x
Expand configuration variables (e.g. Domail_plugins rA quota) and show file contents (from e.g. ssl_cert = </etc/ssl/certs/dovecot.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.

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.0 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 settingaqs 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
 }
 

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), dovecot-lda(1), dsync(1)