curlsharesetopt(3)            libcurl Manual            curlsharesetopt(3)



NAME
       curlsharesetopt - Set options for a shared object

SYNOPSIS
       ##include <>

       CURLSHcode curlsharesetopt(CURLSH *share, CURLSHoption option, param-
       eter);

DESCRIPTION
       Set the option to parameter for the given share.

OPTIONS
       CURLSHOPTLOCKFUNC
              The parameter must be a pointer to a function matching the  fol-
              lowing 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 fol-
              lowing 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 lick 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
                     Cached  DNS  hosts will be shared across the easy handles
                     using this shared object.

       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
              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)



libcurl 7.10.7                    8 Aug 2003              curlsharesetopt(3)