POSTCONF(1)                 General Commands Manual                POSTCONF(1)

NAME
       postconf - Postfix configuration utility

SYNOPSIS
       Managing main.cf:

       postconf [-dfhnovx] [-c config_dir] [-C class,...] [param‐
       eter ...]

       postconf [-ev] [-c config_dir] [parameter=value ...]

       postconf [-#vX] [-c config_dir] [parameter ...]

       Managing master.cf:

       postconf [-fMovx] [-c config_dir] [service ...]

       Managing bounce message templates:

       postconf [-btv] [-c config_dir] [template_file]

       Managing other configuration:

       postconf [-aAlmv] [-c config_dir]

DESCRIPTION
       By default, the postconf(1) command displays the values of
       main.cf configuration parameters, and warns about possible
       mis-typed parameter names (Postfix 2.9 and later).  It can
       also  change  main.cf  configuration  parameter values, or
       display other configuration information about the  Postfix
       mail system.

       Options:

       -a     List  the available SASL server plug-in types.  The
              SASL   plug-in   type   is   selected   with    the
              smtpd_sasl_type configuration parameter by specify‐
              ing one of the names listed below.

              cyrus  This server plug-in is available when  Post‐
                     fix is built with Cyrus SASL support.

              dovecot
                     This server plug-in uses the Dovecot authen‐
                     tication server, and is available when Post‐
                     fix is built with any form of SASL support.

              This  feature  is  available  with  Postfix 2.3 and
              later.

       -A     List the available SASL client plug-in types.   The
              SASL    plug-in   type   is   selected   with   the
              smtp_sasl_type  or   lmtp_sasl_type   configuration
              parameters  by  specifying  one of the names listed
              below.

              cyrus  This client plug-in is available when  Post‐
                     fix is built with Cyrus SASL support.

              This  feature  is  available  with  Postfix 2.3 and
              later.

       -b [template_file]
              Display the message text that appears at the begin‐
              ning  of  delivery  status  notification (DSN) mes‐
              sages, replacing $name expressions with actual val‐
              ues as described in bounce(5).

              To  override the built-in templates, specify a tem‐
              plate file name at the end of the postconf(1)  com‐
              mand  line,  or specify a file name in main.cf with
              the bounce_template_file parameter.

              To force selection of the built-in templates, spec‐
              ify  an empty template file name on the postconf(1)
              command line (in shell language: "").

              This feature is  available  with  Postfix  2.3  and
              later.

       -c config_dir
              The  main.cf  configuration  file  is  in the named
              directory  instead  of  the  default  configuration
              directory.

       -C class,...
              When  displaying  main.cf  parameters,  select only
              parameters from the specified class(es):

              builtin
                     Parameters with built-in names.

              service
                     Parameters with service-defined  names  (the
                     first  field  of  a  master.cf  entry plus a
                     Postfix-defined suffix).

              user   Parameters with user-defined names.

              all    All the above classes.

              The default is as if "-C all" is specified.

       -d     Print main.cf default parameter settings instead of
              actual  settings.   Specify  -df to fold long lines
              for human readability (Postfix 2.9 and later).

       -e     Edit the main.cf  configuration  file,  and  update
              parameter  settings  with the "name=value" pairs on
              the postconf(1) command line. The file is copied to
              a  temporary file then renamed into place.  Specify
              quotes to protect special characters and whitespace
              on the postconf(1) command line.

              The -e is no longer needed with Postfix version 2.8
              and later.

       -f     Fold long lines when printing main.cf or  master.cf
              configuration file entries, for human readability.

              This  feature  is  available  with  Postfix 2.9 and
              later.

       -h     Show main.cf parameter values without the "name = "
              label that normally precedes the value.

       -l     List  the  names  of  all supported mailbox locking
              methods.  Postfix supports the following methods:

              flock  A kernel-based advisory locking  method  for
                     local  files  only.   This locking method is
                     available on systems with a  BSD  compatible
                     library.

              fcntl  A  kernel-based  advisory locking method for
                     local and remote files.

              dotlock
                     An  application-level  locking  method.   An
                     application  locks  a file named filename by
                     creating a file  named  filename.lock.   The
                     application  is  expected  to remove its own
                     lock file, as well as stale lock files  that
                     were left behind after abnormal program ter‐
                     mination.

       -m     List the names of all supported lookup table types.
              In  Postfix  configuration files, lookup tables are
              specified as type:name, where type is  one  of  the
              types  listed  below. The table name syntax depends
              on the lookup table type as described in the  DATA‐
              BASE_README document.

              btree  A  sorted,  balanced tree structure.  Avail‐
                     able on systems with support for Berkeley DB
                     databases.

              cdb    A  read-optimized  structure with no support
                     for incremental updates.  Available on  sys‐
                     tems with support for CDB databases.

              cidr   A  table  that associates values with Class‐
                     less Inter-Domain Routing  (CIDR)  patterns.
                     This is described in cidr_table(5).

              dbm    An  indexed  file  type  based  on  hashing.
                     Available on systems with  support  for  DBM
                     databases.

              environ
                     The  UNIX  process  environment  array.  The
                     lookup key is the variable name.  Originally
                     implemented  for  testing,  someone may find
                     this useful someday.

              fail   A table that reliably  fails  all  requests.
                     The  lookup  table name is used for logging.
                     This table exists to simplify Postfix  error
                     tests.

              hash   An  indexed  file  type  based  on  hashing.
                     Available on systems with support for Berke‐
                     ley DB databases.

              internal
                     A non-shared, in-memory hash table. Its con‐
                     tent are lost when a process terminates.

              lmdb   OpenLDAP  LMDB  database  (a  memory-mapped,
                     persistent file).  Available on systems with
                     support  for  LMDB   databases.    This   is
                     described in lmdb_table(5).

              ldap (read-only)
                     LDAP  database  client. This is described in
                     ldap_table(5).

              memcache
                     Memcache database client. This is  described
                     in memcache_table(5).

              mysql (read-only)
                     MySQL database client.  Available on systems
                     with support for MySQL databases.   This  is
                     described in mysql_table(5).

              pcre (read-only)
                     A lookup table based on Perl Compatible Reg‐
                     ular  Expressions.   The  file   format   is
                     described in pcre_table(5).

              pgsql (read-only)
                     PostgreSQL    database   client.   This   is
                     described in pgsql_table(5).

              proxy  Postfix proxymap(8) client for shared access
                     to  Postfix databases. The table name syntax
                     is type:name.

              regexp (read-only)
                     A lookup table based on regular expressions.
                     The  file  format is described in regexp_ta‐
                     ble(5).

              sdbm   An  indexed  file  type  based  on  hashing.
                     Available  on  systems with support for SDBM
                     databases.

              socketmap (read-only)
                     Sendmail-style socketmap client.  The  table
                     name  is  inet:host:port:name  for  a TCP/IP
                     server, or unix:pathname:name  for  a  UNIX-
                     domain  server.  This  is described in sock‐
                     etmap_table(5).

              sqlite (read-only)
                     SQLite  database.  This  is   described   in
                     sqlite_table(5).

              static (read-only)
                     A  table  that  always  returns  its name as
                     lookup result.  For  example,  static:foobar
                     always  returns  the string foobar as lookup
                     result.

              tcp (read-only)
                     TCP/IP client. The protocol is described  in
                     tcp_table(5).

              texthash (read-only)
                     Produces  similar  results  as  hash: files,
                     except  that  you  don't  need  to  run  the
                     postmap(1)  command  before  you can use the
                     file, and that it does  not  detect  changes
                     after the file is read.

              unix (read-only)
                     A  limited  view  of the UNIX authentication
                     database. The following  tables  are  imple‐
                     mented:

                     unix:passwd.byname
                            The  table is the UNIX password data‐
                            base. The key is a login  name.   The
                            result  is  a  password file entry in
                            passwd(5) format.

                     unix:group.byname
                            The table is the UNIX group database.
                            The  key is a group name.  The result
                            is a group  file  entry  in  group(5)
                            format.

              Other  table types may exist depending on how Post‐
              fix was built.

       -M     Show master.cf file  contents  instead  of  main.cf
              file  contents.  Specify -Mf to fold long lines for
              human readability.

              If service ... is specified, only the matching ser‐
              vices  will  be  output. For example, "postconf -Mf
              inet" will output all services that listen  on  the
              network.

              Specify  zero  or  more arguments, each with a ser‐
              vice-type name (inet, unix, fifo, or pass) or  with
              a  service-name.service-type  pair,  where service-
              name is the first field of a master.cf entry.

              This feature is  available  with  Postfix  2.9  and
              later.

       -n     Show   only   configuration  parameters  that  have
              explicit name=value settings in  main.cf.   Specify
              -nf to fold long lines for human readability (Post‐
              fix 2.9 and later).

       -o name=value
              Override main.cf parameter settings.

              This feature is available  with  Postfix  2.10  and
              later.

       -t [template_file]
              Display  the templates for text that appears at the
              beginning of  delivery  status  notification  (DSN)
              messages, without expanding $name expressions.

              To  override the built-in templates, specify a tem‐
              plate file name at the end of the postconf(1)  com‐
              mand  line,  or specify a file name in main.cf with
              the bounce_template_file parameter.

              To force selection of the built-in templates, spec‐
              ify  an empty template file name on the postconf(1)
              command line (in shell language: "").

              This feature is  available  with  Postfix  2.3  and
              later.

       -v     Enable verbose logging for debugging purposes. Mul‐
              tiple -v options  make  the  software  increasingly
              verbose.

       -x     Expand $name in main.cf or master.cf parameter val‐
              ues. The expansion is recursive.

              This feature is available  with  Postfix  2.10  and
              later.

       -X     Edit the main.cf configuration file, and remove the
              parameters named on the postconf(1)  command  line.
              The file is copied to a temporary file then renamed
              into place.  Specify a list of parameter names, not
              "name=value"  pairs.   There is no postconf(1) com‐
              mand to perform the reverse operation.

              This feature is available  with  Postfix  2.10  and
              later.

       -#     Edit  the  main.cf  configuration file, and comment
              out the parameters named on the postconf(1) command
              line,  so  that  those  parameters  revert to their
              default values.  The file is copied to a  temporary
              file  then  renamed  into place.  Specify a list of
              parameter names, not "name=value" pairs.  There  is
              no postconf(1) command to perform the reverse oper‐
              ation.

              This feature is  available  with  Postfix  2.6  and
              later.

DIAGNOSTICS
       Problems are reported to the standard error stream.

ENVIRONMENT
       MAIL_CONFIG
              Directory with Postfix configuration files.

CONFIGURATION PARAMETERS
       The  following  main.cf parameters are especially relevant
       to this program.

       The text below provides  only  a  parameter  summary.  See
       postconf(5) for more details including examples.

       config_directory (see 'postconf -d' output)
              The  default  location  of  the Postfix main.cf and
              master.cf configuration files.

       bounce_template_file (empty)
              Pathname of a configuration file with  bounce  mes‐
              sage templates.

FILES
       /etc/postfix/main.cf, Postfix configuration parameters
       /etc/postfix/master.cf, Postfix master daemon configuraton

SEE ALSO
       bounce(5), bounce template file format
       master(5), master.cf configuration file syntax
       postconf(5), main.cf configuration file syntax

README FILES
       DATABASE_README, Postfix lookup table overview

LICENSE
       The Secure Mailer license must be  distributed  with  this
       software.

AUTHOR(S)
       Wietse Venema
       IBM T.J. Watson Research
       P.O. Box 704
       Yorktown Heights, NY 10598, USA

                                                                   POSTCONF(1)