CURLOPT_FORBID_REUSE(3)

💅 NAME

okay bestie, you're reading CURLOPT_FORBID_REUSE(3) from the Library Functions Manual 💖 — the curl option that makes a connection get closed at once after use. periodt.

✨ SYNOPSIS ✨

#include <curl/curl.h>

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

🦋 DESCRIPTION 🦋

Pass a long, bestie. Set close to 1 to make libcurl explicitly close the connection when done with the transfer. Normally, libcurl keeps all connections alive when done with one transfer in case a succeeding one follows that can reuse them.

⚠️ This option should be used with caution and only if you understand what it does as it can seriously impact performance. like, fr fr, do not just vibe-set this without knowing.

Set to 0 to have libcurl keep the connection open for possible later reuse (default behavior).

🎀 DEFAULT 🎀

0

🌈 PROTOCOLS 🌈

This functionality affects all supported protocols ⭐

🔥 EXAMPLE 🔥

int main(void)
{
  CURL *curl = curl_easy_init();
  if(curl) {
    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);

    curl_easy_cleanup(curl);
  }
}

🫶 AVAILABILITY 🫶

Added in curl 7.7

💜 RETURN VALUE 💜

curl_easy_setopt(3) returns a CURLcode indicating success or error.

CURLE_OK (0) means everything was OK, non-zero means an error occurred, see libcurl-errors(3).

👑 SEE ALSO 👑

• CURLMOPT_NETWORK_CHANGED(3)
• CURLOPT_FRESH_CONNECT(3)
• CURLOPT_MAXCONNECTS(3)
• CURLOPT_MAXLIFETIME_CONN(3)

---

mwah 💋 this iconic CURLOPT_FORBID_REUSE(3) page is brought to you by libcurl, dated 2026-10-12 — go forth and reuse connections responsibly… or don't, if you set close to 1 🧚‍♀️✨