Artifactspublic-v0

curl

master
ply4 git calls430 ms288 KiB2 cachedprotocol v2
109 lines2.5 KiBRaw

NAME

CURLINFO_CERTINFO - TLS certificate chain

SYNOPSIS

c
#include <curl/curl.h>

CURLcode curl_easy_getinfo(CURL *handle, CURLINFO_CERTINFO,
                           struct curl_certinfo **chainp);

DESCRIPTION

Pass a pointer to a struct curl_certinfo * and it is set to point to a struct that holds info about the server's certificate chain, assuming you had CURLOPT_CERTINFO(3) enabled when the request was made.

c
struct curl_certinfo {
  int num_of_certs;
  struct curl_slist **certinfo;
};

The certinfo struct member is an array of linked lists of certificate information. The num_of_certs struct member is the number of certificates which is the number of elements in the array. Each certificate's list has items with textual information in the format "name:content" such as "Subject:Foo", "Issuer:Bar", etc. The items in each list varies depending on the SSL backend and the certificate.

%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) {
      int i;
      struct curl_certinfo *ci;
      result = curl_easy_getinfo(curl, CURLINFO_CERTINFO, &ci);

      if(result == CURLE_OK) {
        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);
  }
}

See also the certinfo.c example.

HISTORY

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

%AVAILABILITY%

RETURN VALUE

curl_easy_getinfo(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: CURLINFO_CERTINFO
5Section: 3
6Source: libcurl
7See-also:
8 - CURLINFO_CAPATH (3)
9 - curl_easy_getinfo (3)
10 - curl_easy_setopt (3)
11Protocol:
12 - TLS
13TLS-backend:
14 - OpenSSL
15 - GnuTLS
16 - Schannel
17 - Rustls
18Added-in: 7.19.1
19---
21# NAME
23CURLINFO_CERTINFO - TLS certificate chain
25# SYNOPSIS
27~~~c
28#include <curl/curl.h>
30CURLcode curl_easy_getinfo(CURL *handle, CURLINFO_CERTINFO,
31 struct curl_certinfo **chainp);
32~~~
34# DESCRIPTION
36Pass a pointer to a `struct curl_certinfo *` and it is set to point to a
37struct that holds info about the server's certificate chain, assuming you had
38CURLOPT_CERTINFO(3) enabled when the request was made.
40~~~c
41struct curl_certinfo {
42 int num_of_certs;
43 struct curl_slist **certinfo;
44};
45~~~
47The *certinfo* struct member is an array of linked lists of certificate
48information. The *num_of_certs* struct member is the number of certificates
49which is the number of elements in the array. Each certificate's list has
50items with textual information in the format "name:content" such as
51"Subject:Foo", "Issuer:Bar", etc. The items in each list varies depending on
52the SSL backend and the certificate.
54# %PROTOCOLS%
56# EXAMPLE
58~~~c
59int main(void)
61 CURL *curl = curl_easy_init();
62 if(curl) {
63 CURLcode result;
64 curl_easy_setopt(curl, CURLOPT_URL, "https://www.example.com/");
66 /* connect to any HTTPS site, trusted or not */
67 curl_easy_setopt(curl, CURLOPT_SSL_VERIFYPEER, 0L);
68 curl_easy_setopt(curl, CURLOPT_SSL_VERIFYHOST, 0L);
70 curl_easy_setopt(curl, CURLOPT_CERTINFO, 1L);
72 result = curl_easy_perform(curl);
74 if(result == CURLE_OK) {
75 int i;
76 struct curl_certinfo *ci;
77 result = curl_easy_getinfo(curl, CURLINFO_CERTINFO, &ci);
79 if(result == CURLE_OK) {
80 printf("%d certs!\n", ci->num_of_certs);
82 for(i = 0; i < ci->num_of_certs; i++) {
83 struct curl_slist *slist;
85 for(slist = ci->certinfo[i]; slist; slist = slist->next)
86 printf("%s\n", slist->data);
87 }
88 }
89 }
90 curl_easy_cleanup(curl);
91 }
93~~~
95See also the *certinfo.c* example.
97# HISTORY
99GnuTLS support added in 7.42.0. Schannel support added in 7.50.0. mbedTLS
100support added in 8.9.0.
102# %AVAILABILITY%
104# RETURN VALUE
106curl_easy_getinfo(3) returns a CURLcode indicating success or error.
108CURLE_OK (0) means everything was OK, non-zero means an error occurred, see
109libcurl-errors(3).
Diagnostics4 git calls · 430 ms
CallStatusSizeTime0430 ms
discover200152 B2 ms
git.upload-pack discover
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=ls-refs
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 · hit3 ms
git.upload-pack fetch
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=fetch
git.upstream.dur_ms=3
git.response.bytes=293470
git.response.cache=HIT
git.response.duration_ms=3
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 KiB425 ms
git.upload-pack fetch
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=fetch
git.upstream.dur_ms=425
git.response.bytes=1265
git.response.cache=MISS
git.response.duration_ms=425
git.fetch.wants=4d95ad7509b3d6b594eed701f380edc71465e2a8
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=1265
git.pkt.payload.max=1244
git.sideband.band1.bytes=1243
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
a5e312db89983e6e
Request
1ee02c24…
Protocol
v2 · sha1
Agent
gitty/1.0
Filter
advertised
Fetch
shallow filter sideband-all
Capabilities
agent ls-refs fetch object-format