Quelle  postconf.c

/*++
/* NAME
/* postconf 1
/* SUMMARY
/* Postfix configuration utility
/* SYNOPSIS
/* .fi
/* .ti -4
/* \fBManaging main.cf:\fR
/*
/* \fBpostconf\fR [\fB-dfhHjnopqvx\fR] [\fB-c \fIconfig_dir\fR]
/* [\fB-C \fIclass,...\fR] [\fIparameter ...\fR]
/*
/* \fBpostconf\fR [\fB-epv\fR] [\fB-c \fIconfig_dir\fR]
/* \fIparameter\fB=\fIvalue ...\fR
/*
/* \fBpostconf\fR \fB-#\fR [\fB-pv\fR] [\fB-c \fIconfig_dir\fR]
/* \fIparameter ...\fR
/*
/* \fBpostconf\fR \fB-X\fR [\fB-pv\fR] [\fB-c \fIconfig_dir\fR]
/* \fIparameter ...\fR
/*
/* .ti -4
/* \fBManaging master.cf service entries:\fR
/*
/* \fBpostconf\fR \fB-M\fR [\fB-joqvx\fR] [\fB-c \fIconfig_dir\fR]
/* [\fIservice\fR[\fB/\fItype\fR]\fI ...\fR]
/*
/* \fBpostconf\fR \fB-M\fR [\fB-ev\fR] [\fB-c \fIconfig_dir\fR]
/* \fIservice\fB/\fItype\fB=\fIvalue ...\fR
/*
/* \fBpostconf\fR \fB-M#\fR [\fB-v\fR] [\fB-c \fIconfig_dir\fR]
/* \fIservice\fB/\fItype ...\fR
/*
/* \fBpostconf\fR \fB-MX\fR [\fB-v\fR] [\fB-c \fIconfig_dir\fR]
/* \fIservice\fB/\fItype ...\fR
/*
/* .ti -4
/* \fBManaging master.cf service fields:\fR
/*
/* \fBpostconf\fR \fB-F\fR [\fB-fhHjoqvx\fR] [\fB-c \fIconfig_dir\fR]
/* [\fIservice\fR[\fB/\fItype\fR[\fB/\fIfield\fR]]\fI ...\fR]
/*
/* \fBpostconf\fR \fB-F\fR [\fB-ev\fR] [\fB-c \fIconfig_dir\fR]
/* \fIservice\fB/\fItype\fB/\fIfield\fB=\fIvalue ...\fR
/*
/* .ti -4
/* \fBManaging master.cf service parameters:\fR
/*
/* \fBpostconf\fR \fB-P\fR [\fB-fhHjoqvx\fR] [\fB-c \fIconfig_dir\fR]
/* [\fIservice\fR[\fB/\fItype\fR[\fB/\fIparameter\fR]]\fI ...\fR]
/*
/* \fBpostconf\fR \fB-P\fR [\fB-ev\fR] [\fB-c \fIconfig_dir\fR]
/* \fIservice\fB/\fItype\fB/\fIparameter\fB=\fIvalue ...\fR
/*
/* \fBpostconf\fR \fB-PX\fR [\fB-v\fR] [\fB-c \fIconfig_dir\fR]
/* \fIservice\fB/\fItype\fB/\fIparameter ...\fR
/*
/* .ti -4
/* \fBManaging bounce message templates:\fR
/*
/* \fBpostconf\fR \fB-b\fR [\fB-v\fR] [\fB-c \fIconfig_dir\fR]
/* [\fItemplate_file\fR]
/*
/* \fBpostconf\fR \fB-t\fR [\fB-v\fR] [\fB-c \fIconfig_dir\fR]
/* [\fItemplate_file\fR]
/*
/* .ti -4
/* \fBManaging TLS features:\fR
/*
/* \fBpostconf\fR \fB-T \fImode\fR [\fB-v\fR] [\fB-c \fIconfig_dir\fR]
/*
/* .ti -4
/* \fBManaging other configuration:\fR
/*
/* \fBpostconf\fR \fB-a\fR|\fB-A\fR|\fB-l\fR|\fB-m\fR [\fB-v\fR]
/* [\fB-c \fIconfig_dir\fR]
/* DESCRIPTION
/* By default, the \fBpostconf\fR(1) command displays the
/* values of \fBmain.cf\fR configuration parameters, and warns
/* about possible mis-typed parameter names (Postfix 2.9 and later).
/* The command can also change \fBmain.cf\fR configuration
/* parameter values, or display other configuration information
/* about the Postfix mail system.
/*
/* Options:
/* .IP \fB-a\fR
/* List the available SASL plug-in types for the Postfix SMTP
/* server. The plug-in type is selected with the \fBsmtpd_sasl_type\fR
/* configuration parameter by specifying one of the names
/* listed below.
/* .RS
/* .IP \fBcyrus\fR
/* This server plug-in is available when Postfix is built with
/* Cyrus SASL support.
/* .IP \fBdovecot\fR
/* This server plug-in uses the Dovecot authentication server,
/* and is available when Postfix is built with any form of SASL
/* support.
/* .RE
/* .IP
/* This feature is available with Postfix 2.3 and later.
/* .IP \fB-A\fR
/* List the available SASL plug-in types for the Postfix SMTP
/* client.  The plug-in type is selected with the \fBsmtp_sasl_type\fR
/* or \fBlmtp_sasl_type\fR configuration parameters by specifying
/* one of the names listed below.
/* .RS
/* .IP \fBcyrus\fR
/* This client plug-in is available when Postfix is built with
/* Cyrus SASL support.
/* .RE
/* .IP
/* This feature is available with Postfix 2.3 and later.
/* .IP "\fB-b\fR [\fItemplate_file\fR]"
/* Display the message text that appears at the beginning of
/* delivery status notification (DSN) messages, expanding
/* $\fBname\fR expressions with actual values as described in
/* \fBbounce\fR(5).
/*
/* To override the \fBbounce_template_file\fR parameter setting,
/* specify a template file name at the end of the "\fBpostconf
/* -b\fR" command line. Specify an empty file name to display
/* built-in templates (in shell language: "").
/*
/* This feature is available with Postfix 2.3 and later.
/* .IP "\fB-c \fIconfig_dir\fR"
/* The \fBmain.cf\fR configuration file is in the named directory
/* instead of the default configuration directory.
/* .IP "\fB-C \fIclass,...\fR"
/* When displaying \fBmain.cf\fR parameters, select only
/* parameters from the specified class(es):
/* .RS
/* .IP \fBbuiltin\fR
/* Parameters with built-in names.
/* .IP \fBservice\fR
/* Parameters with service-defined names (the first field of
/* a \fBmaster.cf\fR entry plus a Postfix-defined suffix).
/* .IP \fBuser\fR
/* Parameters with user-defined names.
/* .IP \fBall\fR
/* All the above classes.
/* .RE
/* .IP
/* The default is as if "\fB-C all\fR" is
/* specified.
/*
/* This feature is available with Postfix 2.9 and later.
/* .IP \fB-d\fR
/* Print \fBmain.cf\fR default parameter settings instead of
/* actual settings.
/* Specify \fB-df\fR to fold long lines for human readability
/* (Postfix 2.9 and later).
/* .IP \fB-e\fR
/* Edit the \fBmain.cf\fR configuration file, and update
/* parameter settings with the "\fIname=value\fR" pairs on the
/* \fBpostconf\fR(1) command line.
/*
/* With \fB-M\fR, edit the \fBmaster.cf\fR configuration file,
/* and replace one or more service entries with new values as
/* specified with "\fIservice/type=value\fR" on the \fBpostconf\fR(1)
/* command line.
/*
/* With \fB-F\fR, edit the \fBmaster.cf\fR configuration file,
/* and replace one or more service fields with new values as
/* specified with "\fIservice/type/field=value\fR" on the
/* \fBpostconf\fR(1) command line. Currently, the "command"
/* field contains the command name and command arguments.  This
/* may change in the near future, so that the "command" field
/* contains only the command name, and a new "arguments"
/* pseudofield contains the command arguments.
/*
/* With \fB-P\fR, edit the \fBmaster.cf\fR configuration file,
/* and add or update one or more service parameter settings
/* (-o parameter=value settings) with new values as specified
/* with "\fIservice/type/parameter=value\fR" on the \fBpostconf\fR(1)
/* command line.
/*
/* In all cases the file is copied to a temporary file then
/* renamed into place.  Specify quotes to protect special
/* characters and whitespace on the \fBpostconf\fR(1) command
/* line.
/*
/* The \fB-e\fR option is no longer needed with Postfix version
/* 2.8 and later, as it is assumed whenever a value is specified
/* (empty or non-empty).
/* .IP \fB-f\fR
/* Fold long lines when printing \fBmain.cf\fR or \fBmaster.cf\fR
/* configuration file entries, for human readability.
/*
/* This feature is available with Postfix 2.9 and later.
/* .IP \fB-F\fR
/* Show \fBmaster.cf\fR per-entry field settings (by default
/* all services and all fields), formatted as
/* "\fIservice/type/field=value\fR", one per line. Specify
/* \fB-Ff\fR to fold long lines.
/*
/* Specify one or more "\fIservice/type/field\fR" instances
/* on the \fBpostconf\fR(1) command line to limit the output
/* to fields of interest.  Trailing parameter name or service
/* type fields that are omitted will be handled as "*" wildcard
/* fields.
/*
/* This feature is available with Postfix 2.11 and later.
/* .IP \fB-h\fR
/* Show parameter or attribute values without the "\fIname\fR = "
/* label that normally precedes the value.
/* .IP \fB-H\fR
/* Show parameter or attribute names without the " = \fIvalue\fR"
/* that normally follows the name.
/*
/* This feature is available with Postfix 3.1 and later.
/* .IP \fB-j\fR
/*      JSON output. Format main.cf or master.cf settings as one
/*      \fB{"\fIkey\fB": "\fIvalue\fB"}\fR object per line.
/*
/* This feature is available with Postfix 3.11 and later.
/* .IP \fB-l\fR
/* List the names of all supported mailbox locking methods.
/* Postfix supports the following methods:
/* .RS
/* .IP \fBflock\fR
/* A kernel-based advisory locking method for local files only.
/* This locking method is available on systems with a BSD
/* compatible library.
/* .IP \fBfcntl\fR
/* A kernel-based advisory locking method for local and remote
/* files.
/* .IP \fBdotlock\fR
/* An application-level locking method. An application locks
/* a file named \fIfilename\fR by creating a file named
/* \fIfilename\fB.lock\fR.  The application is expected to
/* remove its own lock file, as well as stale lock files that
/* were left behind after abnormal program termination.
/* .RE
/* .IP \fB-m\fR
/* List the names of all supported lookup table types. In
/* Postfix configuration files, lookup tables are specified
/* as \fItype\fB:\fIname\fR, where \fItype\fR is one of the
/* types listed below. The table \fIname\fR syntax depends on
/* the lookup table type as described in the DATABASE_README
/* document.
/* .RS
/* .IP \fBbtree\fR
/* A sorted, balanced tree structure.  Available on systems
/* with support for Berkeley DB databases.
/* .IP \fBcdb\fR
/* A read-optimized structure with no support for incremental
/* updates.  Available on systems with support for CDB databases.
/*
/* This feature is available with Postfix 2.2 and later.
/* .IP \fBcidr\fR
/* A table that associates values with Classless Inter-Domain
/* Routing (CIDR) patterns. This is described in \fBcidr_table\fR(5).
/*
/* This feature is available with Postfix 2.2 and later.
/* .IP \fBdbm\fR
/* An indexed file type based on hashing.  Available on systems
/* with support for DBM databases.
/* .IP \fBdebug\fR
/* An adapter for another table that causes all accesses to be
/* logged.  The table name syntax is \fItype\fB:\fIname\fR.
/* Example usage: \fBdebug:hash:/etc/postfix/example\fR.  The
/* formats of the log messages are unspecified and subject to
/* change.  Warning: If a query or the underlying table contains
/* sensitive information (such as a password), that information
/* might be logged.
/*
/* This feature is available with Postfix 3.11 and later.
/* .IP \fBenviron\fR
/* The UNIX process environment array. The lookup key is the
/* environment variable name; the table name is ignored.  Originally
/* implemented for testing, someone may find this useful someday.
/* .IP \fBfail\fR
/* A table that reliably fails all requests. The lookup table
/* name is used for logging. This table exists to simplify
/* Postfix error tests.
/*
/* This feature is available with Postfix 2.9 and later.
/* .IP \fBhash\fR
/* An indexed file type based on hashing.  Available on systems
/* with support for Berkeley DB databases.
/* .IP "\fBinline\fR (read-only)"
/* A non-shared, in-memory lookup table. Example: "\fBinline:{
/* \fIkey\fB=\fIvalue\fB, { \fIkey\fB = \fItext with whitespace
/* or comma\fB }}\fR". Key-value pairs are separated by
/* whitespace or comma; with a key-value pair inside "\fB{}\fR",
/* whitespace is ignored after the opening "\fB{\fR", around
/* the "\fB=\fR" between key and value, and before the closing
/* "\fB}\fR". Inline tables eliminate the need to create a
/* database file for just a few fixed elements.  See also the
/* \fIstatic:\fR map type.
/*
/* This feature is available with Postfix 3.0 and later.
/* .IP \fBinternal\fR
/* A non-shared, in-memory hash table. Its content are lost
/* when a process terminates.
/* .IP "\fBlmdb\fR"
/* OpenLDAP LMDB database (a memory-mapped, persistent file).
/* Available on systems with support for LMDB databases.  This
/* is described in \fBlmdb_table\fR(5).
/*
/* This feature is available with Postfix 2.11 and later.
/* .IP "\fBldap\fR (read-only)"
/* LDAP database client. This is described in \fBldap_table\fR(5).
/* .IP "\fBmemcache\fR"
/* Memcache database client. This is described in
/* \fBmemcache_table\fR(5).
/*
/* This feature is available with Postfix 2.9 and later.
/* .IP "\fBmongodb\fR"
/* MongoDB database client. This is described in
/* \fBmongodb_table\fR(5).
/*
/* This feature is available with Postfix 3.9 and later.
/* .IP "\fBmysql\fR (read-only)"
/* MySQL database client.  Available on systems with support
/* for MySQL databases.  This is described in \fBmysql_table\fR(5).
/* .IP "\fBpcre\fR (read-only)"
/* A lookup table based on Perl Compatible Regular Expressions.
/* The file format is described in \fBpcre_table\fR(5).
/* .IP "\fBpgsql\fR (read-only)"
/* PostgreSQL database client. This is described in
/* \fBpgsql_table\fR(5).
/*
/* This feature is available with Postfix 2.1 and later.
/* .IP "\fBpipemap\fR (read-only)"
/* A lookup table that constructs a pipeline of tables.  Example:
/* "\fBpipemap:{\fItype_1:name_1,  ..., type_n:name_n\fB}\fR".
/* Each "pipemap:" query is given to the first table.  Each
/* lookup result becomes the query for the next table in the
/* pipeline, and the last table produces the final result.
/* When any table lookup produces no result, the pipeline
/* produces no result. The first and last characters of the
/* "pipemap:" table name must be "\fB{\fR" and "\fB}\fR".
/* Within these, individual maps are separated with comma or
/* whitespace.
/*
/* This feature is available with Postfix 3.0 and later.
/* .IP "\fBproxy\fR"
/* Postfix \fBproxymap\fR(8) client for shared access to Postfix
/* databases. The table name syntax is \fItype\fB:\fIname\fR.
/*
/* This feature is available with Postfix 2.0 and later.
/* .IP "\fBrandmap\fR (read-only)"
/* An in-memory table that performs random selection. Example:
/* "\fBrandmap:{\fIresult_1, ..., result_n\fB}\fR". Each table query
/* returns a random choice from the specified results. The first
/* and last characters of the "randmap:" table name must be
/* "\fB{\fR" and "\fB}\fR".  Within these, individual results
/* are separated with comma or whitespace. To give a specific
/* result more weight, specify it multiple times.
/*
/* This feature is available with Postfix 3.0 and later.
/* .IP "\fBregexp\fR (read-only)"
/* A lookup table based on regular expressions. The file format
/* is described in \fBregexp_table\fR(5).
/* .IP \fBsdbm\fR
/* An indexed file type based on hashing.  Available on systems
/* with support for SDBM databases.
/*
/* This feature is available with Postfix 2.2 and later.
/* .IP "\fBsocketmap\fR (read-only)"
/* Sendmail-style socketmap client. The table name is
/* \fBinet\fR:\fIhost\fR:\fIport\fR:\fIname\fR for a TCP/IP
/* server, or \fBunix\fR:\fIpathname\fR:\fIname\fR for a
/* UNIX-domain server. This is described in \fBsocketmap_table\fR(5).
/*
/* This feature is available with Postfix 2.10 and later.
/* .IP "\fBsqlite\fR (read-only)"
/* SQLite database. This is described in \fBsqlite_table\fR(5).
/*
/* This feature is available with Postfix 2.8 and later.
/* .IP "\fBstatic\fR (read-only)"
/* A table that always returns its name as lookup result. For
/* example, \fBstatic:foobar\fR always returns the string
/* \fBfoobar\fR as lookup result. Specify "\fBstatic:{ \fItext
/* with whitespace\fB }\fR" when the result contains whitespace;
/* this form ignores whitespace after the opening "\fB{\fR"
/* and before the closing
/* "\fB}\fR". See also the \fIinline:\fR map.
/*
/* The form "\fBstatic:{\fItext\fB}\fR is available with Postfix
/* 3.0 and later.
/* .IP "\fBtcp\fR (read-only)"
/* TCP/IP client. The protocol is described in \fBtcp_table\fR(5).
/* .IP "\fBtexthash\fR (read-only)"
/* Produces similar results as hash: files, except that you
/* don't need to run the \fBpostmap\fR(1) command before you
/* can use the file, and that it does not detect changes after
/* the file is read.
/*
/* This feature is available with Postfix 2.8 and later.
/* .IP "\fBunionmap\fR (read-only)"
/* A table that sends each query to multiple lookup tables and
/* that concatenates all found results, separated by comma.
/* The table name syntax is the same as for \fBpipemap\fR.
/*
/* This feature is available with Postfix 3.0 and later.
/* .IP "\fBunix\fR (read-only)"
/* A limited view of the UNIX authentication database. The
/* following tables are implemented:
/* .RS
/*. IP \fBunix:passwd.byname\fR
/* The table is the UNIX password database. The key is a login
/* name.  The result is a password file entry in \fBpasswd\fR(5)
/* format.
/* .IP \fBunix:group.byname\fR
/* The table is the UNIX group database. The key is a group
/* name.  The result is a group file entry in \fBgroup\fR(5)
/* format.
/* .RE
/* .RE
/* .IP
/* Other table types may exist depending on how Postfix was
/* built.
/* .IP \fB-M\fR
/* Show \fBmaster.cf\fR file contents instead of \fBmain.cf\fR
/* file contents.  Specify \fB-Mf\fR to fold long lines for
/* human readability.
/*
/* Specify zero or more arguments, each with a \fIservice-name\fR
/* or \fIservice-name/service-type\fR pair, where \fIservice-name\fR
/* is the first field of a master.cf entry and \fIservice-type\fR
/* is one of (\fBinet\fR, \fBunix\fR, \fBfifo\fR, or \fBpass\fR).
/*
/* If \fIservice-name\fR or \fIservice-name/service-type\fR
/* is specified, only the matching master.cf entries will be
/* output. For example, "\fBpostconf -Mf smtp\fR" will output
/* all services named "smtp", and "\fBpostconf -Mf smtp/inet\fR"
/* will output only the smtp service that listens on the
/* network.  Trailing service type fields that are omitted
/* will be handled as "*" wildcard fields.
/*
/* This feature is available with Postfix 2.9 and later. The
/* syntax was changed from "\fIname.type\fR" to "\fIname/type\fR",
/* and "*" wildcard support was added with Postfix 2.11.
/* .IP \fB-n\fR
/* Show only configuration parameters that have explicit
/* \fIname=value\fR settings in \fBmain.cf\fR.  Specify \fB-nf\fR
/* to fold long lines for human readability (Postfix 2.9 and
/* later). To show settings that differ from built-in defaults
/* only, use the following bash syntax:
/* .nf
/*     LANG=C comm -23 <(postconf -n) <(postconf -d)
/* .fi
/* Replace "-23" with "-12" to show settings that duplicate
/* built-in defaults.
/* .IP "\fB-o \fIname=value\fR"
/* Override \fBmain.cf\fR parameter settings.  This lets you see
/* the effect changing a parameter would have when it is used in
/* other configuration parameters, e.g.:
/* .nf
/*     postconf -x -o stress=yes
/* .fi
/*
/* This feature is available with Postfix 2.10 and later.
/* .IP \fB-p\fR
/* Show \fBmain.cf\fR parameter settings. This is the default.
/*
/* This feature is available with Postfix 2.11 and later.
/* .IP \fB-P\fR
/* Show \fBmaster.cf\fR service parameter settings (by default
/* all services and all parameters), formatted as
/* "\fIservice/type/parameter=value\fR", one per line.  Specify
/* \fB-Pf\fR to fold long lines.
/*
/* Specify multiple \fB-P\fR options to also list service parameters
/* that are not set in master.cf. This is useful with \fB-x\fR to
/* evaluate the impact of master.cf overrides on other parameter
/* settings.
/*
/* Specify one or more "\fIservice/type/parameter\fR" instances
/* on the \fBpostconf\fR(1) command line to limit the output
/* to parameters of interest.  Trailing parameter name or
/* service type fields that are omitted will be handled as "*"
/* wildcard fields.
/*
/* This feature is available with Postfix 2.11 and later.
/* .IP \fB-q\fR
/* Do not log warnings for deprecated or unused parameters.
/*
/* This feature is available with Postfix 3.9 and later.
/* .IP "\fB-t\fR [\fItemplate_file\fR]"
/* Display the templates for text that appears at the beginning
/* of delivery status notification (DSN) messages, without
/* expanding $\fBname\fR expressions.
/*
/* To override the \fBbounce_template_file\fR parameter setting,
/* specify a template file name at the end of the "\fBpostconf
/* -t\fR" command line. Specify an empty file name to display
/* built-in templates (in shell language: "").
/*
/* This feature is available with Postfix 2.3 and later.
/* .IP "\fB-T \fImode\fR"
/* If Postfix is compiled without TLS support, the \fB-T\fR option
/* produces no output.  Otherwise, if an invalid \fImode\fR is specified,
/* the \fB-T\fR option reports an error and exits with a non-zero status
/* code. The valid modes are:
/* .RS
/* .IP \fBcompile-version\fR
/* Output the OpenSSL version that Postfix was compiled with
/* (i.e. the OpenSSL version in a header file). The output
/* format is the same as with the command "\fBopenssl version\fR".
/* .IP \fBrun-version\fR
/* Output the OpenSSL version that Postfix is linked with at
/* runtime (i.e. the OpenSSL version in a shared library).
/* .IP \fBpublic-key-algorithms\fR
/* Output the lower-case names of the supported public-key
/* algorithms, one per-line.
/* .RE
/* .IP
/* This feature is available with Postfix 3.1 and later.
/* .IP \fB-v\fR
/* Enable verbose logging for debugging purposes. Multiple
/* \fB-v\fR options make the software increasingly verbose.
/* .IP \fB-x\fR
/* Expand \fI$name\fR in \fBmain.cf\fR or \fBmaster.cf\fR
/* parameter values. The expansion is recursive.
/*
/* This feature is available with Postfix 2.10 and later.
/* .IP \fB-X\fR
/* Edit the \fBmain.cf\fR configuration file, and remove the
/* parameters named on the \fBpostconf\fR(1) command line.
/* Specify a list of parameter names, not "\fIname=value\fR"
/* pairs.
/*
/* With \fB-M\fR, edit the \fBmaster.cf\fR configuration file,
/* and remove one or more service entries as specified with
/* "\fIservice/type\fR" on the \fBpostconf\fR(1) command line.
/*
/* With \fB-P\fR, edit the \fBmaster.cf\fR configuration file,
/* and remove one or more service parameter settings (-o
/* parameter=value settings) as specified with
/* "\fIservice/type/parameter\fR" on the \fBpostconf\fR(1)
/* command line.
/*
/* In all cases the file is copied to a temporary file then
/* renamed into place.  Specify quotes to protect special
/* characters on the \fBpostconf\fR(1) command line.
/*
/* There is no \fBpostconf\fR(1) command to perform the reverse
/* operation.
/*
/* This feature is available with Postfix 2.10 and later.
/* Support for -M and -P was added with Postfix 2.11.
/* .IP \fB-#\fR
/* Edit the \fBmain.cf\fR configuration file, and comment out
/* the parameters named on the \fBpostconf\fR(1) command line,
/* so that those parameters revert to their default values.
/* Specify a list of parameter names, not "\fIname=value\fR"
/* pairs.
/*
/* With \fB-M\fR, edit the \fBmaster.cf\fR configuration file,
/* and comment out one or more service entries as specified
/* with "\fIservice/type\fR" on the \fBpostconf\fR(1) command
/* line.
/*
/* In all cases the file is copied to a temporary file then
/* renamed into place.  Specify quotes to protect special
/* characters on the \fBpostconf\fR(1) command line.
/*
/* There is no \fBpostconf\fR(1) command to perform the reverse
/* operation.
/*
/* This feature is available with Postfix 2.6 and later. Support
/* for -M was added with Postfix 2.11.
/* DIAGNOSTICS
/* Problems are reported to the standard error stream.
/* ENVIRONMENT
/* .ad
/* .fi
/* .IP \fBMAIL_CONFIG\fR
/* Directory with Postfix configuration files.
/* CONFIGURATION PARAMETERS
/* .ad
/* .fi
/* The following \fBmain.cf\fR parameters are especially
/* relevant to this program.
/*
/* The text below provides only a parameter summary. See
/* \fBpostconf\fR(5) for more details including examples.
/* .IP "\fBconfig_directory (see 'postconf -d' output)\fR"
/* The default location of the Postfix main.cf and master.cf
/* configuration files.
/* .IP "\fBbounce_template_file (empty)\fR"
/* Pathname of a configuration file with bounce message templates.
/* FILES
/* /etc/postfix/main.cf, Postfix configuration parameters
/* /etc/postfix/master.cf, Postfix master daemon configuration
/* SEE ALSO
/* bounce(5), bounce template file format
/* master(5), master.cf configuration file syntax
/* postconf(5), main.cf configuration file syntax
/* README FILES
/* .ad
/* .fi
/* Use "\fBpostconf readme_directory\fR" or "\fBpostconf
/* html_directory\fR" to locate this information.
/* .na
/* .nf
/* DATABASE_README, Postfix lookup table overview
/* LICENSE
/* .ad
/* .fi
/* 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
/*
/* Wietse Venema
/* Google, Inc.
/* 111 8th Avenue
/* New York, NY 10011, USA
/*--*/

