summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorDaniel Stenberg <daniel@haxx.se>2022-12-14 13:56:42 +0100
committerDaniel Stenberg <daniel@haxx.se>2022-12-15 14:36:37 +0100
commit50750d097aa55864498d2622fd14aad17fda941e (patch)
treefb635eaeff5be30b9995c29bef63ce83853737de /docs
parentaf0924210bef6bc775b452c7bfece26d2bc00346 (diff)
downloadcurl-50750d097aa55864498d2622fd14aad17fda941e.tar.gz
ssl-reqd.d: clarify that this is for upgrading connections only
Closes #10093
Diffstat (limited to 'docs')
-rw-r--r--docs/cmdline-opts/ssl-reqd.d8
1 files changed, 6 insertions, 2 deletions
diff --git a/docs/cmdline-opts/ssl-reqd.d b/docs/cmdline-opts/ssl-reqd.d
index cf81fb229..6f95d5b67 100644
--- a/docs/cmdline-opts/ssl-reqd.d
+++ b/docs/cmdline-opts/ssl-reqd.d
@@ -9,11 +9,15 @@ Example: --ssl-reqd ftp://example.com
See-also: ssl insecure
Multi: boolean
---
-Require SSL/TLS for the connection. Terminates the connection if the server
-does not support SSL/TLS.
+Require SSL/TLS for the connection. Terminates the connection if the transfer
+cannot be upgraded to use SSL/TLS.
This option is handled in LDAP since version 7.81.0. It is fully supported
by the OpenLDAP backend and rejected by the generic ldap backend if explicit
TLS is required.
+This option is unnecessary if you use a URL scheme that in itself implies
+immediate and implicit use of TLS, like for FTPS, IMAPS, POP3S, SMTPS and
+LDAPS. Such transfers will always fail if the TLS handshake does not work.
+
This option was formerly known as --ftp-ssl-reqd.