← Back to branch summary

~ubuntu-branches/ubuntu/vivid/postfix/vivid-proposed

« back to all changes in this revision

Viewing changes to proto/postconf.man.prolog

  • Committer: Bazaar Package Importer
  • Author(s): LaMont Jones
  • Date: 2005-02-27 09:33:07 UTC
  • Revision ID: james.westby@ubuntu.com-20050227093307-cn789t27ibnlh6tf
Tags: upstream-2.1.5
Import upstream version 2.1.5

Show diffs side-by-side

added added

removed removed

Lines of Context:
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.
 
40
.IP \(bu
 
41
The expression "${name:value}" expands to "value" when
 
42
"$name" is empty.
 
43
.RE
 
44
.IP \(bu
 
45
When the same parameter is defined multiple times, only the last
 
46
instance is remembered.
 
47
.IP \(bu
 
48
Otherwise, the order of main.cf parameter definitions does not matter.
 
49
.PP
 
50
The remainder of this document is a description of all Postfix
 
51
configuration parameters. Default values are shown after the 
 
52
parameter name in parentheses, and can be looked up with the
 
53
\fBpostconf -d\fR command. 
 
54
.PP
 
55
Note: this is not an invitation to make changes to Postfix
 
56
configuration parameters. Unnecessary changes can impair the
 
57
operation of the mail system.