curl_easy_reset(3)

💅 curl_easy_reset(3) — your fave libcurl glow-up reset button ✨

okay so bestie, this little gem lives in the Library Functions Manual (very official, very demure) and honestly it's giving "factory reset but make it cute" 🎀

---

✨ NAME ✨

curl_easy_reset — resets, like, every single option on a libcurl session handle. yes. all of them. 🧹

---

🌸 SYNOPSIS 🌸

#include <curl/curl.h>

void curl_easy_reset(CURL *handle);

---

🦋 DESCRIPTION 🦋

So here's the tea ☕ — curl_easy_reset re-initializes all the options you previously set on a specified curl handle back to their default values. It literally puts the handle back into the exact same state it was in when it was freshly created with curl_easy_init(3). brand new. no cap. 💫

But wait — it does NOT change the following info that's still vibing inside the handle:

• live connections 🔌
• the Session ID cache
• the DNS cache
• the cookies 🍪
• the shares
• the alt-svc cache

so like, it's a reset but it's not a reset reset, yk? the handle keeps its whole social life, it just forgets its preferences 🙈

---

🌈 PROTOCOLS 🌈

This functionality affects all supported protocols — every single one, no gatekeeping, periodt 👑

---

🎀 EXAMPLE 🎀

int main(void)
{
  CURL *curl = curl_easy_init();
  if(curl) {

    /* ... the handle is used and options are set ... */
    curl_easy_reset(curl);
  }
}

look at that little main character handle getting its options set and then getting reset 😌 iconic behavior honestly

---

⭐ AVAILABILITY ⭐

Added in curl 7.12.1 — so it's been serving looks since way back 🫶

---

💜 RETURN VALUE 💜

Nothing. it returns void, it does not return a value, it is unbothered, it is at peace 🧘‍♀️

fr fr do not try to assign its return value to anything, there is literally nothing there 💀

---

🔥 SEE ALSO 🔥

• curl_easy_cleanup(3)
• curl_easy_duphandle(3)
• curl_easy_init(3)
• curl_easy_setopt(3)

---

and that's the whole page bestie!! ✨

this masterpiece was brought to you by libcurl, dated 2026-10-12, in the curl_easy_reset(3) era — mwah, love u, go reset something 💋💅