table of contents
other versions
- buster-backports 7.74.0-1.2~bpo10+1
- testing 7.74.0-1.2
- unstable 7.74.0-1.3
CURLINFO_PROXY_ERROR(3) | curl_easy_getinfo options | CURLINFO_PROXY_ERROR(3) |
NAME¶
CURLINFO_PROXY_ERROR - get the detailed (SOCKS) proxy errorSYNOPSIS¶
#include <curl/curl.h> typedef enum { CURLPX_OK, CURLPX_BAD_ADDRESS_TYPE, CURLPX_BAD_VERSION, CURLPX_CLOSED, CURLPX_GSSAPI, CURLPX_GSSAPI_PERMSG, CURLPX_GSSAPI_PROTECTION, CURLPX_IDENTD, CURLPX_IDENTD_DIFFER, CURLPX_LONG_HOSTNAME, CURLPX_LONG_PASSWD, CURLPX_LONG_USER, CURLPX_NO_AUTH, CURLPX_RECV_ADDRESS, CURLPX_RECV_AUTH, CURLPX_RECV_CONNECT, CURLPX_RECV_REQACK, CURLPX_REPLY_ADDRESS_TYPE_NOT_SUPPORTED, CURLPX_REPLY_COMMAND_NOT_SUPPORTED, CURLPX_REPLY_CONNECTION_REFUSED, CURLPX_REPLY_GENERAL_SERVER_FAILURE, CURLPX_REPLY_HOST_UNREACHABLE, CURLPX_REPLY_NETWORK_UNREACHABLE, CURLPX_REPLY_NOT_ALLOWED, CURLPX_REPLY_TTL_EXPIRED, CURLPX_REPLY_UNASSIGNED, CURLPX_REQUEST_FAILED, CURLPX_RESOLVE_HOST, CURLPX_SEND_AUTH, CURLPX_SEND_CONNECT, CURLPX_SEND_REQUEST, CURLPX_UNKNOWN_FAIL, CURLPX_UNKNOWN_MODE, CURLPX_USER_REJECTED, CURLPX_LAST /* never use */ } CURLproxycode; CURLcode curl_easy_getinfo(CURL *handle, CURLINFO_PROXY_ERROR, long *detail);
DESCRIPTION¶
Pass a pointer to a long to receive a detailed error code when the most recent transfer returned a CURLE_PROXY error.The return value will match the CURLproxycode set.
The returned value will be zero (equal to CURLPX_OK) if no such response code was available.
PROTOCOLS¶
All that can be done over SOCKSEXAMPLE¶
CURL *curl = curl_easy_init(); if(curl) { CURLcode res; curl_easy_setopt(curl, CURLOPT_URL, "https://example.com"); curl_easy_setopt(curl, CURLOPT_PROXY, "socks5://127.0.0.1"); res = curl_easy_perform(curl); if(res == CURLE_PROXY) { long proxycode; res = curl_easy_getinfo(curl, CURLINFO_PROXY_ERROR, &proxycode); if(!res && proxycode) printf("The detailed proxy error: %ld\n", proxycode); } curl_easy_cleanup(curl); }
AVAILABILITY¶
Added in 7.73.0RETURN VALUE¶
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.SEE ALSO¶
CURLINFO_RESPONSE_CODE(3), libcurl-errors(3), curl_easy_getinfo(3), curl_easy_setopt(3),November 4, 2020 | libcurl 7.74.0 |