/* System library. */

#include <sys_defs.h>
#include <sys/stat.h>
#include <stdlib.h>

/* Utility library. */

#include <mac_midna.h>
#include <msg.h>
#include <msg_vstream.h>
#include <dict.h>
#include <htable.h>
#include <vstring.h>
#include <vstream.h>
#include <stringops.h>
#include <name_mask.h>
#include <warn_stat.h>
#include <mymalloc.h>

/* Global library. */

#include <mail_params.h>
#include <mail_conf.h>
#include <mail_version.h>
#include <mail_run.h>
#include <mail_dict.h>
#include <compat_level.h>

/* Application-specific. */

#include <postconf.h>

 /*
  * Global storage. See postconf.h for description.
  */
PCF_PARAM_TABLE *pcf_param_table;
PCF_MASTER_ENT *pcf_master_table;
int     pcf_cmd_mode = PCF_DEF_MODE;

 /*
  * Application fingerprinting.
  */
MAIL_VERSION_STAMP_DECLARE;

 /*
  * This program has so many command-line options that we have to implement a
  * compatibility matrix to weed out the conflicting option combinations, and
  * to alert the user about option combinations that have no effect.
  */

 /*
  * Options that are mutually-exclusive. First entry must specify the major
  * modes. Other entries specify conflicts between option modifiers.
  */
