summaryrefslogtreecommitdiffstats
path: root/html/postconf.1.html
blob: e6525618b8d4d59950edf76af1914a19b9a59647 (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
<!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=us-ascii">
<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.

       <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:
                  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 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>