Artifactspublic-v0

curl

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

NAME

curl_multi_cleanup - close down a multi session

SYNOPSIS

c
#include <curl/curl.h>

CURLMcode curl_multi_cleanup(CURLM *multi_handle);

DESCRIPTION

This function is the opposite of curl_multi_init(3). Cleans up and removes a whole multi stack. It does not free or touch any individual easy handles in any way - they still need to be closed individually, using the usual curl_easy_cleanup(3) way. The order of cleaning up should be:

1 - curl_multi_remove_handle(3) before any easy handles are cleaned up

2 - curl_easy_cleanup(3) can now be called independently since the easy handle is no longer connected to the multi handle

3 - curl_multi_cleanup(3) should be called when all easy handles are removed

When this function is called, remaining entries in the connection pool held by the multi handle are shut down, which might trigger calls to the CURLMOPT_SOCKETFUNCTION(3) callback.

Passing in a NULL pointer in multi_handle makes this function return CURLM_BAD_HANDLE immediately with no other action.

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

%PROTOCOLS%

EXAMPLE

c
int main(void)
{
  CURLM *multi = curl_multi_init();

  /* when the multi transfer is done ... */

  /* remove all easy handles, then: */
  curl_multi_cleanup(multi);
}

%AVAILABILITY%

RETURN VALUE

This function returns a CURLMcode indicating success or error.

CURLM_OK (0) means everything was OK, non-zero means an error occurred, see libcurl-errors(3).

1---
2c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
3SPDX-License-Identifier: curl
4Title: curl_multi_cleanup
5Section: 3
6Source: libcurl
7See-also:
8 - curl_easy_cleanup (3)
9 - curl_easy_init (3)
10 - curl_multi_get_handles (3)
11 - curl_multi_init (3)
12Protocol:
13 - All
14Added-in: 7.9.6
15---
17# NAME
19curl_multi_cleanup - close down a multi session
21# SYNOPSIS
23~~~c
24#include <curl/curl.h>
26CURLMcode curl_multi_cleanup(CURLM *multi_handle);
27~~~
29# DESCRIPTION
31This function is the opposite of curl_multi_init(3). Cleans up and removes a
32whole multi stack. It does not free or touch any individual easy handles in
33any way - they still need to be closed individually, using the usual
34curl_easy_cleanup(3) way. The order of cleaning up should be:
361 - curl_multi_remove_handle(3) before any easy handles are cleaned up
382 - curl_easy_cleanup(3) can now be called independently since the easy
39handle is no longer connected to the multi handle
413 - curl_multi_cleanup(3) should be called when all easy handles are
42removed
44When this function is called, remaining entries in the connection pool held by
45the multi handle are shut down, which might trigger calls to the
46CURLMOPT_SOCKETFUNCTION(3) callback.
48Passing in a NULL pointer in *multi_handle* makes this function return
49CURLM_BAD_HANDLE immediately with no other action.
51Any use of the **multi_handle** after this function has been called and have
52returned, is illegal.
53# %PROTOCOLS%
55# EXAMPLE
57~~~c
58int main(void)
60 CURLM *multi = curl_multi_init();
62 /* when the multi transfer is done ... */
64 /* remove all easy handles, then: */
65 curl_multi_cleanup(multi);
67~~~
69# %AVAILABILITY%
71# RETURN VALUE
73This function returns a CURLMcode indicating success or error.
75CURLM_OK (0) means everything was OK, non-zero means an error occurred, see
76libcurl-errors(3).
Diagnostics4 git calls · 206 ms
CallStatusSizeTime0206 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 · hit2 ms
git.upload-pack fetch
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=fetch
git.upstream.dur_ms=202
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
fetch200988 B202 ms
git.upload-pack fetch
http.response.status_code=200
git.response.bytes=988
git.response.cache=MISS
git.response.duration_ms=202
git.fetch.wants=1d4a1f81ffd2b3e51bf2a7d776710681b493d9fb
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=988
git.pkt.payload.max=967
git.sideband.band1.bytes=966
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
a5e321125f1f9de8
Request
08cf91ca…
Protocol
v2 · sha1
Agent
gitty/1.0
Filter
advertised
Fetch
shallow filter sideband-all
Capabilities
agent ls-refs fetch object-format