<pclass="level0">This function returns a CURLSH handle to be used as input to all the other share-functions, sometimes referred to as a share handle on some places in the documentation. This init call MUST have a corresponding call to <spanClass="emphasis">curl_share_cleanup</span> when all operations using the share are complete.
<pclass="level0">This <spanClass="emphasis">share handle</span> is what you pass to curl using the <spanClass="emphasis">CURLOPT_SHARE</span> option with <aclass="emphasis"href="./curl_easy_setopt.html">curl_easy_setopt(3)</a>, to make that specific curl handle use the data in this share. <aname="RETURN"></a><h2class="nroffsh">RETURN VALUE</h2>
<pclass="level0">If this function returns NULL, something went wrong (out of memory, etc.) and therefore the share object was not created. <aname="SEE"></a><h2class="nroffsh">SEE ALSO</h2>