CURLOPT_PROXY_SSLVERSION(3)

1CURLOPT_PROXY_SSLVERSION(3)curl_easy_setopt optionsCURLOPT_PROXY_SSLVERSION(3)
2
3
4

NAME

6       CURLOPT_PROXY_SSLVERSION - preferred HTTPS proxy TLS version
7

SYNOPSIS

9       #include <curl/curl.h>
10
11       CURLcode curl_easy_setopt(CURL *handle, CURLOPT_PROXY_SSLVERSION,
12                                 long version);
13

DESCRIPTION

15       Pass a long as parameter to control which version of SSL/TLS to attempt
16       to use when connecting to an HTTPS proxy.
17
18       Use one of the available defines for this purpose.  The  available  op‐
19       tions are:
20
21              CURL_SSLVERSION_DEFAULT
22                     The  default  action. This will attempt to figure out the
23                     remote SSL protocol version.
24
25              CURL_SSLVERSION_TLSv1
26                     TLSv1.x
27
28              CURL_SSLVERSION_TLSv1_0
29                     TLSv1.0
30
31              CURL_SSLVERSION_TLSv1_1
32                     TLSv1.1
33
34              CURL_SSLVERSION_TLSv1_2
35                     TLSv1.2
36
37              CURL_SSLVERSION_TLSv1_3
38                     TLSv1.3
39       The maximum TLS version can be set by using  one  of  the  CURL_SSLVER‐
40       SION_MAX_  macros  below. It is also possible to OR one of the CURL_SS‐
41       LVERSION_ macros with one of the CURL_SSLVERSION_MAX_ macros.  The  MAX
42       macros are not supported for WolfSSL.
43
44              CURL_SSLVERSION_MAX_DEFAULT
45                     The  flag  defines  the  maximum supported TLS version as
46                     TLSv1.2, or the  default  value  from  the  SSL  library.
47                     (Added in 7.54.0)
48
49              CURL_SSLVERSION_MAX_TLSv1_0
50                     The   flag  defines  maximum  supported  TLS  version  as
51                     TLSv1.0.  (Added in 7.54.0)
52
53              CURL_SSLVERSION_MAX_TLSv1_1
54                     The  flag  defines  maximum  supported  TLS  version   as
55                     TLSv1.1.  (Added in 7.54.0)
56
57              CURL_SSLVERSION_MAX_TLSv1_2
58                     The   flag  defines  maximum  supported  TLS  version  as
59                     TLSv1.2.  (Added in 7.54.0)
60
61              CURL_SSLVERSION_MAX_TLSv1_3
62                     The  flag  defines  maximum  supported  TLS  version   as
63                     TLSv1.3.  (Added in 7.54.0)
64
65       In  versions of curl prior to 7.54 the CURL_SSLVERSION_TLS options were
66       documented to allow only the specified TLS version,  but  behavior  was
67       inconsistent depending on the TLS library.
68
69

DEFAULT

71       CURL_SSLVERSION_DEFAULT
72

PROTOCOLS

74       All
75

EXAMPLE

77       CURL *curl = curl_easy_init();
78       if(curl) {
79         curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
80
81         /* ask libcurl to use TLS version 1.0 or later */
82         curl_easy_setopt(curl, CURLOPT_SSLVERSION, CURL_SSLVERSION_TLSv1);
83
84         /* Perform the request */
85         curl_easy_perform(curl);
86       }
87

AVAILABILITY

89       Added in 7.52.0
90

RETURN VALUE

92       Returns  CURLE_OK  if the option is supported, and CURLE_UNKNOWN_OPTION
93       if not.
94