Artifactspublic-v0

curl

master
ply4 git calls490 ms288 KiB2 cachedprotocol v2
88 lines2.0 KiBRaw

NAME

CURLOPT_PROXYHEADER - set of HTTP headers to pass to proxy

SYNOPSIS

c
#include <curl/curl.h>

CURLcode curl_easy_setopt(CURL *handle, CURLOPT_PROXYHEADER,
                          struct curl_slist *headers);

DESCRIPTION

Pass a pointer to a linked list of HTTP headers to pass in your HTTP request sent to a proxy. The rules for this list is identical to the CURLOPT_HTTPHEADER(3) option's.

The headers set with this option is only ever used in requests sent to a proxy

  • when there is also a request sent to a host.

The first line in a request (containing the method, usually a GET or POST) is NOT a header and cannot be replaced using this option. Only the lines following the request-line are headers. Adding this method line in this list of headers causes your request to send an invalid header.

Using this option multiple times makes the last set list override the previous ones. Set it to NULL to disable its use again.

libcurl does not copy the list, it needs to be kept around until after the transfer has completed.

DEFAULT

NULL

%PROTOCOLS%

EXAMPLE

c
int main(void)
{
  CURL *curl = curl_easy_init();

  struct curl_slist *list;

  if(curl) {
    CURLcode result;
    curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
    curl_easy_setopt(curl, CURLOPT_PROXY, "http://proxy.example.com:80");

    list = curl_slist_append(NULL, "Shoesize: 10");
    list = curl_slist_append(list, "Accept:");

    curl_easy_setopt(curl, CURLOPT_PROXYHEADER, list);

    result = curl_easy_perform(curl);

    curl_slist_free_all(list); /* free the list again */
    curl_easy_cleanup(curl);
  }
}

%AVAILABILITY%

RETURN VALUE

curl_easy_setopt(3) returns a CURLcode indicating success or error.

CURLE_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: CURLOPT_PROXYHEADER
5Section: 3
6Source: libcurl
7See-also:
8 - CURLOPT_HEADEROPT (3)
9 - CURLOPT_HTTPHEADER (3)
10Protocol:
11 - All
12Added-in: 7.37.0
13---
15# NAME
17CURLOPT_PROXYHEADER - set of HTTP headers to pass to proxy
19# SYNOPSIS
21~~~c
22#include <curl/curl.h>
24CURLcode curl_easy_setopt(CURL *handle, CURLOPT_PROXYHEADER,
25 struct curl_slist *headers);
26~~~
28# DESCRIPTION
30Pass a pointer to a linked list of HTTP headers to pass in your HTTP request
31sent to a proxy. The rules for this list is identical to the
32CURLOPT_HTTPHEADER(3) option's.
34The headers set with this option is only ever used in requests sent to a proxy
35- when there is also a request sent to a host.
37The first line in a request (containing the method, usually a GET or POST) is
38NOT a header and cannot be replaced using this option. Only the lines
39following the request-line are headers. Adding this method line in this list
40of headers causes your request to send an invalid header.
42Using this option multiple times makes the last set list override the previous
43ones. Set it to NULL to disable its use again.
45libcurl does not copy the list, it needs to be kept around until after the
46transfer has completed.
48# DEFAULT
50NULL
52# %PROTOCOLS%
54# EXAMPLE
56~~~c
57int main(void)
59 CURL *curl = curl_easy_init();
61 struct curl_slist *list;
63 if(curl) {
64 CURLcode result;
65 curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
66 curl_easy_setopt(curl, CURLOPT_PROXY, "http://proxy.example.com:80");
68 list = curl_slist_append(NULL, "Shoesize: 10");
69 list = curl_slist_append(list, "Accept:");
71 curl_easy_setopt(curl, CURLOPT_PROXYHEADER, list);
73 result = curl_easy_perform(curl);
75 curl_slist_free_all(list); /* free the list again */
76 curl_easy_cleanup(curl);
77 }
79~~~
81# %AVAILABILITY%
83# RETURN VALUE
85curl_easy_setopt(3) returns a CURLcode indicating success or error.
87CURLE_OK (0) means everything was OK, non-zero means an error occurred, see
88libcurl-errors(3).
Diagnostics4 git calls · 490 ms
CallStatusSizeTime0490 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 · 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 · hit4 ms
git.upload-pack fetch
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=fetch
git.upstream.dur_ms=483
git.response.bytes=293470
git.response.cache=HIT
git.response.duration_ms=4
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 KiB483 ms
git.upload-pack fetch
http.response.status_code=200
git.response.bytes=1118
git.response.cache=MISS
git.response.duration_ms=483
git.fetch.wants=340446b53eb291f6acc249778cd877d6e023b916
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=1118
git.pkt.payload.max=1097
git.sideband.band1.bytes=1096
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
a5e372de79c222ce
Request
95f25488…
Protocol
v2 · sha1
Agent
gitty/1.0
Filter
advertised
Fetch
shallow filter sideband-all
Capabilities
agent ls-refs fetch object-format