---
name: "CURLSHOPT_UNLOCKFUNC"
section: "3"
platform: "linux"
package: "curl"
version: "8.23.0-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux", "macos"]
url: "https://new.carta.tech/CURLSHOPT_UNLOCKFUNC"
---

# CURLSHOPT\_UNLOCKFUNC(3)

mutex unlock callback

## NAME

CURLSHOPT\_UNLOCKFUNC - mutex unlock callback

## SYNOPSIS

```
#include <curl/curl.h>
void unlockcb(CURL *handle, curl_lock_data data, void *clientp);
CURLSHcode curl_share_setopt(CURLSH *share, CURLSHOPT_UNLOCKFUNC, unlockcb);
```

## DESCRIPTION

Set a mutex unlock callback for the share object. There is a corresponding *[CURLSHOPT\_LOCKFUNC(3)](/CURLSHOPT_LOCKFUNC/3.md)* callback called when the mutex is first locked.

The *unlockcb* argument must be a pointer to a function matching the prototype shown above. The arguments to the callback are:

*handle* is the currently active easy handle in use when the share object is released.

The *data* argument tells what kind of data libcurl wants to unlock. Make sure that the callback uses a different lock for each kind of data.

*clientp* is the private pointer you set with *[CURLSHOPT\_USERDATA(3)](/CURLSHOPT_USERDATA/3.md)*. This pointer is not used by libcurl itself.

## PROTOCOLS

This functionality affects all supported protocols

## EXAMPLE

```
extern void mutex_unlock(CURL *, curl_lock_data, void *);
int main(void)
{
  CURLSHcode sh;
  CURLSH *share = curl_share_init();
  sh = curl_share_setopt(share, CURLSHOPT_UNLOCKFUNC, mutex_unlock);
  if(sh)
    printf("Error: %s\n", curl_share_strerror(sh));
}
```

## AVAILABILITY

Added in curl 7.10.3

## RETURN VALUE

CURLSHE\_OK (zero) means that the option was set properly, non-zero means an error occurred. See *[libcurl-errors(3)](/libcurl-errors/3.md)* for the full list with descriptions.

## SEE ALSO

[**CURLSHOPT\_LOCKFUNC**(3)](/CURLSHOPT_LOCKFUNC/3.md), [**curl\_share\_cleanup**(3)](/curl_share_cleanup/3.md), [**curl\_share\_init**(3)](/curl_share_init/3.md), [**curl\_share\_setopt**(3)](/curl_share_setopt/3.md)