Artifactspublic-v0

curl

master
ply4 git calls251 ms288 KiB2 cachedprotocol v2
94 lines2.2 KiBRaw

NAME

CURLOPT_PROXY_CAINFO_BLOB - proxy Certificate Authority (CA) bundle in PEM format

SYNOPSIS

c
#include <curl/curl.h>

CURLcode curl_easy_setopt(CURL *handle, CURLOPT_PROXY_CAINFO_BLOB,
                          struct curl_blob *stblob);

DESCRIPTION

This option is for connecting to an HTTPS proxy, not an HTTPS server.

Pass a pointer to a curl_blob structure, which contains information (pointer and size) about a memory block with binary data of PEM encoded content holding one or more certificates to verify the HTTPS proxy with.

If the blob is initialized with the flags member of struct curl_blob set to CURL_BLOB_COPY, the application does not have to keep the buffer around after setting this.

If CURLOPT_PROXY_SSL_VERIFYPEER(3) is zero and you avoid verifying the server's certificate, CURLOPT_PROXY_CAINFO_BLOB(3) is not needed.

This option overrides CURLOPT_PROXY_CAINFO(3).

DEFAULT

NULL

%PROTOCOLS%

EXAMPLE

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

extern char *strpem; /* strpem must point to a PEM string */
int main(void)
{
  CURL *curl = curl_easy_init();
  if(curl) {
    CURLcode result;
    struct curl_blob blob;
    curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
    /* using an HTTPS proxy */
    curl_easy_setopt(curl, CURLOPT_PROXY, "https://proxy.example:443");
    blob.data = strpem;
    blob.len = strlen(strpem);
    blob.flags = CURL_BLOB_COPY;
    curl_easy_setopt(curl, CURLOPT_PROXY_CAINFO_BLOB, &blob);
    result = curl_easy_perform(curl);
    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_PROXY_CAINFO_BLOB
5Section: 3
6Source: libcurl
7See-also:
8 - CURLOPT_CAINFO (3)
9 - CURLOPT_CAINFO_BLOB (3)
10 - CURLOPT_CAPATH (3)
11 - CURLOPT_PROXY_CAINFO (3)
12 - CURLOPT_PROXY_CAPATH (3)
13 - CURLOPT_PROXY_SSL_VERIFYHOST (3)
14 - CURLOPT_PROXY_SSL_VERIFYPEER (3)
15 - CURLOPT_SSL_VERIFYHOST (3)
16 - CURLOPT_SSL_VERIFYPEER (3)
17Protocol:
18 - TLS
19TLS-backend:
20 - OpenSSL
21 - Rustls
22 - Schannel
23Added-in: 7.77.0
24---
26# NAME
28CURLOPT_PROXY_CAINFO_BLOB - proxy Certificate Authority (CA) bundle in PEM format
30# SYNOPSIS
32~~~c
33#include <curl/curl.h>
35CURLcode curl_easy_setopt(CURL *handle, CURLOPT_PROXY_CAINFO_BLOB,
36 struct curl_blob *stblob);
37~~~
39# DESCRIPTION
41This option is for connecting to an HTTPS proxy, not an HTTPS server.
43Pass a pointer to a curl_blob structure, which contains information (pointer
44and size) about a memory block with binary data of PEM encoded content holding
45one or more certificates to verify the HTTPS proxy with.
47If the blob is initialized with the flags member of struct curl_blob set to
48CURL_BLOB_COPY, the application does not have to keep the buffer around after
49setting this.
51If CURLOPT_PROXY_SSL_VERIFYPEER(3) is zero and you avoid verifying the
52server's certificate, CURLOPT_PROXY_CAINFO_BLOB(3) is not needed.
54This option overrides CURLOPT_PROXY_CAINFO(3).
56# DEFAULT
58NULL
60# %PROTOCOLS%
62# EXAMPLE
64~~~c
65#include <string.h> /* for strlen */
67extern char *strpem; /* strpem must point to a PEM string */
68int main(void)
70 CURL *curl = curl_easy_init();
71 if(curl) {
72 CURLcode result;
73 struct curl_blob blob;
74 curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
75 /* using an HTTPS proxy */
76 curl_easy_setopt(curl, CURLOPT_PROXY, "https://proxy.example:443");
77 blob.data = strpem;
78 blob.len = strlen(strpem);
79 blob.flags = CURL_BLOB_COPY;
80 curl_easy_setopt(curl, CURLOPT_PROXY_CAINFO_BLOB, &blob);
81 result = curl_easy_perform(curl);
82 curl_easy_cleanup(curl);
83 }
85~~~
87# %AVAILABILITY%
89# RETURN VALUE
91curl_easy_setopt(3) returns a CURLcode indicating success or error.
93CURLE_OK (0) means everything was OK, non-zero means an error occurred, see
94libcurl-errors(3).
Diagnostics4 git calls · 251 ms
CallStatusSizeTime0251 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=247
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 KiB247 ms
git.upload-pack fetch
http.response.status_code=200
git.response.bytes=1132
git.response.cache=MISS
git.response.duration_ms=247
git.fetch.wants=36666edf212c10004525e67fabc08d9cdc42b112
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=1132
git.pkt.payload.max=1111
git.sideband.band1.bytes=1110
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
a5e37661fbf5a140
Request
7faac906…
Protocol
v2 · sha1
Agent
gitty/1.0
Filter
advertised
Fetch
shallow filter sideband-all
Capabilities
agent ls-refs fetch object-format