Artifactspublic-v0

curl

master
ply4 git calls120 ms288 KiB2 cachedprotocol v2
155 lines3.5 KiBRaw

NAME

CURLOPT_SSLVERSION - preferred TLS/SSL version

SYNOPSIS

c
#include <curl/curl.h>

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

DESCRIPTION

Pass a long as parameter to control which version range of SSL/TLS versions to use.

The SSL and TLS versions have typically developed from the most insecure version to be more and more secure in this order through history: SSLv2, SSLv3, TLSv1.0, TLSv1.1, TLSv1.2 and the most recent TLSv1.3.

Use one of the available defines for this purpose. The available options are:

CURL_SSLVERSION_DEFAULT

The default acceptable version range. The minimum acceptable version is by default TLSv1.2 since 8.16.0 (unless the TLS library has a stricter rule).

CURL_SSLVERSION_TLSv1

TLSv1.0 or later

CURL_SSLVERSION_SSLv2

SSLv2 - refused

CURL_SSLVERSION_SSLv3

SSLv3 - refused

CURL_SSLVERSION_TLSv1_0

TLSv1.0 or later

CURL_SSLVERSION_TLSv1_1

TLSv1.1 or later

CURL_SSLVERSION_TLSv1_2

TLSv1.2 or later

CURL_SSLVERSION_TLSv1_3

TLSv1.3 or later

The maximum TLS version can be set by using one of the CURL_SSLVERSION_MAX_ macros below. It is also possible to OR one of the CURL_SSLVERSION_ macros with one of the CURL_SSLVERSION_MAX_ macros.

CURL_SSLVERSION_MAX_DEFAULT

The flag defines the maximum supported TLS version by libcurl, or the default value from the SSL library is used. libcurl uses a sensible default maximum, which was TLSv1.2 up to before 7.61.0 and is TLSv1.3 since then - assuming the TLS library support it.

CURL_SSLVERSION_MAX_TLSv1_0

The flag defines maximum supported TLS version as TLSv1.0.

CURL_SSLVERSION_MAX_TLSv1_1

The flag defines maximum supported TLS version as TLSv1.1.

CURL_SSLVERSION_MAX_TLSv1_2

The flag defines maximum supported TLS version as TLSv1.2.

CURL_SSLVERSION_MAX_TLSv1_3

The flag defines maximum supported TLS version as TLSv1.3.

DEFAULT

CURL_SSLVERSION_DEFAULT

%PROTOCOLS%

EXAMPLE

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

    /* ask libcurl to use TLS version 1.0 or later */
    curl_easy_setopt(curl, CURLOPT_SSLVERSION, CURL_SSLVERSION_TLSv1);

    /* Perform the request */
    result = curl_easy_perform(curl);
    curl_easy_cleanup(curl);
  }
}

HISTORY

SSLv2 is disabled by default since 7.18.1. Other SSL versions availability may vary depending on which backend libcurl has been built to use.

SSLv3 is disabled by default since 7.39.0.

SSLv2 and SSLv3 are refused completely since curl 7.77.0

Since 8.10.0 wolfSSL is fully supported. Before 8.10.0 the MAX macros were not supported with wolfSSL and the other macros did not set a minimum, but restricted the TLS version to only the specified one.

Rustls support added in 8.10.0.

