summaryrefslogtreecommitdiffstats
path: root/html/postconf.1.html
blob: 4269a5e126300b4c7f9eade55bb96b0bb2be5ab4 (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
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
<!doctype html public "-//W3C//DTD HTML 4.01 Transitional//EN"
        "http://www.w3.org/TR/html4/loose.dtd">
<html> <head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<link rel='stylesheet' type='text/css' href='postfix-doc.css'>
<title> Postfix manual - postconf(1) </title>
</head> <body> <pre>
POSTCONF(1)                                                        POSTCONF(1)

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

<b>SYNOPSIS</b>
   <b>Managing <a href="postconf.5.html">main.cf</a>:</b>

       <b>postconf</b> [<b>-dfhHnopvx</b>] [<b>-c</b> <i>config</i><b>_</b><i>dir</i>] [<b>-C</b> <i>class,...</i>] [<i>parameter ...</i>]

       <b>postconf</b> [<b>-epv</b>] [<b>-c</b> <i>config</i><b>_</b><i>dir</i>] <i>parameter</i><b>=</b><i>value ...</i>

       <b>postconf -#</b> [<b>-pv</b>] [<b>-c</b> <i>config</i><b>_</b><i>dir</i>] <i>parameter ...</i>

       <b>postconf -X</b> [<b>-pv</b>] [<b>-c</b> <i>config</i><b>_</b><i>dir</i>] <i>parameter ...</i>

   <b>Managing <a href="master.5.html">master.cf</a> service entries:</b>

       <b>postconf -M</b> [<b>-fovx</b>] [<b>-c</b> <i>config</i><b>_</b><i>dir</i>] [<i>service</i>[<b>/</b><i>type</i>] <i>...</i>]

       <b>postconf -M</b> [<b>-ev</b>] [<b>-c</b> <i>config</i><b>_</b><i>dir</i>] <i>service</i><b>/</b><i>type</i><b>=</b><i>value ...</i>

       <b>postconf -M#</b> [<b>-v</b>] [<b>-c</b> <i>config</i><b>_</b><i>dir</i>] <i>service</i><b>/</b><i>type ...</i>

       <b>postconf -MX</b> [<b>-v</b>] [<b>-c</b> <i>config</i><b>_</b><i>dir</i>] <i>service</i><b>/</b><i>type ...</i>

   <b>Managing <a href="master.5.html">master.cf</a> service fields:</b>

       <b>postconf -F</b> [<b>-fhHovx</b>] [<b>-c</b> <i>config</i><b>_</b><i>dir</i>] [<i>service</i>[<b>/</b><i>type</i>[<b>/</b><i>field</i>]] <i>...</i>]

       <b>postconf -F</b> [<b>-ev</b>] [<b>-c</b> <i>config</i><b>_</b><i>dir</i>] <i>service</i><b>/</b><i>type</i><b>/</b><i>field</i><b>=</b><i>value ...</i>

   <b>Managing <a href="master.5.html">master.cf</a> service parameters:</b>

       <b>postconf -P</b> [<b>-fhHovx</b>] [<b>-c</b> <i>config</i><b>_</b><i>dir</i>] [<i>service</i>[<b>/</b><i>type</i>[<b>/</b><i>parameter</i>]] <i>...</i>]

       <b>postconf -P</b> [<b>-ev</b>] [<b>-c</b> <i>config</i><b>_</b><i>dir</i>] <i>service</i><b>/</b><i>type</i><b>/</b><i>parameter</i><b>=</b><i>value ...</i>

       <b>postconf -PX</b> [<b>-v</b>] [<b>-c</b> <i>config</i><b>_</b><i>dir</i>] <i>service</i><b>/</b><i>type</i><b>/</b><i>parameter ...</i>

   <b>Managing bounce message templates:</b>

       <b>postconf -b</b> [<b>-v</b>] [<b>-c</b> <i>config</i><b>_</b><i>dir</i>] [<i>template</i><b>_</b><i>file</i>]

       <b>postconf -t</b> [<b>-v</b>] [<b>-c</b> <i>config</i><b>_</b><i>dir</i>] [<i>template</i><b>_</b><i>file</i>]

   <b>Managing TLS features:</b>

       <b>postconf -T</b> <i>mode</i> [<b>-v</b>] [<b>-c</b> <i>config</i><b>_</b><i>dir</i>]

   <b>Managing other configuration:</b>

       <b>postconf -a</b>|<b>-A</b>|<b>-l</b>|<b>-m</b> [<b>-v</b>] [<b>-c</b> <i>config</i><b>_</b><i>dir</i>]

<b>DESCRIPTION</b>
       By default, the <a href="postconf.1.html"><b>postconf</b>(1)</a> command displays the values of <a href="postconf.5.html"><b>main.cf</b></a> con-
       figuration  parameters,  and  warns  about possible mis-typed parameter
       names (Postfix 2.9 and later).  The command  can  also  change  <a href="postconf.5.html"><b>main.cf</b></a>
       configuration parameter values, or display other configuration informa-
       tion about the Postfix mail system.

       Options:

       <b>-a</b>     List the available SASL  plug-in  types  for  the  Postfix  SMTP
              server.  The  plug-in  type is selected with the <b><a href="postconf.5.html#smtpd_sasl_type">smtpd_sasl_type</a></b>
              configuration parameter by specifying one of  the  names  listed
              below.

              <b>cyrus</b>  This  server  plug-in  is available when Postfix is built
                     with Cyrus SASL support.

              <b>dovecot</b>
                     This  server  plug-in  uses  the  Dovecot  authentication
                     server,  and  is available when Postfix is built with any
                     form of SASL support.

              This feature is available with Postfix 2.3 and later.

       <b>-A</b>     List the available SASL  plug-in  types  for  the  Postfix  SMTP
              client.  The plug-in type is selected with the <b><a href="postconf.5.html#smtp_sasl_type">smtp_sasl_type</a></b> or
              <b><a href="postconf.5.html#lmtp_sasl_type">lmtp_sasl_type</a></b> configuration parameters by specifying one of the
              names listed below.

              <b>cyrus</b>  This  client  plug-in  is available when Postfix is built
                     with Cyrus SASL support.

              This feature is available with Postfix 2.3 and later.

       <b>-b</b> [<i>template</i><b>_</b><i>file</i>]
              Display the message text that appears at the beginning of deliv-
              ery  status notification (DSN) messages, expanding $<b>name</b> expres-
              sions with actual values as described in <a href="bounce.5.html"><b>bounce</b>(5)</a>.

              To override the <b><a href="postconf.5.html#bounce_template_file">bounce_template_file</a></b> parameter setting,  specify
              a  template  file  name  at the end of the "<b>postconf -b</b>" 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.

       <b>-c</b> <i>config</i><b>_</b><i>dir</i>
              The <a href="postconf.5.html"><b>main.cf</b></a> configuration file is in the named directory instead
              of the default configuration directory.

       <b>-C</b> <i>class,...</i>
              When displaying <a href="postconf.5.html"><b>main.cf</b></a> parameters, select only parameters  from
              the specified class(es):

              <b>builtin</b>
                     Parameters with built-in names.

              <b>service</b>
                     Parameters with service-defined names (the first field of
                     a <a href="master.5.html"><b>master.cf</b></a> entry plus a Postfix-defined suffix).

              <b>user</b>   Parameters with user-defined names.

              <b>all</b>    All the above classes.

              The default is as if "<b>-C all</b>" is specified.

              This feature is available with Postfix 2.9 and later.

       <b>-d</b>     Print <a href="postconf.5.html"><b>main.cf</b></a> default parameter settings instead of actual  set-
              tings.   Specify  <b>-df</b>  to  fold long lines for human readability
              (Postfix 2.9 and later).

       <b>-e</b>     Edit the <a href="postconf.5.html"><b>main.cf</b></a> configuration file, and update  parameter  set-
              tings  with  the  "<i>name=value</i>"  pairs on the <a href="postconf.1.html"><b>postconf</b>(1)</a> command
              line.

              With <b>-M</b>, edit the <a href="master.5.html"><b>master.cf</b></a> configuration file, and replace  one
              or  more service entries with new values as specified with "<i>ser-</i>
              <i>vice/type=value</i>" on the <a href="postconf.1.html"><b>postconf</b>(1)</a> command line.

              With <b>-F</b>, edit the <a href="master.5.html"><b>master.cf</b></a> configuration file, and replace  one
              or  more  service fields with new values as specified with "<i>ser-</i>
              <i>vice/type/field=value</i>" on the  <a href="postconf.1.html"><b>postconf</b>(1)</a>  command  line.  Cur-
              rently,  the  "command" field contains the command name and com-
              mand arguments.  This may change in the near future, so that the
              "command" field contains only the command name, and a new "argu-
              ments" pseudofield contains the command arguments.

              With <b>-P</b>, edit the  <a href="master.5.html"><b>master.cf</b></a>  configuration  file,  and  add  or
              update  one  or  more  service  parameter  settings  (-o parame-
              ter=value settings) with new  values  as  specified  with  "<i>ser-</i>
              <i>vice/type/parameter=value</i>" on the <a href="postconf.1.html"><b>postconf</b>(1)</a> 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 <a href="postconf.1.html"><b>postconf</b>(1)</a> command line.

              The  <b>-e</b>  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).

       <b>-f</b>     Fold long lines when printing <a href="postconf.5.html"><b>main.cf</b></a> or <a href="master.5.html"><b>master.cf</b></a> configuration
              file entries, for human readability.

              This feature is available with Postfix 2.9 and later.

       <b>-F</b>     Show <a href="master.5.html"><b>master.cf</b></a> per-entry field settings (by default all services
              and  all  fields),  formatted as "<i>service/type/field=value</i>", one
              per line. Specify <b>-Ff</b> to fold long lines.

              Specify one or more "<i>service/type/field</i>" instances on the  <a href="postconf.1.html"><b>post-</b></a>
              <a href="postconf.1.html"><b>conf</b>(1)</a>  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.

       <b>-h</b>     Show  parameter  or attribute values without the "<i>name</i> = " label
              that normally precedes the value.

       <b>-H</b>     Show parameter or attribute names without the "  =  <i>value</i>"  that
              normally follows the name.

              This feature is available with Postfix 3.1 and later.

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

              <b>flock</b>  A kernel-based advisory locking method  for  local  files
                     only.  This locking method is available on systems with a
                     BSD compatible 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>file-</i>
                     <i>name</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 program termination.

       <b>-m</b>     List  the  names of all supported lookup table types. In Postfix
              configuration files, lookup tables are specified  as  <i>type</i><b>:</b><i>name</i>,
              where <i>type</i> is one of the types listed below. The table <i>name</i> syn-
              tax depends on the lookup table type as described in  the  <a href="DATABASE_README.html">DATA</a>-
              <a href="DATABASE_README.html">BASE_README</a> document.

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

              <b>cdb</b>    A read-optimized structure with no support for  incremen-
                     tal  updates.   Available on systems with support for CDB
                     databases.

                     This feature is available with Postfix 2.2 and later.

              <b>cidr</b>   A   table   that   associates   values   with   Classless
                     Inter-Domain  Routing  (CIDR) patterns. This is described
                     in <a href="cidr_table.5.html"><b>cidr_table</b>(5)</a>.

                     This feature is available with Postfix 2.2 and later.

              <b>dbm</b>    An indexed file type based on hashing.  Available on sys-
                     tems with support for DBM databases.

              <b>environ</b>
                     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.

              <b>fail</b>   A table that reliably fails all requests. The lookup  ta-
                     ble  name  is used for logging. This table exists to sim-
                     plify Postfix error tests.

                     This feature is available with Postfix 2.9 and later.

              <b>hash</b>   An indexed file type based on hashing.  Available on sys-
                     tems with support for Berkeley DB databases.

              <b>inline</b> (read-only)
                     A  non-shared, in-memory lookup table. Example: "<b><a href="DATABASE_README.html#types">inline</a>:{</b>
                     <i>key</i><b>=</b><i>value</i><b>, {</b> <i>key</i> <b>=</b> <i>text with  whitespace  or  comma</i>  <b>}}</b>".
                     Key-value  pairs  are  separated  by whitespace or comma;
                     with a key-value pair inside "<b>{}</b>", whitespace is  ignored
                     after  the  opening  "<b>{</b>",  around the "<b>=</b>" between key and
                     value, and before the closing "<b>}</b>". Inline  tables  elimi-
                     nate  the  need  to create a database file for just a few
                     fixed elements.  See also the <i><a href="DATABASE_README.html#types">static</a>:</i> map type.

                     This feature is available with Postfix 3.0 and later.

              <b>internal</b>
                     A non-shared, in-memory hash table. Its content are  lost
                     when a process terminates.

              <b>lmdb</b>   OpenLDAP   LMDB  database  (a  memory-mapped,  persistent
                     file).  Available on systems with support for LMDB  data-
                     bases.  This is described in <a href="lmdb_table.5.html"><b>lmdb_table</b>(5)</a>.

                     This feature is available with Postfix 2.11 and later.

              <b>ldap</b> (read-only)
                     LDAP database client. This is described in <a href="ldap_table.5.html"><b>ldap_table</b>(5)</a>.

              <b>memcache</b>
                     Memcache database  client.  This  is  described  in  <a href="memcache_table.5.html"><b>mem-</b></a>
                     <a href="memcache_table.5.html"><b>cache_table</b>(5)</a>.

                     This feature is available with Postfix 2.9 and later.

              <b>mysql</b> (read-only)
                     MySQL database client.  Available on systems with support
                     for MySQL databases.   This  is  described  in  <a href="mysql_table.5.html"><b>mysql_ta-</b></a>
                     <a href="mysql_table.5.html"><b>ble</b>(5)</a>.

              <b>pcre</b> (read-only)
                     A  lookup  table based on Perl Compatible Regular Expres-
                     sions.  The file format is described in <a href="pcre_table.5.html"><b>pcre_table</b>(5)</a>.

              <b>pgsql</b> (read-only)
                     PostgreSQL  database  client.  This   is   described   in
                     <a href="pgsql_table.5.html"><b>pgsql_table</b>(5)</a>.

                     This feature is available with Postfix 2.1 and later.

              <b>pipemap</b> (read-only)
                     A  lookup  table  that  constructs  a pipeline of tables.
                     Example: "<b><a href="DATABASE_README.html#types">pipemap</a>:{</b><i>type</i><b>_</b><i>1:name</i><b>_</b><i>1,  ...,  type</i><b>_</b><i>n:name</i><b>_</b><i>n</i><b>}</b>".
                     Each  "<a href="DATABASE_README.html#types">pipemap</a>:" 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
                     "<a href="DATABASE_README.html#types">pipemap</a>:" table name must be "<b>{</b>" and "<b>}</b>".  Within these,
                     individual maps are separated with comma or whitespace.

                     This feature is available with Postfix 3.0 and later.

              <b>proxy</b>  Postfix  <a href="proxymap.8.html"><b>proxymap</b>(8)</a>  client for shared access to Postfix
                     databases. The table name syntax is <i>type</i><b>:</b><i>name</i>.

                     This feature is available with Postfix 2.0 and later.

              <b>randmap</b> (read-only)
                     An in-memory table that performs random selection.  Exam-
                     ple:  "<b><a href="DATABASE_README.html#types">randmap</a>:{</b><i>result</i><b>_</b><i>1,  ...,  result</i><b>_</b><i>n</i><b>}</b>".  Each  table
                     query returns a random choice from the specified results.
                     The  first  and  last  characters of the "<a href="DATABASE_README.html#types">randmap</a>:" table
                     name must be  "<b>{</b>"  and  "<b>}</b>".   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.

              <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>regexp_table</b>(5)</a>.

              <b>sdbm</b>   An indexed file type based on hashing.  Available on sys-
                     tems with support for SDBM databases.

                     This feature is available with Postfix 2.2 and later.

              <b>socketmap</b> (read-only)
                     Sendmail-style  socketmap  client.  The  table  name   is
                     <b>inet</b>:<i>host</i>:<i>port</i>:<i>name</i>  for  a  TCP/IP server, or <b>unix</b>:<i>path-</i>
                     <i>name</i>:<i>name</i> for a UNIX-domain server. This is described  in
                     <a href="socketmap_table.5.html"><b>socketmap_table</b>(5)</a>.

                     This feature is available with Postfix 2.10 and later.

              <b>sqlite</b> (read-only)
                     SQLite database. This is described in <a href="sqlite_table.5.html"><b>sqlite_table</b>(5)</a>.

                     This feature is available with Postfix 2.8 and later.

              <b>static</b> (read-only)
                     A  table  that  always returns its name as lookup result.
                     For example, <b><a href="DATABASE_README.html#types">static</a>:foobar</b> always returns the string <b>foo-</b>
                     <b>bar</b>  as lookup result. Specify "<b><a href="DATABASE_README.html#types">static</a>:{</b> <i>text with white-</i>
                     <i>space</i> <b>}</b>" when the result contains whitespace;  this  form
                     ignores  whitespace  after the opening "<b>{</b>" and before the
                     closing "<b>}</b>". See also the <i><a href="DATABASE_README.html#types">inline</a>:</i> map.

                     The form "<b><a href="DATABASE_README.html#types">static</a>:{</b><i>text</i><b>}</b> is available with Postfix 3.0 and
                     later.

              <b>tcp</b> (read-only)
                     TCP/IP client. The protocol is described in <a href="tcp_table.5.html"><b>tcp_table</b>(5)</a>.

              <b>texthash</b> (read-only)
                     Produces similar results as <a href="DATABASE_README.html#types">hash</a>: files, except that  you
                     don't  need  to run the <a href="postmap.1.html"><b>postmap</b>(1)</a> 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.

              <b>unionmap</b> (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 <b>pipemap</b>.

                     This feature is available with Postfix 3.0 and later.

              <b>unix</b> (read-only)
                     A limited view of the UNIX authentication  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 <b>passwd</b>(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
                            <b>group</b>(5) format.

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

       <b>-M</b>     Show <a href="master.5.html"><b>master.cf</b></a> file contents instead of <a href="postconf.5.html"><b>main.cf</b></a>  file  contents.
              Specify <b>-Mf</b> to fold long lines for human readability.

              Specify zero or more arguments, each with a <i>service-name</i> or <i>ser-</i>
              <i>vice-name/service-type</i> pair, where  <i>service-name</i>  is  the  first
              field  of  a  <a href="master.5.html">master.cf</a>  entry and <i>service-type</i> is one of (<b>inet</b>,
              <b>unix</b>, <b>fifo</b>, or <b>pass</b>).

              If <i>service-name</i> or <i>service-name/service-type</i> is specified,  only
              the  matching  <a href="master.5.html">master.cf</a>  entries  will  be output. For example,
              "<b>postconf -Mf smtp</b>" will output all services named  "smtp",  and
              "<b>postconf  -Mf smtp/inet</b>" 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 "<i>name.type</i>" to "<i>name/type</i>",  and  "*"  wildcard
              support was added with Postfix 2.11.

       <b>-n</b>     Show only configuration parameters that have explicit <i>name=value</i>
              settings in <a href="postconf.5.html"><b>main.cf</b></a>.  Specify <b>-nf</b> to fold long lines  for  human
              readability  (Postfix 2.9 and later). To show settings that dif-
              fer from built-in defaults only, use the following bash syntax:
                  LANG=C comm -23 &lt;(postconf -n) &lt;(postconf -d)
              Replace  "-23"  with  "-12"  to  show  settings  that  duplicate
              built-in defaults.

       <b>-o</b> <i>name=value</i>
              Override  <a href="postconf.5.html"><b>main.cf</b></a>  parameter  settings.   This  lets you see the
              effect changing a parameter would have when it is used in  other
              configuration parameters, e.g.:
                  postconf -x -o stress=yes

              This feature is available with Postfix 2.10 and later.

       <b>-p</b>     Show <a href="postconf.5.html"><b>main.cf</b></a> parameter settings. This is the default.

              This feature is available with Postfix 2.11 and later.

       <b>-P</b>     Show  <a href="master.5.html"><b>master.cf</b></a>  service parameter settings (by default all ser-
              vices and all parameters),  formatted  as  "<i>service/type/parame-</i>
              <i>ter=value</i>", one per line.  Specify <b>-Pf</b> to fold long lines.

              Specify  one  or  more "<i>service/type/parameter</i>" instances on the
              <a href="postconf.1.html"><b>postconf</b>(1)</a> 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.

       <b>-t</b> [<i>template</i><b>_</b><i>file</i>]
              Display the templates for text that appears at the beginning  of
              delivery  status  notification (DSN) messages, without expanding
              $<b>name</b> expressions.

              To override the <b><a href="postconf.5.html#bounce_template_file">bounce_template_file</a></b> parameter setting,  specify
              a  template  file  name  at the end of the "<b>postconf -t</b>" 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.

       <b>-T</b> <i>mode</i>
              If  Postfix  is compiled without TLS support, the <b>-T</b> option pro-
              duces no output.  Otherwise, if an invalid  <i>mode</i>  is  specified,
              the  <b>-T</b> option reports an error and exits with a non-zero status
              code. The valid modes are:

              <b>compile-version</b>
                     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 "<b>openssl version</b>".

              <b>run-version</b>
                     Output the OpenSSL version that Postfix is linked with at
                     runtime (i.e. the OpenSSL version in a shared library).

              <b>public-key-algorithms</b>
                     Output the lower-case names of the  supported  public-key
                     algorithms, one per-line.

              This feature is available with Postfix 3.1 and later.

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

       <b>-x</b>     Expand <i>$name</i> in  <a href="postconf.5.html"><b>main.cf</b></a>  or  <a href="master.5.html"><b>master.cf</b></a>  parameter  values.  The
              expansion is recursive.

              This feature is available with Postfix 2.10 and later.

       <b>-X</b>     Edit  the  <a href="postconf.5.html"><b>main.cf</b></a> configuration file, and remove the parameters
              named on the <a href="postconf.1.html"><b>postconf</b>(1)</a> command line.  Specify a list of param-
              eter names, not "<i>name=value</i>" pairs.

              With  <b>-M</b>,  edit the <a href="master.5.html"><b>master.cf</b></a> configuration file, and remove one
              or more service entries as specified with "<i>service/type</i>" on  the
              <a href="postconf.1.html"><b>postconf</b>(1)</a> command line.

              With  <b>-P</b>,  edit the <a href="master.5.html"><b>master.cf</b></a> configuration file, and remove one
              or more service parameter settings (-o parameter=value settings)
              as  specified  with  "<i>service/type/parameter</i>" on the <a href="postconf.1.html"><b>postconf</b>(1)</a>
              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
              <a href="postconf.1.html"><b>postconf</b>(1)</a> command line.

              There is no <a href="postconf.1.html"><b>postconf</b>(1)</a> command to perform  the  reverse  opera-
              tion.

              This  feature is available with Postfix 2.10 and later.  Support
              for -M and -P was added with Postfix 2.11.

       <b>-#</b>     Edit the <a href="postconf.5.html"><b>main.cf</b></a> configuration file, and comment out the parame-
              ters named on the <a href="postconf.1.html"><b>postconf</b>(1)</a> command line, so that those param-
              eters revert to their default values.  Specify a list of parame-
              ter names, not "<i>name=value</i>" pairs.

              With  <b>-M</b>, edit the <a href="master.5.html"><b>master.cf</b></a> configuration file, and comment out
              one or more service entries as specified with "<i>service/type</i>"  on
              the <a href="postconf.1.html"><b>postconf</b>(1)</a> 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
              <a href="postconf.1.html"><b>postconf</b>(1)</a> command line.

              There  is  no  <a href="postconf.1.html"><b>postconf</b>(1)</a> command to perform the reverse opera-
              tion.

              This feature is available with Postfix 2.6  and  later.  Support
              for -M was added with Postfix 2.11.

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

<b>ENVIRONMENT</b>
       <b>MAIL_CONFIG</b>
              Directory with Postfix configuration files.

<b>CONFIGURATION PARAMETERS</b>
       The  following  <a href="postconf.5.html"><b>main.cf</b></a> parameters are especially relevant to this pro-
       gram.

       The text below provides only a parameter summary. See  <a href="postconf.5.html"><b>postconf</b>(5)</a>  for
       more details including examples.

       <b><a href="postconf.5.html#config_directory">config_directory</a> (see 'postconf -d' output)</b>
              The  default  location of the Postfix <a href="postconf.5.html">main.cf</a> and <a href="master.5.html">master.cf</a> con-
              figuration files.

       <b><a href="postconf.5.html#bounce_template_file">bounce_template_file</a> (empty)</b>
              Pathname of a configuration file with bounce message  templates.

<b>FILES</b>
       /etc/postfix/<a href="postconf.5.html">main.cf</a>, Postfix configuration parameters
       /etc/postfix/<a href="master.5.html">master.cf</a>, Postfix master daemon configuration

<b>SEE ALSO</b>
       <a href="bounce.5.html">bounce(5)</a>, bounce template file format
       <a href="master.5.html">master(5)</a>, <a href="master.5.html">master.cf</a> configuration file syntax
       <a href="postconf.5.html">postconf(5)</a>, <a href="postconf.5.html">main.cf</a> configuration file syntax

<b>README FILES</b>
       <a href="DATABASE_README.html">DATABASE_README</a>, Postfix lookup table overview

<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

       Wietse Venema
       Google, Inc.
       111 8th Avenue
       New York, NY 10011, USA

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