Artifactspublic-v0

curl

master
ply4 git calls60 ms288 KiB3 cachedprotocol v2
66 lines1.6 KiBRaw

NAME

curl_share_cleanup - close a shared object

SYNOPSIS

c
#include <curl/curl.h>

CURLSHcode curl_share_cleanup(CURLSH *share_handle);

DESCRIPTION

This function deletes a shared object. The share handle cannot be used anymore when this function has been called. The share fails the call if it is still being used in any easy handle.

Passing in a NULL pointer in share_handle makes this function return immediately with no action.

Any use of the share_handle after this function has been called and have returned, is illegal.

For applications that use a share in several threads, it is critical that the destruction of the share is only done when all other threads have stopped using it. While libcurl tracks how many easy handles are using a share, it can not observe how many pointers to the share the application has.

%PROTOCOLS%

EXAMPLE

c
int main(void)
{
  CURLSHcode sh;
  CURLSH *share = curl_share_init();
  sh = curl_share_setopt(share, CURLSHOPT_SHARE, CURL_LOCK_DATA_CONNECT);
  /* use the share, then ... */
  curl_share_cleanup(share);
}

%AVAILABILITY%

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. If an error occurs, then the share object is not deleted.

1---
2c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
3SPDX-License-Identifier: curl
4Title: curl_share_cleanup
5Section: 3
6Source: libcurl
7See-also:
8 - curl_share_init (3)
9 - curl_share_setopt (3)
10Protocol:
11 - All
12Added-in: 7.10
13---
15# NAME
17curl_share_cleanup - close a shared object
19# SYNOPSIS
21~~~c
22#include <curl/curl.h>
24CURLSHcode curl_share_cleanup(CURLSH *share_handle);
25~~~
27# DESCRIPTION
29This function deletes a shared object. The share handle cannot be used anymore
30when this function has been called. The share fails the call if it is
31still being used in any easy handle.
33Passing in a NULL pointer in *share_handle* makes this function return
34immediately with no action.
36Any use of the **share_handle** after this function has been called and have
37returned, is illegal.
39For applications that use a share in several threads, it is critical that
40the destruction of the share is only done when all other threads have stopped
41using it. While libcurl tracks how many easy handles are using a share,
42it can not observe how many pointers to the share the application has.
44# %PROTOCOLS%
46# EXAMPLE
48~~~c
49int main(void)
51 CURLSHcode sh;
52 CURLSH *share = curl_share_init();
53 sh = curl_share_setopt(share, CURLSHOPT_SHARE, CURL_LOCK_DATA_CONNECT);
54 /* use the share, then ... */
55 curl_share_cleanup(share);
57~~~
59# %AVAILABILITY%
61# RETURN VALUE
63CURLSHE_OK (zero) means that the option was set properly, non-zero means an
64error occurred as *\<curl/curl.h\>* defines. See the libcurl-errors(3) man
65page for the full list with descriptions. If an error occurs, then the share
66object is not deleted.
Diagnostics4 git calls · 60 ms
CallStatusSizeTime060 ms
discover200152 B2 ms
git.upload-pack discover
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=ls-refs
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 · hit19 ms
git.upload-pack fetch
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=fetch
git.upstream.dur_ms=2
git.response.bytes=293470
git.response.cache=HIT
git.response.duration_ms=19
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
fetch200921 B · hit38 ms
git.upload-pack fetch
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=fetch
git.upstream.dur_ms=38
git.response.bytes=921
git.response.cache=HIT
git.response.duration_ms=38
git.fetch.wants=e8390ff3d6a8afbd9d29be6a69d70ac27146807b
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=921
git.pkt.payload.max=900
git.sideband.band1.bytes=899
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
a5e35b542876dfff
Request
6733c600…
Protocol
v2 · sha1
Agent
gitty/1.0
Filter
advertised
Fetch
shallow filter sideband-all
Capabilities
agent ls-refs fetch object-format