Artifactspublic-v0

curl

master
ply4 git calls142 ms288 KiB2 cachedprotocol v2
76 lines1.8 KiBRaw

NAME

CURLSHOPT_LOCKFUNC - mutex lock callback

SYNOPSIS

c
#include <curl/curl.h>

void lockcb(CURL *handle, curl_lock_data data, curl_lock_access access,
            void *clientp);

CURLSHcode curl_share_setopt(CURLSH *share, CURLSHOPT_LOCKFUNC, lockcb);

DESCRIPTION

Set a mutex lock callback for the share object, to allow it to get used by multiple threads concurrently. There is a corresponding CURLSHOPT_UNLOCKFUNC(3) callback called when the mutex is again released.

The lockcb 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 intended to get used.

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

access defines what access type libcurl wants, shared or single.

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_lock(CURL *handle, curl_lock_data data,
                       curl_lock_access access, void *clientp);

int main(void)
{
  CURLSHcode sh;
  CURLSH *share = curl_share_init();
  sh = curl_share_setopt(share, CURLSHOPT_LOCKFUNC, mutex_lock);
  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_LOCKFUNC
5Section: 3
6Source: libcurl
7See-also:
8 - CURLSHOPT_UNLOCKFUNC (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_LOCKFUNC - mutex lock callback
21# SYNOPSIS
23~~~c
24#include <curl/curl.h>
26void lockcb(CURL *handle, curl_lock_data data, curl_lock_access access,
27 void *clientp);
29CURLSHcode curl_share_setopt(CURLSH *share, CURLSHOPT_LOCKFUNC, lockcb);
30~~~
32# DESCRIPTION
34Set a mutex lock callback for the share object, to allow it to get used by
35multiple threads concurrently. There is a corresponding
36CURLSHOPT_UNLOCKFUNC(3) callback called when the mutex is again released.
38The *lockcb* argument must be a pointer to a function matching the
39prototype shown above. The arguments to the callback are:
41*handle* is the currently active easy handle in use when the share object
42is intended to get used.
44The *data* argument tells what kind of data libcurl wants to lock. Make
45sure that the callback uses a different lock for each kind of data.
47*access* defines what access type libcurl wants, shared or single.
49*clientp* is the private pointer you set with CURLSHOPT_USERDATA(3).
50This pointer is not used by libcurl itself.
52# %PROTOCOLS%
54# EXAMPLE
56~~~c
57extern void mutex_lock(CURL *handle, curl_lock_data data,
58 curl_lock_access access, void *clientp);
60int main(void)
62 CURLSHcode sh;
63 CURLSH *share = curl_share_init();
64 sh = curl_share_setopt(share, CURLSHOPT_LOCKFUNC, mutex_lock);
65 if(sh)
66 printf("Error: %s\n", curl_share_strerror(sh));
68~~~
70# %AVAILABILITY%
72# RETURN VALUE
74CURLSHE_OK (zero) means that the option was set properly, non-zero means an
75error occurred. See libcurl-errors(3) for the full list with
76descriptions.
Diagnostics4 git calls · 142 ms
CallStatusSizeTime0142 ms
discover200152 B2 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 · hit2 ms
git.upload-pack ls-refs
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=ls-refs
git.upstream.dur_ms=2
git.response.bytes=149
git.response.cache=HIT
git.response.duration_ms=2
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 · hit3 ms
git.upload-pack fetch
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=fetch
git.upstream.dur_ms=137
git.response.bytes=293470
git.response.cache=HIT
git.response.duration_ms=3
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
fetch2001002 B137 ms
git.upload-pack fetch
http.response.status_code=200
git.response.bytes=1002
git.response.cache=MISS
git.response.duration_ms=137
git.fetch.wants=208dfdd62a1e66e317e2237975f006a8169ecf90
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=1002
git.pkt.payload.max=981
git.sideband.band1.bytes=980
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
a5e36fb5eacbe88e
Request
94fc043e…
Protocol
v2 · sha1
Agent
gitty/1.0
Filter
advertised
Fetch
shallow filter sideband-all
Capabilities
agent ls-refs fetch object-format