summaryrefslogtreecommitdiff
path: root/gnu/dist/postfix/html/postconf.1.html
blob: 0367e4f510cad18cbaee844c15a4c6d3137ae653 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
<html> <head> </head> <body> <pre>
POSTCONF(1)                                           POSTCONF(1)

<b>NAME</b>
       postconf - Postfix configuration utility

<b>SYNOPSIS</b>
       <b>postconf</b> [<b>-dhmlnv</b>] [<b>-c</b> <i>config_dir</i>] [<i>parameter</i> <i>...</i>]

       <b>postconf</b> [<b>-ev</b>] [<b>-c</b> <i>config_dir</i>] [<i>parameter=value</i> <i>...</i>]

<b>DESCRIPTION</b>
       The  <b>postconf</b> command prints the actual value of <i>parameter</i>
       (all known parameters by default) one parameter per  line,
       changes  its  value, or prints other information about the
       Postfix mail system.

       Options:

       <b>-c</b> <i>config_dir</i>
              The <b>main.cf</b> configuration  file  is  in  the  named
              directory  instead  of  the  default  configuration
              directory.

       <b>-d</b>     Print default parameter settings instead of  actual
              settings.

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

       <b>-h</b>     Show  parameter  values  only,  not the ``name = ''
              label that normally precedes the value.

       <b>-l</b>     List the names of  all  supported  mailbox  locking
              methods.  Postfix supports the following methods:

              <b>flock</b>  A  kernel-based  advisory locking method for
                     local files only.  This  locking  method  is
                     available only on systems with a BSD compat-
                     ible library.

              <b>fcntl</b>  A kernel-based advisory locking  method  for
                     local and remote files.

              <b>dotlock</b>
                     An   application-level  locking  method.  An
                     application locks a file named  <i>filename</i>  by
                     creating  a  file  named <i>filename</i><b>.lock</b>.  The
                     application is expected to  remove  its  own
                     lock  file, as well as stale lock files that
                     were left behind after abnormal termination.

       <b>-m</b>     List the names of all supported lookup table types.

              <b>btree</b>  A sorted, balanced tree structure.  This  is
                     available  only  on systems with support for
                     Berkeley DB databases.

              <b>dbm</b>    An indexed file type based on hashing.  This
                     is  available  only  on systems with support
                     for DBM databases.

              <b>environ</b>
                     The  UNIX  process  environment  array.  The
                     lookup  key is the variable name. Originally
                     implemented for testing,  someone  may  find
                     this useful someday.

              <b>hash</b>   An indexed file type based on hashing.  This
                     is available only on  systems  with  support
                     for Berkeley DB databases.

              <b>ldap</b> (read-only)
                     Perform  lookups  using  the  LDAP protocol.
                     This is described in an LDAP_README file.

              <b>mysql</b> (read-only)
                     Perform lookups using  the  MYSQL  protocol.
                     This is described in a MYSQL_README file.

              <b>pcre</b> (read-only)
                     A lookup table based on Perl Compatible Reg-
                     ular  Expressions.  The   file   format   is
                     described in <a href="pcre_table.5.html"><b>pcre</b><i>_</i><b>table</b>(5)</a>.

              <b>regexp</b> (read-only)
                     A lookup table based on regular expressions.
                     The  file  format  is  described   in   <a href="regexp_table.5.html"><b>reg-</b>
                     <b>exp</b><i>_</i><b>table</b>(5)</a>.

              <b>static</b> (read-only)
                     A  table  that  always  returns  its name as
                     lookup result.  For  example,  <b>static:foobar</b>
                     always  returns  the string <b>foobar</b> as lookup
                     result.

              <b>unix</b> (read-only)
                     A limited way to query the UNIX  authentica-
                     tion  database.  The  following  tables  are
                     implemented:

                     <b>unix:passwd.byname</b>
                             The  table  is  the  UNIX   password
                             database.  The  key is a login name.
                             The result is a password file  entry
                             in passwd(5) format.

                     <b>unix:group.byname</b>
                             The   table   is   the   UNIX  group
                             database. The key is a  group  name.
                             The  result is a group file entry in
                             group(5) format.

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

       <b>-n</b>     Print non-default parameter settings only.

       <b>-v</b>     Enable verbose logging for debugging purposes. Mul-
              tiple <b>-v</b> options  make  the  software  increasingly
              verbose.

<b>DIAGNOSTICS</b>
       Problems are reported to the standard error stream.

<b>ENVIRONMENT</b>
       <b>MAIL</b><i>_</i><b>CONFIG</b>
              Directory with Postfix configuration files.

<b>LICENSE</b>
       The  Secure  Mailer  license must be distributed with this
       software.

<b>AUTHOR(S)</b>
       Wietse Venema
       IBM T.J. Watson Research
       P.O. Box 704
       Yorktown Heights, NY 10598, USA

                                                      POSTCONF(1)
</pre> </body> </html>