Artifactspublic-v0

curl

master
ply4 git calls295 ms288 KiB2 cachedprotocol v2
94 lines2.3 KiBRaw

NAME

CURLOPT_DOH_SSL_VERIFYHOST - verify the hostname in the DoH SSL certificate

SYNOPSIS

c
#include <curl/curl.h>

CURLcode curl_easy_setopt(CURL *handle, CURLOPT_DOH_SSL_VERIFYHOST,
                          long verify);

DESCRIPTION

Pass a long set to 2L as asking curl to verify the DoH (DNS-over-HTTPS) server's certificate name fields against the hostname.

This option is the DoH equivalent of CURLOPT_SSL_VERIFYHOST(3) and only affects requests to the DoH server.

When CURLOPT_DOH_SSL_VERIFYHOST(3) is 2, the SSL certificate provided by the DoH server must indicate that the server name is the same as the server name to which you meant to connect to, or the connection fails.

curl considers the DoH server the intended one when the Common Name field or a Subject Alternate Name field in the certificate matches the hostname in the DoH URL to which you told curl to connect.

When the verify value is set to 1L it is treated the same as 2L. However for consistency with the other VERIFYHOST options we suggest use 2 and not 1.

When the verify value is set to 0L, the connection succeeds regardless of the names used in the certificate. Use that ability with caution.

See also CURLOPT_DOH_SSL_VERIFYPEER(3) to verify the digital signature of the DoH server certificate.

DEFAULT

2

%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_DOH_URL,
                     "https://cloudflare-dns.com/dns-query");

    /* Disable hostname verification of the DoH server */
    curl_easy_setopt(curl, CURLOPT_DOH_SSL_VERIFYHOST, 0L);

    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_DOH_SSL_VERIFYHOST
5Section: 3
6Source: libcurl
7See-also:
8 - CURLOPT_DOH_SSL_VERIFYPEER (3)
9 - CURLOPT_PROXY_SSL_VERIFYHOST (3)
10 - CURLOPT_PROXY_SSL_VERIFYPEER (3)
11 - CURLOPT_SSL_VERIFYHOST (3)
12 - CURLOPT_SSL_VERIFYPEER (3)
13Protocol:
14 - TLS
15TLS-backend:
16 - All
17Added-in: 7.76.0
18---
20# NAME
22CURLOPT_DOH_SSL_VERIFYHOST - verify the hostname in the DoH SSL certificate
24# SYNOPSIS
26~~~c
27#include <curl/curl.h>
29CURLcode curl_easy_setopt(CURL *handle, CURLOPT_DOH_SSL_VERIFYHOST,
30 long verify);
31~~~
33# DESCRIPTION
35Pass a long set to 2L as asking curl to *verify* the DoH (DNS-over-HTTPS)
36server's certificate name fields against the hostname.
38This option is the DoH equivalent of CURLOPT_SSL_VERIFYHOST(3) and
39only affects requests to the DoH server.
41When CURLOPT_DOH_SSL_VERIFYHOST(3) is 2, the SSL certificate provided by
42the DoH server must indicate that the server name is the same as the server
43name to which you meant to connect to, or the connection fails.
45curl considers the DoH server the intended one when the Common Name field or a
46Subject Alternate Name field in the certificate matches the hostname in the
47DoH URL to which you told curl to connect.
49When the *verify* value is set to 1L it is treated the same as 2L. However
50for consistency with the other *VERIFYHOST* options we suggest use 2 and
51not 1.
53When the *verify* value is set to 0L, the connection succeeds regardless of
54the names used in the certificate. Use that ability with caution.
56See also CURLOPT_DOH_SSL_VERIFYPEER(3) to verify the digital signature
57of the DoH server certificate.
59# DEFAULT
63# %PROTOCOLS%
65# EXAMPLE
67~~~c
68int main(void)
70 CURL *curl = curl_easy_init();
71 if(curl) {
72 CURLcode result;
73 curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
75 curl_easy_setopt(curl, CURLOPT_DOH_URL,
76 "https://cloudflare-dns.com/dns-query");
78 /* Disable hostname verification of the DoH server */
79 curl_easy_setopt(curl, CURLOPT_DOH_SSL_VERIFYHOST, 0L);
81 result = curl_easy_perform(curl);
82 curl_easy_cleanup(curl);
83 }
85~~~
87# %AVAILABILITY%
89# RETURN VALUE
91curl_easy_setopt(3) returns a CURLcode indicating success or error.
93CURLE_OK (0) means everything was OK, non-zero means an error occurred, see
94libcurl-errors(3).
Diagnostics4 git calls · 295 ms
CallStatusSizeTime0295 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=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 · hit2 ms
git.upload-pack fetch
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=fetch
git.upstream.dur_ms=291
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 KiB291 ms
git.upload-pack fetch
http.response.status_code=200
git.response.bytes=1174
git.response.cache=MISS
git.response.duration_ms=291
git.fetch.wants=0d2c26f2de4050a03084527aba8dc31a0ce9b896
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=1174
git.pkt.payload.max=1153
git.sideband.band1.bytes=1152
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
a5e3866ef8e5a691
Request
f1256251…
Protocol
v2 · sha1
Agent
gitty/1.0
Filter
advertised
Fetch
shallow filter sideband-all
Capabilities
agent ls-refs fetch object-format