POSTCONF(1) POSTCONF(1)
[1mNAME[0m
postconf - Postfix configuration utility
[1mSYNOPSIS[0m
[1mpostconf [22m[[1m-dhnv[22m] [[1m-c [4m[22mconfig_dir[24m] [[4mparameter[24m [4m...[24m]
[1mpostconf [22m[[1m-aAmlv[22m] [[1m-c [4m[22mconfig_dir[24m]
[1mpostconf [22m[[1m-ev[22m] [[1m-c [4m[22mconfig_dir[24m] [[4mparameter=value[24m [4m...[24m]
[1mpostconf [22m[[1m-btv[22m] [[1m-c [4m[22mconfig_dir[24m] [[4mtemplate_file[24m]
[1mDESCRIPTION[0m
The [1mpostconf[22m(1) command displays the actual values of con-
figuration parameters, changes configuration parameter
values, or displays other configuration information about
the Postfix mail system.
Options:
[1m-a [22mList the available SASL server plug-in types. The
SASL plug-in type is selected with the
[1msmtpd_sasl_type [22mconfiguration parameter by specify-
ing one of the names listed below.
[1mcyrus [22mThis server plug-in is available when Post-
fix is built with Cyrus SASL support.
[1mdovecot[0m
This server plug-in requires the Dovecot
authentication server.
This feature is available with Postfix 2.3 and
later.
[1m-A [22mList the available SASL client plug-in types. The
SASL plug-in type is selected with the
[1msmtp_sasl_type [22mor [1mlmtp_sasl_type [22mconfiguration
parameters by specifying one of the names listed
below.
[1mcyrus [22mThis client plug-in is available when Post-
fix is built with Cyrus SASL support.
This feature is available with Postfix 2.3 and
later.
[1m-b [22m[[4mtemplate_file[24m]
Display the message text that appears at the begin-
ning of delivery status notification (DSN) mes-
sages, with $[1mname [22mexpressions 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 [1mbounce_template_file [22mparameter. To force
selection of the built-in message text templates,
specify an empty template file name (in shell lan-
guage: "").
This feature is available with Postfix 2.3 and
later.
[1m-c [4m[22mconfig_dir[0m
The [1mmain.cf [22mconfiguration file is in the named
directory instead of the default configuration
directory.
[1m-d [22mPrint default parameter settings instead of actual
settings.
[1m-e [22mEdit the [1mmain.cf [22mconfiguration 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.
[1m-h [22mShow parameter values only, not the ''name = ''
label that normally precedes the value.
[1m-l [22mList the names of all supported mailbox locking
methods. Postfix supports the following methods:
[1mflock [22mA kernel-based advisory locking method for
local files only. This locking method is
available on systems with a BSD compatible
library.
[1mfcntl [22mA kernel-based advisory locking method for
local and remote files.
[1mdotlock[0m
An application-level locking method. An
application locks a file named [4mfilename[24m by
creating a file named [4mfilename[24m[1m.lock[22m. The
application is expected to remove its own
lock file, as well as stale lock files that
were left behind after abnormal termination.
[1m-m [22mList the names of all supported lookup table types.
In Postfix configuration files, lookup tables are
specified as [4mtype[24m[1m:[4m[22mname[24m, where [4mtype[24m is one of the
types listed below. The table [4mname[24m syntax depends
on the lookup table type as described in the DATA-
BASE_README document.
[1mbtree [22mA sorted, balanced tree structure. This is
available on systems with support for Berke-
ley DB databases.
[1mcdb [22mA read-optimized structure with no support
for incremental updates. This is available
on systems with support for CDB databases.
[1mcidr [22mA table that associates values with Class-
less Inter-Domain Routing (CIDR) patterns.
This is described in [1mcidr_table[22m(5).
[1mdbm [22mAn indexed file type based on hashing. This
is available on systems with support for DBM
databases.
[1menviron[0m
The UNIX process environment array. The
lookup key is the variable name. Originally
implemented for testing, someone may find
this useful someday.
[1mhash [22mAn indexed file type based on hashing. This
is available on systems with support for
Berkeley DB databases.
[1mldap [22m(read-only)
Perform lookups using the LDAP protocol.
This is described in [1mldap_table[22m(5).
[1mmysql [22m(read-only)
Perform lookups using the MYSQL protocol.
This is described in [1mmysql_table[22m(5).
[1mpcre [22m(read-only)
A lookup table based on Perl Compatible Reg-
ular Expressions. The file format is
described in [1mpcre_table[22m(5).
[1mpgsql [22m(read-only)
Perform lookups using the PostgreSQL proto-
col. This is described in [1mpgsql_table[22m(5).
[1mproxy [22m(read-only)
A lookup table that is implemented via the
Postfix [1mproxymap[22m(8) service. The table name
syntax is [4mtype[24m[1m:[4m[22mname[24m.
[1mregexp [22m(read-only)
A lookup table based on regular expressions.
The file format is described in [1mregexp_ta-[0m
[1mble[22m(5).
[1msdbm [22mAn indexed file type based on hashing. This
is available on systems with support for
SDBM databases.
[1mstatic [22m(read-only)
A table that always returns its name as
lookup result. For example, [1mstatic:foobar[0m
always returns the string [1mfoobar [22mas lookup
result.
[1mtcp [22m(read-only)
Perform lookups using a simple request-reply
protocol that is described in [1mtcp_table[22m(5).
This feature is not included with Postfix
2.2.
[1munix [22m(read-only)
A limited way to query the UNIX authentica-
tion database. The following tables are
implemented:
[1munix:passwd.byname[0m
The table is the UNIX password data-
base. The key is a login name. The
result is a password file entry in
[1mpasswd[22m(5) format.
[1munix:group.byname[0m
The table is the UNIX group database.
The key is a group name. The result
is a group file entry in [1mgroup[22m(5)
format.
Other table types may exist depending on how Post-
fix was built.
[1m-n [22mPrint parameter settings that are not left at their
built-in default value, because they are explicitly
specified in main.cf.
[1m-t [22m[[4mtemplate_file[24m]
Display the templates for delivery status notifica-
tion (DSN) messages. To override the built-in tem-
plates, specify a template file at the end of the
command line, or specify a template file in main.cf
with the [1mbounce_template_file [22mparameter. 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.
[1m-v [22mEnable verbose logging for debugging purposes. Mul-
tiple [1m-v [22moptions make the software increasingly
verbose.
[1mDIAGNOSTICS[0m
Problems are reported to the standard error stream.
[1mENVIRONMENT[0m
[1mMAIL_CONFIG[0m
Directory with Postfix configuration files.
[1mCONFIGURATION PARAMETERS[0m
The following [1mmain.cf [22mparameters are especially relevant
to this program.
The text below provides only a parameter summary. See
[1mpostconf[22m(5) for more details including examples.
[1mconfig_directory (see 'postconf -d' output)[0m
The default location of the Postfix main.cf and
master.cf configuration files.
[1mbounce_template_file (empty)[0m
Pathname of a configuration file with bounce mes-
sage templates.
[1mFILES[0m
/etc/postfix/main.cf, Postfix configuration parameters
[1mSEE ALSO[0m
bounce(5), bounce template file format
postconf(5), configuration parameters
[1mREADME FILES[0m
[1mtory[22m" to locate this information.
DATABASE_README, Postfix lookup table overview
[1mLICENSE[0m
The Secure Mailer license must be distributed with this
software.
[1mAUTHOR(S)[0m
Wietse Venema
IBM T.J. Watson Research
P.O. Box 704
Yorktown Heights, NY 10598, USA
POSTCONF(1)