external/ibm-public/postfix/dist/proto/postconf.man.prolog

   1 .TH POSTCONF 5
   2 .SH NAME
   3 postconf
   4 \-
   5 Postfix configuration parameters
   6 .SH SYNOPSIS
   7 .na
   8 .nf
   9 \fBpostconf\fR \fIparameter\fR ...
  10
  11 \fBpostconf -e\fR "\fIparameter=value\fR" ...
  12 .SH DESCRIPTION
  13 .ad
  14 .fi
  15 The Postfix main.cf configuration file specifies a small subset
  16 of all the parameters that control the operation of the Postfix
  17 mail system. Parameters not specified in main.cf are left at their
  18 default values.
  19 .PP
  20 The general format of the main.cf file is as follows:
  21 .IP \(bu
  22 Each logical line has the form "parameter = value".
  23 Whitespace around the "=" is ignored, as is whitespace at the
  24 end of a logical line.
  25 .IP \(bu
  26 Empty lines and whitespace-only lines are ignored, as are lines
  27 whose first non-whitespace character is a `#'.
  28 .IP \(bu
  29 A logical line starts with non-whitespace text. A line that starts
  30 with whitespace continues a logical line.
  31 .IP \(bu
  32 A parameter value may refer to other parameters.
  33 .RS
  34 .IP \(bu
  35 The expressions "$name", "${name}" or "$(name)" are
  36 recursively replaced by the value of the named parameter.
  37 .IP \(bu
  38 The expression "${name?value}" expands to "value" when
  39 "$name" is non-empty. This form is supported with Postfix
  40 version 2.2 and later.
  41 .IP \(bu
  42 The expression "${name:value}" expands to "value" when
  43 "$name" is empty. This form is supported with Postfix
  44 version 2.2 and later.
  45 .IP \(bu
  46 Specify "$$" to produce a single "$" character.
  47 .RE
  48 .IP \(bu
  49 When the same parameter is defined multiple times, only the last
  50 instance is remembered.
  51 .IP \(bu
  52 Otherwise, the order of main.cf parameter definitions does not matter.
  53 .PP
  54 The remainder of this document is a description of all Postfix
  55 configuration parameters. Default values are shown after the
  56 parameter name in parentheses, and can be looked up with the
  57 "\fBpostconf -d\fR" command.
  58 .PP
  59 Note: this is not an invitation to make changes to Postfix
  60 configuration parameters. Unnecessary changes can impair the
  61 operation of the mail system.