Artifactspublic-v0

curl

master
ply4 git calls36 ms288 KiB3 cachedprotocol v2
109 lines2.3 KiBRaw

NAME

CURLOPT_ECH - configuration for Encrypted Client Hello

SYNOPSIS

c
#include <curl/curl.h>

CURLcode curl_easy_setopt(CURL *handle, CURLOPT_ECH, char *config);

DESCRIPTION

This feature is experimental and may change before it is considered stable. We advise against using it in production.

ECH is only compatible with TLSv1.3.

Pass a string that specifies configuration details for ECH. In all cases, if ECH is attempted, it may fail for various reasons. The keywords supported are:

false

Turns off ECH.

grease

Instructs client to emit a GREASE ECH extension. (The connection fails if ECH is attempted but fails.)

true

Instructs client to attempt ECH, if possible, but to not fail if attempting ECH is not possible.

hard

Instructs client to attempt ECH and fail if attempting ECH is not possible.

ecl:<base64-value>

If the string starts with ecl: then the remainder of the string should be a base64-encoded ECHConfigList that is used for ECH rather than attempting to download such a value from the DNS.

pn:<name>

If the string starts with pn: then the remainder of the string should be a DNS/hostname that is used to over-ride the public_name field of the ECHConfigList that is used for ECH.

The application does not have to keep the string around after setting this option.

Using this option multiple times makes the last set string override the previous ones. Set it to NULL or "false" to disable its use again.

DEFAULT

NULL, meaning ECH is disabled.

%PROTOCOLS%

EXAMPLE

c
int main(void)
{
  CURL *curl = curl_easy_init();

  static const char *config =
    "ecl:AED+DQA87wAgACB/RuzUCsW3uBbSFI7mzD63TUXpI8sGDTnFTbFCDpa+"
    "CAAEAAEAAQANY292ZXIuZGVmby5pZQAA";
  if(curl) {
    CURLcode result;
    curl_easy_setopt(curl, CURLOPT_ECH, config);
    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_ECH
5Section: 3
6Source: libcurl
7See-also:
8 - CURLOPT_DOH_URL (3)
9Protocol:
10 - TLS
11TLS-backend:
12 - OpenSSL
13 - wolfSSL
14 - Rustls
15Added-in: 8.8.0
16---
18# NAME
20CURLOPT_ECH - configuration for Encrypted Client Hello
22# SYNOPSIS
24~~~c
25#include <curl/curl.h>
27CURLcode curl_easy_setopt(CURL *handle, CURLOPT_ECH, char *config);
28~~~
30# DESCRIPTION
32This feature is **experimental** and may change before it is considered
33stable. We advise against using it in production.
35ECH is only compatible with TLSv1.3.
37Pass a string that specifies configuration details for ECH. In all cases, if
38ECH is attempted, it may fail for various reasons. The keywords supported are:
40## false
42Turns off ECH.
44## grease
46Instructs client to emit a GREASE ECH extension. (The connection fails if ECH
47is attempted but fails.)
49## true
51Instructs client to attempt ECH, if possible, but to not fail if attempting
52ECH is not possible.
54## hard
56Instructs client to attempt ECH and fail if attempting ECH is not possible.
58## ecl:\<base64-value\>
60If the string starts with `ecl:` then the remainder of the string should be a
61base64-encoded ECHConfigList that is used for ECH rather than attempting to
62download such a value from the DNS.
64## pn:\<name\>
66If the string starts with `pn:` then the remainder of the string should be a
67DNS/hostname that is used to over-ride the public_name field of the
68ECHConfigList that is used for ECH.
70##
72The application does not have to keep the string around after setting this
73option.
75Using this option multiple times makes the last set string override the
76previous ones. Set it to NULL or "false" to disable its use again.
78# DEFAULT
80NULL, meaning ECH is disabled.
82# %PROTOCOLS%
84# EXAMPLE
86~~~c
87int main(void)
89 CURL *curl = curl_easy_init();
91 static const char *config =
92 "ecl:AED+DQA87wAgACB/RuzUCsW3uBbSFI7mzD63TUXpI8sGDTnFTbFCDpa+"
93 "CAAEAAEAAQANY292ZXIuZGVmby5pZQAA";
94 if(curl) {
95 CURLcode result;
96 curl_easy_setopt(curl, CURLOPT_ECH, config);
97 result = curl_easy_perform(curl);
98 curl_easy_cleanup(curl);
99 }
101~~~
102# %AVAILABILITY%
104# RETURN VALUE
106curl_easy_setopt(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 · 36 ms
CallStatusSizeTime036 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.3 KiB · hit31 ms
git.upload-pack fetch
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=fetch
git.upstream.dur_ms=31
git.response.bytes=1336
git.response.cache=HIT
git.response.duration_ms=31
git.fetch.wants=660102c4ce4335f1b35036f7ea9f95a2dd4a3399
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=1336
git.pkt.payload.max=1315
git.sideband.band1.bytes=1314
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
a5e3135648e53e6e
Request
87cc9a58…
Protocol
v2 · sha1
Agent
gitty/1.0
Filter
advertised
Fetch
shallow filter sideband-all
Capabilities
agent ls-refs fetch object-format