Artifactspublic-v0

curl

master
ply4 git calls128 ms288 KiB2 cachedprotocol v2
71 lines1.6 KiBRaw

NAME

CURLSHOPT_UNLOCKFUNC - mutex unlock callback

SYNOPSIS

c
#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) 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). This pointer is not used by libcurl itself.

%PROTOCOLS%

EXAMPLE

c
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%

RETURN VALUE

CURLSHE_OK (zero) means that the option was set properly, non-zero means an error occurred. See libcurl-errors(3) for the full list with descriptions.

1---
2c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
3SPDX-License-Identifier: curl
4Title: CURLSHOPT_UNLOCKFUNC
5Section: 3
6Source: libcurl
7See-also:
8 - CURLSHOPT_LOCKFUNC (3)
9 - curl_share_cleanup (3)
10 - curl_share_init (3)
11 - curl_share_setopt (3)
12Protocol:
13 - All
14Added-in: 7.10.3
15---
17# NAME
19CURLSHOPT_UNLOCKFUNC - mutex unlock callback
21# SYNOPSIS
23~~~c
24#include <curl/curl.h>
26void unlockcb(CURL *handle, curl_lock_data data, void *clientp);
28CURLSHcode curl_share_setopt(CURLSH *share, CURLSHOPT_UNLOCKFUNC, unlockcb);
29~~~
31# DESCRIPTION
33Set a mutex unlock callback for the share object. There is a corresponding
34CURLSHOPT_LOCKFUNC(3) callback called when the mutex is first locked.
36The *unlockcb* argument must be a pointer to a function matching the
37prototype shown above. The arguments to the callback are:
39*handle* is the currently active easy handle in use when the share object
40is released.
42The *data* argument tells what kind of data libcurl wants to unlock. Make
43sure that the callback uses a different lock for each kind of data.
45*clientp* is the private pointer you set with CURLSHOPT_USERDATA(3).
46This pointer is not used by libcurl itself.
48# %PROTOCOLS%
50# EXAMPLE
52~~~c
53extern void mutex_unlock(CURL *, curl_lock_data, void *);
55int main(void)
57 CURLSHcode sh;
58 CURLSH *share = curl_share_init();
59 sh = curl_share_setopt(share, CURLSHOPT_UNLOCKFUNC, mutex_unlock);
60 if(sh)
61 printf("Error: %s\n", curl_share_strerror(sh));
63~~~
65# %AVAILABILITY%
67# RETURN VALUE
69CURLSHE_OK (zero) means that the option was set properly, non-zero means an
70error occurred. See libcurl-errors(3) for the full list with
71descriptions.
Diagnostics4 git calls · 128 ms
CallStatusSizeTime0128 ms
discover200152 B3 ms
git.upload-pack discover
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=fetch
git.upstream.dur_ms=2
git.response.bytes=152
git.server.agent=gitty/1.0
git.server.object_format=sha1
git.server.caps=agent ls-refs fetch object-format
git.server.fetch=shallow filter sideband-all
git.protocol.version=2
git.pkt.frames=8
git.pkt.data=6
git.pkt.flush=2
git.pkt.delim=0
git.pkt.bytes=152
git.pkt.payload.max=34
ls-refs200149 B · hit3 ms
git.upload-pack ls-refs
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=ls-refs
git.upstream.dur_ms=3
git.response.bytes=149
git.response.cache=HIT
git.response.duration_ms=3
git.protocol.version=2
git.pkt.frames=3
git.pkt.data=2
git.pkt.flush=1
git.pkt.delim=0
git.pkt.bytes=149
git.pkt.payload.max=78
git.ls_refs.count=2
git.ls_refs.head=refs/heads/master
fetchblob:none · deepen 10200287 KiB · hit2 ms
git.upload-pack fetch
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=fetch
git.upstream.dur_ms=123
git.response.bytes=293470
git.response.cache=HIT
git.response.duration_ms=2
git.fetch.filter=blob:none
git.fetch.filter.requested=tree:0
git.fetch.filter.fallback=blob:none
git.fetch.filter.learned=false
git.fetch.wants=31c911efe5652725e930f4d2e60c9060e5f6646d
git.fetch.haves.count=0
git.fetch.deepen=10
git.fetch.thin_pack=false
git.fetch.ofs_delta=true
git.protocol.version=2
git.pkt.frames=10
git.pkt.data=8
git.pkt.flush=1
git.pkt.delim=1
git.pkt.bytes=293470
git.pkt.payload.max=65516
git.sideband.band1.bytes=293354
git.sideband.band2.bytes=0
git.sideband.band3.bytes=0
git.pack.objects=87
git.pack.bytes=293354
git.pack.ofs_delta=0
git.pack.ref_delta=1
git.pack.chain.max=1
git.pack.trailer=6a646bcda6740bab42e321b51998b52ea15146c0
git.pack.full=86
Open pack map
fetch200919 B123 ms
git.upload-pack fetch
http.response.status_code=200
git.response.bytes=919
git.response.cache=MISS
git.response.duration_ms=123
git.fetch.wants=503918231d90194d1329523a78fdb2e38500d162
git.fetch.haves.count=0
git.fetch.deepen=0
git.fetch.thin_pack=false
git.fetch.ofs_delta=true
git.protocol.version=2
git.pkt.frames=3
git.pkt.data=2
git.pkt.flush=1
git.pkt.delim=0
git.pkt.bytes=919
git.pkt.payload.max=898
git.sideband.band1.bytes=897
git.sideband.band2.bytes=0
git.sideband.band3.bytes=0

Each row is one HTTP round trip ply made to the git server for this page, on one timeline. discover asks what the server speaks, ls-refs lists branch tips, fetch brings objects by id. A hit was served by Workers Cache. Tap a row for its wire details.

Remote
https://5ad2236b39de4c8bd8f6270ea63f3ea9.artifacts.cloudflare.net/git/public-v0/curl.git
Ref
refs/heads/master
Commit
31c911efe5652725e930f4d2e60c9060e5f6646d
cf-ray
a5e37c39dfa93a24
Request
a16b01fe…
Protocol
v2 · sha1
Agent
gitty/1.0
Filter
advertised
Fetch
shallow filter sideband-all
Capabilities
agent ls-refs fetch object-format