2001-05-28 16:11:02 +02:00
|
|
|
.\" You can view this file with:
|
|
|
|
.\" nroff -man [file]
|
2001-05-31 10:35:26 +02:00
|
|
|
.\" $Id$
|
2001-05-28 16:11:02 +02:00
|
|
|
.\"
|
2001-05-31 10:35:26 +02:00
|
|
|
.TH curl_global_init 3 "31 May 2001" "libcurl 7.8" "libcurl Manual"
|
2001-05-28 16:11:02 +02:00
|
|
|
.SH NAME
|
|
|
|
curl_global_init - Global libcurl initialisation
|
|
|
|
.SH SYNOPSIS
|
|
|
|
.B #include <curl/curl.h>
|
|
|
|
.sp
|
2001-05-29 10:27:43 +02:00
|
|
|
.BI "CURLcode curl_global_init(long " flags ");"
|
2001-05-28 16:11:02 +02:00
|
|
|
.ad
|
|
|
|
.SH DESCRIPTION
|
|
|
|
This function should be called once (no matter how many threads or libcurl
|
|
|
|
sessions that'll be used) by every application that uses libcurl.
|
|
|
|
|
|
|
|
If this function hasn't been invoked when \fIcurl_easy_init\fP is called, it
|
|
|
|
will be done automatically by libcurl.
|
|
|
|
|
2001-05-31 10:35:26 +02:00
|
|
|
The flags option is a bit pattern that tells libcurl exact what features to
|
|
|
|
init, as described below. Set the desired bits by ORing the values together.
|
2001-05-28 17:30:38 +02:00
|
|
|
|
2001-05-28 16:11:02 +02:00
|
|
|
You must however \fBalways\fP use the \fIcurl_global_cleanup\fP function, as
|
|
|
|
that cannot be called automatically for you by libcurl.
|
2001-05-29 10:27:43 +02:00
|
|
|
|
|
|
|
This function was added in libcurl 7.8.
|
2001-05-31 10:35:26 +02:00
|
|
|
.SH FLAGS
|
|
|
|
.TP 5
|
|
|
|
.B CURL_GLOBAL_ALL
|
2001-07-12 03:57:28 +02:00
|
|
|
Initialize everyting possible. This sets all known bits.
|
2001-05-31 10:35:26 +02:00
|
|
|
.TP
|
|
|
|
.B CURL_GLOBAL_SSL
|
2001-07-12 03:57:28 +02:00
|
|
|
Initialize SSL
|
|
|
|
.TP
|
|
|
|
.B CURL_GLOBAL_WIN32
|
|
|
|
Initialize the Win32 socket libraries.
|
2001-05-31 10:35:26 +02:00
|
|
|
.TP
|
|
|
|
.B CURL_GLOBAL_NOTHING
|
|
|
|
Initialise nothing extra. This sets no bit.
|
2001-05-28 16:11:02 +02:00
|
|
|
.SH RETURN VALUE
|
|
|
|
If this function returns non-zero, something went wrong and you cannot use the
|
|
|
|
other curl functions.
|
|
|
|
.SH "SEE ALSO"
|
|
|
|
.BR curl_global_cleanup "(3), "
|
|
|
|
.SH BUGS
|
|
|
|
None.
|
|
|
|
|