manpagez: man pages & more
man CURLOPT_CLOSESOCKETDATA(3)
Home | html | info | man
CURLOPT_CLOSESOCKETDATA(3)                            Library Functions Manual


NAME

       CURLOPT_CLOSESOCKETDATA - pointer passed to the socket close callback


SYNOPSIS

       #include <curl/curl.h>

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


DESCRIPTION

       Pass a pointer that remains untouched by libcurl and passed as the
       first argument in the closesocket callback set with
       CURLOPT_CLOSESOCKETFUNCTION(3).


DEFAULT

       NULL


PROTOCOLS

       This functionality affects all supported protocols


EXAMPLE

       struct priv {
         void *custom;
       };

       static int closesocket(void *clientp, curl_socket_t item)
       {
         struct priv *my = clientp;
         printf("our ptr: %p\n", my->custom);

         printf("libcurl wants to close %d now\n", (int)item);
         return 0;
       }

       int main(void)
       {
         struct priv myown;
         CURL *curl = curl_easy_init();

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

         curl_easy_perform(curl);
         curl_easy_cleanup(curl);
       }


AVAILABILITY

       Added in curl 7.21.7


RETURN VALUE

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


SEE ALSO

       CURLOPT_CLOSESOCKETFUNCTION(3), CURLOPT_OPENSOCKETFUNCTION(3)

libcurl                           2024-08-05        CURLOPT_CLOSESOCKETDATA(3)

curl 8.9.1 - Generated Tue Aug 13 18:56:48 CDT 2024
© manpagez.com 2000-2024
Individual documents may contain additional copyright information.