DOVECONF(1) - phpMan

DOVECONF(1)                                  Dovecot                                  DOVECONF(1)



NAME
       doveconf - Dovecot's configuration dumping utility

SYNOPSIS
       doveconf [-adnPNSx] [-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  dove-
       cot-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/dove-
              cot.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.

       -s     Show also hidden settings. The hidden settings should not be changed normally.


       -P     Show passwords and other sensitive values.

       -x     Expand  configuration  variables (e.g. $mail_plugins => 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 con-
              figured value. You can show a setting inside a section using '/' as the sec-
              tion 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  set-
       ting'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 <dove-
       cot AT dovecot.org>.  Information about reporting bugs is available  at:  http://dove-
       cot.org/bugreport.html

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



Dovecot v2.3                                2014-10-19                                DOVECONF(1)

Generated by $Id: phpMan.php,v 4.55 2007/09/05 04:42:51 chedong Exp $ Author: Che Dong
On Apache
Under GNU General Public License
2024-04-19 07:12 @3.133.109.30 CrawledBy Mozilla/5.0 AppleWebKit/537.36 (KHTML, like Gecko; compatible; ClaudeBot/1.0; +claudebot@anthropic.com)