GNURLINFO_PROTOCOL(3)

📦 version 7.72.0, in nixos 26.05, nixpkgs unstable

💅 GNURLINFO_PROTOCOL(3) 💅

okay so this iconic page comes from the curl_easy_getinfo options manual, and it's here to explain CURLINFO_PROTOCOL to you, bestie. no cap, it's a tiny one. 🦋

✨ NAME ✨

CURLINFO_PROTOCOL — get the protocol used in the connection. that's the whole vibe. 💖

🎀 SYNOPSIS 🎀

#include <gnurl/curl.h>

CURLcode curl_easy_getinfo(CURL *handle, CURLINFO_PROTOCOL, long *p);

🌸 DESCRIPTION 🌸

okay so literally pass a pointer to a long, and it receives the version used in the last http connection. The returned value will be exactly one of the CURLPROTO_* values — no mixing, no guessing, periodt:

  • 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 — like, every protocol, bestie. 💅

🔥 EXAMPLE 🔥

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

⭐ AVAILABILITY ⭐

Added in 7.52.0. slay. 🫶

👑 RETURN VALUE 👑

Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. that's it. 💖

🌈 SEE ALSO 🌈

🫶 okay that's the whole page, bestie! it's from libcurl 7.52.0, dated 23 November 2016. mwah 💋
📦 where this page comes from