Query: curlopt_httpproxytunnel
OS: mojave
Section: 3
Format: Original Unix Latex Style Formatted with HTML and a Horizontal Scroll Bar
CURLOPT_HTTPPROXYTUNNEL(3) curl_easy_setopt options CURLOPT_HTTPPROXYTUNNEL(3)NAMECURLOPT_HTTPPROXYTUNNEL - tunnel through HTTP proxySYNOPSIS#include <curl/curl.h> CURLcode curl_easy_setopt(CURL *handle, CURLOPT_HTTPPROXYTUNNEL, long tunnel);DESCRIPTIONSet the parameter to 1 to make libcurl tunnel all operations through the HTTP proxy. There is a big difference between using a proxy and to tunnel through it. If you don't know what this means, you probably don't want this tunneling option. Tunneling essentially means that a CONNECT is sent to the proxy, asking it to connect to a remote host on a specific port number and then the traffic is just passed through the proxy. Proxies tend to whitelist specific port numbers it allows CONNECT requests to and often only port 80 and 443 are allowed. When using this, it only makes sense to use CURLOPT_PROXYTYPE(3) set to a HTTP proxy. To suppress proxy CONNECT response headers from user callbacks use CURLOPT_SUPPRESS_CONNECT_HEADERS(3).DEFAULT0PROTOCOLSAll network protocolsEXAMPLETODOAVAILABILITYAlwaysRETURN VALUEReturns CURLE_OKSEE ALSOCURLOPT_PROXY(3), CURLOPT_PROXYTYPE(3), CURLOPT_PROXYPORT(3), libcurl 7.54.0 April 28, 2016 CURLOPT_HTTPPROXYTUNNEL(3)