1 <!DOCTYPE HTML PUBLIC
"-//W3C//DTD HTML 4.01 Transitional//EN"
2 "http://www.w3.org/TR/html4/loose.dtd">
4 <title>curl_easy_init man page
</title>
5 <meta name=
"generator" content=
"roffit">
6 <STYLE type=
"text/css">
12 P.level0, pre.level0 {
16 P.level1, pre.level1 {
20 P.level2, pre.level2 {
37 background-color: #e0e0e0;
43 font-family: monospace;
53 <p class=
"level0"><a name=
"NAME"></a><h2 class=
"nroffsh">NAME
</h2>
54 <p class=
"level0">curl_easy_init - Start a libcurl easy session
<a name=
"SYNOPSIS"></a><h2 class=
"nroffsh">SYNOPSIS
</h2>
55 <p class=
"level0"><span Class=
"bold">#include
<curl/curl.h
></span>
56 <p class=
"level0"><span Class=
"bold">CURL *curl_easy_init( );
</span> <a name=
"DESCRIPTION"></a><h2 class=
"nroffsh">DESCRIPTION
</h2>
57 <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 functions in the easy interface. This call
<span Class=
"bold">MUST
</span> have a corresponding call to
<a Class=
"emphasis" href=
"./curl_easy_cleanup.html">curl_easy_cleanup
</a> when the operation is complete.
58 <p class=
"level0">If you did not already call
<a Class=
"emphasis" href=
"./curl_global_init.html">curl_global_init
</a>,
<a Class=
"emphasis" href=
"./curl_easy_init.html">curl_easy_init
</a> does it automatically. This may be lethal in multi-threaded cases, since
<a Class=
"emphasis" href=
"./curl_global_init.html">curl_global_init
</a> is not thread-safe, and it may result in resource problems because there is no corresponding cleanup.
59 <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
</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.
<a name=
"RETURN"></a><h2 class=
"nroffsh">RETURN VALUE
</h2>
60 <p class=
"level0">If this function returns NULL, something went wrong and you cannot use the other curl functions.
<a name=
"EXAMPLE"></a><h2 class=
"nroffsh">EXAMPLE
</h2>
61 <p class=
"level0"><pre class=
"level0">
62 CURL *curl = curl_easy_init();
65 curl_easy_setopt(curl, CURLOPT_URL,
"http://example.com");
66 res = curl_easy_perform(curl);
67 curl_easy_cleanup(curl);
71 <p class=
"level0"><a name=
"SEE"></a><h2 class=
"nroffsh">SEE ALSO
</h2>
72 <p class=
"level0"><a Class=
"manpage" href=
"./curl_easy_cleanup.html">curl_easy_cleanup
</a>,
<a Class=
"manpage" href=
"./curl_global_init.html">curl_global_init
</a>,
<a Class=
"manpage" href=
"./curl_easy_reset.html">curl_easy_reset
</a>,
<a Class=
"manpage" href=
"./curl_easy_perform.html">curl_easy_perform
</a><p class=
"roffit">
73 This HTML page was made with
<a href=
"http://daniel.haxx.se/projects/roffit/">roffit
</a>.