GNURLOPT_S...GSSAPI_NEC(3)

📦 version 7.72.0, in nixos 26.05, nixpkgs unstable

🎀 GNURLOPT_S...GSSAPI_NEC(3) 🎀

okay so bestie, this iconic little page is GNURLOPT_S...GSSAPI_NEC(3) from the curl_easy_setopt options manual — yes, the title is a whole keyboard smash, but the vibe is clear: we’re talking about a SOCKS proxy GSSAPI negotiation protection setting. no cap. 🫶

✨ NAME ✨

CURLOPT_SOCKS5_GSSAPI_NEC — set socks proxy gssapi negotiation protection. that’s the name, lowercase “socks proxy gssapi negotiation protection” and all. slay. 💅

🌸 SYNOPSIS 🌸

#include <gnurl/curl.h>

CURLcode curl_easy_setopt(CURL *handle, CURLOPT_SOCKS5_GSSAPI_NEC, long
nec);

💅 DESCRIPTION 💅

  • CURLOPT_SOCKS5_GSSAPI_NEC — pass a long set to 1 to enable or 0 to disable. periodt.

As part of the gssapi negotiation a protection mode is negotiated. RFC1961 says in section 4.3/4.4 it should be protected, but the NEC reference implementation does not. If enabled, this option allows the unprotected exchange of the protection mode negotiation. that’s the important lore, bestie — don’t lose it. 😭

🦋 DEFAULT 🦋

?

that’s it. literally a question mark in the manual. we are not making up a default. no cap. 🙈

🌈 PROTOCOLS 🌈

Most.

👑 EXAMPLE 👑

CURL *curl = curl_easy_init();
if(curl) {
  curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
  curl_easy_setopt(curl, CURLOPT_PROXY, "socks5://proxy");
  curl_easy_setopt(curl, CURLOPT_SOCKS5_GSSAPI_NEC, 1L);
  ret = curl_easy_perform(curl);
  curl_easy_cleanup(curl);
}

here’s the example exactly as the page gives it, bestie. 🍓

⭐ AVAILABILITY ⭐

Added in 7.19.4. iconic. ✨

💜 RETURN VALUE 💜

Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. that’s the whole return-value tea. 💀

🌸 SEE ALSO 🌸

and yes, the original list is exactly CURLOPT_SOCKS5_GSSAPI_SERVICE(3), CURLOPT_PROXY(3), — trailing comma included, we don’t make the rules. 💅

💖 cute sign-off, bestie: this page comes from source/version libcurl 7.37.0 and is dated 19 Jun 2014. mwah. 💖

📦 where this page comes from