static const int pcf_incompat_options[] = {
    /* Major modes. */
    PCF_SHOW_SASL_SERV | PCF_SHOW_SASL_CLNT | PCF_EXP_DSN_TEMPL \
    |PCF_SHOW_LOCKS | PCF_SHOW_MAPS | PCF_DUMP_DSN_TEMPL | PCF_MAIN_PARAM \
    |PCF_MASTER_ENTRY | PCF_MASTER_FLD | PCF_MASTER_PARAM | PCF_SHOW_TLS,
    /* Modifiers. */
    PCF_MASTER_PP | PCF_EDIT_CONF | PCF_COMMENT_OUT | PCF_EDIT_EXCL,
    PCF_SHOW_DEFS | PCF_EDIT_CONF | PCF_SHOW_NONDEF | PCF_COMMENT_OUT \
    |PCF_EDIT_EXCL,
    PCF_FOLD_LINE | PCF_EDIT_CONF | PCF_COMMENT_OUT | PCF_EDIT_EXCL,
    PCF_SHOW_EVAL | PCF_EDIT_CONF | PCF_COMMENT_OUT | PCF_EDIT_EXCL,
    PCF_MAIN_OVER | PCF_SHOW_DEFS | PCF_EDIT_CONF | PCF_COMMENT_OUT \
    |PCF_EDIT_EXCL,
    PCF_HIDE_NAME | PCF_EDIT_CONF | PCF_COMMENT_OUT | PCF_EDIT_EXCL \
    |PCF_HIDE_VALUE,
    0,
};

 /*
  * Options, and the only options that they are compatible with. There must
  * be one entry for each major mode. Other entries specify compatibility
  * between option modifiers.
  */
