mir/postfix
2
0
Fork 0
mirror of https://github.com/vdukhovni/postfix synced 2025-09-01 14:45:32 +00:00
Code Issues Releases Wiki Activity

postfix-3.1-20160214

Browse Source
This commit is contained in:
Wietse Venema
2016-02-14 00:00:00 -05:00
committed by Viktor Dukhovni
parent 6cd4b2aa33
commit 70f66a4b6a
35 changed files with 538 additions and 451 deletions
Download Patch File Download Diff File Expand all files Collapse all files

6
postfix/HISTORY
View File

@@ -22173,4 +22173,8 @@ Apologies for any names omitted.
20160213 20160213
Google credits in manpages. Added Google credits to external manpages.
20160214
More manpage cleanups. Viktor, Wietse.

67
postfix/RELEASE_NOTES
View File

@@ -29,21 +29,47 @@ description.
Major changes with snaphot 20151227 Major changes with snaphot 20151227
=================================== ===================================
This introduces a safety limit on the number of address verification The new address_verify_pending_request_limit parameter introduces
probes in the active queue (address_verify_pending_request_limit), a safety limit for the number of address verification probes in the
by default 1/4 of the active queue maximum size. The queue manager active queue. The default limit is 1/4 of the active queue maximum
enforces the limit by tempfailing probe messages that exceed the size. The queue manager enforces the limit by tempfailing probe
limit. The design avoids dependency on global counters that may get messages that exceed the limit. This design avoids dependencies on
out of sync after process crash. global counters that get out of sync after a process or system crash.
Tempfailing requests in this manner is not as bad as one might Tempfailing verify requests is not as bad as one might think. The
think. The Postfix verify cache proactively updates active addresses Postfix verify cache proactively updates active addresses weeks
well before they expire. The address_verify_pending_request_limit before they expire. The address_verify_pending_request_limit affects
affects only unknown addresses and inactive addresses that have only unknown addresses, and inactive addresses that have expired
expired from the address verify cache (by default, after 31 days). from the address verify cache (by default, after 31 days).
Major changes with snaphot 20151129
===================================
Machine-readable, JSON-formatted queue listing with "postqueue -j"
(no "mailq" equivalent). The output is a stream of JSON objects,
one per queue file. To simplify parsing, each JSON object is
formatted as one text line followed by one newline character. See
the postqueue(1) manpage for a detailed description of the output
format.
Major changes with Postfix snapshot 20151031
============================================
New "smtpd_client_auth_rate_limit" feature, to enforce an optional
rate limit on the number of AUTH commands per client IP address.
Similar to other smtpd_client_*rate_limit features, this enforces
a limit on the number of requests per $anvil_rate_time_unit.
Major changes with Postfix snapshot 20150913
============================================
New SMTPD policy service attribute "policy_context", with a
corresponding "smtpd_policy_service_policy_context" configuration
parameter. Originally, this was implemented to share the same SMTPD
policy service endpoint among multiple check_policy_service clients.
Incompatible change with Postfix snapshot 20150721 Incompatible change with Postfix snapshot 20150721
-------------------------------------------------- ==================================================
As of the middle of 2015, all supported Postfix releases no longer As of the middle of 2015, all supported Postfix releases no longer
enable "export" grade ciphers for opportunistic TLS, and no longer enable "export" grade ciphers for opportunistic TLS, and no longer
@@ -118,7 +144,7 @@ Destination-independent delivery rate delay
Support to enforce a destination-independent delay between email Support to enforce a destination-independent delay between email
deliveries. The following example inserts 20 seconds of delay deliveries. The following example inserts 20 seconds of delay
between deliveries with the SMTP transport, limiting the delivery between all deliveries with the SMTP transport, limiting the delivery
rate to at most three messages per minute. rate to at most three messages per minute.
/etc/postfix/main.cf: /etc/postfix/main.cf:
@@ -126,3 +152,18 @@ rate to at most three messages per minute.
For details, see the description of default_transport_rate_delay For details, see the description of default_transport_rate_delay
and transport_transport_rate_delay in the postconf(5) manpage. and transport_transport_rate_delay in the postconf(5) manpage.
Major changes with snaphot 20150523
===================================
The milter_macro_defaults feature provides an optional list of macro
name=value pairs. These specify default values for Milter macros
when no value is available from the SMTP session context.
For example, with "milter_macro_defaults = auth_type=TLS", the
Postfix SMTP server will send an auth_type of "TLS" to a Milter,
unless the remote client authenticates with SASL.
This feature was originally implemented for a submission service
that may authenticate clients with a TLS certificate, without having
to make changes to the code that implements TLS support.

5
postfix/WISHLIST
View File

@@ -6,11 +6,6 @@ Wish list:
Disable -DSNAPSHOT and -DNONPROD in makedefs. Disable -DSNAPSHOT and -DNONPROD in makedefs.
Add "postfix tls" and other new stuff to RELEASE_NOTES.
Fix bold "[" and "]" in manpages; these are not part of the
command line.
Remove this file from the stable release. Remove this file from the stable release.
Things to do after the stable release: Things to do after the stable release:

112
postfix/html/oqmgr.8.html
View File

