GNURLOPT_C...ETFUNCTION(3)

📦 version 7.72.0, in nixos 26.05, nixpkgs unstable

💖 NAME 💖 — GNURLOPT_C...ETFUNCTION(3) from the curl_easy_setopt options manual 💖

okay so bestie, this whole page is about CURLOPT_CLOSESOCKETFUNCTION — a callback to socket close replacement function. yes, that's the vibe. 🫶

✨ SYNOPSIS ✨

like, here's the exact shape of it, no cap:

#include <gnurl/curl.h>

int closesocket_callback(void *clientp, curl_socket_t item);

CURLcode curl_easy_setopt(CURL *handle, CURLOPT_CLOSESOCKETFUNCTION,
closesocket_callback);

🦋 DESCRIPTION 🦋

Pass a pointer to your callback function — it should match the prototype shown above, bestie. 💅

This callback function gets called by libcurl instead of the close(3) or closesocket(3) call when sockets are closed. and this is literally not for any other file descriptors, okay? It's pretty much the reverse to the CURLOPT_OPENSOCKETFUNCTION(3) option. Return 0 to signal success and 1 if there was an error. 🔥

The clientp pointer is set with CURLOPT_CLOSESOCKETDATA(3). item is the socket libcurl wants to be closed. 🎀

🌸 DEFAULT 🌸

By default libcurl uses the standard socket close function. classic default behavior, lowkey iconic. ✨

🌈 PROTOCOLS 🌈

All — periodt. 💜

🍓 EXAMPLE 🍓

here's the example in all its main-character glory:

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. 💫

👑 RETURN VALUE 👑

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

🧚 SEE ALSO 🧚

(yes, that trailing comma on the second one is giving original paperwork energy, and we kept it 😭)

cute lil sign-off: this page says libcurl 7.37.0 and 16 Jun 2014 at the bottom, so mwah 💋 — that's the source/version and date, bestie. 🎀

📦 where this page comes from