xref: /curl/docs/cmdline-opts/ssl-reqd.md (revision 2abfc759)
1---
2c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
3SPDX-License-Identifier: curl
4Long: ssl-reqd
5Help: Require SSL/TLS
6Protocols: FTP IMAP POP3 SMTP LDAP
7Added: 7.20.0
8Category: tls imap pop3 smtp ldap
9Multi: boolean
10See-also:
11  - ssl
12  - insecure
13Example:
14  - --ssl-reqd ftp://example.com
15---
16
17# `--ssl-reqd`
18
19Require SSL/TLS for the connection - often referred to as STARTTLS or STLS
20because of the involved commands. Terminates the connection if the transfer
21cannot be upgraded to use SSL/TLS.
22
23This option is handled in LDAP (added in 7.81.0). It is fully supported by the
24OpenLDAP backend and rejected by the generic ldap backend if explicit TLS is
25required.
26
27This option is unnecessary if you use a URL scheme that in itself implies
28immediate and implicit use of TLS, like for FTPS, IMAPS, POP3S, SMTPS and
29LDAPS. Such a transfer always fails if the TLS handshake does not work.
30
31This option was formerly known as --ftp-ssl-reqd.
32