Artifactspublic-v0

curl

master
ply4 git calls272 ms288 KiB2 cachedprotocol v2
92 lines2.1 KiBRaw

NAME

CURLOPT_CA_CACHE_TIMEOUT - life-time for cached certificate stores

SYNOPSIS

c
#include <curl/curl.h>

CURLcode curl_easy_setopt(CURL *handle, CURLOPT_CA_CACHE_TIMEOUT, long age);

DESCRIPTION

Pass a long, this sets the timeout in seconds. This tells libcurl the maximum time any cached CA certificate store it has in memory may be kept and reused for new connections. Once the timeout has expired, a subsequent fetch requiring a CA certificate has to reload it.

Building a CA certificate store from a CURLOPT_CAINFO(3) file is a slow operation so curl may cache the generated certificate store internally to speed up future connections.

Set the timeout to zero to completely disable caching, or set to -1 to retain the cached store remain forever. By default, libcurl caches this info for 24 hours.

DEFAULT

86400 (24 hours)

%PROTOCOLS%

EXAMPLE

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

    /* only reuse certificate stores for a short time */
    curl_easy_setopt(curl, CURLOPT_CA_CACHE_TIMEOUT, 60L);

    result = curl_easy_perform(curl);

    /* in this second request, the cache is not used if more than
       sixty seconds passed since the previous connection */
    result = curl_easy_perform(curl);

    curl_easy_cleanup(curl);
  }
}

HISTORY

This option is supported by OpenSSL and its forks (since 7.87.0), Schannel (since 8.5.0), wolfSSL (since 8.9.0) and GnuTLS (since 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_CA_CACHE_TIMEOUT
5Section: 3
6Source: libcurl
7See-also:
8 - CURLOPT_CAINFO (3)
9 - CURLOPT_CAINFO_BLOB (3)
10 - CURLOPT_CAPATH (3)
11 - CURLOPT_SSL_VERIFYHOST (3)
12 - CURLOPT_SSL_VERIFYPEER (3)
13Protocol:
14 - TLS
15TLS-backend:
16 - GnuTLS
17 - OpenSSL
18 - Schannel
19 - wolfSSL
20Added-in: 7.87.0
21---
23# NAME
25CURLOPT_CA_CACHE_TIMEOUT - life-time for cached certificate stores
27# SYNOPSIS
29~~~c
30#include <curl/curl.h>
32CURLcode curl_easy_setopt(CURL *handle, CURLOPT_CA_CACHE_TIMEOUT, long age);
33~~~
35# DESCRIPTION
37Pass a long, this sets the timeout in seconds. This tells libcurl the maximum
38time any cached CA certificate store it has in memory may be kept and reused
39for new connections. Once the timeout has expired, a subsequent fetch
40requiring a CA certificate has to reload it.
42Building a CA certificate store from a CURLOPT_CAINFO(3) file is a slow
43operation so curl may cache the generated certificate store internally to
44speed up future connections.
46Set the timeout to zero to completely disable caching, or set to -1 to retain
47the cached store remain forever. By default, libcurl caches this info for 24
48hours.
50# DEFAULT
5286400 (24 hours)
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://example.com/foo.bin");
66 /* only reuse certificate stores for a short time */
67 curl_easy_setopt(curl, CURLOPT_CA_CACHE_TIMEOUT, 60L);
69 result = curl_easy_perform(curl);
71 /* in this second request, the cache is not used if more than
72 sixty seconds passed since the previous connection */
73 result = curl_easy_perform(curl);
75 curl_easy_cleanup(curl);
76 }
78~~~
80# HISTORY
82This option is supported by OpenSSL and its forks (since 7.87.0), Schannel
83(since 8.5.0), wolfSSL (since 8.9.0) and GnuTLS (since 8.9.0).
85# %AVAILABILITY%
87# RETURN VALUE
89curl_easy_setopt(3) returns a CURLcode indicating success or error.
91CURLE_OK (0) means everything was OK, non-zero means an error occurred, see
92libcurl-errors(3).
Diagnostics4 git calls · 272 ms
CallStatusSizeTime0272 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 · 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 · hit2 ms
git.upload-pack fetch
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=fetch
git.upstream.dur_ms=267
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 KiB267 ms
git.upload-pack fetch
http.response.status_code=200
git.response.bytes=1160
git.response.cache=MISS
git.response.duration_ms=267
git.fetch.wants=af677d8b1456a75cc1309b5e9a378451249dc2a0
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=1160
git.pkt.payload.max=1139
git.sideband.band1.bytes=1138
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
a5e371b6c9f522ce
Request
ffec032a…
Protocol
v2 · sha1
Agent
gitty/1.0
Filter
advertised
Fetch
shallow filter sideband-all
Capabilities
agent ls-refs fetch object-format