@@ -4,7 +4,7 @@
<meta http-equiv="Content-Type" content="text/html; charset=us-ascii"> <meta http-equiv="Content-Type" content="text/html; charset=us-ascii">
<title> Postfix manual - oqmgr(8) </title> <title> Postfix manual - oqmgr(8) </title>
</head> <body> <pre> </head> <body> <pre>
OQMGR(8) System Manager's Manual OQMGR(8) OQMGR(8) OQMGR(8)
<b>NAME</b> <b>NAME</b>
oqmgr - old Postfix queue manager oqmgr - old Postfix queue manager
@@ -41,7 +41,7 @@ OQMGR(8) System Manager's Manual OQMGR(8)
<b>corrupt</b> <b>corrupt</b>
Unreadable or damaged queue files are moved here for inspection. Unreadable or damaged queue files are moved here for inspection.
<b>hold</b> Messages that are kept "on hold" are kept here until someone <b>hold</b> Messages that are kept "on hold" are kept here until someone
sets them free. sets them free.
<b>DELIVERY STATUS REPORTS</b> <b>DELIVERY STATUS REPORTS</b>
@@ -49,17 +49,17 @@ OQMGR(8) System Manager's Manual OQMGR(8)
in the following directories. Each status report file has the same name in the following directories. Each status report file has the same name
as the corresponding message file: as the corresponding message file:
<b>bounce</b> Per-recipient status information about why mail is bounced. <b>bounce</b> Per-recipient status information about why mail is bounced.
These files are maintained by the <a href="bounce.8.html"><b>bounce</b>(8)</a> daemon. These files are maintained by the <a href="bounce.8.html"><b>bounce</b>(8)</a> daemon.
<b>defer</b> Per-recipient status information about why mail is delayed. <b>defer</b> Per-recipient status information about why mail is delayed.
These files are maintained by the <a href="defer.8.html"><b>defer</b>(8)</a> daemon. These files are maintained by the <a href="defer.8.html"><b>defer</b>(8)</a> daemon.
<b>trace</b> Per-recipient status information as requested with the Postfix <b>trace</b> Per-recipient status information as requested with the Postfix
"<b>sendmail -v</b>" or "<b>sendmail -bv</b>" command. These files are main- "<b>sendmail -v</b>" or "<b>sendmail -bv</b>" command. These files are main-
tained by the <a href="trace.8.html"><b>trace</b>(8)</a> daemon. tained by the <a href="trace.8.html"><b>trace</b>(8)</a> daemon.
The <a href="qmgr.8.html"><b>oqmgr</b>(8)</a> daemon is responsible for asking the <a href="bounce.8.html"><b>bounce</b>(8)</a>, <a href="defer.8.html"><b>defer</b>(8)</a> The <a href="qmgr.8.html"><b>oqmgr</b>(8)</a> daemon is responsible for asking the <a href="bounce.8.html"><b>bounce</b>(8)</a>, <a href="defer.8.html"><b>defer</b>(8)</a>
or <a href="trace.8.html"><b>trace</b>(8)</a> daemons to send delivery reports. or <a href="trace.8.html"><b>trace</b>(8)</a> daemons to send delivery reports.
<b>STRATEGIES</b> <b>STRATEGIES</b>
@@ -67,69 +67,69 @@ OQMGR(8) System Manager's Manual OQMGR(8)
queue files (input) or for message delivery (output). queue files (input) or for message delivery (output).
<b>leaky bucket</b> <b>leaky bucket</b>
This strategy limits the number of messages in the <b>active</b> queue This strategy limits the number of messages in the <b>active</b> queue
and prevents the queue manager from running out of memory under and prevents the queue manager from running out of memory under
heavy load. heavy load.
<b>fairness</b> <b>fairness</b>
When the <b>active</b> queue has room, the queue manager takes one mes- When the <b>active</b> queue has room, the queue manager takes one mes-
sage from the <a href="QSHAPE_README.html#incoming_queue"><b>incoming</b> queue</a> and one from the <b>deferred</b> queue. sage from the <a href="QSHAPE_README.html#incoming_queue"><b>incoming</b> queue</a> and one from the <b>deferred</b> queue.
This prevents a large mail backlog from blocking the delivery of This prevents a large mail backlog from blocking the delivery of
new mail. new mail.
<b>slow start</b> <b>slow start</b>
This strategy eliminates "thundering herd" problems by slowly This strategy eliminates "thundering herd" problems by slowly
adjusting the number of parallel deliveries to the same destina- adjusting the number of parallel deliveries to the same destina-
tion. tion.
<b>round robin</b> <b>round robin</b>
The queue manager sorts delivery requests by destination. The queue manager sorts delivery requests by destination.
Round-robin selection prevents one destination from dominating Round-robin selection prevents one destination from dominating
deliveries to other destinations. deliveries to other destinations.
<b>exponential backoff</b> <b>exponential backoff</b>
Mail that cannot be delivered upon the first attempt is Mail that cannot be delivered upon the first attempt is
deferred. The time interval between delivery attempts is dou- deferred. The time interval between delivery attempts is dou-
bled after each attempt. bled after each attempt.
<b>destination status cache</b> <b>destination status cache</b>
The queue manager avoids unnecessary delivery attempts by main- The queue manager avoids unnecessary delivery attempts by main-
taining a short-term, in-memory list of unreachable destina- taining a short-term, in-memory list of unreachable destina-
tions. tions.
<b>TRIGGERS</b> <b>TRIGGERS</b>
On an idle system, the queue manager waits for the arrival of trigger On an idle system, the queue manager waits for the arrival of trigger
events, or it waits for a timer to go off. A trigger is a one-byte mes- events, or it waits for a timer to go off. A trigger is a one-byte mes-
sage. Depending on the message received, the queue manager performs sage. Depending on the message received, the queue manager performs
one of the following actions (the message is followed by the symbolic one of the following actions (the message is followed by the symbolic
constant used internally by the software): constant used internally by the software):
<b>D (QMGR_REQ_SCAN_DEFERRED)</b> <b>D (QMGR_REQ_SCAN_DEFERRED)</b>
Start a <a href="QSHAPE_README.html#deferred_queue">deferred queue</a> scan. If a deferred queue scan is Start a <a href="QSHAPE_README.html#deferred_queue">deferred queue</a> scan. If a deferred queue scan is
already in progress, that scan will be restarted as soon as it already in progress, that scan will be restarted as soon as it
finishes. finishes.
<b>I (QMGR_REQ_SCAN_INCOMING)</b> <b>I (QMGR_REQ_SCAN_INCOMING)</b>
Start an <a href="QSHAPE_README.html#incoming_queue">incoming queue</a> scan. If an incoming queue scan is Start an <a href="QSHAPE_README.html#incoming_queue">incoming queue</a> scan. If an incoming queue scan is
already in progress, that scan will be restarted as soon as it already in progress, that scan will be restarted as soon as it
finishes. finishes.
<b>A (QMGR_REQ_SCAN_ALL)</b> <b>A (QMGR_REQ_SCAN_ALL)</b>
Ignore <a href="QSHAPE_README.html#deferred_queue">deferred queue</a> file time stamps. The request affects the Ignore <a href="QSHAPE_README.html#deferred_queue">deferred queue</a> file time stamps. The request affects the
next <a href="QSHAPE_README.html#deferred_queue">deferred queue</a> scan. next <a href="QSHAPE_README.html#deferred_queue">deferred queue</a> scan.
<b>F (QMGR_REQ_FLUSH_DEAD)</b> <b>F (QMGR_REQ_FLUSH_DEAD)</b>
Purge all information about dead transports and destinations. Purge all information about dead transports and destinations.
<b>W (TRIGGER_REQ_WAKEUP)</b> <b>W (TRIGGER_REQ_WAKEUP)</b>
Wakeup call, This is used by the master server to instantiate Wakeup call, This is used by the master server to instantiate
servers that should not go away forever. The action is to start servers that should not go away forever. The action is to start
an <a href="QSHAPE_README.html#incoming_queue">incoming queue</a> scan. an <a href="QSHAPE_README.html#incoming_queue">incoming queue</a> scan.
The <a href="qmgr.8.html"><b>oqmgr</b>(8)</a> daemon reads an entire buffer worth of triggers. Multiple The <a href="qmgr.8.html"><b>oqmgr</b>(8)</a> daemon reads an entire buffer worth of triggers. Multiple
identical trigger requests are collapsed into one, and trigger requests identical trigger requests are collapsed into one, and trigger requests
are sorted so that <b>A</b> and <b>F</b> precede <b>D</b> and <b>I</b>. Thus, in order to force a are sorted so that <b>A</b> and <b>F</b> precede <b>D</b> and <b>I</b>. Thus, in order to force a
<a href="QSHAPE_README.html#deferred_queue">deferred queue</a> run, one would request <b>A F D</b>; in order to notify the <a href="QSHAPE_README.html#deferred_queue">deferred queue</a> run, one would request <b>A F D</b>; in order to notify the
queue manager of the arrival of new mail one would request <b>I</b>. queue manager of the arrival of new mail one would request <b>I</b>.
<b>STANDARDS</b> <b>STANDARDS</b>
@@ -137,18 +137,18 @@ OQMGR(8) System Manager's Manual OQMGR(8)
<a href="http://tools.ietf.org/html/rfc3464">RFC 3464</a> (Delivery status notifications) <a href="http://tools.ietf.org/html/rfc3464">RFC 3464</a> (Delivery status notifications)
<b>SECURITY</b> <b>SECURITY</b>
The <a href="qmgr.8.html"><b>oqmgr</b>(8)</a> daemon is not security sensitive. It reads single-charac- The <a href="qmgr.8.html"><b>oqmgr</b>(8)</a> daemon is not security sensitive. It reads single-charac-
ter messages from untrusted local users, and thus may be susceptible to ter messages from untrusted local users, and thus may be susceptible to
denial of service attacks. The <a href="qmgr.8.html"><b>oqmgr</b>(8)</a> daemon does not talk to the denial of service attacks. The <a href="qmgr.8.html"><b>oqmgr</b>(8)</a> daemon does not talk to the
outside world, and it can be run at fixed low privilege in a chrooted outside world, and it can be run at fixed low privilege in a chrooted
environment. environment.
<b>DIAGNOSTICS</b> <b>DIAGNOSTICS</b>
Problems and transactions are logged to the <b>syslog</b>(8) daemon. Cor- Problems and transactions are logged to the <b>syslog</b>(8) daemon. Cor-
rupted message files are saved to the <b>corrupt</b> queue for further inspec- rupted message files are saved to the <b>corrupt</b> queue for further inspec-
tion. tion.
Depending on the setting of the <b><a href="postconf.5.html#notify_classes">notify_classes</a></b> parameter, the postmas- Depending on the setting of the <b><a href="postconf.5.html#notify_classes">notify_classes</a></b> parameter, the postmas-
ter is notified of bounces and of other trouble. ter is notified of bounces and of other trouble.
<b>BUGS</b> <b>BUGS</b>
@@ -157,11 +157,11 @@ OQMGR(8) System Manager's Manual OQMGR(8)
mail can negatively impact outbound delivery rates. mail can negatively impact outbound delivery rates.
<b>CONFIGURATION PARAMETERS</b> <b>CONFIGURATION PARAMETERS</b>
Changes to <a href="postconf.5.html"><b>main.cf</b></a> are not picked up automatically, as <a href="qmgr.8.html"><b>oqmgr</b>(8)</a> is a Changes to <a href="postconf.5.html"><b>main.cf</b></a> are not picked up automatically, as <a href="qmgr.8.html"><b>oqmgr</b>(8)</a> is a
persistent process. Use the command "<b>postfix reload</b>" after a configura- persistent process. Use the command "<b>postfix reload</b>" after a configura-
tion change. tion change.
The text below provides only a parameter summary. See <a href="postconf.5.html"><b>postconf</b>(5)</a> for The text below provides only a parameter summary. See <a href="postconf.5.html"><b>postconf</b>(5)</a> for
more details including examples. more details including examples.
In the text below, <i>transport</i> is the first field in a <a href="master.5.html"><b>master.cf</b></a> entry. In the text below, <i>transport</i> is the first field in a <a href="master.5.html"><b>master.cf</b></a> entry.
@@ -170,33 +170,33 @@ OQMGR(8) System Manager's Manual OQMGR(8)
Available before Postfix version 2.5: Available before Postfix version 2.5:
<b><a href="postconf.5.html#allow_min_user">allow_min_user</a> (no)</b> <b><a href="postconf.5.html#allow_min_user">allow_min_user</a> (no)</b>
Allow a sender or recipient address to have `-' as the first Allow a sender or recipient address to have `-' as the first
character. character.
Available with Postfix version 2.7 and later: Available with Postfix version 2.7 and later:
<b><a href="postconf.5.html#default_filter_nexthop">default_filter_nexthop</a> (empty)</b> <b><a href="postconf.5.html#default_filter_nexthop">default_filter_nexthop</a> (empty)</b>
When a <a href="postconf.5.html#content_filter">content_filter</a> or FILTER request specifies no explicit When a <a href="postconf.5.html#content_filter">content_filter</a> or FILTER request specifies no explicit
next-hop destination, use $<a href="postconf.5.html#default_filter_nexthop">default_filter_nexthop</a> instead; when next-hop destination, use $<a href="postconf.5.html#default_filter_nexthop">default_filter_nexthop</a> instead; when
that value is empty, use the domain in the recipient address. that value is empty, use the domain in the recipient address.
<b>ACTIVE QUEUE CONTROLS</b> <b>ACTIVE QUEUE CONTROLS</b>
<b><a href="postconf.5.html#qmgr_clog_warn_time">qmgr_clog_warn_time</a> (300s)</b> <b><a href="postconf.5.html#qmgr_clog_warn_time">qmgr_clog_warn_time</a> (300s)</b>
The minimal delay between warnings that a specific destination The minimal delay between warnings that a specific destination
is clogging up the Postfix <a href="QSHAPE_README.html#active_queue">active queue</a>. is clogging up the Postfix <a href="QSHAPE_README.html#active_queue">active queue</a>.
<b><a href="postconf.5.html#qmgr_message_active_limit">qmgr_message_active_limit</a> (20000)</b> <b><a href="postconf.5.html#qmgr_message_active_limit">qmgr_message_active_limit</a> (20000)</b>
The maximal number of messages in the <a href="QSHAPE_README.html#active_queue">active queue</a>. The maximal number of messages in the <a href="QSHAPE_README.html#active_queue">active queue</a>.
<b><a href="postconf.5.html#qmgr_message_recipient_limit">qmgr_message_recipient_limit</a> (20000)</b> <b><a href="postconf.5.html#qmgr_message_recipient_limit">qmgr_message_recipient_limit</a> (20000)</b>
The maximal number of recipients held in memory by the Postfix The maximal number of recipients held in memory by the Postfix
queue manager, and the maximal size of the short-term, in-memory queue manager, and the maximal size of the short-term, in-memory
"dead" destination status cache. "dead" destination status cache.
<b>DELIVERY CONCURRENCY CONTROLS</b> <b>DELIVERY CONCURRENCY CONTROLS</b>
<b><a href="postconf.5.html#qmgr_fudge_factor">qmgr_fudge_factor</a> (100)</b> <b><a href="postconf.5.html#qmgr_fudge_factor">qmgr_fudge_factor</a> (100)</b>
Obsolete feature: the percentage of delivery resources that a Obsolete feature: the percentage of delivery resources that a
busy mail system will use up for delivery of a large mailing busy mail system will use up for delivery of a large mailing
list message. list message.
<b><a href="postconf.5.html#initial_destination_concurrency">initial_destination_concurrency</a> (5)</b> <b><a href="postconf.5.html#initial_destination_concurrency">initial_destination_concurrency</a> (5)</b>
@@ -204,7 +204,7 @@ OQMGR(8) System Manager's Manual OQMGR(8)
delivery to the same destination. delivery to the same destination.
<b><a href="postconf.5.html#default_destination_concurrency_limit">default_destination_concurrency_limit</a> (20)</b> <b><a href="postconf.5.html#default_destination_concurrency_limit">default_destination_concurrency_limit</a> (20)</b>
The default maximal number of parallel deliveries to the same The default maximal number of parallel deliveries to the same
destination. destination.
<b><a href="postconf.5.html#transport_destination_concurrency_limit"><i>transport</i>_destination_concurrency_limit</a> ($<a href="postconf.5.html#default_destination_concurrency_limit">default_destination_concur</a>-</b> <b><a href="postconf.5.html#transport_destination_concurrency_limit"><i>transport</i>_destination_concurrency_limit</a> ($<a href="postconf.5.html#default_destination_concurrency_limit">default_destination_concur</a>-</b>
@@ -215,12 +215,12 @@ OQMGR(8) System Manager's Manual OQMGR(8)
<b><a href="postconf.5.html#transport_initial_destination_concurrency"><i>transport</i>_initial_destination_concurrency</a> ($<a href="postconf.5.html#initial_destination_concurrency">initial_destination_concur</a>-</b> <b><a href="postconf.5.html#transport_initial_destination_concurrency"><i>transport</i>_initial_destination_concurrency</a> ($<a href="postconf.5.html#initial_destination_concurrency">initial_destination_concur</a>-</b>
<b><a href="postconf.5.html#initial_destination_concurrency">rency</a>)</b> <b><a href="postconf.5.html#initial_destination_concurrency">rency</a>)</b>
Initial concurrency for delivery via the named message <i>trans-</i> Initial concurrency for delivery via the named message <i>trans-</i>
<i>port</i>. <i>port</i>.
<b><a href="postconf.5.html#default_destination_concurrency_failed_cohort_limit">default_destination_concurrency_failed_cohort_limit</a> (1)</b> <b><a href="postconf.5.html#default_destination_concurrency_failed_cohort_limit">default_destination_concurrency_failed_cohort_limit</a> (1)</b>
How many pseudo-cohorts must suffer connection or handshake How many pseudo-cohorts must suffer connection or handshake
failure before a specific destination is considered unavailable failure before a specific destination is considered unavailable
(and further delivery is suspended). (and further delivery is suspended).
<b><a href="postconf.5.html#transport_destination_concurrency_failed_cohort_limit"><i>transport</i>_destination_concurrency_failed_cohort_limit</a> ($<a href="postconf.5.html#default_destination_concurrency_failed_cohort_limit">default_desti</a>-</b> <b><a href="postconf.5.html#transport_destination_concurrency_failed_cohort_limit"><i>transport</i>_destination_concurrency_failed_cohort_limit</a> ($<a href="postconf.5.html#default_destination_concurrency_failed_cohort_limit">default_desti</a>-</b>
@@ -237,7 +237,7 @@ OQMGR(8) System Manager's Manual OQMGR(8)
Idem, for delivery via the named message <i>transport</i>. Idem, for delivery via the named message <i>transport</i>.
<b><a href="postconf.5.html#default_destination_concurrency_positive_feedback">default_destination_concurrency_positive_feedback</a> (1)</b> <b><a href="postconf.5.html#default_destination_concurrency_positive_feedback">default_destination_concurrency_positive_feedback</a> (1)</b>
The per-destination amount of delivery concurrency positive The per-destination amount of delivery concurrency positive
feedback, after a delivery completes without connection or hand- feedback, after a delivery completes without connection or hand-
shake failure. shake failure.
@@ -265,30 +265,30 @@ OQMGR(8) System Manager's Manual OQMGR(8)
The maximal time between attempts to deliver a deferred message. The maximal time between attempts to deliver a deferred message.
<b><a href="postconf.5.html#maximal_queue_lifetime">maximal_queue_lifetime</a> (5d)</b> <b><a href="postconf.5.html#maximal_queue_lifetime">maximal_queue_lifetime</a> (5d)</b>
Consider a message as undeliverable, when delivery fails with a Consider a message as undeliverable, when delivery fails with a
temporary error, and the time in the queue has reached the <a href="postconf.5.html#maximal_queue_lifetime">maxi</a>- temporary error, and the time in the queue has reached the <a href="postconf.5.html#maximal_queue_lifetime">maxi</a>-
<a href="postconf.5.html#maximal_queue_lifetime">mal_queue_lifetime</a> limit. <a href="postconf.5.html#maximal_queue_lifetime">mal_queue_lifetime</a> limit.
<b><a href="postconf.5.html#queue_run_delay">queue_run_delay</a> (300s)</b> <b><a href="postconf.5.html#queue_run_delay">queue_run_delay</a> (300s)</b>
The time between <a href="QSHAPE_README.html#deferred_queue">deferred queue</a> scans by the queue manager; The time between <a href="QSHAPE_README.html#deferred_queue">deferred queue</a> scans by the queue manager;
prior to Postfix 2.4 the default value was 1000s. prior to Postfix 2.4 the default value was 1000s.
<b><a href="postconf.5.html#transport_retry_time">transport_retry_time</a> (60s)</b> <b><a href="postconf.5.html#transport_retry_time">transport_retry_time</a> (60s)</b>
The time between attempts by the Postfix queue manager to con- The time between attempts by the Postfix queue manager to con-
tact a malfunctioning message delivery transport. tact a malfunctioning message delivery transport.
Available in Postfix version 2.1 and later: Available in Postfix version 2.1 and later:
<b><a href="postconf.5.html#bounce_queue_lifetime">bounce_queue_lifetime</a> (5d)</b> <b><a href="postconf.5.html#bounce_queue_lifetime">bounce_queue_lifetime</a> (5d)</b>
Consider a bounce message as undeliverable, when delivery fails Consider a bounce message as undeliverable, when delivery fails
with a temporary error, and the time in the queue has reached with a temporary error, and the time in the queue has reached
the <a href="postconf.5.html#bounce_queue_lifetime">bounce_queue_lifetime</a> limit. the <a href="postconf.5.html#bounce_queue_lifetime">bounce_queue_lifetime</a> limit.
Available in Postfix version 2.5 and later: Available in Postfix version 2.5 and later:
<b><a href="postconf.5.html#default_destination_rate_delay">default_destination_rate_delay</a> (0s)</b> <b><a href="postconf.5.html#default_destination_rate_delay">default_destination_rate_delay</a> (0s)</b>
The default amount of delay that is inserted between individual The default amount of delay that is inserted between individual
deliveries to the same destination; the resulting behavior deliveries to the same destination; the resulting behavior
depends on the value of the corresponding per-destination recip- depends on the value of the corresponding per-destination recip-
ient limit. ient limit.
@@ -298,8 +298,8 @@ OQMGR(8) System Manager's Manual OQMGR(8)
Available in Postfix version 3.1 and later: Available in Postfix version 3.1 and later:
<b><a href="postconf.5.html#default_transport_rate_delay">default_transport_rate_delay</a> (0s)</b> <b><a href="postconf.5.html#default_transport_rate_delay">default_transport_rate_delay</a> (0s)</b>
The default amount of delay that is inserted between individual The default amount of delay that is inserted between individual
deliveries over the same message delivery transport, regardless deliveries over the same message delivery transport, regardless
of destination. of destination.
<b><a href="postconf.5.html#transport_transport_rate_delay"><i>transport</i>_transport_rate_delay</a> $<a href="postconf.5.html#default_transport_rate_delay">default_transport_rate_delay</a></b> <b><a href="postconf.5.html#transport_transport_rate_delay"><i>transport</i>_transport_rate_delay</a> $<a href="postconf.5.html#default_transport_rate_delay">default_transport_rate_delay</a></b>
@@ -308,7 +308,7 @@ OQMGR(8) System Manager's Manual OQMGR(8)
<b>SAFETY CONTROLS</b> <b>SAFETY CONTROLS</b>
<b><a href="postconf.5.html#qmgr_daemon_timeout">qmgr_daemon_timeout</a> (1000s)</b> <b><a href="postconf.5.html#qmgr_daemon_timeout">qmgr_daemon_timeout</a> (1000s)</b>
How much time a Postfix queue manager process may take to handle How much time a Postfix queue manager process may take to handle
a request before it is terminated by a built-in watchdog timer. a request before it is terminated by a built-in watchdog timer.
<b><a href="postconf.5.html#qmgr_ipc_timeout">qmgr_ipc_timeout</a> (60s)</b> <b><a href="postconf.5.html#qmgr_ipc_timeout">qmgr_ipc_timeout</a> (60s)</b>
The time limit for the queue manager to send or receive informa- The time limit for the queue manager to send or receive informa-

213
postfix/html/postconf.1.html
View File

@@ -4,13 +4,13 @@
<meta http-equiv="Content-Type" content="text/html; charset=us-ascii"> <meta http-equiv="Content-Type" content="text/html; charset=us-ascii">
<title> Postfix manual - postconf(1) </title> <title> Postfix manual - postconf(1) </title>
</head> <body> <pre> </head> <body> <pre>
POSTCONF(1) General Commands Manual POSTCONF(1) POSTCONF(1) POSTCONF(1)
<b>NAME</b> <b>NAME</b>
postconf - Postfix configuration utility postconf - Postfix configuration utility
<b>SYNOPSIS</b> <b>SYNOPSIS</b>
<b>Managing <a href="postconf.5.html">main.cf</a>:</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>-dfhHnopvx</b>] [<b>-c</b> <i>config</i><b>_</b><i>dir</i>] [<b>-C</b> <i>class,...</i>] [<i>parameter ...</i>]
@@ -20,7 +20,7 @@ POSTCONF(1) General Commands Manual POSTCONF(1)
<b>postconf -X</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>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>-fovx</b>] [<b>-c</b> <i>config</i><b>_</b><i>dir</i>] [<i>service</i>[<b>/</b><i>type</i>] <i>...</i>]
@@ -30,13 +30,13 @@ POSTCONF(1) General Commands Manual POSTCONF(1)
<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>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>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>-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>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>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>-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>]
@@ -44,64 +44,64 @@ POSTCONF(1) General Commands Manual POSTCONF(1)
<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>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>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 -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>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>Managing TLS features:</b>
<b>postconf</b> [<b>-v</b>] [<b>-c</b> <i>config</i><b>_</b><i>dir</i>] <b>-T</b> <i>mode</i> <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>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>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> <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- 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 figuration parameters, and warns about possible mis-typed parameter
names (Postfix 2.9 and later). It can also change <a href="postconf.5.html"><b>main.cf</b></a> configura- names (Postfix 2.9 and later). It can also change <a href="postconf.5.html"><b>main.cf</b></a> configura-
tion parameter values, or display other configuration information about tion parameter values, or display other configuration information about
the Postfix mail system. the Postfix mail system.
Options: Options:
<b>-a</b> List the available SASL server plug-in types. The SASL plug-in <b>-a</b> List the available SASL server plug-in types. The SASL plug-in
type is selected with the <b><a href="postconf.5.html#smtpd_sasl_type">smtpd_sasl_type</a></b> configuration parame- type is selected with the <b><a href="postconf.5.html#smtpd_sasl_type">smtpd_sasl_type</a></b> configuration parame-
ter by specifying one of the names listed below. ter by specifying one of the names listed below.
<b>cyrus</b> This server plug-in is available when Postfix is built <b>cyrus</b> This server plug-in is available when Postfix is built
with Cyrus SASL support. with Cyrus SASL support.
<b>dovecot</b> <b>dovecot</b>
This server plug-in uses the Dovecot authentication This server plug-in uses the Dovecot authentication
server, and is available when Postfix is built with any server, and is available when Postfix is built with any
form of SASL support. form of SASL support.
This feature is available with Postfix 2.3 and later. This feature is available with Postfix 2.3 and later.
<b>-A</b> List the available SASL client plug-in types. The SASL plug-in <b>-A</b> List the available SASL client plug-in types. The SASL 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> con- 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> con-
figuration parameters by specifying one of the names listed figuration parameters by specifying one of the names listed
below. below.
<b>cyrus</b> This client plug-in is available when Postfix is built <b>cyrus</b> This client plug-in is available when Postfix is built
with Cyrus SASL support. with Cyrus SASL support.
This feature is available with Postfix 2.3 and later. This feature is available with Postfix 2.3 and later.
<b>-b</b> [<i>template</i><b>_</b><i>file</i>] <b>-b</b> [<i>template</i><b>_</b><i>file</i>]
Display the message text that appears at the beginning of deliv- Display the message text that appears at the beginning of deliv-
ery status notification (DSN) messages, replacing $<b>name</b> expres- ery status notification (DSN) messages, replacing $<b>name</b> expres-
sions with actual values as described in <a href="bounce.5.html"><b>bounce</b>(5)</a>. sions with actual values as described in <a href="bounce.5.html"><b>bounce</b>(5)</a>.
To override the built-in templates, specify a template file name To override the built-in templates, specify a template file name
at the end of the <a href="postconf.1.html"><b>postconf</b>(1)</a> command line, or specify a file at the end of the <a href="postconf.1.html"><b>postconf</b>(1)</a> command line, or specify a file
name in <a href="postconf.5.html"><b>main.cf</b></a> with the <b><a href="postconf.5.html#bounce_template_file">bounce_template_file</a></b> parameter. name in <a href="postconf.5.html"><b>main.cf</b></a> with the <b><a href="postconf.5.html#bounce_template_file">bounce_template_file</a></b> parameter.
To force selection of the built-in templates, specify an empty To force selection of the built-in templates, specify an empty
template file name on the <a href="postconf.1.html"><b>postconf</b>(1)</a> command line (in shell template file name on the <a href="postconf.1.html"><b>postconf</b>(1)</a> command line (in shell
language: ""). language: "").
This feature is available with Postfix 2.3 and later. This feature is available with Postfix 2.3 and later.
@@ -111,7 +111,7 @@ POSTCONF(1) General Commands Manual POSTCONF(1)
of the default configuration directory. of the default configuration directory.
<b>-C</b> <i>class,...</i> <b>-C</b> <i>class,...</i>
When displaying <a href="postconf.5.html"><b>main.cf</b></a> parameters, select only parameters from When displaying <a href="postconf.5.html"><b>main.cf</b></a> parameters, select only parameters from
the specified class(es): the specified class(es):
<b>builtin</b> <b>builtin</b>
@@ -129,36 +129,36 @@ POSTCONF(1) General Commands Manual POSTCONF(1)
This feature is available with Postfix 2.9 and later. 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- <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 tings. Specify <b>-df</b> to fold long lines for human readability
(Postfix 2.9 and later). (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- <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 tings with the "<i>name=value</i>" pairs on the <a href="postconf.1.html"><b>postconf</b>(1)</a> command
line. line.
With <b>-M</b>, edit the <a href="master.5.html"><b>master.cf</b></a> configuration file, and replace one 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> 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. <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 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 specied with "<i>ser-</i> or more service fields with new values as specied 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- <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- rently, the "command" field contains the command name and com-
mand arguments. this may change in the near future, so that the mand arguments. this may change in the near future, so that the
"command" field contains only the command name, and a new "argu- "command" field contains only the command name, and a new "argu-
ments" pseudofield contains the command arguments. 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 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- update one or more service parameter settings (-o parame-
ter=value settings) with new values as specied with "<i>ser-</i> ter=value settings) with new values as specied with "<i>ser-</i>
<i>vice/type/parameter=value</i>" on the <a href="postconf.1.html"><b>postconf</b>(1)</a> command line. <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 In all cases the file is copied to a temporary file then renamed
into place. Specify quotes to protect special characters and into place. Specify quotes to protect special characters and
whitespace on the <a href="postconf.1.html"><b>postconf</b>(1)</a> command line. 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 The <b>-e</b> option is no longer needed with Postfix version 2.8 and
later. 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 <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
@@ -167,56 +167,56 @@ POSTCONF(1) General Commands Manual POSTCONF(1)
This feature is available with Postfix 2.9 and later. 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 <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 one "<i>service/type/field=value</i>" per and all fields), formatted as "<i>service/type/field=value</i>", one
line. Specify <b>-Ff</b> to fold long lines. 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> 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. <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 Trailing parameter name or service type fields that are omitted
will be handled as "*" wildcard fields. will be handled as "*" wildcard fields.
This feature is available with Postfix 2.11 and later. This feature is available with Postfix 2.11 and later.
<b>-h</b> Show parameter or attribute values without the "<i>name</i> = " label <b>-h</b> Show parameter or attribute values without the "<i>name</i> = " label
that normally precedes the value. that normally precedes the value.
<b>-H</b> Show parameter or attribute names without the " = <i>value</i>" that <b>-H</b> Show parameter or attribute names without the " = <i>value</i>" that
normally follows the name. normally follows the name.
This feature is available with Postfix 3.1 and later. This feature is available with Postfix 3.1 and later.
<b>-l</b> List the names of all supported mailbox locking methods. Post- <b>-l</b> List the names of all supported mailbox locking methods. Post-
fix supports the following methods: fix supports the following methods:
<b>flock</b> A kernel-based advisory locking method for local files <b>flock</b> A kernel-based advisory locking method for local files
only. This locking method is available on systems with a only. This locking method is available on systems with a
BSD compatible library. BSD compatible library.
<b>fcntl</b> A kernel-based advisory locking method for local and <b>fcntl</b> A kernel-based advisory locking method for local and
remote files. remote files.
<b>dotlock</b> <b>dotlock</b>
An application-level locking method. An application locks An application-level locking method. An application locks
a file named <i>filename</i> by creating a file named <i>file-</i> 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 <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 lock file, as well as stale lock files that were left
behind after abnormal program termination. behind after abnormal program termination.
<b>-m</b> List the names of all supported lookup table types. In Postfix <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>, 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- 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>- 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. <a href="DATABASE_README.html">BASE_README</a> document.
<b>btree</b> A sorted, balanced tree structure. Available on systems <b>btree</b> A sorted, balanced tree structure. Available on systems
with support for Berkeley DB databases. with support for Berkeley DB databases.
<b>cdb</b> A read-optimized structure with no support for incremen- <b>cdb</b> A read-optimized structure with no support for incremen-
tal updates. Available on systems with support for CDB tal updates. Available on systems with support for CDB
databases. databases.
<b>cidr</b> A table that associates values with Classless <b>cidr</b> A table that associates values with Classless
Inter-Domain Routing (CIDR) patterns. This is described Inter-Domain Routing (CIDR) patterns. This is described
in <a href="cidr_table.5.html"><b>cidr_table</b>(5)</a>. in <a href="cidr_table.5.html"><b>cidr_table</b>(5)</a>.
<b>dbm</b> An indexed file type based on hashing. Available on sys- <b>dbm</b> An indexed file type based on hashing. Available on sys-
@@ -224,31 +224,31 @@ POSTCONF(1) General Commands Manual POSTCONF(1)
<b>environ</b> <b>environ</b>
The UNIX process environment array. The lookup key is the The UNIX process environment array. The lookup key is the
variable name. Originally implemented for testing, some- variable name. Originally implemented for testing, some-
one may find this useful someday. one may find this useful someday.
<b>fail</b> A table that reliably fails all requests. The lookup ta- <b>fail</b> A table that reliably fails all requests. The lookup ta-
ble name is used for logging. This table exists to sim- ble name is used for logging. This table exists to sim-
plify Postfix error tests. plify Postfix error tests.
<b>hash</b> An indexed file type based on hashing. Available on sys- <b>hash</b> An indexed file type based on hashing. Available on sys-
tems with support for Berkeley DB databases. tems with support for Berkeley DB databases.
<b>inline</b> (read-only) <b>inline</b> (read-only)
A non-shared, in-memory lookup table. Example: "<b><a href="DATABASE_README.html#types">inline</a>:{</b> 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>". <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; Key-value pairs are separated by whitespace or comma;
whitespace after "<b>{</b>" and before "<b>}</b>" is ignored. Inline whitespace after "<b>{</b>" and before "<b>}</b>" is ignored. Inline
tables eliminate the need to create a database file for tables eliminate 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 just a few fixed elements. See also the <i><a href="DATABASE_README.html#types">static</a>:</i> map
type. type.
<b>internal</b> <b>internal</b>
A non-shared, in-memory hash table. Its content are lost A non-shared, in-memory hash table. Its content are lost
when a process terminates. when a process terminates.
<b>lmdb</b> OpenLDAP LMDB database (a memory-mapped, persistent <b>lmdb</b> OpenLDAP LMDB database (a memory-mapped, persistent
file). Available on systems with support for LMDB data- 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>. bases. This is described in <a href="lmdb_table.5.html"><b>lmdb_table</b>(5)</a>.
<b>ldap</b> (read-only) <b>ldap</b> (read-only)
@@ -321,14 +321,14 @@ POSTCONF(1) General Commands Manual POSTCONF(1)
TCP/IP client. The protocol is described in <a href="tcp_table.5.html"><b>tcp_table</b>(5)</a>. 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) <b>texthash</b> (read-only)
Produces similar results as <a href="DATABASE_README.html#types">hash</a>: files, except that you 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 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 use the file, and that it does not detect changes after
the file is read. the file is read.
<b>unionmap</b> (read-only) <b>unionmap</b> (read-only)
A table that sends each query to multiple lookup tables A table that sends each query to multiple lookup tables
and that concatenates all found results, separated by and that concatenates all found results, separated by
comma. The table name syntax is the same as for <b>pipemap</b>. comma. The table name syntax is the same as for <b>pipemap</b>.
<b>unix</b> (read-only) <b>unix</b> (read-only)
@@ -345,29 +345,29 @@ POSTCONF(1) General Commands Manual POSTCONF(1)
group name. The result is a group file entry in group name. The result is a group file entry in
<b>group</b>(5) format. <b>group</b>(5) format.
Other table types may exist depending on how Postfix was built. 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. <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 <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> 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 <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>, 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>). <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 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, 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</b>" will output all services named "smtp", and
"<b>postconf -Mf smtp/inet</b>" will output only the smtp service that "<b>postconf -Mf smtp/inet</b>" will output only the smtp service that
listens on the network. Trailing service type fields that are listens on the network. Trailing service type fields that are
omitted will be handled as "*" wildcard fields. omitted will be handled as "*" wildcard fields.
This feature is available with Postfix 2.9 and later. The syntax 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 was changed from "<i>name.type</i>" to "<i>name/type</i>", and "*" wildcard
support was added with Postfix 2.11. support was added with Postfix 2.11.
<b>-n</b> Show only configuration parameters that have explicit <i>name=value</i> <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 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). readability (Postfix 2.9 and later).
<b>-o</b> <i>name=value</i> <b>-o</b> <i>name=value</i>
@@ -379,10 +379,9 @@ POSTCONF(1) General Commands Manual POSTCONF(1)
This feature is available with Postfix 2.11 and later. 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- <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 one "<i>ser-</i> vices and all parameters), formatted as "<i>service/type/parame-</i>
<i>vice/type/parameter=value</i>" per line. Specify <b>-Pf</b> to fold long <i>ter=value</i>", one per line. Specify <b>-Pf</b> to fold long lines.
lines.
Specify one or more "<i>service/type/parameter</i>" instances on the 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 <a href="postconf.1.html"><b>postconf</b>(1)</a> command line to limit the output to parameters of
@@ -422,28 +421,28 @@ POSTCONF(1) General Commands Manual POSTCONF(1)
runtime (i.e. the OpenSSL version in a shared library). runtime (i.e. the OpenSSL version in a shared library).
<b>public-key-algorithms</b> <b>public-key-algorithms</b>
Output the lower-case names of the supported public-key Output the lower-case names of the supported public-key
algorithms, one per-line. algorithms, one per-line.
This feature is available with Postfix 3.1 and later. This feature is available with Postfix 3.1 and later.
<b>-v</b> Enable verbose logging for debugging purposes. Multiple <b>-v</b> <b>-v</b> Enable verbose logging for debugging purposes. Multiple <b>-v</b>
options make the software increasingly verbose. 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 <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. expansion is recursive.
This feature is available with Postfix 2.10 and later. 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 <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- 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. 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 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 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. <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 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) or more service parameter settings (-o parameter=value settings)
as specied with "<i>service/type/parameter</i>" on the <a href="postconf.1.html"><b>postconf</b>(1)</a> com- as specied with "<i>service/type/parameter</i>" on the <a href="postconf.1.html"><b>postconf</b>(1)</a> com-
mand line. mand line.
@@ -452,10 +451,10 @@ POSTCONF(1) General Commands Manual POSTCONF(1)
into place. Specify quotes to protect special characters on the into place. Specify quotes to protect special characters on the
<a href="postconf.1.html"><b>postconf</b>(1)</a> command line. <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- There is no <a href="postconf.1.html"><b>postconf</b>(1)</a> command to perform the reverse opera-
tion. tion.
This feature is available with Postfix 2.10 and later. Support This feature is available with Postfix 2.10 and later. Support
for -M and -P was added with Postfix 2.11. 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- <b>-#</b> Edit the <a href="postconf.5.html"><b>main.cf</b></a> configuration file, and comment out the parame-
@@ -463,18 +462,18 @@ POSTCONF(1) General Commands Manual POSTCONF(1)
eters revert to their default values. Specify a list of parame- eters revert to their default values. Specify a list of parame-
ter names, not "<i>name=value</i>" pairs. 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 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 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. 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 In all cases the file is copied to a temporary file then renamed
into place. Specify quotes to protect special characters on the into place. Specify quotes to protect special characters on the
<a href="postconf.1.html"><b>postconf</b>(1)</a> command line. <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- There is no <a href="postconf.1.html"><b>postconf</b>(1)</a> command to perform the reverse opera-
tion. tion.
This feature is available with Postfix 2.6 and later. Support This feature is available with Postfix 2.6 and later. Support
for -M was added with Postfix 2.11. for -M was added with Postfix 2.11.
<b>DIAGNOSTICS</b> <b>DIAGNOSTICS</b>
@@ -485,18 +484,18 @@ POSTCONF(1) General Commands Manual POSTCONF(1)
Directory with Postfix configuration files. Directory with Postfix configuration files.
<b>CONFIGURATION PARAMETERS</b> <b>CONFIGURATION PARAMETERS</b>
The following <a href="postconf.5.html"><b>main.cf</b></a> parameters are especially relevant to this pro- The following <a href="postconf.5.html"><b>main.cf</b></a> parameters are especially relevant to this pro-
gram. gram.
The text below provides only a parameter summary. See <a href="postconf.5.html"><b>postconf</b>(5)</a> for The text below provides only a parameter summary. See <a href="postconf.5.html"><b>postconf</b>(5)</a> for
more details including examples. more details including examples.
<b><a href="postconf.5.html#config_directory">config_directory</a> (see 'postconf -d' output)</b> <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- 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. figuration files.
<b><a href="postconf.5.html#bounce_template_file">bounce_template_file</a> (empty)</b> <b><a href="postconf.5.html#bounce_template_file">bounce_template_file</a> (empty)</b>
Pathname of a configuration file with bounce message templates. Pathname of a configuration file with bounce message templates.
<b>FILES</b> <b>FILES</b>
/etc/postfix/<a href="postconf.5.html">main.cf</a>, Postfix configuration parameters /etc/postfix/<a href="postconf.5.html">main.cf</a>, Postfix configuration parameters

