curl_easy_init(3)

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 manually, 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 possible.

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!