2 <title>curl_easy_init man page
</title>
3 <meta name=
"generator" content=
"roffit 0.7">
4 <STYLE type=
"text/css">
30 background-color: #e0e0e0;
36 font-family: monospace;
46 <p class=
"level0"><a name=
"NAME"></a><h2 class=
"nroffsh">NAME
</h2>
47 <p class=
"level0">curl_easy_init - Start a libcurl easy session
<a name=
"SYNOPSIS"></a><h2 class=
"nroffsh">SYNOPSIS
</h2>
48 <p class=
"level0"><span Class=
"bold">#include
<curl/curl.h
></span>
49 <p class=
"level0"><span Class=
"bold">CURL *curl_easy_init( );
</span>
50 <p class=
"level0"><a name=
"DESCRIPTION"></a><h2 class=
"nroffsh">DESCRIPTION
</h2>
51 <p class=
"level0">This function must be the first function to call, and it returns a CURL easy handle that you must use as input to other easy-functions. curl_easy_init initializes curl and this call
<span Class=
"bold">MUST
</span> have a corresponding call to
<a class=
"emphasis" href=
"./curl_easy_cleanup.html">curl_easy_cleanup(
3)
</a> when the operation is complete.
52 <p class=
"level0">If you did not already call
<a class=
"emphasis" href=
"./curl_global_init.html">curl_global_init(
3)
</a>,
<a class=
"emphasis" href=
"./curl_easy_init.html">curl_easy_init(
3)
</a> does it automatically. This may be lethal in multi-threaded cases, since
<a class=
"emphasis" href=
"./curl_global_init.html">curl_global_init(
3)
</a> is not thread-safe, and it may result in resource problems because there is no corresponding cleanup.
53 <p class=
"level0">You are strongly advised to not allow this automatic behaviour, by calling
<a class=
"emphasis" href=
"./curl_global_init.html">curl_global_init(
3)
</a> yourself properly. See the description in
<span Class=
"bold">libcurl
</span>(
3) of global environment requirements for details of how to use this function.
54 <p class=
"level0"><a name=
"RETURN"></a><h2 class=
"nroffsh">RETURN VALUE
</h2>
55 <p class=
"level0">If this function returns NULL, something went wrong and you cannot use the other curl functions.
<a name=
"SEE"></a><h2 class=
"nroffsh">SEE ALSO
</h2>
56 <p class=
"level0"><a class=
"manpage" href=
"./curl_easy_cleanup.html">curl_easy_cleanup (
3)
</a> <a class=
"manpage" href=
"./curl_global_init.html"> curl_global_init (
3)
</a> <a class=
"manpage" href=
"./curl_easy_reset.html"> curl_easy_reset (
3)
</a> <p class=
"roffit">
57 This HTML page was made with
<a href=
"http://daniel.haxx.se/projects/roffit/">roffit
</a>.