1 .\" **************************************************************************
3 .\" * Project ___| | | | _ \| |
4 .\" * / __| | | | |_) | |
5 .\" * | (__| |_| | _ <| |___
6 .\" * \___|\___/|_| \_\_____|
8 .\" * Copyright (C) 1998 - 2014, Daniel Stenberg, <daniel@haxx.se>, et al.
10 .\" * This software is licensed as described in the file COPYING, which
11 .\" * you should have received as part of this distribution. The terms
12 .\" * are also available at http://curl.haxx.se/docs/copyright.html.
14 .\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
15 .\" * copies of the Software, and permit persons to whom the Software is
16 .\" * furnished to do so, under the terms of the COPYING file.
18 .\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
19 .\" * KIND, either express or implied.
21 .\" **************************************************************************
23 .TH CURLOPT_SSLVERSION 3 "17 Jun 2014" "libcurl 7.37.0" "curl_easy_setopt options"
25 CURLOPT_SSLVERSION \- set preferred TLS/SSL version
27 #include <curl/curl.h>
29 CURLcode curl_easy_setopt(CURL *handle, CURLOPT_SSLVERSION, long version);
31 Pass a long as parameter to control which version of SSL/TLS to attempt to
34 Use one of the available defines for this purpose. The available options are:
36 .IP CURL_SSLVERSION_DEFAULT
37 The default action. This will attempt to figure out the remote SSL protocol
39 .IP CURL_SSLVERSION_TLSv1
41 .IP CURL_SSLVERSION_SSLv2
43 .IP CURL_SSLVERSION_SSLv3
45 .IP CURL_SSLVERSION_TLSv1_0
46 TLSv1.0 (Added in 7.34.0)
47 .IP CURL_SSLVERSION_TLSv1_1
48 TLSv1.1 (Added in 7.34.0)
49 .IP CURL_SSLVERSION_TLSv1_2
50 TLSv1.2 (Added in 7.34.0)
53 CURL_SSLVERSION_DEFAULT
55 All TLS based protocols: HTTPS, FTPS, IMAPS, POP3, SMTPS etc.
58 CURL *curl = curl_easy_init();
60 curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
62 /* ask libcurl to use TLS version 1.0 or later */
63 curl_easy_setopt(curl, CURLOPT_SSLVERSION, CURL_SSLVERSION_TLSv1);
65 /* Perform the request */
66 curl_easy_perform(curl);
70 SSLv2 is disabled by default since 7.18.1. Other SSL versions availability may
71 vary depending on which backend libcurl has been built to use.
73 SSLv3 is disabled by default since 7.39.0.
75 Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
77 .BR CURLOPT_USE_SSL "(3), " CURLOPT_HTTP_VERSION "(3), "
78 .BR CURLOPT_IPRESOLVE "(3) "