libcurl Manual                               curlsharesetopt(3)



NAME
     curlsharesetopt - Set options for a shared object

SYNOPSIS
     #include 

     CURLSHcode  curlsharesetopt(CURLSH  *share,   CURLSHoption
     option, parameter);

DESCRIPTION
     Set the option to parameter for the given share.

OPTIONS
     CURLSHOPTLOCKFUNC
          The parameter must be a pointer to a function  matching
          the following prototype:

          void lockfunction(CURL *handle,  curllockdata  data,
          curllockaccess access, void *userptr);

          data defines what data libcurl wants to lock,  and  you
          must  make sure that only one lock is given at any time
          for each kind of data.

          access defines what access type libcurl  wants,  shared
          or single.

          userptr is the pointer you set with CURLSHOPTUSERDATA.

     CURLSHOPTUNLOCKFUNC
          The parameter must be a pointer to a function  matching
          the following prototype:

          void unlockfunction(CURL *handle, curllockdata data,
          void *userptr);

          data defines what data libcurl wants to unlock, and you
          must  make sure that only one lock is given at any time
          for each kind of data.

          userptr is the pointer you set with CURLSHOPTUSERDATA.

     CURLSHOPTSHARE
          The parameter specifies a type of data that  should  be
          shared.  This may be set to one of the values described
          below.

          CURLOCKDATACOKIE
               Cookie data will be shared across the easy handles
               using this shared object.

          CURLOCKDATADNS



libcurl 7.10.7       Last change: 8 Aug 2003                    1






libcurl Manual                               curlsharesetopt(3)



               Cached DNS hosts will be shared  across  the  easy
               handles  using  this shared object. Note that when
               you use the  multi  interface,  all  easy  handles
               added  to  the  same  multi  handle will share DNS
               cache by default without this having to be used!

     CURLSHOPTUNSHARE
          This option does the opposite  of  CURLSHOPTSHARE.  It
          specifies  that  the specified parameter will no longer
          be shared. Valid values  are  the  same  as  those  for
          CURLSHOPTSHARE.

     CURLSHOPTUSERDATA
          The parameter allows you to specify a pointer  to  data
          that   will   be   passed   to  the  lockfunction  and
          unlockfunction each time it is called.

RETURN VALUE
     CURLSHEOK (zero) means that the option  was  set  properly,
     non-zero  means  an error occurred as  defines.
     See the libcurl-errors.3 man page for  the  full  list  with
     descriptions.

SEE ALSO
     curlsharecleanup(3), curlshareinit(3)

ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:

     
       ATRIBUTE TYPE     ATRIBUTE VALUE
    
     Availability         SUNWcurl       
    
     Interface Stability  Uncommitted    
    

NOTES
     Source for C-URL is available on http:/opensolaris.org.















libcurl 7.10.7       Last change: 8 Aug 2003                    2