installation: fix codeblock rendering in zfs performance tips section

[pmg-docs.git] / pmg.conf.5-opts.adoc

diff --git a/pmg.conf.5-opts.adoc b/pmg.conf.5-opts.adoc
index c58480ada9e59ffb3f02254e480c44f5f46fb3e6..4c83177bfd80d2368492973d8c87508956a0c254 100644 (file)
--- a/pmg.conf.5-opts.adoc
+++ b/pmg.conf.5-opts.adoc
@@ -1,8 +1,12 @@
 .Section 'admin'
 
 .Section 'admin'
 

-`advfilter`: `<boolean>` ('default =' `1`)::
+`advfilter`: `<boolean>` ('default =' `0`)::

 
 

-Use advanced filters for statistic.
+Enable advanced filters for statistic.
++
+If this is enabled, the receiver statistic are limited to active ones
+(receivers which also sent out mail in the 90 days before), and the contact
+statistic will not contain these active receivers.

 
 `avast`: `<boolean>` ('default =' `0`)::
 
 
 `avast`: `<boolean>` ('default =' `0`)::
 


@@ -28,6 +32,10 @@ Send daily reports.
 
 Demo mode - do not start SMTP filter.
 
 
 Demo mode - do not start SMTP filter.
 

+`dkim-use-domain`: `<envelope | header>` ('default =' `envelope`)::
+
+Whether to sign using the address from the header or the envelope.
+

 `dkim_selector`: `<string>` ::
 
 Default DKIM selector
 `dkim_selector`: `<string>` ::
 
 Default DKIM selector


@@ -82,9 +90,13 @@ This option sets the lowest number of Credit Card or Social Security numbers fou
 
 Sets the maximum amount of data (in bytes) to be scanned for each input file.
 
 
 Sets the maximum amount of data (in bytes) to be scanned for each input file.
 

-`safebrowsing`: `<boolean>` ('default =' `1`)::
+`safebrowsing`: `<boolean>` ('default =' `0`)::
+
+Enables support for Google Safe Browsing. (deprecated option, will be ignored)

 
 

-Enables support for Google Safe Browsing.
+`scriptedupdates`: `<boolean>` ('default =' `1`)::
+
+Enables ScriptedUpdates (incremental download of signatures)

 
 .Section 'mail'
 
 
 .Section 'mail'
 


@@ -106,27 +118,43 @@ The maximal number of connection attempts any client is allowed to make to this
 
 `dnsbl_sites`: `<string>` ::
 
 
 `dnsbl_sites`: `<string>` ::
 

-Optional list of DNS white/blacklist domains (see postscreen_dnsbl_sites parameter).
+Optional list of DNS white/blacklist domains (postfix option `postscreen_dnsbl_sites`).

 
 `dnsbl_threshold`: `<integer> (0 - N)` ('default =' `1`)::
 
 
 `dnsbl_threshold`: `<integer> (0 - N)` ('default =' `1`)::
 

-The inclusive lower bound for blocking a remote SMTP client, based on its combined DNSBL score (see postscreen_dnsbl_threshold parameter).
+The inclusive lower bound for blocking a remote SMTP client, based on its combined DNSBL score (postfix option `postscreen_dnsbl_threshold`).

 
 `dwarning`: `<integer> (0 - N)` ('default =' `4`)::
 
 
 `dwarning`: `<integer> (0 - N)` ('default =' `4`)::
 

-SMTP delay warning time (in hours).
+SMTP delay warning time (in hours). (postfix option `delay_warning_time`)

 
 `ext_port`: `<integer> (1 - 65535)` ('default =' `25`)::
 
 SMTP port number for incoming mail (untrusted). This must be a different number than 'int_port'.
 
 
 `ext_port`: `<integer> (1 - 65535)` ('default =' `25`)::
 
 SMTP port number for incoming mail (untrusted). This must be a different number than 'int_port'.
 

