Loading docs/libcurl/opts/CURLINFO_PROXY_SSL_VERIFYRESULT.3 +6 −7 Original line number Diff line number Diff line Loading @@ -22,23 +22,22 @@ .\" .TH CURLINFO_PROXY_SSL_VERIFYRESULT 3 "16 Nov 2016" "libcurl 7.52.0" "curl_easy_getinfo options" .SH NAME CURLINFO_PROXY_SSL_VERIFYRESULT \- get the result of the proxy certification verification CURLINFO_PROXY_SSL_VERIFYRESULT \- get the result of the proxy certificate verification .SH SYNOPSIS #include <curl/curl.h> CURLcode curl_easy_getinfo(CURL *handle, CURLINFO_PROXY_SSL_VERIFYRESULT, long *result); .SH DESCRIPTION TODO: Make this text specific to HTTPS proxy. (Added in 7.XXX) Pass a pointer to a long to receive the result of the certification verification that was requested (using the \fICURLOPT_SSL_VERIFYPEER(3)\fP option. Pass a pointer to a long to receive the result of the certificate verification that was requested (using the \fICURLOPT_PROXY_SSL_VERIFYPEER(3)\fP option. .SH PROTOCOLS All using TLS All .SH EXAMPLE TODO .SH AVAILABILITY Added in 7.5 Added in 7.52.0 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH "SEE ALSO" .BR curl_easy_getinfo "(3), " curl_easy_setopt "(3), " .BR CURLINFO_SSL_VERIFYRESULT "(3), " docs/libcurl/opts/CURLOPT_PROXY_CAPATH.3 +7 −9 Original line number Diff line number Diff line Loading @@ -28,22 +28,20 @@ CURLOPT_PROXY_CAPATH \- specify directory holding proxy CA certificates CURLcode curl_easy_setopt(CURL *handle, CURLOPT_PROXY_CAPATH, char *capath); .SH DESCRIPTION TODO: Make this text specific to HTTPS proxy. (Added in 7.XXX) Pass a char * to a zero terminated string naming a directory holding multiple CA certificates to verify the peer with. If libcurl is built against OpenSSL, the certificate directory must be prepared using the openssl c_rehash utility. This makes sense only when used in combination with the \fICURLOPT_SSL_VERIFYPEER(3)\fP option. The \fICURLOPT_CAPATH(3)\fP function apparently does not work in Windows due to some limitation in openssl. CA certificates to verify the HTTPS proxy with. If libcurl is built against OpenSSL, the certificate directory must be prepared using the openssl c_rehash utility. This makes sense only when \fICURLOPT_SSL_VERIFYPEER(3)\fP is enabled (which it is by default). .SH DEFAULT NULL .SH PROTOCOLS All TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. Everything used over an HTTPS proxy .SH EXAMPLE TODO .SH AVAILABILITY Added in 7.52.0 This option is supported by the OpenSSL, GnuTLS and PolarSSL backends. The NSS backend provides the option only for backward compatibility. .SH RETURN VALUE Loading docs/libcurl/opts/CURLOPT_PROXY_SSLCERTTYPE.3 +10 −7 Original line number Diff line number Diff line Loading @@ -28,22 +28,25 @@ CURLOPT_PROXY_SSLCERTTYPE \- specify type of the proxy client SSL certificate CURLcode curl_easy_setopt(CURL *handle, CURLOPT_PROXY_SSLCERTTYPE, char *type); .SH DESCRIPTION TODO: Make this text specific to HTTPS proxy. (Added in 7.XXX) Pass a pointer to a zero terminated string as parameter. The string should be the format of your certificate. Supported formats are "PEM" and "DER", except with Secure Transport. OpenSSL (versions 0.9.3 and later) and Secure Transport (on iOS 5 or later, or OS X 10.7 or later) also support "P12" for PKCS#12-encoded files. the format of your client certificate used when connecting to a HTTPS proxy. Supported formats are "PEM" and "DER", except with Secure Transport. OpenSSL (versions 0.9.3 and later) and Secure Transport (on iOS 5 or later, or OS X 10.7 or later) also support "P12" for PKCS#12-encoded files. .SH DEFAULT "PEM" .SH PROTOCOLS All TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. All .SH EXAMPLE TODO .SH AVAILABILITY Added in 7.52.0 If built TLS enabled. .SH RETURN VALUE Returns CURLE_OK if TLS is supported, CURLE_UNKNOWN_OPTION if not, or CURLE_OUT_OF_MEMORY if there was insufficient heap space. .SH "SEE ALSO" .BR CURLOPT_SSLCERT "(3), " CURLOPT_SSLKEY "(3), " .BR CURLOPT_PROXY_SSLCERT "(3), " CURLOPT_PROXY_SSLKEY "(3), " .BR CURLOPT_SSLCERTTYPE "(3), " docs/libcurl/opts/CURLOPT_PROXY_SSLKEY.3 +7 −4 Original line number Diff line number Diff line Loading @@ -28,10 +28,10 @@ CURLOPT_PROXY_SSLKEY \- specify private keyfile for TLS and SSL proxy client cer CURLcode curl_easy_setopt(CURL *handle, CURLOPT_PROXY_SSLKEY, char *keyfile); .SH DESCRIPTION TODO: Make this text specific to HTTPS proxy. (Added in 7.XXX) Pass a pointer to a zero terminated string as parameter. The string should be the file name of your private key. The default format is "PEM" and can be changed with \fICURLOPT_SSLKEYTYPE(3)\fP. the file name of your private key used for connecting to the HTTPS proxy. The default format is "PEM" and can be changed with \fICURLOPT_PROXY_SSLKEYTYPE(3)\fP. (iOS and Mac OS X only) This option is ignored if curl was built against Secure Transport. Secure Transport expects the private key to be already Loading @@ -39,13 +39,16 @@ present in the keychain or PKCS#12 file containing the certificate. .SH DEFAULT NULL .SH PROTOCOLS All TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. All .SH EXAMPLE TODO .SH AVAILABILITY Added in 7.52.0 If built TLS enabled. .SH RETURN VALUE Returns CURLE_OK if TLS is supported, CURLE_UNKNOWN_OPTION if not, or CURLE_OUT_OF_MEMORY if there was insufficient heap space. .SH "SEE ALSO" .BR CURLOPT_PROXY_SSLKEYTYPE "(3), " CURLOPT_PROXY_SSLCERT "(3), " .BR CURLOPT_SSLKEYTYPE "(3), " CURLOPT_SSLCERT "(3), " docs/libcurl/opts/CURLOPT_PROXY_SSLVERSION.3 +11 −18 Original line number Diff line number Diff line Loading @@ -22,15 +22,14 @@ .\" .TH CURLOPT_PROXY_SSLVERSION 3 "16 Nov 2016" "libcurl 7.52.0" "curl_easy_setopt options" .SH NAME CURLOPT_PROXY_SSLVERSION \- set proxy preferred TLS/SSL version CURLOPT_PROXY_SSLVERSION \- set preferred proxy TLS/SSL version .SH SYNOPSIS #include <curl/curl.h> CURLcode curl_easy_setopt(CURL *handle, CURLOPT_PROXY_SSLVERSION, long version); .SH DESCRIPTION TODO: Make this text specific to HTTPS proxy. (Added in 7.XXX) Pass a long as parameter to control which version of SSL/TLS to attempt to use. Pass a long as parameter to control which version of SSL/TLS to attempt to use when connecting to an HTTPS proxy. Use one of the available defines for this purpose. The available options are: .RS Loading @@ -39,23 +38,19 @@ The default action. This will attempt to figure out the remote SSL protocol version. .IP CURL_SSLVERSION_TLSv1 TLSv1.x .IP CURL_SSLVERSION_SSLv2 SSLv2 .IP CURL_SSLVERSION_SSLv3 SSLv3 .IP CURL_SSLVERSION_TLSv1_0 TLSv1.0 (Added in 7.34.0) TLSv1.0 .IP CURL_SSLVERSION_TLSv1_1 TLSv1.1 (Added in 7.34.0) TLSv1.1 .IP CURL_SSLVERSION_TLSv1_2 TLSv1.2 (Added in 7.34.0) TLSv1.2 .IP CURL_SSLVERSION_TLSv1_3 TLSv1.3 (Added in 7.52.0) TLSv1.3 .RE .SH DEFAULT CURL_SSLVERSION_DEFAULT .SH PROTOCOLS All TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. All .SH EXAMPLE .nf CURL *curl = curl_easy_init(); Loading @@ -70,12 +65,10 @@ if(curl) { } .fi .SH AVAILABILITY SSLv2 is disabled by default since 7.18.1. Other SSL versions availability may vary depending on which backend libcurl has been built to use. SSLv3 is disabled by default since 7.39.0. Added in 7.52.0 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH "SEE ALSO" .BR CURLOPT_USE_SSL "(3), " CURLOPT_HTTP_VERSION "(3), " .BR CURLOPT_IPRESOLVE "(3) " .BR CURLOPT_IPRESOLVE "(3) " CURLOPT_SSLVERSION "(3), " Loading
docs/libcurl/opts/CURLINFO_PROXY_SSL_VERIFYRESULT.3 +6 −7 Original line number Diff line number Diff line Loading @@ -22,23 +22,22 @@ .\" .TH CURLINFO_PROXY_SSL_VERIFYRESULT 3 "16 Nov 2016" "libcurl 7.52.0" "curl_easy_getinfo options" .SH NAME CURLINFO_PROXY_SSL_VERIFYRESULT \- get the result of the proxy certification verification CURLINFO_PROXY_SSL_VERIFYRESULT \- get the result of the proxy certificate verification .SH SYNOPSIS #include <curl/curl.h> CURLcode curl_easy_getinfo(CURL *handle, CURLINFO_PROXY_SSL_VERIFYRESULT, long *result); .SH DESCRIPTION TODO: Make this text specific to HTTPS proxy. (Added in 7.XXX) Pass a pointer to a long to receive the result of the certification verification that was requested (using the \fICURLOPT_SSL_VERIFYPEER(3)\fP option. Pass a pointer to a long to receive the result of the certificate verification that was requested (using the \fICURLOPT_PROXY_SSL_VERIFYPEER(3)\fP option. .SH PROTOCOLS All using TLS All .SH EXAMPLE TODO .SH AVAILABILITY Added in 7.5 Added in 7.52.0 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH "SEE ALSO" .BR curl_easy_getinfo "(3), " curl_easy_setopt "(3), " .BR CURLINFO_SSL_VERIFYRESULT "(3), "
docs/libcurl/opts/CURLOPT_PROXY_CAPATH.3 +7 −9 Original line number Diff line number Diff line Loading @@ -28,22 +28,20 @@ CURLOPT_PROXY_CAPATH \- specify directory holding proxy CA certificates CURLcode curl_easy_setopt(CURL *handle, CURLOPT_PROXY_CAPATH, char *capath); .SH DESCRIPTION TODO: Make this text specific to HTTPS proxy. (Added in 7.XXX) Pass a char * to a zero terminated string naming a directory holding multiple CA certificates to verify the peer with. If libcurl is built against OpenSSL, the certificate directory must be prepared using the openssl c_rehash utility. This makes sense only when used in combination with the \fICURLOPT_SSL_VERIFYPEER(3)\fP option. The \fICURLOPT_CAPATH(3)\fP function apparently does not work in Windows due to some limitation in openssl. CA certificates to verify the HTTPS proxy with. If libcurl is built against OpenSSL, the certificate directory must be prepared using the openssl c_rehash utility. This makes sense only when \fICURLOPT_SSL_VERIFYPEER(3)\fP is enabled (which it is by default). .SH DEFAULT NULL .SH PROTOCOLS All TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. Everything used over an HTTPS proxy .SH EXAMPLE TODO .SH AVAILABILITY Added in 7.52.0 This option is supported by the OpenSSL, GnuTLS and PolarSSL backends. The NSS backend provides the option only for backward compatibility. .SH RETURN VALUE Loading
docs/libcurl/opts/CURLOPT_PROXY_SSLCERTTYPE.3 +10 −7 Original line number Diff line number Diff line Loading @@ -28,22 +28,25 @@ CURLOPT_PROXY_SSLCERTTYPE \- specify type of the proxy client SSL certificate CURLcode curl_easy_setopt(CURL *handle, CURLOPT_PROXY_SSLCERTTYPE, char *type); .SH DESCRIPTION TODO: Make this text specific to HTTPS proxy. (Added in 7.XXX) Pass a pointer to a zero terminated string as parameter. The string should be the format of your certificate. Supported formats are "PEM" and "DER", except with Secure Transport. OpenSSL (versions 0.9.3 and later) and Secure Transport (on iOS 5 or later, or OS X 10.7 or later) also support "P12" for PKCS#12-encoded files. the format of your client certificate used when connecting to a HTTPS proxy. Supported formats are "PEM" and "DER", except with Secure Transport. OpenSSL (versions 0.9.3 and later) and Secure Transport (on iOS 5 or later, or OS X 10.7 or later) also support "P12" for PKCS#12-encoded files. .SH DEFAULT "PEM" .SH PROTOCOLS All TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. All .SH EXAMPLE TODO .SH AVAILABILITY Added in 7.52.0 If built TLS enabled. .SH RETURN VALUE Returns CURLE_OK if TLS is supported, CURLE_UNKNOWN_OPTION if not, or CURLE_OUT_OF_MEMORY if there was insufficient heap space. .SH "SEE ALSO" .BR CURLOPT_SSLCERT "(3), " CURLOPT_SSLKEY "(3), " .BR CURLOPT_PROXY_SSLCERT "(3), " CURLOPT_PROXY_SSLKEY "(3), " .BR CURLOPT_SSLCERTTYPE "(3), "
docs/libcurl/opts/CURLOPT_PROXY_SSLKEY.3 +7 −4 Original line number Diff line number Diff line Loading @@ -28,10 +28,10 @@ CURLOPT_PROXY_SSLKEY \- specify private keyfile for TLS and SSL proxy client cer CURLcode curl_easy_setopt(CURL *handle, CURLOPT_PROXY_SSLKEY, char *keyfile); .SH DESCRIPTION TODO: Make this text specific to HTTPS proxy. (Added in 7.XXX) Pass a pointer to a zero terminated string as parameter. The string should be the file name of your private key. The default format is "PEM" and can be changed with \fICURLOPT_SSLKEYTYPE(3)\fP. the file name of your private key used for connecting to the HTTPS proxy. The default format is "PEM" and can be changed with \fICURLOPT_PROXY_SSLKEYTYPE(3)\fP. (iOS and Mac OS X only) This option is ignored if curl was built against Secure Transport. Secure Transport expects the private key to be already Loading @@ -39,13 +39,16 @@ present in the keychain or PKCS#12 file containing the certificate. .SH DEFAULT NULL .SH PROTOCOLS All TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. All .SH EXAMPLE TODO .SH AVAILABILITY Added in 7.52.0 If built TLS enabled. .SH RETURN VALUE Returns CURLE_OK if TLS is supported, CURLE_UNKNOWN_OPTION if not, or CURLE_OUT_OF_MEMORY if there was insufficient heap space. .SH "SEE ALSO" .BR CURLOPT_PROXY_SSLKEYTYPE "(3), " CURLOPT_PROXY_SSLCERT "(3), " .BR CURLOPT_SSLKEYTYPE "(3), " CURLOPT_SSLCERT "(3), "
docs/libcurl/opts/CURLOPT_PROXY_SSLVERSION.3 +11 −18 Original line number Diff line number Diff line Loading @@ -22,15 +22,14 @@ .\" .TH CURLOPT_PROXY_SSLVERSION 3 "16 Nov 2016" "libcurl 7.52.0" "curl_easy_setopt options" .SH NAME CURLOPT_PROXY_SSLVERSION \- set proxy preferred TLS/SSL version CURLOPT_PROXY_SSLVERSION \- set preferred proxy TLS/SSL version .SH SYNOPSIS #include <curl/curl.h> CURLcode curl_easy_setopt(CURL *handle, CURLOPT_PROXY_SSLVERSION, long version); .SH DESCRIPTION TODO: Make this text specific to HTTPS proxy. (Added in 7.XXX) Pass a long as parameter to control which version of SSL/TLS to attempt to use. Pass a long as parameter to control which version of SSL/TLS to attempt to use when connecting to an HTTPS proxy. Use one of the available defines for this purpose. The available options are: .RS Loading @@ -39,23 +38,19 @@ The default action. This will attempt to figure out the remote SSL protocol version. .IP CURL_SSLVERSION_TLSv1 TLSv1.x .IP CURL_SSLVERSION_SSLv2 SSLv2 .IP CURL_SSLVERSION_SSLv3 SSLv3 .IP CURL_SSLVERSION_TLSv1_0 TLSv1.0 (Added in 7.34.0) TLSv1.0 .IP CURL_SSLVERSION_TLSv1_1 TLSv1.1 (Added in 7.34.0) TLSv1.1 .IP CURL_SSLVERSION_TLSv1_2 TLSv1.2 (Added in 7.34.0) TLSv1.2 .IP CURL_SSLVERSION_TLSv1_3 TLSv1.3 (Added in 7.52.0) TLSv1.3 .RE .SH DEFAULT CURL_SSLVERSION_DEFAULT .SH PROTOCOLS All TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. All .SH EXAMPLE .nf CURL *curl = curl_easy_init(); Loading @@ -70,12 +65,10 @@ if(curl) { } .fi .SH AVAILABILITY SSLv2 is disabled by default since 7.18.1. Other SSL versions availability may vary depending on which backend libcurl has been built to use. SSLv3 is disabled by default since 7.39.0. Added in 7.52.0 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH "SEE ALSO" .BR CURLOPT_USE_SSL "(3), " CURLOPT_HTTP_VERSION "(3), " .BR CURLOPT_IPRESOLVE "(3) " .BR CURLOPT_IPRESOLVE "(3) " CURLOPT_SSLVERSION "(3), "