static const int pcf_compat_options[][2] = {
    /* Major modes. */
    {PCF_SHOW_SASL_SERV, 0},
    {PCF_SHOW_SASL_CLNT, 0},
    {PCF_EXP_DSN_TEMPL, 0},
    {PCF_SHOW_LOCKS, 0},
    {PCF_SHOW_MAPS, 0,},
    {PCF_SHOW_TLS, 0,},
    {PCF_DUMP_DSN_TEMPL, 0},
    {PCF_MAIN_PARAM, (PCF_EDIT_CONF | PCF_EDIT_EXCL | PCF_COMMENT_OUT \
        |PCF_FOLD_LINE | PCF_HIDE_NAME | PCF_PARAM_CLASS \
        |PCF_SHOW_EVAL | PCF_SHOW_DEFS | PCF_SHOW_NONDEF \
        |PCF_MAIN_OVER | PCF_HIDE_VALUE | PCF_SHOW_JSON)},
    {PCF_MASTER_ENTRY, (PCF_EDIT_CONF | PCF_EDIT_EXCL | PCF_COMMENT_OUT \
   |PCF_FOLD_LINE | PCF_MAIN_OVER | PCF_SHOW_EVAL \
   |PCF_SHOW_JSON)},
    {PCF_MASTER_FLD, (PCF_EDIT_CONF | PCF_FOLD_LINE | PCF_HIDE_NAME \
        |PCF_MAIN_OVER | PCF_SHOW_EVAL | PCF_HIDE_VALUE \
        |PCF_SHOW_JSON)},
    {PCF_MASTER_PARAM, (PCF_EDIT_CONF | PCF_EDIT_EXCL | PCF_FOLD_LINE \
   |PCF_HIDE_NAME | PCF_MAIN_OVER | PCF_SHOW_EVAL \
   |PCF_HIDE_VALUE | PCF_SHOW_JSON | PCF_MASTER_PP)},
    {PCF_MASTER_PP, (PCF_FOLD_LINE \
       |PCF_HIDE_NAME | PCF_MAIN_OVER | PCF_SHOW_EVAL \
       |PCF_HIDE_VALUE | PCF_SHOW_JSON | PCF_MASTER_PARAM)},
    {PCF_SHOW_JSON, (PCF_MAIN_PARAM | PCF_MASTER_ENTRY | PCF_MASTER_FLD \
       |PCF_MASTER_PARAM | PCF_MAIN_OVER | PCF_SHOW_EVAL \
       |PCF_SHOW_NONDEF | PCF_SHOW_DEFS)},
    /* Modifiers. */
    {PCF_PARAM_CLASS, (PCF_MAIN_PARAM | PCF_SHOW_DEFS | PCF_SHOW_NONDEF)},
    0,
};

 /*
  * Compatibility to string conversion support.
  */