CURL_SSLVERSION_* macros became long types in 8.16.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_SSLVERSION
5Section: 3
6Source: libcurl
7See-also:
8 - CURLOPT_HTTP_VERSION (3)
9 - CURLOPT_IPRESOLVE (3)
10 - CURLOPT_PROXY_SSLVERSION (3)
11 - CURLOPT_USE_SSL (3)
12Protocol:
13 - TLS
14TLS-backend:
15 - All
16Added-in: 7.1
17---
19# NAME
21CURLOPT_SSLVERSION - preferred TLS/SSL version
23# SYNOPSIS
25~~~c
26#include <curl/curl.h>
28CURLcode curl_easy_setopt(CURL *handle, CURLOPT_SSLVERSION, long version);
29~~~
31# DESCRIPTION
33Pass a long as parameter to control which version range of SSL/TLS versions to
34use.
36The SSL and TLS versions have typically developed from the most insecure
37version to be more and more secure in this order through history: SSLv2,
38SSLv3, TLSv1.0, TLSv1.1, TLSv1.2 and the most recent TLSv1.3.
40Use one of the available defines for this purpose. The available options are:
42## CURL_SSLVERSION_DEFAULT
44The default acceptable version range. The minimum acceptable version is by
45default TLSv1.2 since 8.16.0 (unless the TLS library has a stricter rule).
47## CURL_SSLVERSION_TLSv1
49TLSv1.0 or later
51## CURL_SSLVERSION_SSLv2
53SSLv2 - refused
55## CURL_SSLVERSION_SSLv3
57SSLv3 - refused
59## CURL_SSLVERSION_TLSv1_0
61TLSv1.0 or later
63## CURL_SSLVERSION_TLSv1_1
65TLSv1.1 or later
67## CURL_SSLVERSION_TLSv1_2
69TLSv1.2 or later
71## CURL_SSLVERSION_TLSv1_3
73TLSv1.3 or later
75##
77The maximum TLS version can be set by using *one* of the CURL_SSLVERSION_MAX_
78macros below. It is also possible to OR *one* of the CURL_SSLVERSION_ macros
79with *one* of the CURL_SSLVERSION_MAX_ macros.
81## CURL_SSLVERSION_MAX_DEFAULT
83The flag defines the maximum supported TLS version by libcurl, or the default
84value from the SSL library is used. libcurl uses a sensible default maximum,
85which was TLSv1.2 up to before 7.61.0 and is TLSv1.3 since then - assuming
86the TLS library support it.
88## CURL_SSLVERSION_MAX_TLSv1_0
90The flag defines maximum supported TLS version as TLSv1.0.
92## CURL_SSLVERSION_MAX_TLSv1_1
94The flag defines maximum supported TLS version as TLSv1.1.
96## CURL_SSLVERSION_MAX_TLSv1_2
98The flag defines maximum supported TLS version as TLSv1.2.
100## CURL_SSLVERSION_MAX_TLSv1_3
102The flag defines maximum supported TLS version as TLSv1.3.
104# DEFAULT
106CURL_SSLVERSION_DEFAULT
108# %PROTOCOLS%
110# EXAMPLE
112~~~c
113int main(void)
115 CURL *curl = curl_easy_init();
116 if(curl) {
117 CURLcode result;
118 curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
120 /* ask libcurl to use TLS version 1.0 or later */
121 curl_easy_setopt(curl, CURLOPT_SSLVERSION, CURL_SSLVERSION_TLSv1);
123 /* Perform the request */
124 result = curl_easy_perform(curl);
125 curl_easy_cleanup(curl);
126 }
128~~~
130# HISTORY
132SSLv2 is disabled by default since 7.18.1. Other SSL versions availability may
133vary depending on which backend libcurl has been built to use.
135SSLv3 is disabled by default since 7.39.0.
137SSLv2 and SSLv3 are refused completely since curl 7.77.0
139Since 8.10.0 wolfSSL is fully supported. Before 8.10.0 the MAX macros were not
140supported with wolfSSL and the other macros did not set a minimum, but
141restricted the TLS version to only the specified one.
143Rustls support added in 8.10.0.
145**CURL_SSLVERSION_*** macros became `long` types in 8.16.0, prior to this
146version a `long` cast was necessary when passed to curl_easy_setopt(3).
148# %AVAILABILITY%
150# RETURN VALUE
152curl_easy_setopt(3) returns a CURLcode indicating success or error.
154CURLE_OK (0) means everything was OK, non-zero means an error occurred, see
155libcurl-errors(3).
Diagnostics4 git calls · 120 ms
CallStatusSizeTime0120 ms
discover200152 B2 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 · 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=115
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.5 KiB115 ms
git.upload-pack fetch
http.response.status_code=200
git.response.bytes=1556
git.response.cache=MISS
git.response.duration_ms=115
git.fetch.wants=cbe7a89c30c94ae6f5a867c3c4f4bfe6c5f6820c
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=1556
git.pkt.payload.max=1535
git.sideband.band1.bytes=1534
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
a5e32c163c2f5094
Request
af154fac…
Protocol
v2 · sha1
Agent
gitty/1.0
Filter
advertised
Fetch
shallow filter sideband-all
Capabilities
agent ls-refs fetch object-format