NAME
postconf
-
Postfix configuration utility
SYNOPSIS
ppoossttccoonnff [--ddhhnnvv] [--cc _c_o_n_f_i_g___d_i_r]
[_p_a_r_a_m_e_t_e_r _._._.]
ppoossttccoonnff [--aaAAmmllvv] [--cc _c_o_n_f_i_g___d_i_r]
ppoossttccoonnff [--eevv] [--cc _c_o_n_f_i_g___d_i_r]
[_p_a_r_a_m_e_t_e_r_=_v_a_l_u_e _._._.]
ppoossttccoonnff [--bbttvv] [--cc _c_o_n_f_i_g___d_i_r] [_t_e_m_p_l_a_t_e___f_i_l_e]
DESCRIPTION
The ppoossttccoonnff(1) command displays the actual values
of configuration parameters, changes configuration parameter
values, or displays other configuration information about
the Postfix mail system.
Options:
-
--aa
List the available SASL server plug-in types. The SASL
-
plug-in type is selected with the ssmmttppdd__ssaassll__ttyyppee
configuration parameter by specifying one of the names
listed below.
-
ccyyrruuss
This server plug-in is available when Postfix is built with
-
Cyrus SASL support.
-
ddoovveeccoott
This server plug-in requires the Dovecot authentication
-
server.
-
This feature is available with Postfix 2.3 and later.
-
-
--AA
List the available SASL client plug-in types. The SASL
-
plug-in type is selected with the ssmmttpp__ssaassll__ttyyppee or
llmmttpp__ssaassll__ttyyppee configuration parameters by specifying
one of the names listed below.
-
ccyyrruuss
This client plug-in is available when Postfix is built with
-
Cyrus SASL support.
-
This feature is available with Postfix 2.3 and later.
-
-
--bb [_t_e_m_p_l_a_t_e___f_i_l_e]
Display the message text that appears at the beginning of
-
delivery status notification (DSN) messages, with $nnaammee
expressions replaced by actual values. To override the
built-in message text, specify a template file at the end
of the command line, or specify a template file in main.cf
with the bboouunnccee__tteemmppllaattee__ffiillee parameter.
To force selection of the built-in message text templates,
specify an empty template file name (in shell language: "").
This feature is available with Postfix 2.3 and later.
-
--cc _c_o_n_f_i_g___d_i_r
The mmaaiinn..ccff configuration file is in the named directory
-
instead of the default configuration directory.
-
--dd
Print default parameter settings instead of actual settings.
-
-
--ee
Edit the mmaaiinn..ccff configuration file. The file is copied
-
to a temporary file then renamed into place. Parameters and
values are specified on the command line. Use quotes in order
to protect shell metacharacters and whitespace.
-
--hh
Show parameter values only, not the ``name = '' label
-
that normally precedes the value.
-
--ll
List the names of all supported mailbox locking methods.
-
Postfix supports the following methods:
-
fflloocckk
A kernel-based advisory locking method for local files only.
-
This locking method is available on systems with a BSD
compatible library.
-
ffccnnttll
A kernel-based advisory locking method for local and remote files.
-
-
ddoottlloocckk
An application-level locking method. An application locks a file
-
named _f_i_l_e_n_a_m_e by creating a file named _f_i_l_e_n_a_m_e..lloocckk.
The application is expected to remove its own lock file, as well as
stale lock files that were left behind after abnormal termination.
-
--mm
List the names of all supported lookup table types. In Postfix
-
configuration files,
lookup tables are specified as _t_y_p_e::_n_a_m_e, where
_t_y_p_e is one of the types listed below. The table _n_a_m_e
syntax depends on the lookup table type as described in the
DATABASE_README document.
-
bbttrreeee
A sorted, balanced tree structure.
-
This is available on systems with support for Berkeley DB
databases.
-
ccddbb
A read-optimized structure with no support for incremental updates.
-
This is available on systems with support for CDB databases.
-
cciiddrr
A table that associates values with Classless Inter-Domain Routing
-
(CIDR) patterns. This is described in cciiddrr__ttaabbllee(5).
-
ddbbmm
An indexed file type based on hashing.
-
This is available on systems with support for DBM databases.
-
eennvviirroonn
The UNIX process environment array. The lookup key is the variable
-
name. Originally implemented for testing, someone may find this
useful someday.
-
hhaasshh
An indexed file type based on hashing.
-
This is available on systems with support for Berkeley DB
databases.
-
llddaapp (read-only)
Perform lookups using the LDAP protocol. This is described
-
in llddaapp__ttaabbllee(5).
-
mmyyssqqll (read-only)
Perform lookups using the MYSQL protocol. This is described
-
in mmyyssqqll__ttaabbllee(5).
-
ppccrree (read-only)
A lookup table based on Perl Compatible Regular Expressions. The
-
file format is described in ppccrree__ttaabbllee(5).
-
ppggssqqll (read-only)
Perform lookups using the PostgreSQL protocol. This is described
-
in ppggssqqll__ttaabbllee(5).
-
pprrooxxyy (read-only)
A lookup table that is implemented via the Postfix
-
pprrooxxyymmaapp(8) service. The table name syntax is
_t_y_p_e::_n_a_m_e.
-
rreeggeexxpp (read-only)
A lookup table based on regular expressions. The file format is
-
described in rreeggeexxpp__ttaabbllee(5).
-
ssddbbmm
An indexed file type based on hashing.
-
This is available on systems with support for SDBM databases.
-
ssttaattiicc (read-only)
A table that always returns its name as lookup result. For example,
-
ssttaattiicc::ffoooobbaarr always returns the string ffoooobbaarr as lookup
result.
-
ttccpp (read-only)
Perform lookups using a simple request-reply protocol that is
-
described in ttccpp__ttaabbllee(5).
This feature is not included with the stable Postfix release.
-
uunniixx (read-only)
A limited way to query the UNIX authentication database. The
-
following tables are implemented:
-
uunniixx::ppaasssswwdd..bbyynnaammee
The table is the UNIX password database. The key is a login name.
-
The result is a password file entry in ppaasssswwdd(5) format.
-
uunniixx::ggrroouupp..bbyynnaammee
The table is the UNIX group database. The key is a group name.
-
The result is a group file entry in ggrroouupp(5) format.
-
Other table types may exist depending on how Postfix was built.
-
-
--nn
Print parameter settings that are not left at their built-in
-
default value, because they are explicitly specified in main.cf.
-
--tt [_t_e_m_p_l_a_t_e___f_i_l_e]
Display the templates for delivery status notification (DSN)
-
messages. To override the built-in templates, specify a
template file at the end of the command line, or specify a
template file in main.cf with the bboouunnccee__tteemmppllaattee__ffiillee
parameter. To force selection of the built-in templates,
specify an empty template file name (in shell language:
"").
This feature is available with Postfix 2.3 and later.
-
--vv
Enable verbose logging for debugging purposes. Multiple --vv
-
options make the software increasingly verbose.
DIAGNOSTICS
Problems are reported to the standard error stream.
ENVIRONMENT
-
MMAAIILL__CCOONNFFIIGG
Directory with Postfix configuration files.
-
CONFIGURATION PARAMETERS
The following mmaaiinn..ccff parameters are especially relevant to
this program.
The text below provides only a parameter summary. See
ppoossttccoonnff(5) for more details including examples.
-
ccoonnffiigg__ddiirreeccttoorryy ((sseeee ''ppoossttccoonnff --dd'' oouuttppuutt))
The default location of the Postfix main.cf and master.cf
-
configuration files.
-
bboouunnccee__tteemmppllaattee__ffiillee ((eemmppttyy))
Pathname of a configuration file with bounce message templates.
-
FILES
/etc/postfix/main.cf, Postfix configuration parameters
SEE ALSO
bounce(5), bounce template file format
postconf(5), configuration parameters
README FILES
Use "ppoossttccoonnff rreeaaddmmee__ddiirreeccttoorryy" or
"ppoossttccoonnff hhttmmll__ddiirreeccttoorryy" to locate this information.
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