GNURLOPT_S...ONID_CACHE(3)

🌸 NAME 🌸

okay so this is the gnurl manual page named GNURLOPT_S...ONID_CACHE(3) — that's the manual name folded in right here, bestie 🎀 — from the curl_easy_setopt options manual. It's about CURLOPT_SSL_SESSIONID_CACHE: the enable/disable switch for use of the SSL session-ID cache. iconic. 💅

---

✨ SYNOPSIS ✨

#include <gnurl/curl.h>

CURLcode curl_easy_setopt(CURL *handle, CURLOPT_SSL_SESSIONID_CACHE,
                                long enabled);

🫶 DESCRIPTION 🫶

okay so you pass a long, and the vibe check is simple: set it to 0 to disable libcurl's use of SSL session-ID caching. Set it to 1 to enable it. By default, all transfers are done using the cache enabled — so it's on unless you say otherwise. ✨

the tea is that, while nothing ever should get hurt by attempting to reuse SSL session-IDs, there seem to be (or have been) broken SSL implementations in the wild that may require you to disable this in order for you to succeed. no cap. 😭

🎀 DEFAULT 🎀

• 1 — yep, cache is on by default. periodt.

🌈 PROTOCOLS 🌈

• All TLS-based — that's the whole protocol roster, bestie. 🦋

🦋 EXAMPLE 🦋

here's the example, code kept exactly as it is because code is sacred:

CURL *curl = curl_easy_init();
if(curl) {
  curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
  /* switch off session-id use! */
  curl_easy_setopt(curl, CURLOPT_SSL_SESSIONID_CACHE, 0L);
  ret = curl_easy_perform(curl);
  curl_easy_cleanup(curl);
}

👑 AVAILABILITY 👑

• Added in 7.16.0 — that's when this lil icon entered the chat. 👑

⭐ RETURN VALUE ⭐

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

💖 SEE ALSO 💖

• CURLOPT_DNS_CACHE_TIMEOUT(3), CURLOPT_SSLVERSION(3),

(that trailing comma is literally part of the original list, iykyk 💅)

---

xoxo bestie 🫶 this page is from libcurl 7.37.0, dated 19 Jun 2014, and it's the GNURLOPT_S...ONID_CACHE(3) manual. periodt. 💅✨