mention 'easy handle' and not just handle, there will soon be other handles

.\" nroff -man [file]

.\" nroff -man [file]

.\" $Id$

.\" $Id$

.\"

.\"

.TH curl_easy_init 3 "1 March 2002" "libcurl 7.8.1" "libcurl Manual"

.TH curl_easy_init 3 "4 March 2002" "libcurl 7.8.1" "libcurl Manual"

.SH NAME

.SH NAME

curl_easy_init - Start a libcurl session

curl_easy_init - Start a libcurl easy session

.SH SYNOPSIS

.SH SYNOPSIS

.B #include <curl/curl.h>

.B #include <curl/curl.h>

.sp

.sp

.BI "CURL *curl_easy_init( );"

.BI "CURL *curl_easy_init( );"

.ad

.ad

.SH DESCRIPTION

.SH DESCRIPTION

This function must be the first function to call, and it returns a CURL handle

This function must be the first function to call, and it returns a CURL easy

that you shall use as input to the other easy-functions. The init calls

handle that you must use as input to other easy-functions. curl_easy_init

intializes curl and this call MUST have a corresponding call to

intializes curl and this call MUST have a corresponding call to

.I curl_easy_cleanup

\fIcurl_easy_cleanup\fP when the operation is complete.

when the operation is complete.

.SH RETURN VALUE

.SH RETURN VALUE

If this function returns NULL, something went wrong and you cannot use the

If this function returns NULL, something went wrong and you cannot use the