Artifactspublic-v0

curl

master
ply4 git calls161 ms288 KiB2 cachedprotocol v2
73 lines1.6 KiBRaw

NAME

curl_pushheader_bynum - get a push header by index

SYNOPSIS

c
#include <curl/curl.h>

char *curl_pushheader_bynum(struct curl_pushheaders *h, size_t num);

DESCRIPTION

This is a function that is only functional within a CURLMOPT_PUSHFUNCTION(3) callback. It makes no sense to try to use it elsewhere and it has no function then.

It returns the value for the header field at the given index num, for the incoming server push request or NULL. The data pointed to is freed by libcurl when this callback returns. The returned pointer points to a "name:value" string that gets freed when this callback returns; although not constrained by its type, this string may not be altered.

%PROTOCOLS%

EXAMPLE

c
/* output all the incoming push request headers */
static int push_cb(CURL *parent,
                   CURL *easy,
                   size_t num_headers,
                   struct curl_pushheaders *headers,
                   void *clientp)
{
  size_t i = 0;
  char *field;
  do {
    field = curl_pushheader_bynum(headers, i);
    if(field)
      fprintf(stderr, "Push header: %s\n", field);
    i++;
  } while(field);
  return CURL_PUSH_OK; /* permission granted */
}

int main(void)
{
  CURLM *multi = curl_multi_init();
  curl_multi_setopt(multi, CURLMOPT_PUSHFUNCTION, push_cb);
}

%AVAILABILITY%

RETURN VALUE

Returns a pointer to the header field content or NULL.

1---
2c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
3SPDX-License-Identifier: curl
4Title: curl_pushheader_bynum
5Section: 3
6Source: libcurl
7See-also:
8 - CURLMOPT_PUSHFUNCTION (3)
9 - curl_pushheader_byname (3)
10Protocol:
11 - HTTP
12Added-in: 7.44.0
13---
15# NAME
17curl_pushheader_bynum - get a push header by index
19# SYNOPSIS
21~~~c
22#include <curl/curl.h>
24char *curl_pushheader_bynum(struct curl_pushheaders *h, size_t num);
25~~~
27# DESCRIPTION
29This is a function that is only functional within a
30CURLMOPT_PUSHFUNCTION(3) callback. It makes no sense to try to use it
31elsewhere and it has no function then.
33It returns the value for the header field at the given index **num**, for
34the incoming server push request or NULL. The data pointed to is freed by
35libcurl when this callback returns. The returned pointer points to a
36"name:value" string that gets freed when this callback returns; although
37not constrained by its type, this string may not be altered.
39# %PROTOCOLS%
41# EXAMPLE
43~~~c
44/* output all the incoming push request headers */
45static int push_cb(CURL *parent,
46 CURL *easy,
47 size_t num_headers,
48 struct curl_pushheaders *headers,
49 void *clientp)
51 size_t i = 0;
52 char *field;
53 do {
54 field = curl_pushheader_bynum(headers, i);
55 if(field)
56 fprintf(stderr, "Push header: %s\n", field);
57 i++;
58 } while(field);
59 return CURL_PUSH_OK; /* permission granted */
62int main(void)
64 CURLM *multi = curl_multi_init();
65 curl_multi_setopt(multi, CURLMOPT_PUSHFUNCTION, push_cb);
67~~~
69# %AVAILABILITY%
71# RETURN VALUE
73Returns a pointer to the header field content or NULL.
Diagnostics4 git calls · 161 ms
CallStatusSizeTime0161 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=156
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
fetch200926 B156 ms
git.upload-pack fetch
http.response.status_code=200
git.response.bytes=926
git.response.cache=MISS
git.response.duration_ms=156
git.fetch.wants=256098e030325c2f8cfc4320346ca7b80b0c2f43
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=926
git.pkt.payload.max=905
git.sideband.band1.bytes=904
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
a5e32f4dfc258821
Request
abb758cc…
Protocol
v2 · sha1
Agent
gitty/1.0
Filter
advertised
Fetch
shallow filter sideband-all
Capabilities
agent ls-refs fetch object-format