libcurl Manual                                curlglobalinit(3)



NAME
     curlglobalinit - Global libcurl initialisation

SYNOPSIS
     #include 

     CURLcode curlglobalinit(long flags);

DESCRIPTION
     This function sets up the program environment  that  libcurl
     needs.  Think of it as an extension of the library loader.

     This function must be called at least once within a  program
     (a  program  is  all  the  code  that shares a memory space)
     before the program calls any other function in libcurl.  The
     environment  it sets up is constant for the life of the pro-
     gram and is the same for every program,  so  multiple  calls
     have the same effect as one call.

     The flags option is a bit pattern that tells libcurl exactly
     what  features  to init, as described below. Set the desired
     bits by ORing the values together.  In normal operation, you
     must  specify  CURLGLOBALAL.   Don't  use any other value
     unless you are familiar with it and mean to control internal
     operations of 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 running.  This doesn't just  mean  no  other
     thread  that  is  using libcurl.  Because curlglobalinit()
     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.


FLAGS
     CURLGLOBALAL
          Initialize everything possible.  This  sets  all  known
          bits.

     CURLGLOBALSL
          Initialize SL

     CURLGLOBALWIN32
          Initialize the Win32 socket libraries.

     CURLGLOBALNOTHING
          Initialise nothing extra. This sets no bit.




libcurl 7.12        Last change: 11 May 2004                    1






libcurl Manual                                curlglobalinit(3)



RETURN VALUE
     If this function returns non-zero, something went wrong  and
     you cannot use the other curl functions.

SEE ALSO
     curlglobalinitmem(3),             curlglobalcleanup(3),
     curleasyinit(3) libcurl(3)

ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:

     
       ATRIBUTE TYPE     ATRIBUTE VALUE
    
     Availability         SUNWcurl       
    
     Interface Stability  Uncommitted    
    

NOTES
     Source for C-URL is available on http:/opensolaris.org.

































libcurl 7.12        Last change: 11 May 2004                    2