52
postfix/html/postfix.1.html
View File

@@ -4,7 +4,7 @@
<meta http-equiv="Content-Type" content="text/html; charset=us-ascii"> <meta http-equiv="Content-Type" content="text/html; charset=us-ascii">
<title> Postfix manual - postfix(1) </title> <title> Postfix manual - postfix(1) </title>
</head> <body> <pre> </head> <body> <pre>
POSTFIX(1) General Commands Manual POSTFIX(1) POSTFIX(1) POSTFIX(1)
<b>NAME</b> <b>NAME</b>
postfix - Postfix control program postfix - Postfix control program
@@ -145,22 +145,22 @@ POSTFIX(1) General Commands Manual POSTFIX(1)
The directory with Postfix support programs and daemon programs. The directory with Postfix support programs and daemon programs.
<b><a href="postconf.5.html#html_directory">html_directory</a> (see 'postconf -d' output)</b> <b><a href="postconf.5.html#html_directory">html_directory</a> (see 'postconf -d' output)</b>
The location of Postfix HTML files that describe how to build, The location of Postfix HTML files that describe how to build,
configure or operate a specific Postfix subsystem or feature. configure or operate a specific Postfix subsystem or feature.
<b><a href="postconf.5.html#mail_owner">mail_owner</a> (postfix)</b> <b><a href="postconf.5.html#mail_owner">mail_owner</a> (postfix)</b>
The UNIX system account that owns the Postfix queue and most The UNIX system account that owns the Postfix queue and most
Postfix daemon processes. Postfix daemon processes.
<b><a href="postconf.5.html#mailq_path">mailq_path</a> (see 'postconf -d' output)</b> <b><a href="postconf.5.html#mailq_path">mailq_path</a> (see 'postconf -d' output)</b>
Sendmail compatibility feature that specifies where the Postfix Sendmail compatibility feature that specifies where the Postfix
<a href="mailq.1.html"><b>mailq</b>(1)</a> command is installed. <a href="mailq.1.html"><b>mailq</b>(1)</a> command is installed.
<b><a href="postconf.5.html#manpage_directory">manpage_directory</a> (see 'postconf -d' output)</b> <b><a href="postconf.5.html#manpage_directory">manpage_directory</a> (see 'postconf -d' output)</b>
Where the Postfix manual pages are installed. Where the Postfix manual pages are installed.
<b><a href="postconf.5.html#newaliases_path">newaliases_path</a> (see 'postconf -d' output)</b> <b><a href="postconf.5.html#newaliases_path">newaliases_path</a> (see 'postconf -d' output)</b>
Sendmail compatibility feature that specifies the location of Sendmail compatibility feature that specifies the location of
the <a href="newaliases.1.html"><b>newaliases</b>(1)</a> command. the <a href="newaliases.1.html"><b>newaliases</b>(1)</a> command.
<b><a href="postconf.5.html#queue_directory">queue_directory</a> (see 'postconf -d' output)</b> <b><a href="postconf.5.html#queue_directory">queue_directory</a> (see 'postconf -d' output)</b>
@@ -171,31 +171,31 @@ POSTFIX(1) General Commands Manual POSTFIX(1)
configure or operate a specific Postfix subsystem or feature. configure or operate a specific Postfix subsystem or feature.
<b><a href="postconf.5.html#sendmail_path">sendmail_path</a> (see 'postconf -d' output)</b> <b><a href="postconf.5.html#sendmail_path">sendmail_path</a> (see 'postconf -d' output)</b>
A Sendmail compatibility feature that specifies the location of A Sendmail compatibility feature that specifies the location of
the Postfix <a href="sendmail.1.html"><b>sendmail</b>(1)</a> command. the Postfix <a href="sendmail.1.html"><b>sendmail</b>(1)</a> command.
<b><a href="postconf.5.html#setgid_group">setgid_group</a> (postdrop)</b> <b><a href="postconf.5.html#setgid_group">setgid_group</a> (postdrop)</b>
The group ownership of set-gid Postfix commands and of The group ownership of set-gid Postfix commands and of
group-writable Postfix directories. group-writable Postfix directories.
Available in Postfix version 2.5 and later: Available in Postfix version 2.5 and later:
<b><a href="postconf.5.html#data_directory">data_directory</a> (see 'postconf -d' output)</b> <b><a href="postconf.5.html#data_directory">data_directory</a> (see 'postconf -d' output)</b>
The directory with Postfix-writable data files (for example: The directory with Postfix-writable data files (for example:
caches, pseudo-random numbers). caches, pseudo-random numbers).
Available in Postfix version 3.0 and later: Available in Postfix version 3.0 and later:
<b><a href="postconf.5.html#meta_directory">meta_directory</a> (see 'postconf -d' output)</b> <b><a href="postconf.5.html#meta_directory">meta_directory</a> (see 'postconf -d' output)</b>
The location of non-executable files that are shared among mul- The location of non-executable files that are shared among mul-
tiple Postfix instances, such as postfix-files, dynamicmaps.cf, tiple Postfix instances, such as postfix-files, dynamicmaps.cf,
and the multi-instance template files <a href="postconf.5.html">main.cf</a>.proto and <a href="master.5.html">mas- and the multi-instance template files <a href="postconf.5.html">main.cf</a>.proto and <a href="master.5.html">mas-
ter.cf</a>.proto. ter.cf</a>.proto.
<b><a href="postconf.5.html#shlib_directory">shlib_directory</a> (see 'postconf -d' output)</b> <b><a href="postconf.5.html#shlib_directory">shlib_directory</a> (see 'postconf -d' output)</b>
The location of Postfix dynamically-linked libraries (libpost- The location of Postfix dynamically-linked libraries (libpost-
fix-*.so), and the default location of Postfix database plugins fix-*.so), and the default location of Postfix database plugins
(postfix-*.so) that have a relative pathname in the dynam- (postfix-*.so) that have a relative pathname in the dynam-
icmaps.cf file. icmaps.cf file.
Available in Postfix version 3.1 and later: Available in Postfix version 3.1 and later:
@@ -206,29 +206,29 @@ POSTFIX(1) General Commands Manual POSTFIX(1)
Other configuration parameters: Other configuration parameters:
<b><a href="postconf.5.html#import_environment">import_environment</a> (see 'postconf -d' output)</b> <b><a href="postconf.5.html#import_environment">import_environment</a> (see 'postconf -d' output)</b>
The list of environment parameters that a Postfix process will The list of environment parameters that a Postfix process will
import from a non-Postfix parent process. import from a non-Postfix parent process.
<b><a href="postconf.5.html#syslog_facility">syslog_facility</a> (mail)</b> <b><a href="postconf.5.html#syslog_facility">syslog_facility</a> (mail)</b>
The syslog facility of Postfix logging. The syslog facility of Postfix logging.
<b><a href="postconf.5.html#syslog_name">syslog_name</a> (see 'postconf -d' output)</b> <b><a href="postconf.5.html#syslog_name">syslog_name</a> (see 'postconf -d' output)</b>
The mail system name that is prepended to the process name in The mail system name that is prepended to the process name in
syslog records, so that "smtpd" becomes, for example, "post- syslog records, so that "smtpd" becomes, for example, "post-
fix/smtpd". fix/smtpd".
Available in Postfix version 2.6 and later: Available in Postfix version 2.6 and later:
<b><a href="postconf.5.html#multi_instance_directories">multi_instance_directories</a> (empty)</b> <b><a href="postconf.5.html#multi_instance_directories">multi_instance_directories</a> (empty)</b>
An optional list of non-default Postfix configuration directo- An optional list of non-default Postfix configuration directo-
ries; these directories belong to additional Postfix instances ries; these directories belong to additional Postfix instances
that share the Postfix executable files and documentation with that share the Postfix executable files and documentation with
the default Postfix instance, and that are started, stopped, the default Postfix instance, and that are started, stopped,
etc., together with the default Postfix instance. etc., together with the default Postfix instance.
<b><a href="postconf.5.html#multi_instance_wrapper">multi_instance_wrapper</a> (empty)</b> <b><a href="postconf.5.html#multi_instance_wrapper">multi_instance_wrapper</a> (empty)</b>
The pathname of a multi-instance manager command that the <a href="postfix.1.html"><b>post-</b></a> The pathname of a multi-instance manager command that the <a href="postfix.1.html"><b>post-</b></a>
<a href="postfix.1.html"><b>fix</b>(1)</a> command invokes when the <a href="postconf.5.html#multi_instance_directories">multi_instance_directories</a> <a href="postfix.1.html"><b>fix</b>(1)</a> command invokes when the <a href="postconf.5.html#multi_instance_directories">multi_instance_directories</a>
parameter value is non-empty. parameter value is non-empty.
<b><a href="postconf.5.html#multi_instance_group">multi_instance_group</a> (empty)</b> <b><a href="postconf.5.html#multi_instance_group">multi_instance_group</a> (empty)</b>
@@ -238,15 +238,15 @@ POSTFIX(1) General Commands Manual POSTFIX(1)
The optional instance name of this Postfix instance. The optional instance name of this Postfix instance.
<b><a href="postconf.5.html#multi_instance_enable">multi_instance_enable</a> (no)</b> <b><a href="postconf.5.html#multi_instance_enable">multi_instance_enable</a> (no)</b>
Allow this Postfix instance to be started, stopped, etc., by a Allow this Postfix instance to be started, stopped, etc., by a
multi-instance manager. multi-instance manager.
<b>FILES</b> <b>FILES</b>
Prior to Postfix version 2.6, all of the following files were in <b>$<a href="postconf.5.html#config_directory">con</a>-</b> Prior to Postfix version 2.6, all of the following files were in <b>$<a href="postconf.5.html#config_directory">con</a>-</b>
<b><a href="postconf.5.html#config_directory">fig_directory</a></b>. Some files are now in <b>$<a href="postconf.5.html#daemon_directory">daemon_directory</a></b> so that they can <b><a href="postconf.5.html#config_directory">fig_directory</a></b>. Some files are now in <b>$<a href="postconf.5.html#daemon_directory">daemon_directory</a></b> so that they can
be shared among multiple instances that run the same Postfix version. be shared among multiple instances that run the same Postfix version.
Use the command "<b>postconf <a href="postconf.5.html#config_directory">config_directory</a></b>" or "<b>postconf <a href="postconf.5.html#daemon_directory">daemon_direc</a>-</b> Use the command "<b>postconf <a href="postconf.5.html#config_directory">config_directory</a></b>" or "<b>postconf <a href="postconf.5.html#daemon_directory">daemon_direc</a>-</b>
<b><a href="postconf.5.html#daemon_directory">tory</a></b>" to expand the names into their actual values. <b><a href="postconf.5.html#daemon_directory">tory</a></b>" to expand the names into their actual values.
$<a href="postconf.5.html#config_directory">config_directory</a>/<a href="postconf.5.html">main.cf</a>, Postfix configuration parameters $<a href="postconf.5.html#config_directory">config_directory</a>/<a href="postconf.5.html">main.cf</a>, Postfix configuration parameters

