Sync usage with man page.
[netbsd-mini2440.git] / external / ibm-public / postfix / dist / proto / postconf.html.prolog
blob3963e7e6d5a3e2c5388640a99ff3afad2e20f644
1 <!doctype html public "-//W3C//DTD HTML 4.01 Transitional//EN"
2         "http://www.w3.org/TR/html4/loose.dtd">
4 <html>
6 <head>
8 <title>Postfix Configuration Parameters </title>
10 <meta http-equiv="Content-Type" content="text/html; charset=us-ascii">
12 </head>
14 <body>
16 <h1><img src="postfix-logo.jpg" width="203" height="98" alt="">Postfix Configuration Parameters </h1>
18 <hr>
20 <h2> Postfix main.cf file format </h2>
22 <p> The Postfix main.cf configuration file specifies a very small
23 subset of all the parameters that control the operation of the
24 Postfix mail system. Parameters not explicitly specified are left
25 at their default values. </p>
27 <p> The general format of the main.cf file is as follows: </p>
29 <ul>
31 <li> <p> Each logical line is in the form "parameter = value".
32 Whitespace around the "=" is ignored, as is whitespace at the end
33 of a logical line. </p>
35 <li> <p> Empty lines and whitespace-only lines are ignored, as are
36 lines whose first non-whitespace character is a `#'. </p>
38 <li> <p> A logical line starts with non-whitespace text. A line
39 that starts with whitespace continues a logical line. </p>
41 <li> <p> A parameter value may refer to other parameters. </p>
43 <ul>
45 <li> <p> The expressions "$name", "${name}" or "$(name)" are
46 recursively replaced by the value of the named parameter. </p>
48 <li> <p> The expression "${name?value}" expands to "value" when
49 "$name" is non-empty. This form is supported with Postfix version
50 2.2 and later. </p>
52 <li> <p> The expression "${name:value}" expands to "value" when
53 "$name" is empty. This form is supported with Postfix version 2.2
54 and later.  </p>
56 <li> <p> Specify "$$" to produce a single "$" character. </p>
58 </ul>
60 <li> <p> When the same parameter is defined multiple times, only
61 the last instance is remembered. </p>
63 <li> <p> Otherwise, the order of main.cf parameter definitions does
64 not matter. </p>
66 </ul>
68 <p> The remainder of this document is a description of all Postfix
69 configuration parameters. Default values are shown after the
70 parameter name in parentheses, and can be looked up with the
71 "<b>postconf -d</b>" command. </p>
73 <p> Note: this is not an invitation to make changes to Postfix
74 configuration parameters. Unnecessary changes are likely to impair
75 the operation of the mail system.  </p>
77 <dl>