+`filter-timeout`: `<integer> (2 - 86400)` ('default =' `600`)::
+
+Timeout for the processing of one mail (in seconds)  (postfix option `smtpd_proxy_timeout` and `lmtp_data_done_timeout`)
+

 `greylist`: `<boolean>` ('default =' `1`)::
 
 `greylist`: `<boolean>` ('default =' `1`)::
 

-Use Greylisting.
+Use Greylisting for IPv4.
+
+`greylist6`: `<boolean>` ('default =' `0`)::
+
+Use Greylisting for IPv6.
+
+`greylistmask4`: `<integer> (0 - 32)` ('default =' `24`)::
+
+Netmask to apply for greylisting IPv4 hosts
+
+`greylistmask6`: `<integer> (0 - 128)` ('default =' `64`)::
+
+Netmask to apply for greylisting IPv6 hosts

 
 `helotests`: `<boolean>` ('default =' `0`)::
 
 
 `helotests`: `<boolean>` ('default =' `0`)::
 

-Use SMTP HELO tests.
+Use SMTP HELO tests. (postfix option `smtpd_helo_restrictions`)

 
 `hide_received`: `<boolean>` ('default =' `0`)::
 
 
 `hide_received`: `<boolean>` ('default =' `0`)::
 


@@ -136,7 +164,7 @@ Hide received header in outgoing mails.
 
 SMTP port number for outgoing mail (trusted).
 
 
 SMTP port number for outgoing mail (trusted).
 

-`max_filters`: `<integer> (3 - 40)` ('default =' `35`)::
+`max_filters`: `<integer> (3 - 40)` ('default =' `25`)::

 
 Maximum number of pmg-smtp-filter processes.
 
 
 Maximum number of pmg-smtp-filter processes.
 


@@ -154,7 +182,7 @@ Maximum number of SMTP daemon processes (out).
 
 `maxsize`: `<integer> (1024 - N)` ('default =' `10485760`)::
 
 
 `maxsize`: `<integer> (1024 - N)` ('default =' `10485760`)::
 

-Maximum email size. Larger mails are rejected.
+Maximum email size. Larger mails are rejected. (postfix option `message_size_limit`)

 
 `message_rate_limit`: `<integer> (0 - N)` ('default =' `0`)::
 
 
 `message_rate_limit`: `<integer> (0 - N)` ('default =' `0`)::
 


@@ -166,11 +194,11 @@ Send out NDR when mail gets blocked
 
 `rejectunknown`: `<boolean>` ('default =' `0`)::
 
 
 `rejectunknown`: `<boolean>` ('default =' `0`)::
 

-Reject unknown clients.
+Reject unknown clients. (postfix option `reject_unknown_client_hostname`)

 
 `rejectunknownsender`: `<boolean>` ('default =' `0`)::
 
 
 `rejectunknownsender`: `<boolean>` ('default =' `0`)::
 

-Reject unknown senders.
+Reject unknown senders. (postfix option `reject_unknown_sender_domain`)

 
 `relay`: `<string>` ::
 
 
 `relay`: `<string>` ::
 


@@ -178,19 +206,27 @@ The default mail delivery transport (incoming mails).
 
 `relaynomx`: `<boolean>` ('default =' `0`)::
 
 
 `relaynomx`: `<boolean>` ('default =' `0`)::
 

-Disable MX lookups for default relay.
+Disable MX lookups for default relay (SMTP only, ignored for LMTP).

 
 `relayport`: `<integer> (1 - 65535)` ('default =' `25`)::
 
 
 `relayport`: `<integer> (1 - 65535)` ('default =' `25`)::
 

-SMTP port number for relay host.
+SMTP/LMTP port number for relay host.
+
+`relayprotocol`: `<lmtp | smtp>` ('default =' `smtp`)::
+
+Transport protocol for relay host.

 
 `smarthost`: `<string>` ::
 
 
 `smarthost`: `<string>` ::
 

