CURLINFO_PROTOCOL(3)

CURLINFO_PROTOCOL3

Get the protocol used in the connection

Usage

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

Overview

This option is deprecated. We strongly recommend using CURLINFO_SCHEME(3) instead, because this option cannot return all possible protocols!

Pass a pointer to a long to receive the version used in the last http connection. The returned value is set to one of the CURLPROTO_* values:

CURLPROTO_DICT, CURLPROTO_FILE, CURLPROTO_FTP, CURLPROTO_FTPS,
CURLPROTO_GOPHER, CURLPROTO_HTTP, CURLPROTO_HTTPS, CURLPROTO_IMAP,
CURLPROTO_IMAPS, CURLPROTO_LDAP, CURLPROTO_LDAPS, CURLPROTO_POP3,
CURLPROTO_POP3S, CURLPROTO_RTMP, CURLPROTO_RTMPE, CURLPROTO_RTMPS,
CURLPROTO_RTMPT, CURLPROTO_RTMPTE, CURLPROTO_RTMPTS, CURLPROTO_RTSP,
CURLPROTO_SCP, CURLPROTO_SFTP, CURLPROTO_SMB, CURLPROTO_SMBS, CURLPROTO_SMTP,
CURLPROTO_SMTPS, CURLPROTO_TELNET, CURLPROTO_TFTP, CURLPROTO_MQTT

Protocols

All

Examples

int main(void)
{
  CURL *curl = curl_easy_init();
  if(curl) {
    CURLcode res;
    curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
    res = curl_easy_perform(curl);
    if(res == CURLE_OK) {
      long protocol;
      curl_easy_getinfo(curl, CURLINFO_PROTOCOL, &protocol);
    }
    curl_easy_cleanup(curl);
  }
}

Return value

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

Releases

60 releases since macOS 10.12.6; the text changed 11 times.

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

Availability

Added in 7.52.0. Deprecated since 7.85.0.

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