curl/docs/cmdline-opts/ssl.d

Long: ssl
Help: Try SSL/TLS
Protocols: FTP IMAP POP3 SMTP LDAP
Added: 7.20.0
Category: tls
Example: --ssl pop3://example.com/
See-also: insecure ciphers
---
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 since version 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 will be removed in a future version.
docs: fix cmdline-opts metadata headers case consistency. Almost all headers start with an uppercase letter, but some didn't. 2018-05-28 20:16:27 +08:00			`Long: ssl`
cmdline-opts: more command line options documented Moved over to the new format 2016-11-28 07:50:25 +08:00			`Help: Try SSL/TLS`
openldap: implement STARTTLS As this introduces use of CURLOPT_USE_SSL option for LDAP, also check this option in ldap.c as it is not supported by this backend. Closes #8065 2021-12-01 00:48:28 +08:00			`Protocols: FTP IMAP POP3 SMTP LDAP`
cmdline-opts: more command line options documented Moved over to the new format 2016-11-28 07:50:25 +08:00			`Added: 7.20.0`
docs: add categories to all cmdline opts Adapted gen.pl with 'listcats' This commit is a part of "--help me if you can" Closes #5680 2020-07-13 20:15:04 +08:00			`Category: tls`
curl.1: provide examples for each option The file format for each option now features a "Example:" header that can provide one or more examples that get rendered appropriately in the output. All options MUST have at least one example or gen.pl complains at build-time. This fix also does a few other minor format and consistency cleanups. Closes #7654 2021-08-31 22:37:14 +08:00			`Example: --ssl pop3://example.com/`
curl.1: require "see also" for every documented option gen.pl now generates a warning if the "See Also" field is not filled in for a command line option All command line options now provide one or more related options. 167 "See alsos" added! Closes #8019 2021-11-15 22:58:20 +08:00			`See-also: insecure ciphers`
cmdline-opts: more command line options documented Moved over to the new format 2016-11-28 07:50:25 +08:00			`---`
docs: address proselint nits - avoid exclamation marks - use consistent number of spaces after periods: one - avoid clichés - avoid using 'very' Closes #8060 2021-11-26 15:46:59 +08:00			`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`
cmdline-opts: more command line options documented Moved over to the new format 2016-11-28 07:50:25 +08:00			`for different levels of encryption required.`

openldap: implement STARTTLS As this introduces use of CURLOPT_USE_SSL option for LDAP, also check this option in ldap.c as it is not supported by this backend. Closes #8065 2021-12-01 00:48:28 +08:00			`This option is handled in LDAP since version 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.`

cmdline-opts: more command line options documented Moved over to the new format 2016-11-28 07:50:25 +08:00			`This option was formerly known as --ftp-ssl (Added in 7.11.0). That option`
			`name can still be used but will be removed in a future version.`