CURLINFO_HTTP_CONNECTCODE(3)

CURLINFO_HTTP_CONNECTCODE3

Get the connect response code

Usage

#include <curl/curl.h>
CURLcode curl_easy_getinfo(CURL *handle, CURLINFO_HTTP_CONNECTCODE, long *p);

Overview

Pass a pointer to a long to receive the last received HTTP proxy response code to a CONNECT request. The returned value is zero if no such response code was available.

Protocols

HTTP

Examples

int main(void)
{
  CURL *curl = curl_easy_init();
  if(curl) {
    CURLcode res;
    curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
    /* typically CONNECT is used to do HTTPS over HTTP proxies */
    curl_easy_setopt(curl, CURLOPT_PROXY, "http://127.0.0.1");
    res = curl_easy_perform(curl);
    if(res == CURLE_OK) {
      long code;
      res = curl_easy_getinfo(curl, CURLINFO_HTTP_CONNECTCODE, &code);
      if(!res && code)
        printf("The CONNECT response code: %03ld\n", code);
    }
    curl_easy_cleanup(curl);
  }
}

Return value

Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.

Releases

66 releases since macOS 10.12; the text changed 12 times.

  1. 10.12–10.12.5
  2. 10.12.6–10.14.6
  3. 10.15–11.5
  4. 12.0.1–12.2
  5. 12.3–12.5
  6. 13.0
  7. 13.1
  8. 13.2
  9. 13.3
  10. 13.4
  11. 13.5–14.1
  12. 14.2–14.4
  13. 14.5–26.5

Availability

Added in 7.10.7

From curl 166.0.0.0.1 in macOS 26.5. Parsed by carta from the page's man source.