diff options
author | Heiko Schlittermann (HS12-RIPE) <hs@schlittermann.de> | 2020-05-22 17:32:33 +0200 |
---|---|---|
committer | Heiko Schlittermann (HS12-RIPE) <hs@schlittermann.de> | 2020-05-22 17:34:32 +0200 |
commit | ef546e788203ac3881abe2ddb17f3e24f6524d15 (patch) | |
tree | f0b3a8a6551c9d8960bf69d204f5957a61b10a2a /doc | |
parent | 6808e0f19ec9a9544241e26cf1e3179eb86bbd00 (diff) |
SPF: Add main config option "spf_smtp_comment_templateexim-4.94-RC2
Diffstat (limited to 'doc')
-rw-r--r-- | doc/doc-docbook/spec.xfpt | 41 | ||||
-rw-r--r-- | doc/doc-txt/ChangeLog | 3 | ||||
-rw-r--r-- | doc/doc-txt/NewStuff | 7 |
3 files changed, 48 insertions, 3 deletions
diff --git a/doc/doc-docbook/spec.xfpt b/doc/doc-docbook/spec.xfpt index 4147ee205..b1387eb49 100644 --- a/doc/doc-docbook/spec.xfpt +++ b/doc/doc-docbook/spec.xfpt @@ -14578,6 +14578,7 @@ listed in more than one group. .row &%percent_hack_domains%& "recognize %-hack for these domains" .row &%spamd_address%& "set interface to SpamAssassin" .row &%strict_acl_vars%& "object to unset ACL variables" +.row &%spf_smtp_comment_template%& "template for &$spf_smtp_comment$&" .endtable @@ -17761,6 +17762,41 @@ See section &<<SECTscanspamass>>& for more details. This option is available when Exim is compiled with SPF support. See section &<<SECSPF>>& for more details. +.new +.option spf_smtp_comment_template main string&!! "Please%_see%_http://www.open-spf.org/Why" +This option is available when Exim is compiled with SPF support. It +allows the customisation of the SMTP comment that the SPF library +generates. You are strongly encouraged to link to your own explanative +site. The following placeholders (along with Exim variables) are allowed +in the template (this list is compiled from the libspf2 sources): +.ilist +&*L*&: Envelope sender's local part. +.next +&*S*&: Envelope sender. +.next +&*O*&: Envelope sender's domain. +.next +&*D*&: Current(?) domain. +.next +&*I*&: SMTP client Ip. +.next +&*C*&: SMTP client pretty IP. +.next +&*T*&: Epoch time (UTC). +.next +&*P*&: SMTP client domain name. +.next +&*V*&: IP version. +.next +&*H*&: EHLO/HELO domain. +.next +&*R*&: Receiving domain. +.endlist +The capitalized placeholders do proper URL encoding, if you use them +lowercased, no encoding takes place. A note on using Exim variables: As +currenty the SPF library is initialized already during the EHLO phase, +the amount of variables available for expansion is quite limited. +.wen .option split_spool_directory main boolean false @@ -41044,8 +41080,13 @@ variables: .vitem &$spf_smtp_comment$& .vindex &$spf_smtp_comment$& +.vindex &%spf_smtp_comment_template%& This contains a string that can be used in a SMTP response to the calling party. Useful for "fail". +.new + The string is generated by the SPF library from the template configured in the main config + option &%spf_smtp_comment_template%&. +.wen .endlist diff --git a/doc/doc-txt/ChangeLog b/doc/doc-txt/ChangeLog index 2d7c5e014..585deb042 100644 --- a/doc/doc-txt/ChangeLog +++ b/doc/doc-txt/ChangeLog @@ -204,7 +204,8 @@ JH/43 Fix possible long line in DSN. Previously when a very long SMTP error standards on line-length limits. Truncate if needed. HS/01 Remove parameters of the link to www.open-spf.org. The linked form - doesn't work. + doesn't work. (Additionally add a new main config option to configure the + spf_smtp_comment) Exim version 4.93 diff --git a/doc/doc-txt/NewStuff b/doc/doc-txt/NewStuff index c29525d50..43e170e11 100644 --- a/doc/doc-txt/NewStuff +++ b/doc/doc-txt/NewStuff @@ -17,7 +17,7 @@ Version 4.94 3. A msg:defer event. - 4. Client-side support in the gsasl authenticator. Tested against the + 4. Client-side support in the gsasl authenticator. Tested against the plaintext driver for PLAIN; only against itself for SCRAM-SHA-1 and SCRAM-SHA-1-PLUS methods. @@ -71,6 +71,9 @@ Version 4.94 21. bounce_message_file and warn_message_file are now expanded before use. +22. New main config option spf_smtp_comment_template to customise the + $spf_smtp_comment variable + Version 4.93 @@ -111,7 +114,7 @@ Version 4.93 15: Support under OpenSSL for writing NSS-style key files for packet-capture decode. The environment variable SSLKEYLOGFILE is used; if an absolute path it must indicate a file under the spool directory; if relative the the spool - directory is prepended. Works on the server side only. Support under + directory is prepended. Works on the server side only. Support under GnuTLS was already there, being done purely by the library (server side only, and exim must be run as root). |