NAME

       curl_global_cleanup - global libcurl cleanup

SYNOPSIS

       #include <curl/curl.h>

       void curl_global_cleanup(void);

DESCRIPTION

       This function releases resources acquired by curl_global_init(3).

       You should call curl_global_cleanup(3) once for each call you make to curl_global_init(3),
       after you are done using libcurl.

       This function  is  thread-safe  since  libcurl  7.84.0  if  curl_version_info(3)  has  the
       CURL_VERSION_THREADSAFE feature bit set (most platforms).

       If  this  is not thread-safe, you must not call this function when any other thread in the
       program (i.e. a thread sharing the same memory) is running.  This does not  just  mean  no
       other  thread  that  is  using  libcurl. Because curl_global_cleanup(3) calls functions of
       other libraries that are similarly thread unsafe, it could conflict with any other  thread
       that uses these other libraries.

       See the description in libcurl(3) of global environment requirements for details of how to
       use this function.

CAUTION

       curl_global_cleanup(3) does not block waiting for any libcurl-created threads to terminate
       (such  as  threads used for name resolving). If a module containing libcurl is dynamically
       unloaded while libcurl-created threads are still running then your program  may  crash  or
       other  corruption  may occur. We recommend you do not run libcurl from any module that may
       be unloaded dynamically. This behavior may be addressed in the future.

       libcurl may not be able to fully clean up after multi-threaded OpenSSL  depending  on  how
       OpenSSL  was  built  and  loaded as a library. It is possible in some rare circumstances a
       memory leak could occur unless you implement your own OpenSSL  thread  cleanup.  Refer  to
       libcurl-thread(3).

PROTOCOLS

       This functionality affects all supported protocols

EXAMPLE

       int main(void)
       {
         curl_global_init(CURL_GLOBAL_DEFAULT);

         /* use libcurl, then before exiting... */

         curl_global_cleanup();
       }

AVAILABILITY

       Added in curl 7.8

RETURN VALUE

       None

SEE ALSO

       curl_global_init(3), libcurl(3), libcurl-thread(3)