GNURLOPT_CLOSESOCKETDATA(3)

💖 GNURLOPT_CLOSESOCKETDATA(3) 💖

okay so bestie, welcome to this page from the curl_easy_setopt options manual — we're talking about CURLOPT_CLOSESOCKETDATA, and it's lowkey a tiny little handoff situation 💅✨

🌸 NAME 🌸

CURLOPT_CLOSESOCKETDATA — pointer passed to the socket close callback 🫶

🎀 SYNOPSIS 🎀

#include <gnurl/curl.h>

CURLcode curl_easy_setopt(CURL *handle, CURLOPT_CLOSESOCKETDATA, void
*pointer);

✨ DESCRIPTION ✨

You pass in a pointer, and libcurl literally leaves it untouched — no peeking, no vibes-checking, nothing. It just gets passed along as the first argument in the closesocket callback that you set with CURLOPT_CLOSESOCKETFUNCTION(3) 💖

Think of it as the little bag you hand over and say “hold this for me,” except libcurl is a very polite bestie and does not open it 🎀

🦋 DEFAULT 🦋

The default value of this parameter is NULL. periodt 💀

🌈 PROTOCOLS 🌈

All except file: — no cap, that's the whole list 🧚

💜 EXAMPLE 💜

static int closesocket(void *clientp, curl_socket_t item)
{
  printf("libcurl wants to close %d now\n", (int)item);
  return 0;
}

/* call this function to close sockets */
curl_easy_setopt(curl, CURLOPT_CLOSESOCKETFUNCTION, closesocket);
curl_easy_setopt(curl, CURLOPT_CLOSESOCKETDATA, &sockfd);

⭐ AVAILABILITY ⭐

Added in 7.21.7 — iconic behavior since way back 👑

🔥 RETURN VALUE 🔥

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

👀 SEE ALSO 👀

• CURLOPT_CLOSESOCKETFUNCTION(3), CURLOPT_OPENSOCKETFUNCTION(3), — the whole squad, iykyk 🫶

---

okay that's the whole vibe, bestie — this page is from libcurl 7.37.0, dated 16 Jun 2014, signed off as GNURLOPT_CLOSESOCKETDATA(3) 💖✨🎀