NAME

WWW::Curl::Share - Perl extension interface for libcurl

SYNOPSIS

use WWW::CURL::Share;
my $curlsh = new WWW::Curl::Share;
$curlsh->setopt(CURLSHOPT_SHARE, CURL_LOCK_DATA_COOKIE);
$curlsh->setopt(CURLSHOPT_SHARE, CURL_LOCK_DATA_DNS);
$curl->setopt(CURLOPT_SHARE, $curlsh);
$curlsh->setopt(CURLSHOPT_UNSHARE, CURL_LOCK_DATA_COOKIE);
$curlsh->setopt(CURLSHOPT_UNSHARE, CURL_LOCK_DATA_DNS);

DESCRIPTION

WWW::Curl::Share is an extension to WWW::Curl::Easy which makes it possible to use single cookies/dns cache for several Easy handles.

METHODS

$curlsh = new WWW::Curl::Share
	This method constructs a new WWW::Curl::Share object.

$curlsh->setopt(CURLSHOPT_SHARE, $value );
	Enables share for:
		CURL_LOCK_DATA_COOKIE	use single cookies database
		CURL_LOCK_DATA_DNS	use single DNS cache
$curlsh->setopt(CURLSHOPT_UNSHARE, $value );
	Disable share for given $value (see CURLSHOPT_SHARE)

$curlsh->strerror( ErrNo )
	This method returns a string describing the CURLSHcode error 
	code passed in the argument errornum.

$curl->setopt(CURLOPT_SHARE, $curlsh)
	Attach share object to WWW::Curl::Easy instance

List of all available options and lock constants:
	CURLSHOPT_LAST
	CURLSHOPT_LOCKFUNC
	CURLSHOPT_NONE
	CURLSHOPT_SHARE
	CURLSHOPT_UNLOCKFUNC
	CURLSHOPT_UNSHARE
	CURLSHOPT_USERDATA
	CURL_LOCK_DATA_CONNECT
	CURL_LOCK_DATA_COOKIE
	CURL_LOCK_DATA_DNS
	CURL_LOCK_DATA_LAST
	CURL_LOCK_DATA_NONE
	CURL_LOCK_DATA_SHARE
	CURL_LOCK_DATA_SSL_SESSION

AUTHOR

Anton Fedorov (datacompboy <at> mail.ru)

COPYRIGHT

Copyright (C) 2004 Sebastian Riedel, et al.

You may opt to use, copy, modify, merge, publish, distribute and/or sell copies of the Software, and permit persons to whom the Software is furnished to do so, under the terms of the MPL or the MIT/X-derivate licenses. You may pick one of these licenses.

SEE ALSO

WWW::Curl, WWW::Curl::Easy, http://curl.haxx.se/