6
postfix/html/postmulti.1.html
View File

@@ -10,11 +10,11 @@ POSTMULTI(1) POSTMULTI(1)
postmulti - Postfix multi-instance manager postmulti - Postfix multi-instance manager
<b>SYNOPSIS</b> <b>SYNOPSIS</b>
<b>ENABLING MULTI-INSTANCE MANAGEMENT:</b> <b>Enabling multi-instance management:</b>
<b>postmulti -e init</b> [<b>-v</b>] <b>postmulti -e init</b> [<b>-v</b>]
<b>ITERATOR MODE:</b> <b>Iterator mode:</b>
<b>postmulti -l</b> [<b>-aRv</b>] [<b>-g</b> <i>group</i>] [<b>-i</b> <i>name</i>] <b>postmulti -l</b> [<b>-aRv</b>] [<b>-g</b> <i>group</i>] [<b>-i</b> <i>name</i>]
@@ -22,7 +22,7 @@ POSTMULTI(1) POSTMULTI(1)
<b>postmulti -x</b> [<b>-aRv</b>] [<b>-g</b> <i>group</i>] [<b>-i</b> <i>name</i>] <i>command...</i> <b>postmulti -x</b> [<b>-aRv</b>] [<b>-g</b> <i>group</i>] [<b>-i</b> <i>name</i>] <i>command...</i>
<b>LIFE-CYCLE MANAGEMENT:</b> <b>Life-cycle management:</b>
<b>postmulti -e create</b> [<b>-av</b>] [<b>-g</b> <i>group</i>] [<b>-i</b> <i>name</i>] [<b>-G</b> <i>group</i>] [<b>-I</b> <i>name</i>] <b>postmulti -e create</b> [<b>-av</b>] [<b>-g</b> <i>group</i>] [<b>-i</b> <i>name</i>] [<b>-G</b> <i>group</i>] [<b>-I</b> <i>name</i>]
[<i>param=value</i> ...] [<i>param=value</i> ...]

116
postfix/html/postqueue.1.html
View File

@@ -4,13 +4,13 @@
<meta http-equiv="Content-Type" content="text/html; charset=us-ascii"> <meta http-equiv="Content-Type" content="text/html; charset=us-ascii">
<title> Postfix manual - postqueue(1) </title> <title> Postfix manual - postqueue(1) </title>
</head> <body> <pre> </head> <body> <pre>
POSTQUEUE(1) General Commands Manual POSTQUEUE(1) POSTQUEUE(1) POSTQUEUE(1)
<b>NAME</b> <b>NAME</b>
postqueue - Postfix queue control postqueue - Postfix queue control
<b>SYNOPSIS</b> <b>SYNOPSIS</b>
<b>To flush the mail queue</b>: <b>To flush the mail queue</b>:
<b>postqueue</b> [<b>-v</b>] [<b>-c</b> <i>config</i><b>_</b><i>dir</i>] <b>-f</b> <b>postqueue</b> [<b>-v</b>] [<b>-c</b> <i>config</i><b>_</b><i>dir</i>] <b>-f</b>
@@ -18,7 +18,7 @@ POSTQUEUE(1) General Commands Manual POSTQUEUE(1)
<b>postqueue</b> [<b>-v</b>] [<b>-c</b> <i>config</i><b>_</b><i>dir</i>] <b>-s</b> <i>site</i> <b>postqueue</b> [<b>-v</b>] [<b>-c</b> <i>config</i><b>_</b><i>dir</i>] <b>-s</b> <i>site</i>
<b>To list the mail queue</b>: <b>To list the mail queue</b>:
<b>postqueue</b> [<b>-v</b>] [<b>-c</b> <i>config</i><b>_</b><i>dir</i>] <b>-j</b> <b>postqueue</b> [<b>-v</b>] [<b>-c</b> <i>config</i><b>_</b><i>dir</i>] <b>-j</b>
@@ -58,45 +58,8 @@ POSTQUEUE(1) General Commands Manual POSTQUEUE(1)
<b>-j</b> Produce a queue listing in JSON format, based on output from the <b>-j</b> Produce a queue listing in JSON format, based on output from the
<a href="showq.8.html">showq(8)</a> daemon. The result is a stream of zero or more JSON <a href="showq.8.html">showq(8)</a> daemon. The result is a stream of zero or more JSON
objects, one per queue file. Each object is followed by a new- objects, one per queue file. Each object is followed by a new-
line character to support simple streaming parsers. line character to support simple streaming parsers. See "<b>JSON</b>
<b>OBJECT FORMAT</b>" below for details.
Object members have string values unless indicated otherwise.
Programs should ignore object members that are not listed here;
the list of members is expected to grow over time.
<b>queue_name</b>
The name of the queue where the message was found. Note
that the contents of the mail queue may change while it
is being listed; some messages may appear more than once,
and some messages may be missed.
<b>queue_id</b>
The queue file name. The name may be reused unless
"<a href="postconf.5.html#enable_long_queue_ids">enable_long_queue_ids</a> = true".
<b>arrival_time</b>
The number of seconds since the start of the UNIX epoch.
<b>message_size</b>
The number of bytes in the message header and body. This
number does not include message envelope information. It
is approximately equal to the number of bytes that would
be transmitted via SMTP including the &lt;CR&gt;&lt;LF&gt; line end-
ings.
<b>sender</b> The envelope sender address.
<b>recipients</b>
An array containing zero or more objects with members:
<b>address</b>
One recipient address.
<b>delay_reason</b>
If present, the reason for delayed delivery. Some
delayed recipients have no delay reason, for exam-
ple, when delivery is in progress or when the sys-
tem was stopped before it could record the reason.
This feature is available in Postfix 3.1 and later. This feature is available in Postfix 3.1 and later.
@@ -132,8 +95,53 @@ POSTQUEUE(1) General Commands Manual POSTQUEUE(1)
options make the software increasingly verbose. As of Postfix options make the software increasingly verbose. As of Postfix
2.3, this option is available for the super-user only. 2.3, this option is available for the super-user only.
<b>JSON OBJECT FORMAT</b>
Each JSON object represents one queue file; it is emitted as a single
text line followed by a newline character.
Object members have string values unless indicated otherwise. Programs
should ignore object members that are not listed here; the list of mem-
bers is expected to grow over time.
<b>queue_name</b>
The name of the queue where the message was found. Note that
the contents of the mail queue may change while it is being
listed; some messages may appear more than once, and some mes-
sages may be missed.
<b>queue_id</b>
The queue file name. The queue_id may be reused within a Postfix
instance unless "<a href="postconf.5.html#enable_long_queue_ids">enable_long_queue_ids</a> = true" and time is mono-
tonic. Even then, the queue_id is not expected to be unique
between different Postfix instances. Management tools that
require a unique name should combine the queue_id with the
<a href="postconf.5.html#myhostname">myhostname</a> setting of the Postfix instance.
<b>arrival_time</b>
The number of seconds since the start of the UNIX epoch.
<b>message_size</b>
The number of bytes in the message header and body. This number
does not include message envelope information. It is approxi-
mately equal to the number of bytes that would be transmitted
via SMTP including the &lt;CR&gt;&lt;LF&gt; line endings.
<b>sender</b> The envelope sender address.
<b>recipients</b>
An array containing zero or more objects with members:
<b>address</b>
One recipient address.
<b>delay_reason</b>
If present, the reason for delayed delivery. Delayed
recipients may have no delay reason, for example, while
delivery is in progress, or after the system was stopped
before it could record the reason.
<b>SECURITY</b> <b>SECURITY</b>
This program is designed to run with set-group ID privileges, so that This program is designed to run with set-group ID privileges, so that
it can connect to Postfix daemon processes. it can connect to Postfix daemon processes.
<b>STANDARDS</b> <b>STANDARDS</b>
@@ -144,27 +152,27 @@ POSTQUEUE(1) General Commands Manual POSTQUEUE(1)
<b>ENVIRONMENT</b> <b>ENVIRONMENT</b>
MAIL_CONFIG MAIL_CONFIG
Directory with the <a href="postconf.5.html"><b>main.cf</b></a> file. In order to avoid exploitation Directory with the <a href="postconf.5.html"><b>main.cf</b></a> file. In order to avoid exploitation
of set-group ID privileges, a non-standard directory is allowed of set-group ID privileges, a non-standard directory is allowed
only if: only if:
<b>o</b> The name is listed in the standard <a href="postconf.5.html"><b>main.cf</b></a> file with the <b>o</b> The name is listed in the standard <a href="postconf.5.html"><b>main.cf</b></a> file with the
<b><a href="postconf.5.html#alternate_config_directories">alternate_config_directories</a></b> configuration parameter. <b><a href="postconf.5.html#alternate_config_directories">alternate_config_directories</a></b> configuration parameter.
<b>o</b> The command is invoked by the super-user. <b>o</b> The command is invoked by the super-user.
<b>CONFIGURATION PARAMETERS</b> <b>CONFIGURATION PARAMETERS</b>
The following <a href="postconf.5.html"><b>main.cf</b></a> parameters are especially relevant to this pro- 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>post-</b></a> gram. The text below provides only a parameter summary. See <a href="postconf.5.html"><b>post-</b></a>
<a href="postconf.5.html"><b>conf</b>(5)</a> for more details including examples. <a href="postconf.5.html"><b>conf</b>(5)</a> for more details including examples.
<b><a href="postconf.5.html#alternate_config_directories">alternate_config_directories</a> (empty)</b> <b><a href="postconf.5.html#alternate_config_directories">alternate_config_directories</a> (empty)</b>
A list of non-default Postfix configuration directories that may A list of non-default Postfix configuration directories that may
be specified with "-c <a href="postconf.5.html#config_directory">config_directory</a>" on the command line, or be specified with "-c <a href="postconf.5.html#config_directory">config_directory</a>" on the command line, or
via the MAIL_CONFIG environment parameter. via the MAIL_CONFIG environment parameter.
<b><a href="postconf.5.html#config_directory">config_directory</a> (see 'postconf -d' output)</b> <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- 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. figuration files.
<b><a href="postconf.5.html#command_directory">command_directory</a> (see 'postconf -d' output)</b> <b><a href="postconf.5.html#command_directory">command_directory</a> (see 'postconf -d' output)</b>
@@ -175,7 +183,7 @@ POSTQUEUE(1) General Commands Manual POSTQUEUE(1)
tion logfiles with mail that is queued to those destinations. tion logfiles with mail that is queued to those destinations.
<b><a href="postconf.5.html#import_environment">import_environment</a> (see 'postconf -d' output)</b> <b><a href="postconf.5.html#import_environment">import_environment</a> (see 'postconf -d' output)</b>
The list of environment parameters that a Postfix process will The list of environment parameters that a Postfix process will
import from a non-Postfix parent process. import from a non-Postfix parent process.
<b><a href="postconf.5.html#queue_directory">queue_directory</a> (see 'postconf -d' output)</b> <b><a href="postconf.5.html#queue_directory">queue_directory</a> (see 'postconf -d' output)</b>
@@ -185,12 +193,12 @@ POSTQUEUE(1) General Commands Manual POSTQUEUE(1)
The syslog facility of Postfix logging. The syslog facility of Postfix logging.
<b><a href="postconf.5.html#syslog_name">syslog_name</a> (see 'postconf -d' output)</b> <b><a href="postconf.5.html#syslog_name">syslog_name</a> (see 'postconf -d' output)</b>
The mail system name that is prepended to the process name in The mail system name that is prepended to the process name in
syslog records, so that "smtpd" becomes, for example, "post- syslog records, so that "smtpd" becomes, for example, "post-
fix/smtpd". fix/smtpd".
<b><a href="postconf.5.html#trigger_timeout">trigger_timeout</a> (10s)</b> <b><a href="postconf.5.html#trigger_timeout">trigger_timeout</a> (10s)</b>
The time limit for sending a trigger to a Postfix daemon (for The time limit for sending a trigger to a Postfix daemon (for
example, the <a href="pickup.8.html"><b>pickup</b>(8)</a> or <a href="qmgr.8.html"><b>qmgr</b>(8)</a> daemon). example, the <a href="pickup.8.html"><b>pickup</b>(8)</a> or <a href="qmgr.8.html"><b>qmgr</b>(8)</a> daemon).
Available in Postfix version 2.2 and later: Available in Postfix version 2.2 and later:

114
postfix/html/qmgr.8.html
View File

