Artifactspublic-v0

curl

master
ply4 git calls158 ms288 KiB2 cachedprotocol v2
131 lines3.3 KiBRaw

NAME

CURLOPT_HTTP_VERSION - HTTP protocol version to use

SYNOPSIS

c
#include <curl/curl.h>

CURLcode curl_easy_setopt(CURL *handle, CURLOPT_HTTP_VERSION, long version);

DESCRIPTION

Pass version a long, set to one of the values described below. They ask libcurl to use the specific HTTP versions.

Note that the HTTP version is a request. libcurl still prioritizes to reuse existing connections so it might then reuse a connection using an HTTP version you have not asked for.

CURL_HTTP_VERSION_NONE

We do not care about what version the library uses. libcurl uses whatever it thinks fit.

CURL_HTTP_VERSION_1_0

Enforce HTTP 1.0 requests.

CURL_HTTP_VERSION_1_1

Enforce HTTP 1.1 requests.

CURL_HTTP_VERSION_2_0

Attempt HTTP 2 requests. libcurl falls back to HTTP 1.1 if HTTP 2 cannot be negotiated with the server.

When libcurl uses HTTP/2 over HTTPS, it does not itself insist on TLS 1.2 or higher even though that is required by the specification. A user can add this version requirement with CURLOPT_SSLVERSION(3).

The alias CURL_HTTP_VERSION_2 was added to better reflect the actual protocol name.

CURL_HTTP_VERSION_2TLS

Attempt HTTP 2 over TLS (HTTPS) only. libcurl falls back to HTTP 1.1 if HTTP 2 cannot be negotiated with the HTTPS server. For clear text HTTP servers, libcurl uses 1.1.

CURL_HTTP_VERSION_2_PRIOR_KNOWLEDGE

Issue non-TLS HTTP requests using HTTP/2 without HTTP/1.1 Upgrade. It requires prior knowledge that the server supports HTTP/2 straight away. HTTPS requests still do HTTP/2 the standard way with negotiated protocol version in the TLS handshake.

Since 8.10.0 if this option is set for an HTTPS request then the application layer protocol version (ALPN) offered to the server is only HTTP/2. Prior to that both HTTP/1.1 and HTTP/2 were offered.

CURL_HTTP_VERSION_3

(Added in 7.66.0) This option makes libcurl attempt to use HTTP/3 to the host given in the URL, with fallback to earlier HTTP versions if needed.

CURL_HTTP_VERSION_3ONLY

(Added in 7.88.0) Setting this makes libcurl attempt to use HTTP/3 directly to server given in the URL and does not downgrade to earlier HTTP version if the server does not support HTTP/3.

DEFAULT

Since curl 8.13.0: CURL_HTTP_VERSION_NONE

Since curl 7.62.0: CURL_HTTP_VERSION_2TLS

Before that: CURL_HTTP_VERSION_1_1

%PROTOCOLS%

EXAMPLE

c
int main(void)
{
  CURL *curl = curl_easy_init();
  if(curl) {
    CURLcode result;
    curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
    curl_easy_setopt(curl, CURLOPT_HTTP_VERSION, CURL_HTTP_VERSION_2TLS);
    result = curl_easy_perform(curl);
    if(result == CURLE_HTTP_RETURNED_ERROR) {
      /* an HTTP response error problem */
    }
  }
}

HISTORY

CURL_HTTP_VERSION_* enums became long types in 8.13.0, prior to this version a long cast was necessary when passed to curl_easy_setopt(3).

