ScriptInstallation.In

postconf - Postfix configuration utility

postconf [-dhnv] [-c config_dir] [parameter ...]
postconf [-aAmlv] [-c config_dir]
postconf [-ev] [-c config_dir] [parameter=value ...]
postconf [-btv] [-c config_dir] [template_file]

The postconf command displays the actual values of configuration parameters, changes configuration parameter values, or displays other configuration information about the Postfix mail system.

postconf -a

List the available SASL server plug-in types. The SASL plug-in type is selected with the smtpd_sasl_type configuration parameer by specifying one of the names listed below.

cyrus - This server plug-in is available when Postfix is built with Cyrus SASL support.

dovecot - This server plug-in requires the Dovecot authentication server.

postconf -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 Postfix is built with Cyrus SASL support.

postconf -b [template_file]

Display the message text that appears at the beginning of delivery status notification (DSN) messages, with $name 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 bounce_template_file parameter. To force selection of the built-in message text templates, specify an empty template file name (in shell language: "").

postconf -c config_dir

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

postconf -d

Print default parameter settings instead of actual settings.

postconf -e

Edit the main.cf 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.

postconf -h

Show parameter values only, not the ``name = '' label that normally precedes the value.

postconf -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 termination.

server22# postconf -l
flock
fcntl
dotlock
server22#

postconf -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 DATABASE_README document.

btree - A sorted, balanced tree structure. This is available on systems with support for Berkeley DB databases.
cdb - A read-optimized structure with no support for incremental updates. This is available on systems with support for CDB databases.
cidr - A table that associates values with Classless Inter-Domain Routing (CIDR) patterns. This is described in cidr_table(5).
dbm - An indexed file type based on hashing. This is 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, some one may find this useful someday.
hash - An indexed file type based on hashing. This is available on systems with support for Berkeley DB databases.
ldap (read-only) - Perform lookups using the LDAP protocol. This is described in ldap_table(5).
mysql (read-only) - Perform lookups using the MYSQL protocol. This is described in mysql_table(5).
pcre (read-only) - A lookup table based on Perl Compatible Regular Expressions. The file format is described in pcre_table(5).
pgsql (read-only) - Perform lookups using the PostgreSQL protocol. This is described in pgsql_table(5).
proxy (read-only) - A lookup table that is implemented via the Postfix proxymap(8) service. The table name syntax is type:name.
regexp (read-only) - A lookup table based on regular expressions. The file format is described in regexp_table(5).
sdbm - An indexed file type based on hashing. This is available on systems with support for SDBM databases.
static (read-only) - A table that always returns its name as lookup result. For example, static:foobar always returns the string foo- bar as lookup result.
tcp (read-only) - Perform lookups using a simple request-reply protocol that is described in tcp_table(5). This feature is not included with Postfix 2.2.
unix (read-only) - A limited way to query the UNIX authentication database.

server22# postconf -m
btree
cidr
environ
hash
pcre
proxy
regexp
static
tcp
unix
server22#

Other table types may exist depending on how Postfix was built.

postconf -n

Print parameter settings that are not left at their built-in default value, because they are explicitly specified in main.cf.

server22# postconf -n
command_directory = /usr/local/sbin
config_directory = /usr/local/etc/postfix
daemon_directory = /usr/local/libexec/postfix
debug_peer_level = 2
html_directory = no
mail_owner = postfix
mailq_path = /usr/local/bin/mailq
manpage_directory = /usr/local/man
mydestination = $myhostname, localhost.$mydomain,
    localhost, $mydomain, webcash.in
mynetworks_style = host
newaliases_path = /usr/local/bin/newaliases
queue_directory = /var/spool/postfix
readme_directory = no
sample_directory = /usr/local/etc/postfix
sendmail_path = /usr/local/sbin/sendmail
setgid_group = maildrop
unknown_local_recipient_reject_code = 550
server22#

postconf -t [template_file]

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 bounce_template_file parameter. To force selection of the built-in templates, specify an empty template file name (in shell language: "").

postconf -v

Enable verbose logging for debugging purposes. Multiple -v options make the software increasingly verbose.

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 con- figuration files.

bounce_template_file (empty)

Pathname of a configuration file with bounce message templates.