xref: /aosp_15_r20/external/curl/docs/cmdline-opts/ssl.md (revision 6236dae45794135f37c4eb022389c904c8b0090d)
1*6236dae4SAndroid Build Coastguard Worker---
2*6236dae4SAndroid Build Coastguard Workerc: Copyright (C) Daniel Stenberg, <[email protected]>, et al.
3*6236dae4SAndroid Build Coastguard WorkerSPDX-License-Identifier: curl
4*6236dae4SAndroid Build Coastguard WorkerLong: ssl
5*6236dae4SAndroid Build Coastguard WorkerHelp: Try enabling TLS
6*6236dae4SAndroid Build Coastguard WorkerProtocols: FTP IMAP POP3 SMTP LDAP
7*6236dae4SAndroid Build Coastguard WorkerAdded: 7.20.0
8*6236dae4SAndroid Build Coastguard WorkerCategory: tls imap pop3 smtp ldap
9*6236dae4SAndroid Build Coastguard WorkerMulti: boolean
10*6236dae4SAndroid Build Coastguard WorkerSee-also:
11*6236dae4SAndroid Build Coastguard Worker  - ssl-reqd
12*6236dae4SAndroid Build Coastguard Worker  - insecure
13*6236dae4SAndroid Build Coastguard Worker  - ciphers
14*6236dae4SAndroid Build Coastguard WorkerExample:
15*6236dae4SAndroid Build Coastguard Worker  - --ssl pop3://example.com/
16*6236dae4SAndroid Build Coastguard Worker---
17*6236dae4SAndroid Build Coastguard Worker
18*6236dae4SAndroid Build Coastguard Worker# `--ssl`
19*6236dae4SAndroid Build Coastguard Worker
20*6236dae4SAndroid Build Coastguard WorkerWarning: this is considered an insecure option. Consider using --ssl-reqd
21*6236dae4SAndroid Build Coastguard Workerinstead to be sure curl upgrades to a secure connection.
22*6236dae4SAndroid Build Coastguard Worker
23*6236dae4SAndroid Build Coastguard WorkerTry to use SSL/TLS for the connection - often referred to as STARTTLS or STLS
24*6236dae4SAndroid Build Coastguard Workerbecause of the involved commands. Reverts to a non-secure connection if the
25*6236dae4SAndroid Build Coastguard Workerserver does not support SSL/TLS. See also --ftp-ssl-control and --ssl-reqd for
26*6236dae4SAndroid Build Coastguard Workerdifferent levels of encryption required.
27*6236dae4SAndroid Build Coastguard Worker
28*6236dae4SAndroid Build Coastguard WorkerThis option is handled in LDAP (added in 7.81.0). It is fully supported by the
29*6236dae4SAndroid Build Coastguard WorkerOpenLDAP backend and ignored by the generic ldap backend.
30*6236dae4SAndroid Build Coastguard Worker
31*6236dae4SAndroid Build Coastguard WorkerPlease note that a server may close the connection if the negotiation does
32*6236dae4SAndroid Build Coastguard Workernot succeed.
33*6236dae4SAndroid Build Coastguard Worker
34*6236dae4SAndroid Build Coastguard WorkerThis option was formerly known as --ftp-ssl (added in 7.11.0). That option
35*6236dae4SAndroid Build Coastguard Workername can still be used but might be removed in a future version.
36