Manpage logo

curl_share_setopt - set options for a shared object

NAME  SYNOPSIS  DESCRIPTION  OPTIONS  PROTOCOLS  EXAMPLE  AVAILABILITY  RETURN VALUE  SEE ALSO 

NAME

curl_share_setopt − set options for a shared object

SYNOPSIS

#include <curl/curl.h>

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

DESCRIPTION

Set the option to parameter for the given share.

OPTIONS

CURLSHOPT_LOCKFUNC

See CURLSHOPT_LOCKFUNC(3).

CURLSHOPT_UNLOCKFUNC

See CURLSHOPT_UNLOCKFUNC(3).

CURLSHOPT_SHARE

See CURLSHOPT_SHARE(3).

CURLSHOPT_UNSHARE

See CURLSHOPT_UNSHARE(3).

CURLSHOPT_USERDATA

See CURLSHOPT_USERDATA(3).

PROTOCOLS

This functionality affects all supported protocols

EXAMPLE

int main(void)
{
CURLSHcode sh;
CURLSH *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 curl 7.10

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)


Updated 2026-06-01 - jenkler.se | uex.se