Artifactspublic-v0

curl

master
ply4 git calls153 ms288 KiB2 cachedprotocol v2
104 lines2.8 KiBRaw

NAME

CURLOPT_DOH_URL - provide the DNS-over-HTTPS URL

SYNOPSIS

c
#include <curl/curl.h>

CURLcode curl_easy_setopt(CURL *handle, CURLOPT_DOH_URL, char *URL);

DESCRIPTION

Pass in a pointer to a URL for the DoH server to use for name resolving. The parameter should be a char pointer to a null-terminated string which must be a valid and correct HTTPS URL.

libcurl does not validate the syntax or use this variable until the transfer is issued. Even if you set a crazy value here, curl_easy_setopt(3) still returns CURLE_OK.

curl sends POST requests to the given DNS-over-HTTPS URL.

To find the DoH server itself, which might be specified using a name, libcurl uses the default name lookup function. You can bootstrap that by providing the address for the DoH server with CURLOPT_RESOLVE(3).

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 to disable its use again.

DoH lookups do not inherit proxy options from its parent transfer.

INHERIT OPTIONS

DoH lookups use SSL and some SSL settings from your transfer are inherited, like CURLOPT_SSL_CTX_FUNCTION(3).

The hostname and peer certificate verification settings are not inherited but can be controlled separately via CURLOPT_DOH_SSL_VERIFYHOST(3) and CURLOPT_DOH_SSL_VERIFYPEER(3).

A set CURLOPT_OPENSOCKETFUNCTION(3) callback is not inherited.

KNOWN BUGS

Even when DoH is set to be used with this option, there are still some name resolves that are performed without it, using the default name resolver mechanism. This includes name resolves done for CURLOPT_INTERFACE(3), CURLOPT_FTPPORT(3), a proxy type set to CURLPROXY_SOCKS4 or CURLPROXY_SOCKS5 and probably some more.

DEFAULT

NULL

%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://dns.example.com");
    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).

Note that curl_easy_setopt(3) does not immediately parse the given string so when given a bad DoH URL, libcurl might not detect the problem until it later tries to resolve a name with it.

1---
2c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
3SPDX-License-Identifier: curl
4Title: CURLOPT_DOH_URL
5Section: 3
6Source: libcurl
7See-also:
8 - CURLOPT_DNS_CACHE_TIMEOUT (3)
9 - CURLOPT_RESOLVE (3)
10 - CURLOPT_VERBOSE (3)
11Protocol:
12 - All
13Added-in: 7.62.0
14---
16# NAME
18CURLOPT_DOH_URL - provide the DNS-over-HTTPS URL
20# SYNOPSIS
22~~~c
23#include <curl/curl.h>
25CURLcode curl_easy_setopt(CURL *handle, CURLOPT_DOH_URL, char *URL);
26~~~
28# DESCRIPTION
30Pass in a pointer to a *URL* for the DoH server to use for name resolving. The
31parameter should be a char pointer to a null-terminated string which must be a
32valid and correct HTTPS URL.
34libcurl does not validate the syntax or use this variable until the transfer
35is issued. Even if you set a crazy value here, curl_easy_setopt(3) still
36returns *CURLE_OK*.
38curl sends POST requests to the given DNS-over-HTTPS URL.
40To find the DoH server itself, which might be specified using a name, libcurl
41uses the default name lookup function. You can bootstrap that by providing the
42address for the DoH server with CURLOPT_RESOLVE(3).
44The application does not have to keep the string around after setting this
45option.
47Using this option multiple times makes the last set string override the
48previous ones. Set it to NULL to disable its use again.
50DoH lookups do not inherit proxy options from its parent transfer.
52# INHERIT OPTIONS
54DoH lookups use SSL and some SSL settings from your transfer are inherited,
55like CURLOPT_SSL_CTX_FUNCTION(3).
57The hostname and peer certificate verification settings are not inherited but
58can be controlled separately via CURLOPT_DOH_SSL_VERIFYHOST(3) and
59CURLOPT_DOH_SSL_VERIFYPEER(3).
61A set CURLOPT_OPENSOCKETFUNCTION(3) callback is not inherited.
63# KNOWN BUGS
65Even when DoH is set to be used with this option, there are still some name
66resolves that are performed without it, using the default name resolver
67mechanism. This includes name resolves done for CURLOPT_INTERFACE(3),
68CURLOPT_FTPPORT(3), a proxy type set to **CURLPROXY_SOCKS4** or
69**CURLPROXY_SOCKS5** and probably some more.
71# DEFAULT
73NULL
75# %PROTOCOLS%
77# EXAMPLE
79~~~c
80int main(void)
82 CURL *curl = curl_easy_init();
83 if(curl) {
84 CURLcode result;
85 curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
86 curl_easy_setopt(curl, CURLOPT_DOH_URL, "https://dns.example.com");
87 result = curl_easy_perform(curl);
88 curl_easy_cleanup(curl);
89 }
91~~~
93# %AVAILABILITY%
95# RETURN VALUE
97curl_easy_setopt(3) returns a CURLcode indicating success or error.
99CURLE_OK (0) means everything was OK, non-zero means an error occurred, see
100libcurl-errors(3).
102Note that curl_easy_setopt(3) does not immediately parse the given string so
103when given a bad DoH URL, libcurl might not detect the problem until it later
104tries to resolve a name with it.
Diagnostics4 git calls · 153 ms
CallStatusSizeTime0153 ms
discover200152 B1 ms
git.upload-pack discover
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=ls-refs
git.upstream.dur_ms=1
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=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.5 KiB149 ms
git.upload-pack fetch
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=fetch
git.upstream.dur_ms=149
git.response.bytes=1511
git.response.cache=MISS
git.response.duration_ms=149
git.fetch.wants=696903c6baebdc7e18346bf15fd2e9e5563c4bb1
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=1511
git.pkt.payload.max=1490
git.sideband.band1.bytes=1489
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
a5e3578f088f2c38
Request
1082ca98…
Protocol
v2 · sha1
Agent
gitty/1.0
Filter
advertised
Fetch
shallow filter sideband-all
Capabilities
agent ls-refs fetch object-format