2002-03-04 05:09:48 -05:00
|
|
|
.\" You can view this file with:
|
|
|
|
|
.\" nroff -man [file]
|
|
|
|
|
.\" $Id$
|
|
|
|
|
.\"
|
2004-05-11 07:30:23 -04:00
|
|
|
.TH curl_global_init 3 "11 May 2004" "libcurl 7.12" "libcurl Manual"
|
2002-03-04 05:09:48 -05:00
|
|
|
.SH NAME
|
|
|
|
|
curl_global_init - Global libcurl initialisation
|
|
|
|
|
.SH SYNOPSIS
|
|
|
|
|
.B #include <curl/curl.h>
|
|
|
|
|
.sp
|
|
|
|
|
.BI "CURLcode curl_global_init(long " flags ");"
|
|
|
|
|
.ad
|
|
|
|
|
.SH DESCRIPTION
|
2006-01-15 18:55:53 -05:00
|
|
|
This function sets up the program environment that libcurl needs. Think
|
|
|
|
|
of it as an extension of the library loader.
|
2002-03-04 05:09:48 -05:00
|
|
|
|
2006-01-15 18:55:53 -05:00
|
|
|
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 program and is the same for every program, so multiple calls have
|
|
|
|
|
the same effect as one call.
|
2002-03-04 05:09:48 -05:00
|
|
|
|
2006-01-15 18:55:53 -05:00
|
|
|
The flags option is a bit pattern that tells libcurl exactly what features to
|
2002-03-04 05:09:48 -05:00
|
|
|
init, as described below. Set the desired bits by ORing the values together.
|
2006-01-15 18:55:53 -05:00
|
|
|
In normal operation, you must specify CURL_GLOBAL_ALL. Don't use any other
|
|
|
|
|
value unless you are familiar with and mean to control internal operations
|
|
|
|
|
of libcurl.
|
2002-03-04 05:09:48 -05:00
|
|
|
|
2006-01-15 18:55:53 -05:00
|
|
|
\fBThis function is not thread safe.\fP 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 \fIcurl_global_init()\fP 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 \fBlibcurl\fP(3) of global environment
|
|
|
|
|
requirements for details of how to use this function.
|
2002-03-04 05:09:48 -05:00
|
|
|
|
|
|
|
|
.SH FLAGS
|
|
|
|
|
.TP 5
|
|
|
|
|
.B CURL_GLOBAL_ALL
|
|
|
|
|
Initialize everything possible. This sets all known bits.
|
|
|
|
|
.TP
|
|
|
|
|
.B CURL_GLOBAL_SSL
|
|
|
|
|
Initialize SSL
|
|
|
|
|
.TP
|
|
|
|
|
.B CURL_GLOBAL_WIN32
|
2004-02-27 10:34:06 -05:00
|
|
|
Initialize the Win32 socket libraries.
|
2002-03-04 05:09:48 -05:00
|
|
|
.TP
|
|
|
|
|
.B CURL_GLOBAL_NOTHING
|
|
|
|
|
Initialise nothing extra. This sets no bit.
|
|
|
|
|
.SH RETURN VALUE
|
|
|
|
|
If this function returns non-zero, something went wrong and you cannot use the
|
|
|
|
|
other curl functions.
|
|
|
|
|
.SH "SEE ALSO"
|
2004-05-11 07:30:23 -04:00
|
|
|
.BR curl_global_init_mem "(3), "
|
2002-03-04 05:09:48 -05:00
|
|
|
.BR curl_global_cleanup "(3), "
|
2006-01-15 18:55:53 -05:00
|
|
|
.BR curl_easy_init "(3) "
|
|
|
|
|
.BR libcurl "(3) "
|
