NAME
curl_easy_init - Start a libcurl session
SYNOPSIS
#include <curl/curl.h>
CURL *curl_easy_init( );
DESCRIPTION
This function must be the first function to call, and it
returns a CURL handle that you shall use as input to the
other easy-functions. The init calls intializes curl and
this call MUST have a corresponding call to
curl_easy_cleanup when the operation is complete.
On win32 systems, if you want to init the winsock stuff man
ually, libcurl will not do that for you. WSAStartup() and
WSACleanup() should then be called accordingly. If you want
libcurl to handle this, use the CURL_GLOBAL_WIN32 flag in
the initial curl_global_init() call.
Using libcurl 7.7 and later, you should perform all your
sequential file transfers using the same curl handle. This
enables libcurl to use persistant connections where possi
ble.
RETURN VALUE
If this function returns NULL, something went wrong and you
cannot use the other curl functions.
SEE ALSO
curl_easy_cleanup(3), curl_global_init(3)
BUGS
Surely there are some, you tell me!
Man(1) output converted with
man2html