CURLOPT_SUPPRESS_CONNECT_HEADERS - suppress proxy CONNECT response headers from user callbacks
#include <curl/curl.h> CURLcode curl_easy_setopt(CURL *handle, CURLOPT_SUPPRESS_CONNECT_HEADERS, long onoff);
curl_easy_setopt options CURLOPT_SUPPRESS_CONNECT_HEADERS(3) NAME CURLOPT_SUPPRESS_CONNECT_HEADERS - suppress proxy CONNECT response headers from user callbacks SYNOPSIS #include <curl/curl.h> CURLcode curl_easy_setopt(CURL *handle, CURLOPT_SUPPRESS_CONNECT_HEADERS, long onoff); DESCRIPTION When CURLOPT_HTTPPROXYTUNNEL(3) is used and a CONNECT request is made, suppress proxy CONNECT response headers from the user callback func- tions CURLOPT_HEADERFUNCTION(3) and CURLOPT_WRITEFUNCTION(3). Proxy CONNECT response headers can complicate header processing since it's essentially a separate set of headers. You can enable this option to suppress those headers. For example let's assume an HTTPS URL is to be retrieved via CONNECT. On success there would normally be two sets of headers, and each header line sent to the header function and/or the write function. The data given to the callbacks would look like this: HTTP/1.1 200 Connection established {headers}... HTTP/1.1 200 OK Content-Type: application/json {headers}... {body}... However by enabling this option the CONNECT response headers are sup- pressed, so the data given to the callbacks would look like this: HTTP/1.1 200 OK Content-Type: application/json {headers}... {body}... DEFAULT 0 PROTOCOLS All EXAMPLE CURL *curl = curl_easy_init(); if(curl) { curl_easy_setopt(curl, CURLOPT_URL, "https://example.com"); curl_easy_setopt(curl, CURLOPT_HEADER, 1L); curl_easy_setopt(curl, CURLOPT_PROXY, "http://foo:3128"); curl_easy_setopt(curl, CURLOPT_HTTPPROXYTUNNEL, 1L); curl_easy_setopt(curl, CURLOPT_SUPPRESS_CONNECT_HEADERS, 1L); curl_easy_perform(curl); /* always cleanup */ curl_easy_cleanup(curl); } AVAILABILITY Added in 7.54.0 RETURN VALUE CURLE_OK or an error such as CURLE_UNKNOWN_OPTION. ATTRIBUTES See attributes(7) for descriptions of the following attributes: +---------------+------------------+ |ATTRIBUTE TYPE | ATTRIBUTE VALUE | +---------------+------------------+ |Availability | web/curl | +---------------+------------------+ |Stability | Uncommitted | +---------------+------------------+ SEE ALSO CURLOPT_HEADER(3), CURLOPT_PROXY(3), CURLOPT_HTTPPROXYTUNNEL(3), NOTES Source code for open source software components in Oracle Solaris can be found at https://www.oracle.com/downloads/opensource/solaris-source- code-downloads.html. This software was built from source available at https://github.com/oracle/solaris-userland. The original community source was downloaded from https://curl.se/down- load/curl-7.83.1.tar.bz2. Further information about this software can be found on the open source community website at http://curl.haxx.se/. libcurl 7.83.1 September 08, 2021 CURLOPT_SUPPRESS_CONNECT_HEADERS(3)