static const NAME_MASK pcf_compat_names[] = {
    "-a", PCF_SHOW_SASL_SERV,
    "-A", PCF_SHOW_SASL_CLNT,
    "-b", PCF_EXP_DSN_TEMPL,
    "-C", PCF_PARAM_CLASS,
    "-d", PCF_SHOW_DEFS,
    "-e", PCF_EDIT_CONF,
    "-f", PCF_FOLD_LINE,
    "-F", PCF_MASTER_FLD,
    "-h", PCF_HIDE_NAME,
    "-H", PCF_HIDE_VALUE,
    "-j", PCF_SHOW_JSON,
    "-l", PCF_SHOW_LOCKS,
    "-m", PCF_SHOW_MAPS,
    "-M", PCF_MASTER_ENTRY,
    "-n", PCF_SHOW_NONDEF,
    "-o", PCF_MAIN_OVER,
    "-p", PCF_MAIN_PARAM,
    "-P", PCF_MASTER_PARAM,
    "-t", PCF_DUMP_DSN_TEMPL,
    "-T", PCF_SHOW_TLS,
    "-x", PCF_SHOW_EVAL,
    "-X", PCF_EDIT_EXCL,
    "-#", PCF_COMMENT_OUT,
    "-PP", PCF_MASTER_PP,
    0,
};

