Artifactspublic-v0

curl

master
ply4 git calls320 ms288 KiB2 cachedprotocol v2
86 lines2.0 KiBRaw

NAME

curl_pushheader_byname - get a push header by name

SYNOPSIS

c
#include <curl/curl.h>

char *curl_pushheader_byname(struct curl_pushheaders *h, const char *name);

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 given header field name (or NULL) for the incoming server push request. This is a shortcut so that the application does not have to loop through all headers to find the one it is interested in. The data this function points to is freed when this callback returns and, although not constrained by its type, may not be altered. If more than one header field use the same name, this returns only the first one.

%PROTOCOLS%

EXAMPLE

c
#include <string.h> /* for strncmp */

static int push_cb(CURL *parent,
                   CURL *easy,
                   size_t num_headers,
                   struct curl_pushheaders *headers,
                   void *clientp)
{
  char *headp;
  int *transfers = (int *)clientp;
  FILE *out;
  headp = curl_pushheader_byname(headers, ":path");
  if(headp && !strncmp(headp, "/push-", 6)) {
    fprintf(stderr, "The PATH is %s\n", headp);

    /* save the push here */
    out = fopen("pushed-stream", "wb");

    /* write to this file */
    curl_easy_setopt(easy, CURLOPT_WRITEDATA, out);

    (*transfers)++; /* one more */

    return CURL_PUSH_OK;
  }
  return CURL_PUSH_DENY;
}

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

%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_byname
5Section: 3
6Source: libcurl
7See-also:
8 - CURLMOPT_PUSHFUNCTION (3)
9 - curl_pushheader_bynum (3)
10Protocol:
11 - HTTP
12Added-in: 7.44.0
13---
15# NAME
17curl_pushheader_byname - get a push header by name
19# SYNOPSIS
21~~~c
22#include <curl/curl.h>
24char *curl_pushheader_byname(struct curl_pushheaders *h, const char *name);
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 given header field name (or NULL) for the
34incoming server push request. This is a shortcut so that the application does
35not have to loop through all headers to find the one it is interested in. The
36data this function points to is freed when this callback returns and,
37although not constrained by its type, may not be altered. If more than
38one header field use the same name, this returns only the first one.
40# %PROTOCOLS%
42# EXAMPLE
44~~~c
45#include <string.h> /* for strncmp */
47static int push_cb(CURL *parent,
48 CURL *easy,
49 size_t num_headers,
50 struct curl_pushheaders *headers,
51 void *clientp)
53 char *headp;
54 int *transfers = (int *)clientp;
55 FILE *out;
56 headp = curl_pushheader_byname(headers, ":path");
57 if(headp && !strncmp(headp, "/push-", 6)) {
58 fprintf(stderr, "The PATH is %s\n", headp);
60 /* save the push here */
61 out = fopen("pushed-stream", "wb");
63 /* write to this file */
64 curl_easy_setopt(easy, CURLOPT_WRITEDATA, out);
66 (*transfers)++; /* one more */
68 return CURL_PUSH_OK;
69 }
70 return CURL_PUSH_DENY;
73int main(void)
75 int counter;
76 CURLM *multi = curl_multi_init();
77 curl_multi_setopt(multi, CURLMOPT_PUSHFUNCTION, push_cb);
78 curl_multi_setopt(multi, CURLMOPT_PUSHDATA, &counter);
80~~~
82# %AVAILABILITY%
84# RETURN VALUE
86Returns a pointer to the header field content or NULL.
Diagnostics4 git calls · 320 ms
CallStatusSizeTime0320 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=315
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
fetch2001.1 KiB315 ms
git.upload-pack fetch
http.response.status_code=200
git.response.bytes=1114
git.response.cache=MISS
git.response.duration_ms=315
git.fetch.wants=e2968fcd4621771b74a058c6db51c14fc651371f
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=1114
git.pkt.payload.max=1093
git.sideband.band1.bytes=1092
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
a5e32e2d1ed28821
Request
8e4563fc…
Protocol
v2 · sha1
Agent
gitty/1.0
Filter
advertised
Fetch
shallow filter sideband-all
Capabilities
agent ls-refs fetch object-format