@@ -4,7 +4,7 @@
<meta http-equiv="Content-Type" content="text/html; charset=us-ascii"> <meta http-equiv="Content-Type" content="text/html; charset=us-ascii">
<title> Postfix manual - qmgr(8) </title> <title> Postfix manual - qmgr(8) </title>
</head> <body> <pre> </head> <body> <pre>
QMGR(8) System Manager's Manual QMGR(8) QMGR(8) QMGR(8)
<b>NAME</b> <b>NAME</b>
qmgr - Postfix queue manager qmgr - Postfix queue manager
@@ -41,22 +41,22 @@ QMGR(8) System Manager's Manual QMGR(8)
<b>corrupt</b> <b>corrupt</b>
Unreadable or damaged queue files are moved here for inspection. Unreadable or damaged queue files are moved here for inspection.
<b>hold</b> Messages that are kept "on hold" are kept here until someone <b>hold</b> Messages that are kept "on hold" are kept here until someone
sets them free. sets them free.
<b>DELIVERY STATUS REPORTS</b> <b>DELIVERY STATUS REPORTS</b>
The <a href="qmgr.8.html"><b>qmgr</b>(8)</a> daemon keeps an eye on per-message delivery status reports The <a href="qmgr.8.html"><b>qmgr</b>(8)</a> daemon keeps an eye on per-message delivery status reports
in the following directories. Each status report file has the same name in the following directories. Each status report file has the same name
as the corresponding message file: as the corresponding message file:
<b>bounce</b> Per-recipient status information about why mail is bounced. <b>bounce</b> Per-recipient status information about why mail is bounced.
These files are maintained by the <a href="bounce.8.html"><b>bounce</b>(8)</a> daemon. These files are maintained by the <a href="bounce.8.html"><b>bounce</b>(8)</a> daemon.
<b>defer</b> Per-recipient status information about why mail is delayed. <b>defer</b> Per-recipient status information about why mail is delayed.
These files are maintained by the <a href="defer.8.html"><b>defer</b>(8)</a> daemon. These files are maintained by the <a href="defer.8.html"><b>defer</b>(8)</a> daemon.
<b>trace</b> Per-recipient status information as requested with the Postfix <b>trace</b> Per-recipient status information as requested with the Postfix
"<b>sendmail -v</b>" or "<b>sendmail -bv</b>" command. These files are main- "<b>sendmail -v</b>" or "<b>sendmail -bv</b>" command. These files are main-
tained by the <a href="trace.8.html"><b>trace</b>(8)</a> daemon. tained by the <a href="trace.8.html"><b>trace</b>(8)</a> daemon.
The <a href="qmgr.8.html"><b>qmgr</b>(8)</a> daemon is responsible for asking the <a href="bounce.8.html"><b>bounce</b>(8)</a>, <a href="defer.8.html"><b>defer</b>(8)</a> or The <a href="qmgr.8.html"><b>qmgr</b>(8)</a> daemon is responsible for asking the <a href="bounce.8.html"><b>bounce</b>(8)</a>, <a href="defer.8.html"><b>defer</b>(8)</a> or
@@ -67,74 +67,74 @@ QMGR(8) System Manager's Manual QMGR(8)
queue files (input) or for message delivery (output). queue files (input) or for message delivery (output).
<b>leaky bucket</b> <b>leaky bucket</b>
This strategy limits the number of messages in the <b>active</b> queue This strategy limits the number of messages in the <b>active</b> queue
and prevents the queue manager from running out of memory under and prevents the queue manager from running out of memory under
heavy load. heavy load.
<b>fairness</b> <b>fairness</b>
When the <b>active</b> queue has room, the queue manager takes one mes- When the <b>active</b> queue has room, the queue manager takes one mes-
sage from the <a href="QSHAPE_README.html#incoming_queue"><b>incoming</b> queue</a> and one from the <b>deferred</b> queue. sage from the <a href="QSHAPE_README.html#incoming_queue"><b>incoming</b> queue</a> and one from the <b>deferred</b> queue.
This prevents a large mail backlog from blocking the delivery of This prevents a large mail backlog from blocking the delivery of
new mail. new mail.
<b>slow start</b> <b>slow start</b>
This strategy eliminates "thundering herd" problems by slowly This strategy eliminates "thundering herd" problems by slowly
adjusting the number of parallel deliveries to the same destina- adjusting the number of parallel deliveries to the same destina-
tion. tion.
<b>round robin</b> <b>round robin</b>
The queue manager sorts delivery requests by destination. The queue manager sorts delivery requests by destination.
Round-robin selection prevents one destination from dominating Round-robin selection prevents one destination from dominating
deliveries to other destinations. deliveries to other destinations.
<b>exponential backoff</b> <b>exponential backoff</b>
Mail that cannot be delivered upon the first attempt is Mail that cannot be delivered upon the first attempt is
deferred. The time interval between delivery attempts is dou- deferred. The time interval between delivery attempts is dou-
bled after each attempt. bled after each attempt.
<b>destination status cache</b> <b>destination status cache</b>
The queue manager avoids unnecessary delivery attempts by main- The queue manager avoids unnecessary delivery attempts by main-
taining a short-term, in-memory list of unreachable destina- taining a short-term, in-memory list of unreachable destina-
tions. tions.
<b>preemptive message scheduling</b> <b>preemptive message scheduling</b>
The queue manager attempts to minimize the average per-recipient The queue manager attempts to minimize the average per-recipient
delay while still preserving the correct per-message delays, delay while still preserving the correct per-message delays,
using a sophisticated preemptive message scheduling. using a sophisticated preemptive message scheduling.
<b>TRIGGERS</b> <b>TRIGGERS</b>
On an idle system, the queue manager waits for the arrival of trigger On an idle system, the queue manager waits for the arrival of trigger
events, or it waits for a timer to go off. A trigger is a one-byte mes- events, or it waits for a timer to go off. A trigger is a one-byte mes-
sage. Depending on the message received, the queue manager performs sage. Depending on the message received, the queue manager performs
one of the following actions (the message is followed by the symbolic one of the following actions (the message is followed by the symbolic
constant used internally by the software): constant used internally by the software):
<b>D (QMGR_REQ_SCAN_DEFERRED)</b> <b>D (QMGR_REQ_SCAN_DEFERRED)</b>
Start a <a href="QSHAPE_README.html#deferred_queue">deferred queue</a> scan. If a deferred queue scan is Start a <a href="QSHAPE_README.html#deferred_queue">deferred queue</a> scan. If a deferred queue scan is
already in progress, that scan will be restarted as soon as it already in progress, that scan will be restarted as soon as it
finishes. finishes.
<b>I (QMGR_REQ_SCAN_INCOMING)</b> <b>I (QMGR_REQ_SCAN_INCOMING)</b>
Start an <a href="QSHAPE_README.html#incoming_queue">incoming queue</a> scan. If an incoming queue scan is Start an <a href="QSHAPE_README.html#incoming_queue">incoming queue</a> scan. If an incoming queue scan is
already in progress, that scan will be restarted as soon as it already in progress, that scan will be restarted as soon as it
finishes. finishes.
<b>A (QMGR_REQ_SCAN_ALL)</b> <b>A (QMGR_REQ_SCAN_ALL)</b>
Ignore <a href="QSHAPE_README.html#deferred_queue">deferred queue</a> file time stamps. The request affects the Ignore <a href="QSHAPE_README.html#deferred_queue">deferred queue</a> file time stamps. The request affects the
next <a href="QSHAPE_README.html#deferred_queue">deferred queue</a> scan. next <a href="QSHAPE_README.html#deferred_queue">deferred queue</a> scan.
<b>F (QMGR_REQ_FLUSH_DEAD)</b> <b>F (QMGR_REQ_FLUSH_DEAD)</b>
Purge all information about dead transports and destinations. Purge all information about dead transports and destinations.
<b>W (TRIGGER_REQ_WAKEUP)</b> <b>W (TRIGGER_REQ_WAKEUP)</b>
Wakeup call, This is used by the master server to instantiate Wakeup call, This is used by the master server to instantiate
servers that should not go away forever. The action is to start servers that should not go away forever. The action is to start
an <a href="QSHAPE_README.html#incoming_queue">incoming queue</a> scan. an <a href="QSHAPE_README.html#incoming_queue">incoming queue</a> scan.
The <a href="qmgr.8.html"><b>qmgr</b>(8)</a> daemon reads an entire buffer worth of triggers. Multiple The <a href="qmgr.8.html"><b>qmgr</b>(8)</a> daemon reads an entire buffer worth of triggers. Multiple
identical trigger requests are collapsed into one, and trigger requests identical trigger requests are collapsed into one, and trigger requests
are sorted so that <b>A</b> and <b>F</b> precede <b>D</b> and <b>I</b>. Thus, in order to force a are sorted so that <b>A</b> and <b>F</b> precede <b>D</b> and <b>I</b>. Thus, in order to force a
<a href="QSHAPE_README.html#deferred_queue">deferred queue</a> run, one would request <b>A F D</b>; in order to notify the <a href="QSHAPE_README.html#deferred_queue">deferred queue</a> run, one would request <b>A F D</b>; in order to notify the
queue manager of the arrival of new mail one would request <b>I</b>. queue manager of the arrival of new mail one would request <b>I</b>.
<b>STANDARDS</b> <b>STANDARDS</b>
@@ -143,16 +143,16 @@ QMGR(8) System Manager's Manual QMGR(8)
<b>SECURITY</b> <b>SECURITY</b>
The <a href="qmgr.8.html"><b>qmgr</b>(8)</a> daemon is not security sensitive. It reads single-character The <a href="qmgr.8.html"><b>qmgr</b>(8)</a> daemon is not security sensitive. It reads single-character
messages from untrusted local users, and thus may be susceptible to messages from untrusted local users, and thus may be susceptible to
denial of service attacks. The <a href="qmgr.8.html"><b>qmgr</b>(8)</a> daemon does not talk to the out- denial of service attacks. The <a href="qmgr.8.html"><b>qmgr</b>(8)</a> daemon does not talk to the out-
side world, and it can be run at fixed low privilege in a chrooted side world, and it can be run at fixed low privilege in a chrooted
environment. environment.
<b>DIAGNOSTICS</b> <b>DIAGNOSTICS</b>
Problems and transactions are logged to the syslog daemon. Corrupted Problems and transactions are logged to the syslog daemon. Corrupted
message files are saved to the <b>corrupt</b> queue for further inspection. message files are saved to the <b>corrupt</b> queue for further inspection.
Depending on the setting of the <b><a href="postconf.5.html#notify_classes">notify_classes</a></b> parameter, the postmas- Depending on the setting of the <b><a href="postconf.5.html#notify_classes">notify_classes</a></b> parameter, the postmas-
ter is notified of bounces and of other trouble. ter is notified of bounces and of other trouble.
<b>BUGS</b> <b>BUGS</b>
@@ -165,7 +165,7 @@ QMGR(8) System Manager's Manual QMGR(8)
sistent process. Use the "<b>postfix reload</b>" command after a configuration sistent process. Use the "<b>postfix reload</b>" command after a configuration
change. change.
The text below provides only a parameter summary. See <a href="postconf.5.html"><b>postconf</b>(5)</a> for The text below provides only a parameter summary. See <a href="postconf.5.html"><b>postconf</b>(5)</a> for
more details including examples. more details including examples.
In the text below, <i>transport</i> is the first field in a <a href="master.5.html"><b>master.cf</b></a> entry. In the text below, <i>transport</i> is the first field in a <a href="master.5.html"><b>master.cf</b></a> entry.
@@ -174,26 +174,26 @@ QMGR(8) System Manager's Manual QMGR(8)
Available before Postfix version 2.5: Available before Postfix version 2.5:
<b><a href="postconf.5.html#allow_min_user">allow_min_user</a> (no)</b> <b><a href="postconf.5.html#allow_min_user">allow_min_user</a> (no)</b>
Allow a sender or recipient address to have `-' as the first Allow a sender or recipient address to have `-' as the first
character. character.
Available with Postfix version 2.7 and later: Available with Postfix version 2.7 and later:
<b><a href="postconf.5.html#default_filter_nexthop">default_filter_nexthop</a> (empty)</b> <b><a href="postconf.5.html#default_filter_nexthop">default_filter_nexthop</a> (empty)</b>
When a <a href="postconf.5.html#content_filter">content_filter</a> or FILTER request specifies no explicit When a <a href="postconf.5.html#content_filter">content_filter</a> or FILTER request specifies no explicit
next-hop destination, use $<a href="postconf.5.html#default_filter_nexthop">default_filter_nexthop</a> instead; when next-hop destination, use $<a href="postconf.5.html#default_filter_nexthop">default_filter_nexthop</a> instead; when
that value is empty, use the domain in the recipient address. that value is empty, use the domain in the recipient address.
<b>ACTIVE QUEUE CONTROLS</b> <b>ACTIVE QUEUE CONTROLS</b>
<b><a href="postconf.5.html#qmgr_clog_warn_time">qmgr_clog_warn_time</a> (300s)</b> <b><a href="postconf.5.html#qmgr_clog_warn_time">qmgr_clog_warn_time</a> (300s)</b>
The minimal delay between warnings that a specific destination The minimal delay between warnings that a specific destination
is clogging up the Postfix <a href="QSHAPE_README.html#active_queue">active queue</a>. is clogging up the Postfix <a href="QSHAPE_README.html#active_queue">active queue</a>.
<b><a href="postconf.5.html#qmgr_message_active_limit">qmgr_message_active_limit</a> (20000)</b> <b><a href="postconf.5.html#qmgr_message_active_limit">qmgr_message_active_limit</a> (20000)</b>
The maximal number of messages in the <a href="QSHAPE_README.html#active_queue">active queue</a>. The maximal number of messages in the <a href="QSHAPE_README.html#active_queue">active queue</a>.
<b><a href="postconf.5.html#qmgr_message_recipient_limit">qmgr_message_recipient_limit</a> (20000)</b> <b><a href="postconf.5.html#qmgr_message_recipient_limit">qmgr_message_recipient_limit</a> (20000)</b>
The maximal number of recipients held in memory by the Postfix The maximal number of recipients held in memory by the Postfix
queue manager, and the maximal size of the short-term, in-memory queue manager, and the maximal size of the short-term, in-memory
"dead" destination status cache. "dead" destination status cache.
@@ -208,7 +208,7 @@ QMGR(8) System Manager's Manual QMGR(8)
Idem, for delivery via the named message <i>transport</i>. Idem, for delivery via the named message <i>transport</i>.
<b><a href="postconf.5.html#default_extra_recipient_limit">default_extra_recipient_limit</a> (1000)</b> <b><a href="postconf.5.html#default_extra_recipient_limit">default_extra_recipient_limit</a> (1000)</b>
The default value for the extra per-transport limit imposed on The default value for the extra per-transport limit imposed on
the number of in-memory recipients. the number of in-memory recipients.
<b><a href="postconf.5.html#transport_extra_recipient_limit"><i>transport</i>_extra_recipient_limit</a> ($<a href="postconf.5.html#default_extra_recipient_limit">default_extra_recipient_limit</a>)</b> <b><a href="postconf.5.html#transport_extra_recipient_limit"><i>transport</i>_extra_recipient_limit</a> ($<a href="postconf.5.html#default_extra_recipient_limit">default_extra_recipient_limit</a>)</b>
@@ -217,7 +217,7 @@ QMGR(8) System Manager's Manual QMGR(8)
Available in Postfix version 2.4 and later: Available in Postfix version 2.4 and later:
<b><a href="postconf.5.html#default_recipient_refill_limit">default_recipient_refill_limit</a> (100)</b> <b><a href="postconf.5.html#default_recipient_refill_limit">default_recipient_refill_limit</a> (100)</b>
The default per-transport limit on the number of recipients The default per-transport limit on the number of recipients
refilled at once. refilled at once.
<b><a href="postconf.5.html#transport_recipient_refill_limit"><i>transport</i>_recipient_refill_limit</a> ($<a href="postconf.5.html#default_recipient_refill_limit">default_recipient_refill_limit</a>)</b> <b><a href="postconf.5.html#transport_recipient_refill_limit"><i>transport</i>_recipient_refill_limit</a> ($<a href="postconf.5.html#default_recipient_refill_limit">default_recipient_refill_limit</a>)</b>
@@ -236,7 +236,7 @@ QMGR(8) System Manager's Manual QMGR(8)
delivery to the same destination. delivery to the same destination.
<b><a href="postconf.5.html#default_destination_concurrency_limit">default_destination_concurrency_limit</a> (20)</b> <b><a href="postconf.5.html#default_destination_concurrency_limit">default_destination_concurrency_limit</a> (20)</b>
The default maximal number of parallel deliveries to the same The default maximal number of parallel deliveries to the same
destination. destination.
<b><a href="postconf.5.html#transport_destination_concurrency_limit"><i>transport</i>_destination_concurrency_limit</a> ($<a href="postconf.5.html#default_destination_concurrency_limit">default_destination_concur</a>-</b> <b><a href="postconf.5.html#transport_destination_concurrency_limit"><i>transport</i>_destination_concurrency_limit</a> ($<a href="postconf.5.html#default_destination_concurrency_limit">default_destination_concur</a>-</b>
@@ -247,12 +247,12 @@ QMGR(8) System Manager's Manual QMGR(8)
<b><a href="postconf.5.html#transport_initial_destination_concurrency"><i>transport</i>_initial_destination_concurrency</a> ($<a href="postconf.5.html#initial_destination_concurrency">initial_destination_concur</a>-</b> <b><a href="postconf.5.html#transport_initial_destination_concurrency"><i>transport</i>_initial_destination_concurrency</a> ($<a href="postconf.5.html#initial_destination_concurrency">initial_destination_concur</a>-</b>
<b><a href="postconf.5.html#initial_destination_concurrency">rency</a>)</b> <b><a href="postconf.5.html#initial_destination_concurrency">rency</a>)</b>
Initial concurrency for delivery via the named message <i>trans-</i> Initial concurrency for delivery via the named message <i>trans-</i>
<i>port</i>. <i>port</i>.
<b><a href="postconf.5.html#default_destination_concurrency_failed_cohort_limit">default_destination_concurrency_failed_cohort_limit</a> (1)</b> <b><a href="postconf.5.html#default_destination_concurrency_failed_cohort_limit">default_destination_concurrency_failed_cohort_limit</a> (1)</b>
How many pseudo-cohorts must suffer connection or handshake How many pseudo-cohorts must suffer connection or handshake
failure before a specific destination is considered unavailable failure before a specific destination is considered unavailable
(and further delivery is suspended). (and further delivery is suspended).
<b><a href="postconf.5.html#transport_destination_concurrency_failed_cohort_limit"><i>transport</i>_destination_concurrency_failed_cohort_limit</a> ($<a href="postconf.5.html#default_destination_concurrency_failed_cohort_limit">default_desti</a>-</b> <b><a href="postconf.5.html#transport_destination_concurrency_failed_cohort_limit"><i>transport</i>_destination_concurrency_failed_cohort_limit</a> ($<a href="postconf.5.html#default_destination_concurrency_failed_cohort_limit">default_desti</a>-</b>
@@ -269,7 +269,7 @@ QMGR(8) System Manager's Manual QMGR(8)
Idem, for delivery via the named message <i>transport</i>. Idem, for delivery via the named message <i>transport</i>.
<b><a href="postconf.5.html#default_destination_concurrency_positive_feedback">default_destination_concurrency_positive_feedback</a> (1)</b> <b><a href="postconf.5.html#default_destination_concurrency_positive_feedback">default_destination_concurrency_positive_feedback</a> (1)</b>
The per-destination amount of delivery concurrency positive The per-destination amount of delivery concurrency positive
feedback, after a delivery completes without connection or hand- feedback, after a delivery completes without connection or hand-
shake failure. shake failure.
@@ -291,14 +291,14 @@ QMGR(8) System Manager's Manual QMGR(8)
<b>MESSAGE SCHEDULING CONTROLS</b> <b>MESSAGE SCHEDULING CONTROLS</b>
<b><a href="postconf.5.html#default_delivery_slot_cost">default_delivery_slot_cost</a> (5)</b> <b><a href="postconf.5.html#default_delivery_slot_cost">default_delivery_slot_cost</a> (5)</b>
How often the Postfix queue manager's scheduler is allowed to How often the Postfix queue manager's scheduler is allowed to
preempt delivery of one message with another. preempt delivery of one message with another.
<b><a href="postconf.5.html#transport_delivery_slot_cost"><i>transport</i>_delivery_slot_cost</a> ($<a href="postconf.5.html#default_delivery_slot_cost">default_delivery_slot_cost</a>)</b> <b><a href="postconf.5.html#transport_delivery_slot_cost"><i>transport</i>_delivery_slot_cost</a> ($<a href="postconf.5.html#default_delivery_slot_cost">default_delivery_slot_cost</a>)</b>
Idem, for delivery via the named message <i>transport</i>. Idem, for delivery via the named message <i>transport</i>.
<b><a href="postconf.5.html#default_minimum_delivery_slots">default_minimum_delivery_slots</a> (3)</b> <b><a href="postconf.5.html#default_minimum_delivery_slots">default_minimum_delivery_slots</a> (3)</b>
How many recipients a message must have in order to invoke the How many recipients a message must have in order to invoke the
Postfix queue manager's scheduling algorithm at all. Postfix queue manager's scheduling algorithm at all.
<b><a href="postconf.5.html#transport_minimum_delivery_slots"><i>transport</i>_minimum_delivery_slots</a> ($<a href="postconf.5.html#default_minimum_delivery_slots">default_minimum_delivery_slots</a>)</b> <b><a href="postconf.5.html#transport_minimum_delivery_slots"><i>transport</i>_minimum_delivery_slots</a> ($<a href="postconf.5.html#default_minimum_delivery_slots">default_minimum_delivery_slots</a>)</b>
@@ -312,7 +312,7 @@ QMGR(8) System Manager's Manual QMGR(8)
Idem, for delivery via the named message <i>transport</i>. Idem, for delivery via the named message <i>transport</i>.
<b><a href="postconf.5.html#default_delivery_slot_loan">default_delivery_slot_loan</a> (3)</b> <b><a href="postconf.5.html#default_delivery_slot_loan">default_delivery_slot_loan</a> (3)</b>
The default value for transport-specific _delivery_slot_loan The default value for transport-specific _delivery_slot_loan
settings. settings.
<b><a href="postconf.5.html#transport_delivery_slot_loan"><i>transport</i>_delivery_slot_loan</a> ($<a href="postconf.5.html#default_delivery_slot_loan">default_delivery_slot_loan</a>)</b> <b><a href="postconf.5.html#transport_delivery_slot_loan"><i>transport</i>_delivery_slot_loan</a> ($<a href="postconf.5.html#default_delivery_slot_loan">default_delivery_slot_loan</a>)</b>
@@ -370,7 +370,7 @@ QMGR(8) System Manager's Manual QMGR(8)
<b>SAFETY CONTROLS</b> <b>SAFETY CONTROLS</b>
<b><a href="postconf.5.html#qmgr_daemon_timeout">qmgr_daemon_timeout</a> (1000s)</b> <b><a href="postconf.5.html#qmgr_daemon_timeout">qmgr_daemon_timeout</a> (1000s)</b>
How much time a Postfix queue manager process may take to handle How much time a Postfix queue manager process may take to handle
a request before it is terminated by a built-in watchdog timer. a request before it is terminated by a built-in watchdog timer.
<b><a href="postconf.5.html#qmgr_ipc_timeout">qmgr_ipc_timeout</a> (60s)</b> <b><a href="postconf.5.html#qmgr_ipc_timeout">qmgr_ipc_timeout</a> (60s)</b>
The time limit for the queue manager to send or receive informa- The time limit for the queue manager to send or receive informa-
@@ -379,12 +379,12 @@ QMGR(8) System Manager's Manual QMGR(8)
Available in Postfix version 3.1 and later: Available in Postfix version 3.1 and later:
<b><a href="postconf.5.html#address_verify_pending_request_limit">address_verify_pending_request_limit</a> (see 'postconf -d' output)</b> <b><a href="postconf.5.html#address_verify_pending_request_limit">address_verify_pending_request_limit</a> (see 'postconf -d' output)</b>
A safety limit that prevents address verification requests from A safety limit that prevents address verification requests from
overwhelming the Postfix queue. overwhelming the Postfix queue.
<b>MISCELLANEOUS CONTROLS</b> <b>MISCELLANEOUS CONTROLS</b>
<b><a href="postconf.5.html#config_directory">config_directory</a> (see 'postconf -d' output)</b> <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- 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. figuration files.
<b><a href="postconf.5.html#defer_transports">defer_transports</a> (empty)</b> <b><a href="postconf.5.html#defer_transports">defer_transports</a> (empty)</b>
@@ -392,11 +392,11 @@ QMGR(8) System Manager's Manual QMGR(8)
mail unless someone issues "<b>sendmail -q</b>" or equivalent. mail unless someone issues "<b>sendmail -q</b>" or equivalent.
<b><a href="postconf.5.html#delay_logging_resolution_limit">delay_logging_resolution_limit</a> (2)</b> <b><a href="postconf.5.html#delay_logging_resolution_limit">delay_logging_resolution_limit</a> (2)</b>
The maximal number of digits after the decimal point when log- The maximal number of digits after the decimal point when log-
ging sub-second delay values. ging sub-second delay values.
<b><a href="postconf.5.html#helpful_warnings">helpful_warnings</a> (yes)</b> <b><a href="postconf.5.html#helpful_warnings">helpful_warnings</a> (yes)</b>
Log warnings about problematic configuration settings, and pro- Log warnings about problematic configuration settings, and pro-
vide helpful suggestions. vide helpful suggestions.
<b><a href="postconf.5.html#process_id">process_id</a> (read-only)</b> <b><a href="postconf.5.html#process_id">process_id</a> (read-only)</b>
@@ -412,14 +412,14 @@ QMGR(8) System Manager's Manual QMGR(8)
The syslog facility of Postfix logging. The syslog facility of Postfix logging.
<b><a href="postconf.5.html#syslog_name">syslog_name</a> (see 'postconf -d' output)</b> <b><a href="postconf.5.html#syslog_name">syslog_name</a> (see 'postconf -d' output)</b>
The mail system name that is prepended to the process name in The mail system name that is prepended to the process name in
syslog records, so that "smtpd" becomes, for example, "post- syslog records, so that "smtpd" becomes, for example, "post-
fix/smtpd". fix/smtpd".
Available in Postfix version 3.0 and later: Available in Postfix version 3.0 and later:
<b><a href="postconf.5.html#confirm_delay_cleared">confirm_delay_cleared</a> (no)</b> <b><a href="postconf.5.html#confirm_delay_cleared">confirm_delay_cleared</a> (no)</b>
After sending a "your message is delayed" notification, inform After sending a "your message is delayed" notification, inform
the sender when the delay clears up. the sender when the delay clears up.
<b>FILES</b> <b>FILES</b>

19
postfix/man/man1/postconf.1
View File

@@ -9,6 +9,7 @@ Postfix configuration utility
.na .na
.nf .nf
.fi .fi
.ti -4
\fBManaging main.cf:\fR \fBManaging main.cf:\fR
\fBpostconf\fR [\fB\-dfhHnopvx\fR] [\fB\-c \fIconfig_dir\fR] \fBpostconf\fR [\fB\-dfhHnopvx\fR] [\fB\-c \fIconfig_dir\fR]
@@ -23,6 +24,7 @@ Postfix configuration utility
\fBpostconf\fR \fB\-X\fR [\fB\-pv\fR] [\fB\-c \fIconfig_dir\fR] \fBpostconf\fR \fB\-X\fR [\fB\-pv\fR] [\fB\-c \fIconfig_dir\fR]
\fIparameter ...\fR \fIparameter ...\fR
.ti -4
\fBManaging master.cf service entries:\fR \fBManaging master.cf service entries:\fR
\fBpostconf\fR \fB\-M\fR [\fB\-fovx\fR] [\fB\-c \fIconfig_dir\fR] \fBpostconf\fR \fB\-M\fR [\fB\-fovx\fR] [\fB\-c \fIconfig_dir\fR]
@@ -37,6 +39,7 @@ Postfix configuration utility
\fBpostconf\fR \fB\-MX\fR [\fB\-v\fR] [\fB\-c \fIconfig_dir\fR] \fBpostconf\fR \fB\-MX\fR [\fB\-v\fR] [\fB\-c \fIconfig_dir\fR]
\fIservice\fB/\fItype ...\fR \fIservice\fB/\fItype ...\fR
.ti -4
\fBManaging master.cf service fields:\fR \fBManaging master.cf service fields:\fR
\fBpostconf\fR \fB\-F\fR [\fB\-fhHovx\fR] [\fB\-c \fIconfig_dir\fR] \fBpostconf\fR \fB\-F\fR [\fB\-fhHovx\fR] [\fB\-c \fIconfig_dir\fR]
@@ -45,6 +48,7 @@ Postfix configuration utility
\fBpostconf\fR \fB\-F\fR [\fB\-ev\fR] [\fB\-c \fIconfig_dir\fR] \fBpostconf\fR \fB\-F\fR [\fB\-ev\fR] [\fB\-c \fIconfig_dir\fR]
\fIservice\fB/\fItype\fB/\fIfield\fB=\fIvalue ...\fR \fIservice\fB/\fItype\fB/\fIfield\fB=\fIvalue ...\fR
.ti -4
\fBManaging master.cf service parameters:\fR \fBManaging master.cf service parameters:\fR
\fBpostconf\fR \fB\-P\fR [\fB\-fhHovx\fR] [\fB\-c \fIconfig_dir\fR] \fBpostconf\fR \fB\-P\fR [\fB\-fhHovx\fR] [\fB\-c \fIconfig_dir\fR]
@@ -56,6 +60,7 @@ Postfix configuration utility
\fBpostconf\fR \fB\-PX\fR [\fB\-v\fR] [\fB\-c \fIconfig_dir\fR] \fBpostconf\fR \fB\-PX\fR [\fB\-v\fR] [\fB\-c \fIconfig_dir\fR]
\fIservice\fB/\fItype\fB/\fIparameter ...\fR \fIservice\fB/\fItype\fB/\fIparameter ...\fR
.ti -4
\fBManaging bounce message templates:\fR \fBManaging bounce message templates:\fR
\fBpostconf\fR \fB\-b\fR [\fB\-v\fR] [\fB\-c \fIconfig_dir\fR] \fBpostconf\fR \fB\-b\fR [\fB\-v\fR] [\fB\-c \fIconfig_dir\fR]
@@ -64,10 +69,12 @@ Postfix configuration utility
\fBpostconf\fR \fB\-t\fR [\fB\-v\fR] [\fB\-c \fIconfig_dir\fR] \fBpostconf\fR \fB\-t\fR [\fB\-v\fR] [\fB\-c \fIconfig_dir\fR]
[\fItemplate_file\fR] [\fItemplate_file\fR]
.ti -4
\fBManaging TLS features:\fR \fBManaging TLS features:\fR
\fBpostconf\fR [\fB\-v\fR] [\fB\-c \fIconfig_dir\fR] \fB\-T \fImode\fR \fBpostconf\fR \fB\-T \fImode\fR [\fB\-v\fR] [\fB\-c \fIconfig_dir\fR]
.ti -4
\fBManaging other configuration:\fR \fBManaging other configuration:\fR
\fBpostconf\fR \fB\-a\fR|\fB\-A\fR|\fB\-l\fR|\fB\-m\fR [\fB\-v\fR] \fBpostconf\fR \fB\-a\fR|\fB\-A\fR|\fB\-l\fR|\fB\-m\fR [\fB\-v\fR]
@@ -193,9 +200,9 @@ configuration file entries, for human readability.
This feature is available with Postfix 2.9 and later. This feature is available with Postfix 2.9 and later.
.IP \fB\-F\fR .IP \fB\-F\fR
Show \fBmaster.cf\fR per\-entry field settings (by default Show \fBmaster.cf\fR per\-entry field settings (by default
all services and all fields), formatted as one all services and all fields), formatted as
"\fIservice/type/field=value\fR" per line. Specify \fB\-Ff\fR "\fIservice/type/field=value\fR", one per line. Specify
to fold long lines. \fB\-Ff\fR to fold long lines.
Specify one or more "\fIservice/type/field\fR" instances Specify one or more "\fIservice/type/field\fR" instances
on the \fBpostconf\fR(1) command line to limit the output on the \fBpostconf\fR(1) command line to limit the output
@@ -395,8 +402,8 @@ Show \fBmain.cf\fR parameter settings. This is the default.
This feature is available with Postfix 2.11 and later. This feature is available with Postfix 2.11 and later.
.IP \fB\-P\fR .IP \fB\-P\fR
Show \fBmaster.cf\fR service parameter settings (by default Show \fBmaster.cf\fR service parameter settings (by default
all services and all parameters). formatted as one all services and all parameters), formatted as
"\fIservice/type/parameter=value\fR" per line. Specify "\fIservice/type/parameter=value\fR", one per line. Specify
\fB\-Pf\fR to fold long lines. \fB\-Pf\fR to fold long lines.
Specify one or more "\fIservice/type/parameter\fR" instances Specify one or more "\fIservice/type/parameter\fR" instances

6
postfix/man/man1/postfix.1
View File

@@ -60,7 +60,7 @@ Re\-read configuration files. Running processes terminate at their
earliest convenience. earliest convenience.
.IP \fBstatus\fR .IP \fBstatus\fR
Indicate if the Postfix mail system is currently running. Indicate if the Postfix mail system is currently running.
.IP "\fBset\-permissions\fR [\fIname\fR=\fIvalue ...\fR] .IP "\fBset\-permissions\fR [\fIname\fR=\fIvalue ...\fR]"
Set the ownership and permissions of Postfix related files and Set the ownership and permissions of Postfix related files and
directories, as specified in the \fBpostfix\-files\fR file. directories, as specified in the \fBpostfix\-files\fR file.
.sp .sp
@@ -72,13 +72,13 @@ already installed Postfix system.
This feature is available in Postfix 2.1 and later. With This feature is available in Postfix 2.1 and later. With
Postfix 2.0 and earlier, use "\fB$config_directory/post\-install Postfix 2.0 and earlier, use "\fB$config_directory/post\-install
set\-permissions\fR". set\-permissions\fR".
.IP "\fBtls\fR \fIsubcommand\fR .IP "\fBtls\fR \fIsubcommand\fR"
Enable opportunistic TLS in the Postfix SMTP client or Enable opportunistic TLS in the Postfix SMTP client or
server, and manage Postfix SMTP server TLS private keys and server, and manage Postfix SMTP server TLS private keys and
certificates. See postfix\-tls(1) for documentation. certificates. See postfix\-tls(1) for documentation.
.sp .sp
This feature is available in Postfix 3.1 and later. This feature is available in Postfix 3.1 and later.
.IP "\fBupgrade\-configuration\fR [\fIname\fR=\fIvalue ...\fR] .IP "\fBupgrade\-configuration\fR [\fIname\fR=\fIvalue ...\fR]"
Update the \fBmain.cf\fR and \fBmaster.cf\fR files with information Update the \fBmain.cf\fR and \fBmaster.cf\fR files with information
that Postfix needs in order to run: add or update services, and add that Postfix needs in order to run: add or update services, and add
or update configuration parameter settings. or update configuration parameter settings.

15
postfix/man/man1/postmulti.1
View File

@@ -9,11 +9,13 @@ Postfix multi\-instance manager
.na .na
.nf .nf
.fi .fi
\fBENABLING MULTI\-INSTANCE MANAGEMENT:\fR .ti -4
\fBEnabling multi\-instance management:\fR
\fBpostmulti\fR \fB\-e init\fR [\fB\-v\fR] \fBpostmulti\fR \fB\-e init\fR [\fB\-v\fR]
\fBITERATOR MODE:\fR .ti -4
\fBIterator mode:\fR
\fBpostmulti\fR \fB\-l\fR [\fB\-aRv\fR] [\fB\-g \fIgroup\fR] \fBpostmulti\fR \fB\-l\fR [\fB\-aRv\fR] [\fB\-g \fIgroup\fR]
[\fB\-i \fIname\fR] [\fB\-i \fIname\fR]
@@ -24,7 +26,8 @@ Postfix multi\-instance manager
\fBpostmulti\fR \fB\-x\fR [\fB\-aRv\fR] [\fB\-g \fIgroup\fR] \fBpostmulti\fR \fB\-x\fR [\fB\-aRv\fR] [\fB\-g \fIgroup\fR]
[\fB\-i \fIname\fR] \fIcommand...\fR [\fB\-i \fIname\fR] \fIcommand...\fR
\fBLIFE\-CYCLE MANAGEMENT:\fR .ti -4
\fBLife\-cycle management:\fR
\fBpostmulti\fR \fB\-e create\fR [\fB\-av\fR] \fBpostmulti\fR \fB\-e create\fR [\fB\-av\fR]
[\fB\-g \fIgroup\fR] [\fB\-i \fIname\fR] [\fB\-G \fIgroup\fR] [\fB\-g \fIgroup\fR] [\fB\-i \fIname\fR] [\fB\-G \fIgroup\fR]
@@ -400,9 +403,9 @@ html_directory\fR" to locate this information.
.nf .nf
.na .na
MULTI_INSTANCE_README, Postfix multi\-instance management MULTI_INSTANCE_README, Postfix multi\-instance management
.SH "HISTORY" .SH HISTORY
.na .ad
.nf .fi
.ad .ad
.fi .fi
The \fBpostmulti\fR(1) command was introduced with Postfix The \fBpostmulti\fR(1) command was introduced with Postfix

83
postfix/man/man1/postqueue.1
View File

@@ -8,6 +8,7 @@ Postfix queue control
.SH "SYNOPSIS" .SH "SYNOPSIS"
.na .na
.nf .nf
.ti -4
\fBTo flush the mail queue\fR: \fBTo flush the mail queue\fR:
\fBpostqueue\fR [\fB\-v\fR] [\fB\-c \fIconfig_dir\fR] \fB\-f\fR \fBpostqueue\fR [\fB\-v\fR] [\fB\-c \fIconfig_dir\fR] \fB\-f\fR
@@ -16,6 +17,7 @@ Postfix queue control
\fBpostqueue\fR [\fB\-v\fR] [\fB\-c \fIconfig_dir\fR] \fB\-s \fIsite\fR \fBpostqueue\fR [\fB\-v\fR] [\fB\-c \fIconfig_dir\fR] \fB\-s \fIsite\fR
.ti -4
\fBTo list the mail queue\fR: \fBTo list the mail queue\fR:
\fBpostqueue\fR [\fB\-v\fR] [\fB\-c \fIconfig_dir\fR] \fB\-j\fR \fBpostqueue\fR [\fB\-v\fR] [\fB\-c \fIconfig_dir\fR] \fB\-j\fR
@@ -57,42 +59,8 @@ Produce a queue listing in JSON format, based on output
from the showq(8) daemon. The result is a stream of zero from the showq(8) daemon. The result is a stream of zero
or more JSON objects, one per queue file. Each object is or more JSON objects, one per queue file. Each object is
followed by a newline character to support simple streaming followed by a newline character to support simple streaming
parsers. parsers. See "\fBJSON OBJECT FORMAT\fR" below for details.
.sp
Object members have string values unless indicated otherwise.
Programs should ignore object members that are not listed
here; the list of members is expected to grow over time.
.RS
.IP \fBqueue_name\fR
The name of the queue where the message was found. Note
that the contents of the mail queue may change while it is
being listed; some messages may appear more than once, and
some messages may be missed.
.IP \fBqueue_id\fR
The queue file name. The name may be reused unless
"enable_long_queue_ids = true".
.IP \fBarrival_time\fR
The number of seconds since the start of the UNIX epoch.
.IP \fBmessage_size\fR
The number of bytes in the message header and body. This
number does not include message envelope information. It
is approximately equal to the number of bytes that would
be transmitted via SMTP including the <CR><LF> line endings.
.IP \fBsender\fR
The envelope sender address.
.IP \fBrecipients\fR
An array containing zero or more objects with members:
.RS
.IP \fBaddress\fR
One recipient address.
.IP \fBdelay_reason\fR
If present, the reason for delayed delivery. Some delayed
recipients have no delay reason, for example, when delivery
is in progress or when the system was stopped before it
could record the reason.
.RE
.RE
.IP
This feature is available in Postfix 3.1 and later. This feature is available in Postfix 3.1 and later.
.IP \fB\-p\fR .IP \fB\-p\fR
Produce a traditional sendmail\-style queue listing. Produce a traditional sendmail\-style queue listing.
@@ -126,6 +94,49 @@ command, by contacting the Postfix \fBflush\fR(8) daemon.
Enable verbose logging for debugging purposes. Multiple \fB\-v\fR Enable verbose logging for debugging purposes. Multiple \fB\-v\fR
options make the software increasingly verbose. As of Postfix 2.3, options make the software increasingly verbose. As of Postfix 2.3,
this option is available for the super\-user only. this option is available for the super\-user only.
.SH "JSON OBJECT FORMAT"
.na
.nf
.ad
.fi
Each JSON object represents one queue file; it is emitted
as a single text line followed by a newline character.
Object members have string values unless indicated otherwise.
Programs should ignore object members that are not listed
here; the list of members is expected to grow over time.
.IP \fBqueue_name\fR
The name of the queue where the message was found. Note
that the contents of the mail queue may change while it is
being listed; some messages may appear more than once, and
some messages may be missed.
.IP \fBqueue_id\fR
The queue file name. The queue_id may be reused within a
Postfix instance unless "enable_long_queue_ids = true" and
time is monotonic. Even then, the queue_id is not expected
to be unique between different Postfix instances. Management
tools that require a unique name should combine the queue_id
with the myhostname setting of the Postfix instance.
.IP \fBarrival_time\fR
The number of seconds since the start of the UNIX epoch.
.IP \fBmessage_size\fR
The number of bytes in the message header and body. This
number does not include message envelope information. It
is approximately equal to the number of bytes that would
be transmitted via SMTP including the <CR><LF> line endings.
.IP \fBsender\fR
The envelope sender address.
.IP \fBrecipients\fR
An array containing zero or more objects with members:
.RS
.IP \fBaddress\fR
One recipient address.
.IP \fBdelay_reason\fR
If present, the reason for delayed delivery. Delayed
recipients may have no delay reason, for example, while
delivery is in progress, or after the system was stopped
before it could record the reason.
.RE
.SH "SECURITY" .SH "SECURITY"
.na .na
.nf .nf

2
postfix/man/man1/qmqp-sink.1
View File

@@ -42,7 +42,7 @@ is completed.
.IP \fB\-v\fR .IP \fB\-v\fR
Increase verbosity. Specify \fB\-v \-v\fR to see some of the QMQP Increase verbosity. Specify \fB\-v \-v\fR to see some of the QMQP
conversation. conversation.
.IP "\fB\-x \fItime\fR .IP "\fB\-x \fItime\fR"
Terminate after \fItime\fR seconds. This is to facilitate memory Terminate after \fItime\fR seconds. This is to facilitate memory
leak testing. leak testing.
.SH "SEE ALSO" .SH "SEE ALSO"

2
postfix/man/man1/sendmail.1
View File

@@ -116,7 +116,7 @@ versions before 2.3.
With all Postfix versions, you can specify a directory pathname With all Postfix versions, you can specify a directory pathname
with the MAIL_CONFIG environment variable to override the with the MAIL_CONFIG environment variable to override the
location of configuration files. location of configuration files.
.IP "\fB\-F \fIfull_name\fR .IP "\fB\-F \fIfull_name\fR"
Set the sender full name. This overrides the NAME environment Set the sender full name. This overrides the NAME environment
variable, and is used only with messages that variable, and is used only with messages that
have no \fBFrom:\fR message header. have no \fBFrom:\fR message header.

2
postfix/man/man8/oqmgr.8
View File

@@ -85,7 +85,7 @@ of new mail.
.IP "\fBslow start\fR" .IP "\fBslow start\fR"
This strategy eliminates "thundering herd" problems by slowly This strategy eliminates "thundering herd" problems by slowly
adjusting the number of parallel deliveries to the same destination. adjusting the number of parallel deliveries to the same destination.
.IP "\fBround robin\fR .IP "\fBround robin\fR"
The queue manager sorts delivery requests by destination. The queue manager sorts delivery requests by destination.
Round\-robin selection prevents one destination from dominating Round\-robin selection prevents one destination from dominating
deliveries to other destinations. deliveries to other destinations.

2
postfix/man/man8/qmgr.8
View File

@@ -85,7 +85,7 @@ of new mail.
.IP "\fBslow start\fR" .IP "\fBslow start\fR"
This strategy eliminates "thundering herd" problems by slowly This strategy eliminates "thundering herd" problems by slowly
adjusting the number of parallel deliveries to the same destination. adjusting the number of parallel deliveries to the same destination.
.IP "\fBround robin\fR .IP "\fBround robin\fR"
The queue manager sorts delivery requests by destination. The queue manager sorts delivery requests by destination.
Round\-robin selection prevents one destination from dominating Round\-robin selection prevents one destination from dominating
deliveries to other destinations. deliveries to other destinations.

6
postfix/src/global/attr_override.c
View File

@@ -32,16 +32,16 @@
/* with arguments. Each macro may appear only once. The list /* with arguments. Each macro may appear only once. The list
/* must be terminated with CA_ATTR_OVER_END which has no argument. /* must be terminated with CA_ATTR_OVER_END which has no argument.
/* The following describes the expected values. /* The following describes the expected values.
/* .IP "CA_ATTR_OVER_STR_TABLE(const ATTR_OVER_STR *) /* .IP "CA_ATTR_OVER_STR_TABLE(const ATTR_OVER_STR *)"
/* The macro argument specifies a null-terminated table with /* The macro argument specifies a null-terminated table with
/* attribute names, assignment targets, and range limits which /* attribute names, assignment targets, and range limits which
/* should be the same as for the corresponding main.cf parameters. /* should be the same as for the corresponding main.cf parameters.
/* .IP "CA_ATTR_OVER_TIME_TABLE(const ATTR_OVER_TIME *) /* .IP "CA_ATTR_OVER_TIME_TABLE(const ATTR_OVER_TIME *)"
/* The macro argument specifies a null-terminated table with /* The macro argument specifies a null-terminated table with
/* attribute names, their default time units (leading digits /* attribute names, their default time units (leading digits
/* are skipped), assignment targets, and range limits which /* are skipped), assignment targets, and range limits which
/* should be the same as for the corresponding main.cf parameters. /* should be the same as for the corresponding main.cf parameters.
/* .IP "CA_ATTR_OVER_INT_TABLE(const ATTR_OVER_INT *) /* .IP "CA_ATTR_OVER_INT_TABLE(const ATTR_OVER_INT *)"
/* The macro argument specifies a null-terminated table with /* The macro argument specifies a null-terminated table with
/* attribute names, assignment targets, and range limits which /* attribute names, assignment targets, and range limits which
/* should be the same as for the corresponding main.cf parameters. /* should be the same as for the corresponding main.cf parameters.

4
postfix/src/global/ext_prop.c
View File

@@ -19,10 +19,10 @@
/* .IP "canonical (EXT_PROP_CANONICAL)" /* .IP "canonical (EXT_PROP_CANONICAL)"
/* Propagate unmatched address extensions to the right-hand side /* Propagate unmatched address extensions to the right-hand side
/* of canonical table entries (not: regular expressions). /* of canonical table entries (not: regular expressions).
/* .IP "virtual (EXT_PROP_VIRTUAL) /* .IP "virtual (EXT_PROP_VIRTUAL)"
/* Propagate unmatched address extensions to the right-hand side /* Propagate unmatched address extensions to the right-hand side
/* of virtual table entries (not: regular expressions). /* of virtual table entries (not: regular expressions).
/* .IP "alias (EXT_PROP_ALIAS) /* .IP "alias (EXT_PROP_ALIAS)"
/* Propagate unmatched address extensions to the right-hand side /* Propagate unmatched address extensions to the right-hand side
/* of alias database entries. /* of alias database entries.
/* .IP "forward (EXT_PROP_FORWARD)" /* .IP "forward (EXT_PROP_FORWARD)"

2
postfix/src/global/mail_version.h
View File

@@ -20,7 +20,7 @@
* Patches change both the patchlevel and the release date. Snapshots have no * Patches change both the patchlevel and the release date. Snapshots have no
* patchlevel; they change the release date only. * patchlevel; they change the release date only.
*/ */
#define MAIL_RELEASE_DATE "20160213" #define MAIL_RELEASE_DATE "20160214"
#define MAIL_VERSION_NUMBER "3.1" #define MAIL_VERSION_NUMBER "3.1"
#ifdef SNAPSHOT #ifdef SNAPSHOT

2
postfix/src/master/event_server.c
View File

@@ -122,7 +122,7 @@
/* by the event_server_disconnect() function (see below). /* by the event_server_disconnect() function (see below).
/* .sp /* .sp
/* Only the last instance of this parameter type is remembered. /* Only the last instance of this parameter type is remembered.
/* .IP "CA_MAIL_SERVER_IN_FLOW_DELAY /* .IP CA_MAIL_SERVER_IN_FLOW_DELAY
/* Pause $in_flow_delay seconds when no "mail flow control token" /* Pause $in_flow_delay seconds when no "mail flow control token"
/* is available. A token is consumed for each connection request. /* is available. A token is consumed for each connection request.
/* .IP CA_MAIL_SERVER_SOLITARY /* .IP CA_MAIL_SERVER_SOLITARY

2
postfix/src/master/multi_server.c
View File

@@ -119,7 +119,7 @@
/* by the multi_server_disconnect() function (see below). /* by the multi_server_disconnect() function (see below).
/* .sp /* .sp
/* Only the last instance of this parameter type is remembered. /* Only the last instance of this parameter type is remembered.
/* .IP "CA_MAIL_SERVER_IN_FLOW_DELAY /* .IP CA_MAIL_SERVER_IN_FLOW_DELAY
/* Pause $in_flow_delay seconds when no "mail flow control token" /* Pause $in_flow_delay seconds when no "mail flow control token"
/* is available. A token is consumed for each connection request. /* is available. A token is consumed for each connection request.
/* .IP CA_MAIL_SERVER_SOLITARY /* .IP CA_MAIL_SERVER_SOLITARY

2
postfix/src/milter/test-milter.c
View File

@@ -34,7 +34,7 @@
/* .IP "\fB-D\fI address\fR" /* .IP "\fB-D\fI address\fR"
/* Delete the specified recipient address. Multiple -D options /* Delete the specified recipient address. Multiple -D options
/* are supported. /* are supported.
/* .IP "\fB-f \fIsender\fR /* .IP "\fB-f \fIsender\fR"
/* Replace the sender by the specified address. /* Replace the sender by the specified address.
/* .IP "\fB-h \fI'index header-label header-value'\fR" /* .IP "\fB-h \fI'index header-label header-value'\fR"
/* Replace the message header at the specified position. /* Replace the message header at the specified position.

2
postfix/src/oqmgr/qmgr.c
View File

@@ -73,7 +73,7 @@
/* .IP "\fBslow start\fR" /* .IP "\fBslow start\fR"
/* This strategy eliminates "thundering herd" problems by slowly /* This strategy eliminates "thundering herd" problems by slowly
/* adjusting the number of parallel deliveries to the same destination. /* adjusting the number of parallel deliveries to the same destination.
/* .IP "\fBround robin\fR /* .IP "\fBround robin\fR"
/* The queue manager sorts delivery requests by destination. /* The queue manager sorts delivery requests by destination.
/* Round-robin selection prevents one destination from dominating /* Round-robin selection prevents one destination from dominating
/* deliveries to other destinations. /* deliveries to other destinations.

19
postfix/src/postconf/postconf.c
View File

@@ -5,6 +5,7 @@
/* Postfix configuration utility /* Postfix configuration utility
/* SYNOPSIS /* SYNOPSIS
/* .fi /* .fi
/* .ti -4
/* \fBManaging main.cf:\fR /* \fBManaging main.cf:\fR
/* /*
/* \fBpostconf\fR [\fB-dfhHnopvx\fR] [\fB-c \fIconfig_dir\fR] /* \fBpostconf\fR [\fB-dfhHnopvx\fR] [\fB-c \fIconfig_dir\fR]
@@ -19,6 +20,7 @@
/* \fBpostconf\fR \fB-X\fR [\fB-pv\fR] [\fB-c \fIconfig_dir\fR] /* \fBpostconf\fR \fB-X\fR [\fB-pv\fR] [\fB-c \fIconfig_dir\fR]
/* \fIparameter ...\fR /* \fIparameter ...\fR
/* /*
/* .ti -4
/* \fBManaging master.cf service entries:\fR /* \fBManaging master.cf service entries:\fR
/* /*
/* \fBpostconf\fR \fB-M\fR [\fB-fovx\fR] [\fB-c \fIconfig_dir\fR] /* \fBpostconf\fR \fB-M\fR [\fB-fovx\fR] [\fB-c \fIconfig_dir\fR]
@@ -33,6 +35,7 @@
/* \fBpostconf\fR \fB-MX\fR [\fB-v\fR] [\fB-c \fIconfig_dir\fR] /* \fBpostconf\fR \fB-MX\fR [\fB-v\fR] [\fB-c \fIconfig_dir\fR]
/* \fIservice\fB/\fItype ...\fR /* \fIservice\fB/\fItype ...\fR
/* /*
/* .ti -4
/* \fBManaging master.cf service fields:\fR /* \fBManaging master.cf service fields:\fR
/* /*
/* \fBpostconf\fR \fB-F\fR [\fB-fhHovx\fR] [\fB-c \fIconfig_dir\fR] /* \fBpostconf\fR \fB-F\fR [\fB-fhHovx\fR] [\fB-c \fIconfig_dir\fR]
@@ -41,6 +44,7 @@
/* \fBpostconf\fR \fB-F\fR [\fB-ev\fR] [\fB-c \fIconfig_dir\fR] /* \fBpostconf\fR \fB-F\fR [\fB-ev\fR] [\fB-c \fIconfig_dir\fR]
/* \fIservice\fB/\fItype\fB/\fIfield\fB=\fIvalue ...\fR /* \fIservice\fB/\fItype\fB/\fIfield\fB=\fIvalue ...\fR
/* /*
/* .ti -4
/* \fBManaging master.cf service parameters:\fR /* \fBManaging master.cf service parameters:\fR
/* /*
/* \fBpostconf\fR \fB-P\fR [\fB-fhHovx\fR] [\fB-c \fIconfig_dir\fR] /* \fBpostconf\fR \fB-P\fR [\fB-fhHovx\fR] [\fB-c \fIconfig_dir\fR]
@@ -52,6 +56,7 @@
/* \fBpostconf\fR \fB-PX\fR [\fB-v\fR] [\fB-c \fIconfig_dir\fR] /* \fBpostconf\fR \fB-PX\fR [\fB-v\fR] [\fB-c \fIconfig_dir\fR]
/* \fIservice\fB/\fItype\fB/\fIparameter ...\fR /* \fIservice\fB/\fItype\fB/\fIparameter ...\fR
/* /*
/* .ti -4
/* \fBManaging bounce message templates:\fR /* \fBManaging bounce message templates:\fR
/* /*
/* \fBpostconf\fR \fB-b\fR [\fB-v\fR] [\fB-c \fIconfig_dir\fR] /* \fBpostconf\fR \fB-b\fR [\fB-v\fR] [\fB-c \fIconfig_dir\fR]
@@ -60,10 +65,12 @@
/* \fBpostconf\fR \fB-t\fR [\fB-v\fR] [\fB-c \fIconfig_dir\fR] /* \fBpostconf\fR \fB-t\fR [\fB-v\fR] [\fB-c \fIconfig_dir\fR]
/* [\fItemplate_file\fR] /* [\fItemplate_file\fR]
/* /*
/* .ti -4
/* \fBManaging TLS features:\fR /* \fBManaging TLS features:\fR
/* /*
/* \fBpostconf\fR [\fB-v\fR] [\fB-c \fIconfig_dir\fR] \fB-T \fImode\fR /* \fBpostconf\fR \fB-T \fImode\fR [\fB-v\fR] [\fB-c \fIconfig_dir\fR]
/* /*
/* .ti -4
/* \fBManaging other configuration:\fR /* \fBManaging other configuration:\fR
/* /*
/* \fBpostconf\fR \fB-a\fR|\fB-A\fR|\fB-l\fR|\fB-m\fR [\fB-v\fR] /* \fBpostconf\fR \fB-a\fR|\fB-A\fR|\fB-l\fR|\fB-m\fR [\fB-v\fR]
@@ -187,9 +194,9 @@
/* This feature is available with Postfix 2.9 and later. /* This feature is available with Postfix 2.9 and later.
/* .IP \fB-F\fR /* .IP \fB-F\fR
/* Show \fBmaster.cf\fR per-entry field settings (by default /* Show \fBmaster.cf\fR per-entry field settings (by default
/* all services and all fields), formatted as one /* all services and all fields), formatted as
/* "\fIservice/type/field=value\fR" per line. Specify \fB-Ff\fR /* "\fIservice/type/field=value\fR", one per line. Specify
/* to fold long lines. /* \fB-Ff\fR to fold long lines.
/* /*
/* Specify one or more "\fIservice/type/field\fR" instances /* Specify one or more "\fIservice/type/field\fR" instances
/* on the \fBpostconf\fR(1) command line to limit the output /* on the \fBpostconf\fR(1) command line to limit the output
@@ -389,8 +396,8 @@
/* This feature is available with Postfix 2.11 and later. /* This feature is available with Postfix 2.11 and later.
/* .IP \fB-P\fR /* .IP \fB-P\fR
/* Show \fBmaster.cf\fR service parameter settings (by default /* Show \fBmaster.cf\fR service parameter settings (by default
/* all services and all parameters). formatted as one /* all services and all parameters), formatted as
/* "\fIservice/type/parameter=value\fR" per line. Specify /* "\fIservice/type/parameter=value\fR", one per line. Specify
/* \fB-Pf\fR to fold long lines. /* \fB-Pf\fR to fold long lines.
/* /*
/* Specify one or more "\fIservice/type/parameter\fR" instances /* Specify one or more "\fIservice/type/parameter\fR" instances

6
postfix/src/postfix/postfix.c
View File

@@ -54,7 +54,7 @@
/* earliest convenience. /* earliest convenience.
/* .IP \fBstatus\fR /* .IP \fBstatus\fR
/* Indicate if the Postfix mail system is currently running. /* Indicate if the Postfix mail system is currently running.
/* .IP "\fBset-permissions\fR [\fIname\fR=\fIvalue ...\fR] /* .IP "\fBset-permissions\fR [\fIname\fR=\fIvalue ...\fR]"
/* Set the ownership and permissions of Postfix related files and /* Set the ownership and permissions of Postfix related files and
/* directories, as specified in the \fBpostfix-files\fR file. /* directories, as specified in the \fBpostfix-files\fR file.
/* .sp /* .sp
@@ -66,13 +66,13 @@
/* This feature is available in Postfix 2.1 and later. With /* This feature is available in Postfix 2.1 and later. With
/* Postfix 2.0 and earlier, use "\fB$config_directory/post-install /* Postfix 2.0 and earlier, use "\fB$config_directory/post-install
/* set-permissions\fR". /* set-permissions\fR".
/* .IP "\fBtls\fR \fIsubcommand\fR /* .IP "\fBtls\fR \fIsubcommand\fR"
/* Enable opportunistic TLS in the Postfix SMTP client or /* Enable opportunistic TLS in the Postfix SMTP client or
/* server, and manage Postfix SMTP server TLS private keys and /* server, and manage Postfix SMTP server TLS private keys and
/* certificates. See postfix-tls(1) for documentation. /* certificates. See postfix-tls(1) for documentation.
/* .sp /* .sp
/* This feature is available in Postfix 3.1 and later. /* This feature is available in Postfix 3.1 and later.
/* .IP "\fBupgrade-configuration\fR [\fIname\fR=\fIvalue ...\fR] /* .IP "\fBupgrade-configuration\fR [\fIname\fR=\fIvalue ...\fR]"
/* Update the \fBmain.cf\fR and \fBmaster.cf\fR files with information /* Update the \fBmain.cf\fR and \fBmaster.cf\fR files with information
/* that Postfix needs in order to run: add or update services, and add /* that Postfix needs in order to run: add or update services, and add
/* or update configuration parameter settings. /* or update configuration parameter settings.

9
postfix/src/postmulti/postmulti.c
View File

@@ -5,11 +5,13 @@
/* Postfix multi-instance manager /* Postfix multi-instance manager
/* SYNOPSIS /* SYNOPSIS
/* .fi /* .fi
/* \fBENABLING MULTI-INSTANCE MANAGEMENT:\fR /* .ti -4
/* \fBEnabling multi-instance management:\fR
/* /*
/* \fBpostmulti\fR \fB-e init\fR [\fB-v\fR] /* \fBpostmulti\fR \fB-e init\fR [\fB-v\fR]
/* /*
/* \fBITERATOR MODE:\fR /* .ti -4
/* \fBIterator mode:\fR
/* /*
/* \fBpostmulti\fR \fB-l\fR [\fB-aRv\fR] [\fB-g \fIgroup\fR] /* \fBpostmulti\fR \fB-l\fR [\fB-aRv\fR] [\fB-g \fIgroup\fR]
/* [\fB-i \fIname\fR] /* [\fB-i \fIname\fR]
@@ -20,7 +22,8 @@
/* \fBpostmulti\fR \fB-x\fR [\fB-aRv\fR] [\fB-g \fIgroup\fR] /* \fBpostmulti\fR \fB-x\fR [\fB-aRv\fR] [\fB-g \fIgroup\fR]
/* [\fB-i \fIname\fR] \fIcommand...\fR /* [\fB-i \fIname\fR] \fIcommand...\fR
/* /*
/* \fBLIFE-CYCLE MANAGEMENT:\fR /* .ti -4
/* \fBLife-cycle management:\fR
/* /*
/* \fBpostmulti\fR \fB-e create\fR [\fB-av\fR] /* \fBpostmulti\fR \fB-e create\fR [\fB-av\fR]
/* [\fB-g \fIgroup\fR] [\fB-i \fIname\fR] [\fB-G \fIgroup\fR] /* [\fB-g \fIgroup\fR] [\fB-i \fIname\fR] [\fB-G \fIgroup\fR]

83
postfix/src/postqueue/postqueue.c
View File

@@ -4,6 +4,7 @@
/* SUMMARY /* SUMMARY
/* Postfix queue control /* Postfix queue control
/* SYNOPSIS /* SYNOPSIS
/* .ti -4
/* \fBTo flush the mail queue\fR: /* \fBTo flush the mail queue\fR:
/* /*
/* \fBpostqueue\fR [\fB-v\fR] [\fB-c \fIconfig_dir\fR] \fB-f\fR /* \fBpostqueue\fR [\fB-v\fR] [\fB-c \fIconfig_dir\fR] \fB-f\fR
@@ -12,6 +13,7 @@
/* /*
/* \fBpostqueue\fR [\fB-v\fR] [\fB-c \fIconfig_dir\fR] \fB-s \fIsite\fR /* \fBpostqueue\fR [\fB-v\fR] [\fB-c \fIconfig_dir\fR] \fB-s \fIsite\fR
/* /*
/* .ti -4
/* \fBTo list the mail queue\fR: /* \fBTo list the mail queue\fR:
/* /*
/* \fBpostqueue\fR [\fB-v\fR] [\fB-c \fIconfig_dir\fR] \fB-j\fR /* \fBpostqueue\fR [\fB-v\fR] [\fB-c \fIconfig_dir\fR] \fB-j\fR
@@ -51,42 +53,8 @@
/* from the showq(8) daemon. The result is a stream of zero /* from the showq(8) daemon. The result is a stream of zero
/* or more JSON objects, one per queue file. Each object is /* or more JSON objects, one per queue file. Each object is
/* followed by a newline character to support simple streaming /* followed by a newline character to support simple streaming
/* parsers. /* parsers. See "\fBJSON OBJECT FORMAT\fR" below for details.
/* .sp /*
/* Object members have string values unless indicated otherwise.
/* Programs should ignore object members that are not listed
/* here; the list of members is expected to grow over time.
/* .RS
/* .IP \fBqueue_name\fR
/* The name of the queue where the message was found. Note
/* that the contents of the mail queue may change while it is
/* being listed; some messages may appear more than once, and
/* some messages may be missed.
/* .IP \fBqueue_id\fR
/* The queue file name. The name may be reused unless
/* "enable_long_queue_ids = true".
/* .IP \fBarrival_time\fR
/* The number of seconds since the start of the UNIX epoch.
/* .IP \fBmessage_size\fR
/* The number of bytes in the message header and body. This
/* number does not include message envelope information. It
/* is approximately equal to the number of bytes that would
/* be transmitted via SMTP including the <CR><LF> line endings.
/* .IP \fBsender\fR
/* The envelope sender address.
/* .IP \fBrecipients\fR
/* An array containing zero or more objects with members:
/* .RS
/* .IP \fBaddress\fR
/* One recipient address.
/* .IP \fBdelay_reason\fR
/* If present, the reason for delayed delivery. Some delayed
/* recipients have no delay reason, for example, when delivery
/* is in progress or when the system was stopped before it
/* could record the reason.
/* .RE
/* .RE
/* .IP
/* This feature is available in Postfix 3.1 and later. /* This feature is available in Postfix 3.1 and later.
/* .IP \fB-p\fR /* .IP \fB-p\fR
/* Produce a traditional sendmail-style queue listing. /* Produce a traditional sendmail-style queue listing.
@@ -120,6 +88,47 @@
/* Enable verbose logging for debugging purposes. Multiple \fB-v\fR /* Enable verbose logging for debugging purposes. Multiple \fB-v\fR
/* options make the software increasingly verbose. As of Postfix 2.3, /* options make the software increasingly verbose. As of Postfix 2.3,
/* this option is available for the super-user only. /* this option is available for the super-user only.
/* JSON OBJECT FORMAT
/* .ad
/* .fi
/* Each JSON object represents one queue file; it is emitted
/* as a single text line followed by a newline character.
/*
/* Object members have string values unless indicated otherwise.
/* Programs should ignore object members that are not listed
/* here; the list of members is expected to grow over time.
/* .IP \fBqueue_name\fR
/* The name of the queue where the message was found. Note
/* that the contents of the mail queue may change while it is
/* being listed; some messages may appear more than once, and
/* some messages may be missed.
/* .IP \fBqueue_id\fR
/* The queue file name. The queue_id may be reused within a
/* Postfix instance unless "enable_long_queue_ids = true" and
/* time is monotonic. Even then, the queue_id is not expected
/* to be unique between different Postfix instances. Management
/* tools that require a unique name should combine the queue_id
/* with the myhostname setting of the Postfix instance.
/* .IP \fBarrival_time\fR
/* The number of seconds since the start of the UNIX epoch.
/* .IP \fBmessage_size\fR
/* The number of bytes in the message header and body. This
/* number does not include message envelope information. It
/* is approximately equal to the number of bytes that would
/* be transmitted via SMTP including the <CR><LF> line endings.
/* .IP \fBsender\fR
/* The envelope sender address.
/* .IP \fBrecipients\fR
/* An array containing zero or more objects with members:
/* .RS
/* .IP \fBaddress\fR
/* One recipient address.
/* .IP \fBdelay_reason\fR
/* If present, the reason for delayed delivery. Delayed
/* recipients may have no delay reason, for example, while
/* delivery is in progress, or after the system was stopped
/* before it could record the reason.
/* .RE
/* SECURITY /* SECURITY
/* .ad /* .ad
/* .fi /* .fi
@@ -516,7 +525,7 @@ static void unavailable(void)
static NORETURN usage(void) static NORETURN usage(void)
{ {
msg_fatal_status(EX_USAGE, "usage: postqueue -f | postqueue -i queueid | postqueue -p | postqueue -s site"); msg_fatal_status(EX_USAGE, "usage: postqueue -f | postqueue -i queueid | postqueue -j | postqueue -p | postqueue -s site");
} }
MAIL_VERSION_STAMP_DECLARE; MAIL_VERSION_STAMP_DECLARE;

14
postfix/src/postqueue/showq_json.c
View File

@@ -157,13 +157,13 @@ static void format_json(VSTREAM *showq_stream)
ATTR_TYPE_END) != 5) ATTR_TYPE_END) != 5)
msg_fatal_status(EX_SOFTWARE, "malformed showq server response"); msg_fatal_status(EX_SOFTWARE, "malformed showq server response");
vstream_printf("{"); vstream_printf("{");
vstream_printf("\"queue_name\": \"%s\",", vstream_printf("\"queue_name\": \"%s\", ",
json_quote(quote_buf, STR(queue_name))); json_quote(quote_buf, STR(queue_name)));
vstream_printf("\"queue_id\": \"%s\",", vstream_printf("\"queue_id\": \"%s\", ",
json_quote(quote_buf, STR(queue_id))); json_quote(quote_buf, STR(queue_id)));
vstream_printf("\"arrival_time\": %ld,", arrival_time); vstream_printf("\"arrival_time\": %ld, ", arrival_time);
vstream_printf("\"message_size\": %ld,", message_size); vstream_printf("\"message_size\": %ld, ", message_size);
vstream_printf("\"sender\": \"%s\",", vstream_printf("\"sender\": \"%s\", ",
json_quote(quote_buf, STR(addr))); json_quote(quote_buf, STR(addr)));
/* /*
@@ -174,7 +174,7 @@ static void format_json(VSTREAM *showq_stream)
vstream_printf("\"recipients\": ["); vstream_printf("\"recipients\": [");
for (rcpt_count = 0; (showq_status = attr_scan_more(showq_stream)) > 0; rcpt_count++) { for (rcpt_count = 0; (showq_status = attr_scan_more(showq_stream)) > 0; rcpt_count++) {
if (rcpt_count > 0) if (rcpt_count > 0)
vstream_printf(","); vstream_printf(", ");
vstream_printf("{"); vstream_printf("{");
if (attr_scan(showq_stream, ATTR_FLAG_MORE | ATTR_FLAG_STRICT, if (attr_scan(showq_stream, ATTR_FLAG_MORE | ATTR_FLAG_STRICT,
RECV_ATTR_STR(MAIL_ATTR_RECIP, addr), RECV_ATTR_STR(MAIL_ATTR_RECIP, addr),
@@ -184,7 +184,7 @@ static void format_json(VSTREAM *showq_stream)
vstream_printf("\"address\": \"%s\"", vstream_printf("\"address\": \"%s\"",
json_quote(quote_buf, STR(addr))); json_quote(quote_buf, STR(addr)));
if (LEN(why) > 0) if (LEN(why) > 0)
vstream_printf(",\"delay_reason\": \"%s\"", vstream_printf(", \"delay_reason\": \"%s\"",
json_quote(quote_buf, STR(why))); json_quote(quote_buf, STR(why)));
vstream_printf("}"); vstream_printf("}");
} }

2
postfix/src/qmgr/qmgr.c
View File

@@ -73,7 +73,7 @@
/* .IP "\fBslow start\fR" /* .IP "\fBslow start\fR"
/* This strategy eliminates "thundering herd" problems by slowly /* This strategy eliminates "thundering herd" problems by slowly
/* adjusting the number of parallel deliveries to the same destination. /* adjusting the number of parallel deliveries to the same destination.
/* .IP "\fBround robin\fR /* .IP "\fBround robin\fR"
/* The queue manager sorts delivery requests by destination. /* The queue manager sorts delivery requests by destination.
/* Round-robin selection prevents one destination from dominating /* Round-robin selection prevents one destination from dominating
/* deliveries to other destinations. /* deliveries to other destinations.

2
postfix/src/sendmail/sendmail.c
View File

@@ -110,7 +110,7 @@
/* With all Postfix versions, you can specify a directory pathname /* With all Postfix versions, you can specify a directory pathname
/* with the MAIL_CONFIG environment variable to override the /* with the MAIL_CONFIG environment variable to override the
/* location of configuration files. /* location of configuration files.
/* .IP "\fB-F \fIfull_name\fR /* .IP "\fB-F \fIfull_name\fR"
/* Set the sender full name. This overrides the NAME environment /* Set the sender full name. This overrides the NAME environment
/* variable, and is used only with messages that /* variable, and is used only with messages that
/* have no \fBFrom:\fR message header. /* have no \fBFrom:\fR message header.

2
postfix/src/smtpstone/qmqp-sink.c
View File

@@ -36,7 +36,7 @@
/* .IP \fB-v\fR /* .IP \fB-v\fR
/* Increase verbosity. Specify \fB-v -v\fR to see some of the QMQP /* Increase verbosity. Specify \fB-v -v\fR to see some of the QMQP
/* conversation. /* conversation.
/* .IP "\fB-x \fItime\fR /* .IP "\fB-x \fItime\fR"
/* Terminate after \fItime\fR seconds. This is to facilitate memory /* Terminate after \fItime\fR seconds. This is to facilitate memory
/* leak testing. /* leak testing.
/* SEE ALSO /* SEE ALSO

2
postfix/src/util/slmdb.c
View File

@@ -149,7 +149,7 @@
/* CA_SLMDB_CTL_END. The following text enumerates the symbolic /* CA_SLMDB_CTL_END. The following text enumerates the symbolic
/* request names and the corresponding argument types. /* request names and the corresponding argument types.
/* .RS /* .RS
/* .IP "CA_SLMDB_CTL_LONGJMP_FN(void (*)(void *, int)) /* .IP "CA_SLMDB_CTL_LONGJMP_FN(void (*)(void *, int))"
/* Call-back function pointer. The function is called to repeat /* Call-back function pointer. The function is called to repeat
/* a failed bulk-mode transaction from the start. The arguments /* a failed bulk-mode transaction from the start. The arguments
/* are the application context and the setjmp() or sigsetjmp() /* are the application context and the setjmp() or sigsetjmp()

6
postfix/src/util/vstream.c
View File

@@ -294,11 +294,11 @@
/* .IP "CA_VSTREAM_CTL_DOUBLE (no arguments)" /* .IP "CA_VSTREAM_CTL_DOUBLE (no arguments)"
/* Use separate buffers for reading and for writing. This prevents /* Use separate buffers for reading and for writing. This prevents
/* unread input from being discarded upon change of I/O direction. /* unread input from being discarded upon change of I/O direction.
/* .IP "CA_VSTREAM_CTL_READ_FD(int) /* .IP "CA_VSTREAM_CTL_READ_FD(int)"
/* The argument specifies the file descriptor to be used for reading. /* The argument specifies the file descriptor to be used for reading.
/* This feature is limited to double-buffered streams, and makes the /* This feature is limited to double-buffered streams, and makes the
/* stream non-seekable. /* stream non-seekable.
/* .IP "CA_VSTREAM_CTL_WRITE_FD(int) /* .IP "CA_VSTREAM_CTL_WRITE_FD(int)"
/* The argument specifies the file descriptor to be used for writing. /* The argument specifies the file descriptor to be used for writing.
/* This feature is limited to double-buffered streams, and makes the /* This feature is limited to double-buffered streams, and makes the
/* stream non-seekable. /* stream non-seekable.
@@ -315,7 +315,7 @@
/* .IP "CA_VSTREAM_CTL_WAITPID_FN(int (*)(pid_t, WAIT_STATUS_T *, int))" /* .IP "CA_VSTREAM_CTL_WAITPID_FN(int (*)(pid_t, WAIT_STATUS_T *, int))"
/* A pointer to function that behaves like waitpid(). This information /* A pointer to function that behaves like waitpid(). This information
/* is used by the vstream_pclose() routine. /* is used by the vstream_pclose() routine.
/* .IP "CA_VSTREAM_CTL_TIMEOUT(int) /* .IP "CA_VSTREAM_CTL_TIMEOUT(int)"
/* The deadline for a descriptor to become readable in case of a read /* The deadline for a descriptor to become readable in case of a read
/* request, or writable in case of a write request. Specify a value /* request, or writable in case of a write request. Specify a value
/* of 0 to disable deadlines. /* of 0 to disable deadlines.

2
postfix/src/util/vstring.c
View File

@@ -134,7 +134,7 @@
/* The function takes a VSTRING pointer and a list of zero or /* The function takes a VSTRING pointer and a list of zero or
/* more macros with zer or more arguments, terminated with /* more macros with zer or more arguments, terminated with
/* CA_VSTRING_CTL_END which has none. /* CA_VSTRING_CTL_END which has none.
/* .IP "CA_VSTRING_CTL_MAXLEN(ssize_t len) /* .IP "CA_VSTRING_CTL_MAXLEN(ssize_t len)"
/* Specifies a hard upper limit on a string's length. When the /* Specifies a hard upper limit on a string's length. When the
/* length would be exceeded, the program simulates a memory /* length would be exceeded, the program simulates a memory
/* allocation problem (i.e. it terminates through msg_fatal()). /* allocation problem (i.e. it terminates through msg_fatal()).