/* usage - enumerate parameters without compatibility info */

static void usage(const char *progname)
{
    msg_fatal("usage: %s"
       " [-a (server SASL types)]"
       " [-A (client SASL types)]"
       " [-b (bounce templates)]"
       " [-c config_dir]"
       " [-c param_class]"
       " [-d (parameter defaults)]"
       " [-e (edit configuration)]"
       " [-f (fold lines)]"
       " [-F (master.cf fields)]"
       " [-h (no names)]"
       " [-H (no values)]"
       " [-j (streaming JSON) ]"
       " [-l (lock types)]"
       " [-m (map types)]"
       " [-M (master.cf)]"
       " [-n (non-default parameters)]"
       " [-o name=value (override parameter value)]"
       " [-p (main.cf, default)]"
       " [-P (master.cf parameters)]"
       " [-t (bounce templates)]"
       " [-T compile-version|run-version|public-key-algorithms]"
       " [-v (verbose)]"
       " [-x (expand parameter values)]"
       " [-X (exclude)]"
       " [-# (comment-out)]"
       " [name...]", progname);
}

/* pcf_check_exclusive_options - complain about mutually-exclusive options */

static void pcf_check_exclusive_options(int optval)
{
    const char *myname = "pcf_check_exclusive_options";
    const int *op;
    int     oval;
    unsigned mask;

    for (op = pcf_incompat_options; (oval = *op) != 0; op++) {
 oval &= optval;
 for (mask = ~0U; (mask & oval) != 0; mask >>= 1) {
     if ((mask & oval) != oval)
  msg_fatal("specify one of %s",
     str_name_mask(myname, pcf_compat_names, oval));
 }
    }
}

/* pcf_check_compat_options - complain about incompatible options */

static void pcf_check_compat_options(int optval)
{
    const char *myname = "pcf_check_compat_options";
    VSTRING *buf1 = vstring_alloc(10);
    VSTRING *buf2 = vstring_alloc(10);
    const int (*op)[2];
    int     excess;

    optval &= ~PCF_DEF_MODE;

    for (op = pcf_compat_options; op[0][0] != 0; op++) {
 if ((optval & *op[0]) != 0
     && (excess = (optval & ~((*op)[0] | (*op)[1]))) != 0)
     msg_fatal("with option %s, do not specify %s",
        str_name_mask_opt(buf1, myname, pcf_compat_names,
     (*op)[0], NAME_MASK_NUMBER),
        str_name_mask_opt(buf2, myname, pcf_compat_names,
     excess, NAME_MASK_NUMBER));
    }
    vstring_free(buf1);
    vstring_free(buf2);
}