%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_HTTP_VERSION
5Section: 3
6Source: libcurl
7Protocol:
8 - HTTP
9See-also:
10 - CURLOPT_ALTSVC (3)
11 - CURLOPT_HTTP09_ALLOWED (3)
12 - CURLOPT_HTTP200ALIASES (3)
13 - CURLOPT_SSLVERSION (3)
14Added-in: 7.9.1
15---
17# NAME
19CURLOPT_HTTP_VERSION - HTTP protocol version to use
21# SYNOPSIS
23~~~c
24#include <curl/curl.h>
26CURLcode curl_easy_setopt(CURL *handle, CURLOPT_HTTP_VERSION, long version);
27~~~
29# DESCRIPTION
31Pass *version* a long, set to one of the values described below. They ask
32libcurl to use the specific HTTP versions.
34Note that the HTTP version is a request. libcurl still prioritizes to reuse
35existing connections so it might then reuse a connection using an HTTP version
36you have not asked for.
38## CURL_HTTP_VERSION_NONE
40We do not care about what version the library uses. libcurl uses whatever it
41thinks fit.
43## CURL_HTTP_VERSION_1_0
45Enforce HTTP 1.0 requests.
47## CURL_HTTP_VERSION_1_1
49Enforce HTTP 1.1 requests.
51## CURL_HTTP_VERSION_2_0
53Attempt HTTP 2 requests. libcurl falls back to HTTP 1.1 if HTTP 2 cannot be
54negotiated with the server.
56When libcurl uses HTTP/2 over HTTPS, it does not itself insist on TLS 1.2 or
57higher even though that is required by the specification. A user can add this
58version requirement with CURLOPT_SSLVERSION(3).
60The alias *CURL_HTTP_VERSION_2* was added to better reflect the actual
61protocol name.
63## CURL_HTTP_VERSION_2TLS
65Attempt HTTP 2 over TLS (HTTPS) only. libcurl falls back to HTTP 1.1 if HTTP 2
66cannot be negotiated with the HTTPS server. For clear text HTTP servers,
67libcurl uses 1.1.
69## CURL_HTTP_VERSION_2_PRIOR_KNOWLEDGE
71Issue non-TLS HTTP requests using HTTP/2 without HTTP/1.1 Upgrade. It requires
72prior knowledge that the server supports HTTP/2 straight away. HTTPS requests
73still do HTTP/2 the standard way with negotiated protocol version in the TLS
74handshake.
76Since 8.10.0 if this option is set for an HTTPS request then the application
77layer protocol version (ALPN) offered to the server is only HTTP/2. Prior to
78that both HTTP/1.1 and HTTP/2 were offered.
80## CURL_HTTP_VERSION_3
82(Added in 7.66.0) This option makes libcurl attempt to use HTTP/3 to the host
83given in the URL, with fallback to earlier HTTP versions if needed.
85## CURL_HTTP_VERSION_3ONLY
87(Added in 7.88.0) Setting this makes libcurl attempt to use HTTP/3 directly to
88server given in the URL and does not downgrade to earlier HTTP version if the
89server does not support HTTP/3.
91# DEFAULT
93Since curl 8.13.0: CURL_HTTP_VERSION_NONE
95Since curl 7.62.0: CURL_HTTP_VERSION_2TLS
97Before that: CURL_HTTP_VERSION_1_1
99# %PROTOCOLS%
101# EXAMPLE
103~~~c
104int main(void)
106 CURL *curl = curl_easy_init();
107 if(curl) {
108 CURLcode result;
109 curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
110 curl_easy_setopt(curl, CURLOPT_HTTP_VERSION, CURL_HTTP_VERSION_2TLS);
111 result = curl_easy_perform(curl);
112 if(result == CURLE_HTTP_RETURNED_ERROR) {
113 /* an HTTP response error problem */
114 }
115 }
117~~~
119# HISTORY
121**CURL_HTTP_VERSION_*** enums became `long` types in 8.13.0, prior to this
122version a `long` cast was necessary when passed to curl_easy_setopt(3).
124# %AVAILABILITY%
126# RETURN VALUE
128curl_easy_setopt(3) returns a CURLcode indicating success or error.
130CURLE_OK (0) means everything was OK, non-zero means an error occurred, see
131libcurl-errors(3).
Diagnostics4 git calls · 158 ms
CallStatusSizeTime0158 ms
discover200152 B3 ms
git.upload-pack discover
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=ls-refs
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 · hit2 ms
git.upload-pack fetch
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=fetch
git.upstream.dur_ms=2
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.6 KiB153 ms
git.upload-pack fetch
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=fetch
git.upstream.dur_ms=152
git.response.bytes=1616
git.response.cache=MISS
git.response.duration_ms=153
git.fetch.wants=f865955d484e137f7058f507ab714be3a3fd7fe5
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=1616
git.pkt.payload.max=1595
git.sideband.band1.bytes=1594
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
a5e3130deec93e6e
Request
1813152b…
Protocol
v2 · sha1
Agent
gitty/1.0
Filter
advertised
Fetch
shallow filter sideband-all
Capabilities
agent ls-refs fetch object-format