Artifactspublic-v0

curl

master
ply4 git calls794 ms288 KiB2 cachedprotocol v2
94 lines2.1 KiBRaw

NAME

CURLOPT_CAINFO_BLOB - Certificate Authority (CA) bundle in PEM format

SYNOPSIS

c
#include <curl/curl.h>

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

DESCRIPTION

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 server 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_SSL_VERIFYPEER(3) is zero and you avoid verifying the server's certificate, CURLOPT_CAINFO_BLOB(3) is not needed.

This option overrides CURLOPT_CAINFO(3).

DEFAULT

NULL

%PROTOCOLS%

EXAMPLE

c
#include <stdint.h> /* for uintptr_t */
#include <string.h>

int main(void)
{
  static const char *strpem = "PEMDATA"; /* must point to a PEM string */
  CURL *curl = curl_easy_init();
  if(curl) {
    CURLcode result;
    struct curl_blob blob;
    curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
    blob.data = (void *)(uintptr_t)(const void *)strpem; /* strip const */
    blob.len = strlen(strpem);
    blob.flags = CURL_BLOB_COPY;
    curl_easy_setopt(curl, CURLOPT_CAINFO_BLOB, &blob);
    result = curl_easy_perform(curl);
    curl_easy_cleanup(curl);
  }
}

HISTORY

This option is supported by the mbedTLS (since 7.81.0), Rustls (since 7.82.0), wolfSSL (since 8.2.0), GnuTLS (since 8.18.0), OpenSSL and Schannel backends.

%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_CAINFO_BLOB
5Section: 3
6Source: libcurl
7Protocol:
8 - TLS
9See-also:
10 - CURLOPT_CAINFO (3)
11 - CURLOPT_CAPATH (3)
12 - CURLOPT_SSL_VERIFYHOST (3)
13 - CURLOPT_SSL_VERIFYPEER (3)
14TLS-backend:
15 - OpenSSL
16 - GnuTLS
17 - mbedTLS
18 - Rustls
19 - wolfSSL
20 - Schannel
21Added-in: 7.77.0
22---
24# NAME
26CURLOPT_CAINFO_BLOB - Certificate Authority (CA) bundle in PEM format
28# SYNOPSIS
30~~~c
31#include <curl/curl.h>
33CURLcode curl_easy_setopt(CURL *handle, CURLOPT_CAINFO_BLOB,
34 struct curl_blob *stblob);
35~~~
37# DESCRIPTION
39Pass a pointer to a curl_blob structure, which contains information (pointer
40and size) about a memory block with binary data of PEM encoded content holding
41one or more certificates to verify the HTTPS server with.
43If the blob is initialized with the flags member of struct curl_blob set to
44CURL_BLOB_COPY, the application does not have to keep the buffer around after
45setting this.
47If CURLOPT_SSL_VERIFYPEER(3) is zero and you avoid verifying the
48server's certificate, CURLOPT_CAINFO_BLOB(3) is not needed.
50This option overrides CURLOPT_CAINFO(3).
52# DEFAULT
54NULL
56# %PROTOCOLS%
58# EXAMPLE
60~~~c
61#include <stdint.h> /* for uintptr_t */
62#include <string.h>
64int main(void)
66 static const char *strpem = "PEMDATA"; /* must point to a PEM string */
67 CURL *curl = curl_easy_init();
68 if(curl) {
69 CURLcode result;
70 struct curl_blob blob;
71 curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
72 blob.data = (void *)(uintptr_t)(const void *)strpem; /* strip const */
73 blob.len = strlen(strpem);
74 blob.flags = CURL_BLOB_COPY;
75 curl_easy_setopt(curl, CURLOPT_CAINFO_BLOB, &blob);
76 result = curl_easy_perform(curl);
77 curl_easy_cleanup(curl);
78 }
80~~~
82# HISTORY
84This option is supported by the mbedTLS (since 7.81.0), Rustls (since 7.82.0),
85wolfSSL (since 8.2.0), GnuTLS (since 8.18.0), OpenSSL and Schannel backends.
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 · 794 ms
CallStatusSizeTime0794 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=5
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 · hit5 ms
git.upload-pack fetch
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=fetch
git.upstream.dur_ms=787
git.response.bytes=293470
git.response.cache=HIT
git.response.duration_ms=5
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.2 KiB787 ms
git.upload-pack fetch
http.response.status_code=200
git.response.bytes=1187
git.response.cache=MISS
git.response.duration_ms=787
git.fetch.wants=0b243da5a76d9989ed4d56ccc1da1c8e575156bf
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=1187
git.pkt.payload.max=1166
git.sideband.band1.bytes=1165
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
a5e37095fb1f22ce
Request
cefecda7…
Protocol
v2 · sha1
Agent
gitty/1.0
Filter
advertised
Fetch
shallow filter sideband-all
Capabilities
agent ls-refs fetch object-format