curl_share_setopt man page on Darwin

Man page or keyword search:  
man Server   23457 pages
apropos Keyword Search (all sections)
Output format
Darwin logo
[printable version]

curl_share_setopt(3)		libcurl Manual		  curl_share_setopt(3)

NAME
       curl_share_setopt - Set options for a shared object

SYNOPSIS
       #include <curl/curl.h>

       CURLSHcode curl_share_setopt(CURLSH *share, CURLSHoption option, param‐
       eter);

DESCRIPTION
       Set the option to parameter for the given share.

OPTIONS
       CURLSHOPT_LOCKFUNC
	      The parameter must be a pointer to a function matching the  fol‐
	      lowing prototype:

	      void    lock_function(CURL    *handle,	curl_lock_data	 data,
	      curl_lock_access 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 CURLSHOPT_USERDATA.

       CURLSHOPT_UNLOCKFUNC
	      The parameter must be a pointer to a function matching the  fol‐
	      lowing prototype:

	      void  unlock_function(CURL  *handle,  curl_lock_data  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 CURLSHOPT_USERDATA.

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

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

	      CURL_LOCK_DATA_DNS
		     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 hav‐
		     ing to be used!

	      CURL_LOCK_DATA_SSL_SESSION
		     SSL session IDs will be shared across  the	 easy  handles
		     using this shared object. This will reduce the time spent
		     in the  SSL  handshake  when  reconnecting	 to  the  same
		     server.  Note  SSL session IDs are reused within the same
		     easy handle by default.

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

       CURLSHOPT_USERDATA
	      The parameter allows you to specify a pointer to data that  will
	      be  passed to the lock_function and unlock_function each time it
	      is called.

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

SEE ALSO
       curl_share_cleanup(3), curl_share_init(3)

libcurl 7.10.7			  8 Aug 2003		  curl_share_setopt(3)
[top]

List of man pages available for Darwin

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net