Artifactspublic-v0

curl

master
ply4 git calls486 ms288 KiB2 cachedprotocol v2
83 lines1.7 KiBRaw

NAME

curl_multi_get_handles - return all added easy handles

SYNOPSIS

c
#include <curl/curl.h>

CURL **curl_multi_get_handles(CURLM *multi_handle);

DESCRIPTION

Returns an array with pointers to all added easy handles. The end of the list is marked with a NULL pointer.

Even if there is not a single easy handle added, this still returns an array but with only a single NULL pointer entry.

The returned array contains all the handles that are present at the time of the call. As soon as a handle has been removed from or a handle has been added to the multi handle after the handle array was returned, the two data points are out of sync.

The order of the easy handles within the array is not guaranteed.

The returned array may not be overwritten and must be freed with a call to curl_free(3) after use.

%PROTOCOLS%

EXAMPLE

c
int main(void)
{
  /* init a multi stack */
  CURLM *multi = curl_multi_init();
  CURL *curl = curl_easy_init();

  if(curl) {
    CURL **list;

    /* add the transfer */
    curl_multi_add_handle(multi, curl);

    /* extract all added handles */
    list = curl_multi_get_handles(multi);

    if(list) {
      int i;
      /* remove all added handles */
      for(i = 0; list[i]; i++) {
        curl_multi_remove_handle(multi, list[i]);
      }
      curl_free(list);
    }
  }
}

%AVAILABILITY%

RETURN VALUE

Returns NULL on failure. Otherwise it returns a pointer to an allocated array.

1---
2c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
3SPDX-License-Identifier: curl
4Title: curl_multi_get_handles
5Section: 3
6Source: libcurl
7See-also:
8 - curl_multi_add_handle (3)
9 - curl_multi_cleanup (3)
10 - curl_multi_init (3)
11 - curl_multi_remove_handle (3)
12Protocol:
13 - All
14Added-in: 8.4.0
15---
17# NAME
19curl_multi_get_handles - return all added easy handles
21# SYNOPSIS
23~~~c
24#include <curl/curl.h>
26CURL **curl_multi_get_handles(CURLM *multi_handle);
27~~~
29# DESCRIPTION
31Returns an array with pointers to all added easy handles. The end of the list
32is marked with a NULL pointer.
34Even if there is not a single easy handle added, this still returns an array
35but with only a single NULL pointer entry.
37The returned array contains all the handles that are present at the time of
38the call. As soon as a handle has been removed from or a handle has been added
39to the multi handle after the handle array was returned, the two data points
40are out of sync.
42The order of the easy handles within the array is not guaranteed.
44The returned array may not be overwritten and must be freed with a call to
45curl_free(3) after use.
47# %PROTOCOLS%
49# EXAMPLE
51~~~c
52int main(void)
54 /* init a multi stack */
55 CURLM *multi = curl_multi_init();
56 CURL *curl = curl_easy_init();
58 if(curl) {
59 CURL **list;
61 /* add the transfer */
62 curl_multi_add_handle(multi, curl);
64 /* extract all added handles */
65 list = curl_multi_get_handles(multi);
67 if(list) {
68 int i;
69 /* remove all added handles */
70 for(i = 0; list[i]; i++) {
71 curl_multi_remove_handle(multi, list[i]);
72 }
73 curl_free(list);
74 }
75 }
77~~~
79# %AVAILABILITY%
81# RETURN VALUE
83Returns NULL on failure. Otherwise it returns a pointer to an allocated array.
Diagnostics4 git calls · 486 ms
CallStatusSizeTime0486 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=481
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
fetch200907 B481 ms
git.upload-pack fetch
http.response.status_code=200
git.response.bytes=907
git.response.cache=MISS
git.response.duration_ms=481
git.fetch.wants=ad472970c9fb290116bab856f1544aa7c9963703
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=907
git.pkt.payload.max=886
git.sideband.band1.bytes=885
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
a5e3464a1feaf4d4
Request
3aacac7c…
Protocol
v2 · sha1
Agent
gitty/1.0
Filter
advertised
Fetch
shallow filter sideband-all
Capabilities
agent ls-refs fetch object-format