Go to main content

man pages section 3: Library Interfaces and Headers

Exit Print View

Updated: Wednesday, July 27, 2022
 
 

curl_global_cleanup (3)

Name

curl_global_cleanup - global libcurl cleanup

Synopsis

#include <curl/curl.h>

void curl_global_cleanup(void);

Description

curl_global_cleanup(3)          libcurl Manual          curl_global_cleanup(3)



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 not thread safe. You must not call it when  any  other
       thread  in  the program (i.e. a thread sharing the same memory) is run-
       ning.  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 corrup-
       tion 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.

EXAMPLE
        curl_global_init(CURL_GLOBAL_DEFAULT);

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

        curl_global_cleanup();

AVAILABILITY
       Added in 7.8

RETURN VALUE
       None


ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:


       +---------------+------------------+
       |ATTRIBUTE TYPE | ATTRIBUTE VALUE  |
       +---------------+------------------+
       |Availability   | web/curl         |
       +---------------+------------------+
       |Stability      | Uncommitted      |
       +---------------+------------------+

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



NOTES
       Source code for open source software components in Oracle  Solaris  can
       be found at https://www.oracle.com/downloads/opensource/solaris-source-
       code-downloads.html.

       This    software    was    built    from    source     available     at
       https://github.com/oracle/solaris-userland.    The  original  community
       source      was      downloaded       from        https://curl.se/down-
       load/curl-7.83.1.tar.bz2.

       Further information about this software can be found on the open source
       community website at http://curl.haxx.se/.



libcurl 7.83.1                 November 26, 2021        curl_global_cleanup(3)