-When set, all outgoing mails are deliverd to the specified smarthost.
+When set, all outgoing mails are deliverd to the specified smarthost. (postfix option `default_transport`)

 
 `smarthostport`: `<integer> (1 - 65535)` ('default =' `25`)::
 
 
 `smarthostport`: `<integer> (1 - 65535)` ('default =' `25`)::
 

-SMTP port number for smarthost.
+SMTP port number for smarthost. (postfix option `default_transport`)
+
+`smtputf8`: `<boolean>` ('default =' `1`)::
+
+Enable SMTPUTF8 support in Postfix and detection for locally generated mail (postfix option `smtputf8_enable`)

 
 `spf`: `<boolean>` ('default =' `1`)::
 
 
 `spf`: `<boolean>` ('default =' `1`)::
 


@@ -210,7 +246,7 @@ Enable TLS Logging.
 
 `verifyreceivers`: `<450 | 550>` ::
 
 
 `verifyreceivers`: `<450 | 550>` ::
 

-Enable receiver verification. The value spefifies the numerical reply code when the Postfix SMTP server rejects a recipient address.
+Enable receiver verification. The value specifies the numerical reply code when the Postfix SMTP server rejects a recipient address. (postfix options `reject_unknown_recipient_domain`, `reject_unverified_recipient`, and `unverified_recipient_reject_code`)

 
 .Section 'spam'
 
 
 .Section 'spam'
 


@@ -220,7 +256,11 @@ Additional score for bounce mails.
 
 `clamav_heuristic_score`: `<integer> (0 - 1000)` ('default =' `3`)::
 
 
 `clamav_heuristic_score`: `<integer> (0 - 1000)` ('default =' `3`)::
 

-Score for ClamAV heuristics (Encrypted Archives/Documents, Google Safe Browsing database, PhishingScanURLs, ...).
+Score for ClamAV heuristics (Encrypted Archives/Documents, PhishingScanURLs, ...).
+
+`extract_text`: `<boolean>` ('default =' `0`)::
+
+Extract text from attachments (doc, pdf, rtf, images) and scan for spam.

 
 `languages`: `(all|([a-z][a-z])+( ([a-z][a-z])+)*)` ('default =' `all`)::
 
 
 `languages`: `(all|([a-z][a-z])+( ([a-z][a-z])+)*)` ('default =' `all`)::
 


@@ -234,11 +274,11 @@ Maximum size of spam messages in bytes.
 
 Enable real time blacklists (RBL) checks.
 
 
 Enable real time blacklists (RBL) checks.
 

-`use_awl`: `<boolean>` ('default =' `1`)::
+`use_awl`: `<boolean>` ('default =' `0`)::

 
 Use the Auto-Whitelist plugin.
 
 
 Use the Auto-Whitelist plugin.
 

-`use_bayes`: `<boolean>` ('default =' `1`)::
+`use_bayes`: `<boolean>` ('default =' `0`)::

 
 Whether to use the naive-Bayesian-style classifier.
 
 
 Whether to use the naive-Bayesian-style classifier.
 


@@ -280,6 +320,10 @@ Quarantine Port. Useful if you have a reverse proxy or port forwarding for the w
 
 Quarantine Webinterface Protocol. Useful if you have a reverse proxy for the webinterface. Only used for the generated Spam report.
 
 
 Quarantine Webinterface Protocol. Useful if you have a reverse proxy for the webinterface. Only used for the generated Spam report.
 

+`quarantinelink`: `<boolean>` ('default =' `0`)::
+
+Enables user self-service for Quarantine Links. Caution: this is accessible without authentication
+

 `reportstyle`: `<custom | none | short | verbose>` ('default =' `verbose`)::
 
 Spam report style.
 `reportstyle`: `<custom | none | short | verbose>` ('default =' `verbose`)::
 
 Spam report style.