Debian Codegraph @

deps/curl/docs/libcurl/opts/CURLOPT_PROXY_SSL_OPTIONS.3

raw
1 .\" **************************************************************************
2 .\" * _ _ ____ _
3 .\" * Project ___| | | | _ \| |
4 .\" * / __| | | | |_) | |
5 .\" * | (__| |_| | _ <| |___
6 .\" * \___|\___/|_| \_\_____|
7 .\" *
8 .\" * Copyright (C) 1998 - 2019, Daniel Stenberg, <[email protected]>, et al.
9 .\" *
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 https://curl.haxx.se/docs/copyright.html.
13 .\" *
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.
17 .\" *
18 .\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
19 .\" * KIND, either express or implied.
20 .\" *
21 .\" **************************************************************************
22 .\"
23 .TH CURLOPT_PROXY_SSL_OPTIONS 3 "16 Nov 2016" "libcurl 7.52.0" "curl_easy_setopt options"
24 .SH NAME
25 CURLOPT_PROXY_SSL_OPTIONS \- set proxy SSL behavior options
26 .SH SYNOPSIS
27 #include <curl/curl.h>
28
29 CURLcode curl_easy_setopt(CURL *handle, CURLOPT_PROXY_SSL_OPTIONS, long bitmask);
30 .SH DESCRIPTION
31 Pass a long with a bitmask to tell libcurl about specific SSL
32 behaviors. Available bits:
33 .IP CURLSSLOPT_ALLOW_BEAST
34 Tells libcurl to not attempt to use any workarounds for a security flaw in the
35 SSL3 and TLS1.0 protocols. If this option isn't used or this bit is set to 0,
36 the SSL layer libcurl uses may use a work-around for this flaw although it
37 might cause interoperability problems with some (older) SSL
38 implementations. WARNING: avoiding this work-around lessens the security, and
39 by setting this option to 1 you ask for exactly that. This option is only
40 supported for DarwinSSL, NSS and OpenSSL.
41 .IP CURLSSLOPT_NO_REVOKE
42 Tells libcurl to disable certificate revocation checks for those SSL backends
43 where such behavior is present. This option is only supported for Schannel
44 (the native Windows SSL library), with an exception in the case of Windows'
45 Untrusted Publishers blacklist which it seems can't be bypassed. (Added in
46 7.44.0)
47 .IP CURLSSLOPT_NO_PARTIALCHAIN
48 Tells libcurl to not accept "partial" certificate chains, which it otherwise
49 does by default. This option is only supported for OpenSSL and will fail the
50 certificate verification if the chain ends with an intermediate certificate
51 and not with a root cert. (Added in 7.68.0)
52 .SH DEFAULT
53 0
54 .SH PROTOCOLS
55 All TLS-based protocols
56 .SH AVAILABLE
57 Added in 7.52.0
58 .SH EXAMPLE
59 .nf
60 CURL *curl = curl_easy_init();
61 if(curl) {
62 curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
63 curl_easy_setopt(curl, CURLOPT_PROXY, "https://proxy");
64 /* weaken TLS only for use with silly proxies */
65 curl_easy_setopt(curl, CURLOPT_PROXY_SSL_OPTIONS, CURLSSLOPT_ALLOW_BEAST |
66 CURLSSLOPT_NO_REVOKE);
67 ret = curl_easy_perform(curl);
68 curl_easy_cleanup(curl);
69 }
70 .fi
71 .SH RETURN VALUE
72 Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
73 .SH "SEE ALSO"
74 .BR CURLOPT_PROXY_SSLVERSION "(3), " CURLOPT_PROXY_SSL_CIPHER_LIST "(3), "
75 .BR CURLOPT_SSLVERSION "(3), " CURLOPT_SSL_CIPHER_LIST "(3), "