Artifactspublic-v0

curl

master
ply4 git calls421 ms288 KiB2 cachedprotocol v2
99 lines2.1 KiBRaw

NAME

CURLOPT_CERTINFO - request SSL certificate information

SYNOPSIS

c
#include <curl/curl.h>

CURLcode curl_easy_setopt(CURL *handle, CURLOPT_CERTINFO, long certinfo);

DESCRIPTION

Pass a long set to 1 to enable libcurl's certificate chain info gatherer. With this enabled, libcurl extracts lots of information and data about the certificates in the certificate chain used in the SSL connection. This data may then be retrieved after a transfer using curl_easy_getinfo(3) and its option CURLINFO_CERTINFO(3).

DEFAULT

0

%PROTOCOLS%

EXAMPLE

c
int main(void)
{
  CURL *curl = curl_easy_init();
  if(curl) {
    CURLcode result;
    curl_easy_setopt(curl, CURLOPT_URL, "https://www.example.com/");

    /* connect to any HTTPS site, trusted or not */
    curl_easy_setopt(curl, CURLOPT_SSL_VERIFYPEER, 0L);
    curl_easy_setopt(curl, CURLOPT_SSL_VERIFYHOST, 0L);

    curl_easy_setopt(curl, CURLOPT_CERTINFO, 1L);

    result = curl_easy_perform(curl);

    if(result == CURLE_OK) {
      struct curl_certinfo *ci;
      result = curl_easy_getinfo(curl, CURLINFO_CERTINFO, &ci);

      if(result == CURLE_OK) {
        int i;
        printf("%d certs!\n", ci->num_of_certs);

        for(i = 0; i < ci->num_of_certs; i++) {
          struct curl_slist *slist;

          for(slist = ci->certinfo[i]; slist; slist = slist->next)
            printf("%s\n", slist->data);
        }
      }
    }
    curl_easy_cleanup(curl);
  }
}

HISTORY

Schannel support added in 7.50.0. mbedTLS support added in 8.9.0.

%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_CERTINFO
5Section: 3
6Source: libcurl
7See-also:
8 - CURLINFO_CAINFO (3)
9 - CURLINFO_CAPATH (3)
10 - CURLINFO_CERTINFO (3)
11 - CURLOPT_CAINFO (3)
12 - CURLOPT_SSL_VERIFYPEER (3)
13Protocol:
14 - TLS
15TLS-backend:
16 - OpenSSL
17 - GnuTLS
18 - Schannel
19 - Rustls
20Added-in: 7.19.1
21---
23# NAME
25CURLOPT_CERTINFO - request SSL certificate information
27# SYNOPSIS
29~~~c
30#include <curl/curl.h>
32CURLcode curl_easy_setopt(CURL *handle, CURLOPT_CERTINFO, long certinfo);
33~~~
35# DESCRIPTION
37Pass a long set to 1 to enable libcurl's certificate chain info gatherer. With
38this enabled, libcurl extracts lots of information and data about the
39certificates in the certificate chain used in the SSL connection. This data
40may then be retrieved after a transfer using curl_easy_getinfo(3) and
41its option CURLINFO_CERTINFO(3).
43# DEFAULT
47# %PROTOCOLS%
49# EXAMPLE
51~~~c
52int main(void)
54 CURL *curl = curl_easy_init();
55 if(curl) {
56 CURLcode result;
57 curl_easy_setopt(curl, CURLOPT_URL, "https://www.example.com/");
59 /* connect to any HTTPS site, trusted or not */
60 curl_easy_setopt(curl, CURLOPT_SSL_VERIFYPEER, 0L);
61 curl_easy_setopt(curl, CURLOPT_SSL_VERIFYHOST, 0L);
63 curl_easy_setopt(curl, CURLOPT_CERTINFO, 1L);
65 result = curl_easy_perform(curl);
67 if(result == CURLE_OK) {
68 struct curl_certinfo *ci;
69 result = curl_easy_getinfo(curl, CURLINFO_CERTINFO, &ci);
71 if(result == CURLE_OK) {
72 int i;
73 printf("%d certs!\n", ci->num_of_certs);
75 for(i = 0; i < ci->num_of_certs; i++) {
76 struct curl_slist *slist;
78 for(slist = ci->certinfo[i]; slist; slist = slist->next)
79 printf("%s\n", slist->data);
80 }
81 }
82 }
83 curl_easy_cleanup(curl);
84 }
86~~~
88# HISTORY
90Schannel support added in 7.50.0. mbedTLS support added in 8.9.0.
92# %AVAILABILITY%
94# RETURN VALUE
96curl_easy_setopt(3) returns a CURLcode indicating success or error.
98CURLE_OK (0) means everything was OK, non-zero means an error occurred, see
99libcurl-errors(3).
Diagnostics4 git calls · 421 ms
CallStatusSizeTime0421 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=3
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 · hit5 ms
git.upload-pack fetch
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=fetch
git.upstream.dur_ms=413
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.1 KiB413 ms
git.upload-pack fetch
http.response.status_code=200
git.response.bytes=1105
git.response.cache=MISS
git.response.duration_ms=413
git.fetch.wants=fdaa0d213240d7bb081f223688b6f1bfb1f105f5
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=1105
git.pkt.payload.max=1084
git.sideband.band1.bytes=1083
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
a5e323fb2b205aae
Request
dfb75d95…
Protocol
v2 · sha1
Agent
gitty/1.0
Filter
advertised
Fetch
shallow filter sideband-all
Capabilities
agent ls-refs fetch object-format