Gitweb:
https://git.exim.org/exim.git/commitdiff/fce82eca42de488efa9d9019727c97bbe25a19e7
Commit: fce82eca42de488efa9d9019727c97bbe25a19e7
Parent: 485b86b9dbb99593f752051e936daf8ff0e8add1
Author: Jeremy Harris <jgh146exb@???>
AuthorDate: Sun Nov 11 18:08:05 2018 +0000
Committer: Jeremy Harris <jgh146exb@???>
CommitDate: Sun Nov 11 18:08:05 2018 +0000
Docs: add notes on smtps
---
doc/doc-docbook/spec.xfpt | 17 ++++++++++++++---
1 file changed, 14 insertions(+), 3 deletions(-)
diff --git a/doc/doc-docbook/spec.xfpt b/doc/doc-docbook/spec.xfpt
index 4e99e6c..8e083d6 100644
--- a/doc/doc-docbook/spec.xfpt
+++ b/doc/doc-docbook/spec.xfpt
@@ -24569,10 +24569,17 @@ variable that contains an outgoing port.
If the value of this option begins with a digit it is taken as a port number;
otherwise it is looked up using &[getservbyname()]&. The default value is
-normally &"smtp"&, but if &%protocol%& is set to &"lmtp"&, the default is
-&"lmtp"&. If the expansion fails, or if a port number cannot be found, delivery
+normally &"smtp"&,
+but if &%protocol%& is set to &"lmtp"& the default is &"lmtp"&
+and if &%protocol%& is set to &"smtps"& the default is &"smtps"&.
+If the expansion fails, or if a port number cannot be found, delivery
is deferred.
+.new
+Note that at least one Linux distribution has been seen failing
+to put &"smtps"& in its &"/etc/services"& file, resulting is such deferrals.
+.wen
+
.option protocol smtp string smtp
@@ -24589,7 +24596,11 @@ over a pipe to a local process &-- see chapter &<<CHAPLMTP>>&.
If this option is set to &"smtps"&, the default value for the &%port%& option
changes to &"smtps"&, and the transport initiates TLS immediately after
connecting, as an outbound SSL-on-connect, instead of using STARTTLS to upgrade.
-The Internet standards bodies strongly discourage use of this mode.
+.new
+The Internet standards bodies used to strongly discourage use of this mode,
+but as of RFC 8314 it is perferred over STARTTLS for message submission
+(as distinct from MTA-MTA communication).
+.wen
.option retry_include_ip_address smtp boolean&!! true