/* main */

int     main(int argc, char **argv)
{
    int     ch;
    int     fd;
    struct stat st;
    ARGV   *ext_argv = 0;
    int     param_class = PCF_PARAM_MASK_CLASS;
    static const NAME_MASK param_class_table[] = {
 "builtin", PCF_PARAM_FLAG_BUILTIN,
 "service", PCF_PARAM_FLAG_SERVICE,
 "user", PCF_PARAM_FLAG_USER,
 "all", PCF_PARAM_MASK_CLASS,
 0,
    };
    ARGV   *override_params = 0;
    const char *pcf_tls_arg = 0;

    /*
     * Fingerprint executables and core dumps.
     */
    MAIL_VERSION_STAMP_ALLOCATE;

    /*
     * Be consistent with file permissions.
     */
    umask(022);

    /*
     * To minimize confusion, make sure that the standard file descriptors
     * are open before opening anything else. XXX Work around for 44BSD where
     * fstat can return EBADF on an open file descriptor.
     */
    for (fd = 0; fd < 3; fd++)
 if (fstat(fd, &st) == -1
     && (close(fd), open("/dev/null", O_RDWR, 0)) != fd)
     msg_fatal("open /dev/null: %m");

    /*
     * Set up logging.
     */
    msg_vstream_init(argv[0], VSTREAM_ERR);

    /*
     * Check the Postfix library version as soon as we enable logging.
     */
    MAIL_VERSION_CHECK;

    /*
     * Parse JCL.
     */
    while ((ch = GETOPT(argc, argv, "aAbc:C:deEfFhHjlmMno:pPqtT:vxX#")) > 0) {
 switch (ch) {
 case 'a':
     pcf_cmd_mode |= PCF_SHOW_SASL_SERV;
     break;
 case 'A':
     pcf_cmd_mode |= PCF_SHOW_SASL_CLNT;
     break;
 case 'b':
     pcf_cmd_mode |= PCF_EXP_DSN_TEMPL;
     if (ext_argv)
  msg_fatal("specify one of -b and -t");
     ext_argv = argv_alloc(2);
     argv_add(ext_argv, "bounce", "-SVnexpand_templates", (char *) 0);
     break;
 case 'c':
     if (setenv(CONF_ENV_PATH, optarg, 1) < 0)
  msg_fatal("out of memory");
     break;
 case 'C':
     param_class = name_mask_opt("-C option", param_class_table,
         optarg, NAME_MASK_ANY_CASE | NAME_MASK_FATAL);
     break;
 case 'd':
     pcf_cmd_mode |= PCF_SHOW_DEFS;
     break;
 case 'e':
     pcf_cmd_mode |= PCF_EDIT_CONF;
     break;
 case 'f':
     pcf_cmd_mode |= PCF_FOLD_LINE;
     break;
 case 'F':
     pcf_cmd_mode |= PCF_MASTER_FLD;
     break;
 case '#':
     pcf_cmd_mode |= PCF_COMMENT_OUT;
     break;
 case 'h':
     pcf_cmd_mode |= PCF_HIDE_NAME;
     break;
 case 'H':
     pcf_cmd_mode |= PCF_HIDE_VALUE;
     break;
 case 'j':
     pcf_cmd_mode |= PCF_SHOW_JSON;
     break;
 case 'l':
     pcf_cmd_mode |= PCF_SHOW_LOCKS;
     break;
 case 'm':
     pcf_cmd_mode |= PCF_SHOW_MAPS;
     break;
 case 'M':
     pcf_cmd_mode |= PCF_MASTER_ENTRY;
     break;
 case 'n':
     pcf_cmd_mode |= PCF_SHOW_NONDEF;
     break;
 case 'o':
     pcf_cmd_mode |= PCF_MAIN_OVER;
     if (override_params == 0)
  override_params = argv_alloc(2);
     argv_add(override_params, optarg, (char *) 0);
     break;
 case 'p':
     pcf_cmd_mode |= PCF_MAIN_PARAM;
     break;
 case 'P':
     if (pcf_cmd_mode & PCF_MASTER_PARAM)
  pcf_cmd_mode |= PCF_MASTER_PP;
     else
  pcf_cmd_mode |= PCF_MASTER_PARAM;
     break;
 case 'q':
     pcf_cmd_mode &= ~(PCF_WARN_UNUSED_DEPRECATED);
     break;
 case 't':
     pcf_cmd_mode |= PCF_DUMP_DSN_TEMPL;
     if (ext_argv)
  msg_fatal("specify one of -b and -t");
     ext_argv = argv_alloc(2);
     argv_add(ext_argv, "bounce", "-SVndump_templates", (char *) 0);
     break;
 case 'T':
     if (pcf_cmd_mode & PCF_SHOW_TLS)
  msg_fatal("At most one -T <mode> option may be specified");
     pcf_cmd_mode |= PCF_SHOW_TLS;
     pcf_tls_arg = optarg;
     break;
 case 'x':
     pcf_cmd_mode |= PCF_SHOW_EVAL;
     break;
 case 'X':
     /* This is irreversible, therefore require two-finger action. */
     pcf_cmd_mode |= PCF_EDIT_EXCL;
     break;
 case 'v':
     msg_verbose++;
     break;
 default:
     usage(argv[0]);
 }
    }

    /*
     * For consistency with mail_params_init().
     */
    compat_level_relop_register();
    mac_midna_register();

    /*
     * We don't enforce import_environment consistency in this program.
     * 
     * We don't extract import_environment from main.cf, because the postconf
     * command must be able to extract parameter settings from main.cf before
     * all installation parameters such as mail_owner or setgid_group have a
     * legitimate value.
     * 
     * We would need the functionality of mail_params_init() including all the
     * side effects of populating the CONFIG_DICT with default values so that
     * $name expansion works correctly, but excluding all the parameter value
     * sanity checks so that it would not abort at installation time.
     */

    /*
     * Make all options explicit, before checking their compatibility.
     */
#define PCF_MAIN_OR_MASTER \
 (PCF_MAIN_PARAM | PCF_MASTER_ENTRY | PCF_MASTER_FLD | PCF_MASTER_PARAM)

    if ((pcf_cmd_mode & pcf_incompat_options[0]) == 0)
 pcf_cmd_mode |= PCF_MAIN_PARAM;
    if ((pcf_cmd_mode & PCF_MAIN_OR_MASTER)
 && argv[optind] && strchr(argv[optind], '='))
 pcf_cmd_mode |= PCF_EDIT_CONF;

    /*
     * Sanity check.
     */
    pcf_check_exclusive_options(pcf_cmd_mode);
    pcf_check_compat_options(pcf_cmd_mode);

    if ((pcf_cmd_mode & PCF_EDIT_CONF) && argc == optind)
 msg_fatal("-e requires name=value argument");

    /*
     * Display bounce template information and exit.
     */
    if (ext_argv) {
 if (argv[optind]) {
     if (argv[optind + 1])
  msg_fatal("options -b and -t require at most one template file");
     argv_add(ext_argv, "-o",
       concatenate(VAR_BOUNCE_TMPL, "=",
     argv[optind], (char *) 0),
       (char *) 0);
 }
 /* Grr... */
 argv_add(ext_argv, "-o",
   concatenate(VAR_QUEUE_DIR, "=", ".", (char *) 0),
   (char *) 0);
 mail_conf_read();
 mail_run_replace(var_daemon_dir, ext_argv->argv);
 /* NOTREACHED */
    }

    /*
     * If showing map types, show them and exit
     */
    if (pcf_cmd_mode & PCF_SHOW_MAPS) {
 mail_conf_read();
 mail_dict_init();
 pcf_show_maps();
    }

    /*
     * If showing locking methods, show them and exit
     */
    else if (pcf_cmd_mode & PCF_SHOW_LOCKS) {
 pcf_show_locks();
    }

    /*
     * If showing master.cf entries, show them and exit
     */
    else if ((pcf_cmd_mode & (PCF_MASTER_ENTRY | PCF_MASTER_FLD | PCF_MASTER_PARAM))
    && !(pcf_cmd_mode & (PCF_EDIT_CONF | PCF_EDIT_EXCL | PCF_COMMENT_OUT))) {
 pcf_read_master(PCF_FAIL_ON_OPEN_ERROR);
 pcf_read_parameters();
 if (override_params)
     pcf_set_parameters(override_params->argv);
 pcf_register_builtin_parameters(basename(argv[0]), getpid());
 pcf_register_service_parameters();
 pcf_register_user_parameters(pcf_cmd_mode);
 if (pcf_cmd_mode & PCF_MASTER_FLD)
     pcf_show_master_fields(VSTREAM_OUT, pcf_cmd_mode, argc - optind,
       argv + optind);
 else if (pcf_cmd_mode & PCF_MASTER_PARAM)
     pcf_show_master_params(VSTREAM_OUT, pcf_cmd_mode, param_class,
       argc - optind, argv + optind);
 else
     pcf_show_master_entries(VSTREAM_OUT, pcf_cmd_mode, argc - optind,
        argv + optind);
 if (pcf_cmd_mode & PCF_WARN_UNUSED_DEPRECATED)
     pcf_flag_unused_master_parameters();
    }

    /*
     * If showing SASL plug-in types, show them and exit
     */
    else if (pcf_cmd_mode & PCF_SHOW_SASL_SERV) {
 pcf_show_sasl(PCF_SHOW_SASL_SERV);
    } else if (pcf_cmd_mode & PCF_SHOW_SASL_CLNT) {
 pcf_show_sasl(PCF_SHOW_SASL_CLNT);
    }

    /*
     * Show TLS info and exit.
     */
    else if (pcf_cmd_mode & PCF_SHOW_TLS) {
 pcf_show_tls(pcf_tls_arg);
    }

    /*
     * Edit main.cf or master.cf.
     */
    else if (pcf_cmd_mode & (PCF_EDIT_CONF | PCF_COMMENT_OUT | PCF_EDIT_EXCL)) {
 if (optind == argc)
     msg_fatal("missing service argument");
 if (pcf_cmd_mode & (PCF_MASTER_ENTRY | PCF_MASTER_FLD | PCF_MASTER_PARAM)) {
     pcf_edit_master(pcf_cmd_mode, argc - optind, argv + optind);
 } else {
     pcf_edit_main(pcf_cmd_mode, argc - optind, argv + optind);
 }
    }

    /*
     * If showing non-default values, read main.cf.
     */
    else {
 if ((pcf_cmd_mode & PCF_SHOW_DEFS) == 0) {
     pcf_read_parameters();
     if (override_params)
  pcf_set_parameters(override_params->argv);
 }
 pcf_register_builtin_parameters(basename(argv[0]), getpid());

 /*
  * Add service-dependent parameters (service names from master.cf)
  * and user-defined parameters ($name macros in parameter values in
  * main.cf and master.cf, but only if those names have a name=value
  * in main.cf or master.cf).
 */
 pcf_read_master(PCF_WARN_ON_OPEN_ERROR);
 pcf_register_service_parameters();
 if ((pcf_cmd_mode & PCF_SHOW_DEFS) == 0)
     pcf_register_user_parameters(pcf_cmd_mode);

 /*
  * Show the requested values.
 */
 pcf_show_parameters(VSTREAM_OUT, pcf_cmd_mode, param_class,
       argv + optind);

 /*
  * Flag unused or deprecated parameters. This makes no sense with
  * "postconf -d", because that ignores all the user-specified
  * parameters and user-specified macro expansions in main.cf.
 */
 if ((pcf_cmd_mode & PCF_SHOW_DEFS) == 0
     && (pcf_cmd_mode & PCF_WARN_UNUSED_DEPRECATED) != 0) {
     pcf_flag_unused_main_parameters();
     pcf_flag_unused_master_parameters();
 }
    }
    vstream_fflush(VSTREAM_OUT);

    if ((pcf_cmd_mode & PCF_WARN_UNUSED_DEPRECATED) && pcf_found_deprecated)
 msg_warn("See https://www.postfix.org/DEPRECATION_README.html "
   "for details");
    exit(0);
}