GNURLOPT_FORBID_REUSE(3)

🌸 GNURLOPT_FORBID_REUSE(3) 🌸

okay bestie, welcome to the curl_easy_setopt options corner — this page is GNURLOPT_FORBID_REUSE(3), and the whole vibe is “close that connection at once after use.” 💅 no cap.

---

💖 NAME 💖

CURLOPT_FORBID_REUSE — make connection get closed at once after use.

✨ SYNOPSIS ✨

#include <gnurl/curl.h>

CURLcode curl_easy_setopt(CURL *handle, CURLOPT_FORBID_REUSE, long
close);

🦋 DESCRIPTION 🦋

okay so first thing: pass a long. Set close to 1 and libcurl will explicitly close the connection when it’s done with the transfer. Normally, libcurl keeps all connections alive when it’s done with one transfer, in case a succeeding one follows that can re-use them. 👀

⚠️ real talk: this option should be used with caution and only if you understand what it does — it can seriously impact performance. Don’t just flip it on for funsies, bestie.

Set it to 0 and libcurl keeps the connection open for possible later re-use — that’s the default behavior. 💖

🎀 DEFAULT 🎀

0 — the default is literally keep the connection open for possible later re-use.

🌈 PROTOCOLS 🌈

Most — that’s it, that’s the protocol note. periodt.

🔥 EXAMPLE 🔥

here’s the exact code vibe, no cap:

{
  curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
  curl_easy_setopt(curl, CURLOPT_FORBID_REUSE, 1L);
  curl_easy_perform(curl);

  /* this second transfer may not reuse the same connection */
  curl_easy_perform(curl);
}

⭐ AVAILABILITY ⭐

Always — she’s always available. ✨

💜 RETURN VALUE 💜

Returns CURLE_OK — that’s the whole note.

🫶 SEE ALSO 🫶

go sip these cross-references, iykyk:

• CURLOPT_FRESH_CONNECT(3)
• CURLOPT_MAXCONNECTS(3)

---

xoxo, your Unix bestie 💅 — this page is from libcurl 7.37.0, dated 17 Jun 2014, and its manual name is GNURLOPT_FORBID_REUSE(3). 🎀