aboutsummaryrefslogtreecommitdiff
path: root/docs/cmdline-opts/ssl.md
diff options
context:
space:
mode:
Diffstat (limited to 'docs/cmdline-opts/ssl.md')
-rw-r--r--docs/cmdline-opts/ssl.md34
1 files changed, 34 insertions, 0 deletions
diff --git a/docs/cmdline-opts/ssl.md b/docs/cmdline-opts/ssl.md
new file mode 100644
index 000000000..9a78ae3a2
--- /dev/null
+++ b/docs/cmdline-opts/ssl.md
@@ -0,0 +1,34 @@
+---
+c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
+SPDX-License-Identifier: curl
+Long: ssl
+Help: Try SSL/TLS
+Protocols: FTP IMAP POP3 SMTP LDAP
+Added: 7.20.0
+Category: tls
+Multi: boolean
+See-also:
+ - ssl-reqd
+ - insecure
+ - ciphers
+Example:
+ - --ssl pop3://example.com/
+---
+
+# `--ssl`
+
+Warning: this is considered an insecure option. Consider using --ssl-reqd
+instead to be sure curl upgrades to a secure connection.
+
+Try to use SSL/TLS for the connection. Reverts to a non-secure connection if
+the server does not support SSL/TLS. See also --ftp-ssl-control and --ssl-reqd
+for different levels of encryption required.
+
+This option is handled in LDAP (added in 7.81.0). It is fully supported by the
+OpenLDAP backend and ignored by the generic ldap backend.
+
+Please note that a server may close the connection if the negotiation does
+not succeed.
+
+This option was formerly known as --ftp-ssl (added in 7.11.0). That option
+name can still be used but might be removed in a future version.