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-reqd 5*6236dae4SAndroid Build Coastguard WorkerHelp: Require SSL/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 12*6236dae4SAndroid Build Coastguard Worker - insecure 13*6236dae4SAndroid Build Coastguard WorkerExample: 14*6236dae4SAndroid Build Coastguard Worker - --ssl-reqd ftp://example.com 15*6236dae4SAndroid Build Coastguard Worker--- 16*6236dae4SAndroid Build Coastguard Worker 17*6236dae4SAndroid Build Coastguard Worker# `--ssl-reqd` 18*6236dae4SAndroid Build Coastguard Worker 19*6236dae4SAndroid Build Coastguard WorkerRequire SSL/TLS for the connection - often referred to as STARTTLS or STLS 20*6236dae4SAndroid Build Coastguard Workerbecause of the involved commands. Terminates the connection if the transfer 21*6236dae4SAndroid Build Coastguard Workercannot be upgraded to use SSL/TLS. 22*6236dae4SAndroid Build Coastguard Worker 23*6236dae4SAndroid Build Coastguard WorkerThis option is handled in LDAP (added in 7.81.0). It is fully supported by the 24*6236dae4SAndroid Build Coastguard WorkerOpenLDAP backend and rejected by the generic ldap backend if explicit TLS is 25*6236dae4SAndroid Build Coastguard Workerrequired. 26*6236dae4SAndroid Build Coastguard Worker 27*6236dae4SAndroid Build Coastguard WorkerThis option is unnecessary if you use a URL scheme that in itself implies 28*6236dae4SAndroid Build Coastguard Workerimmediate and implicit use of TLS, like for FTPS, IMAPS, POP3S, SMTPS and 29*6236dae4SAndroid Build Coastguard WorkerLDAPS. Such a transfer always fails if the TLS handshake does not work. 30*6236dae4SAndroid Build Coastguard Worker 31*6236dae4SAndroid Build Coastguard WorkerThis option was formerly known as --ftp-ssl-reqd. 32