Go to main content

man pages section 3: Library Interfaces and Headers

Exit Print View

Updated: Wednesday, July 27, 2022
 
 

curl_share_init (3)

Name

curl_share_init - Create a shared object

Synopsis

#include <curl/curl.h>

CURLSH *curl_share_init();

Description

curl_share_init(3)              libcurl Manual              curl_share_init(3)



NAME
       curl_share_init - Create a shared object

SYNOPSIS
       #include <curl/curl.h>

       CURLSH *curl_share_init();

DESCRIPTION
       This  function  returns  a CURLSH handle to be used as input to all the
       other share-functions, sometimes referred to as a share handle in  some
       places  in  the documentation. This init call MUST have a corresponding
       call to curl_share_cleanup when all operations using the share are com-
       plete.

       This  share  handle is what you pass to curl using the CURLOPT_SHARE(3)
       option with curl_easy_setopt(3), to make that specific curl handle  use
       the data in this share.

EXAMPLE
         CURLSHcode sh;
         share = curl_share_init();
         sh = curl_share_setopt(share, CURLSHOPT_SHARE, CURL_LOCK_DATA_CONNECT);
         if(sh)
           printf("Error: %s\n", curl_share_strerror(sh));

AVAILABILITY
       Added in 7.10

RETURN VALUE
       If  this  function  returns  NULL, something went wrong (out of memory,
       etc.)  and therefore the share object was not created.


ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:


       +---------------+------------------+
       |ATTRIBUTE TYPE | ATTRIBUTE VALUE  |
       +---------------+------------------+
       |Availability   | web/curl         |
       +---------------+------------------+
       |Stability      | Uncommitted      |
       +---------------+------------------+

SEE ALSO
       curl_share_cleanup(3), curl_share_setopt(3)



NOTES
       Source code for open source software components in Oracle  Solaris  can
       be found at https://www.oracle.com/downloads/opensource/solaris-source-
       code-downloads.html.

       This    software    was    built    from    source     available     at
       https://github.com/oracle/solaris-userland.    The  original  community
       source      was      downloaded       from        https://curl.se/down-
       load/curl-7.83.1.tar.bz2.

       Further information about this software can be found on the open source
       community website at http://curl.haxx.se/.



libcurl 7.83.1                  April 15, 2022              curl_share_init(3)