xref: /aosp_15_r20/external/curl/docs/cmdline-opts/doh-url.md (revision 6236dae45794135f37c4eb022389c904c8b0090d)
1*6236dae4SAndroid Build Coastguard Worker---
2*6236dae4SAndroid Build Coastguard Workerc: Copyright (C) Daniel Stenberg, <[email protected]>, et al.
3*6236dae4SAndroid Build Coastguard WorkerSPDX-License-Identifier: curl
4*6236dae4SAndroid Build Coastguard WorkerLong: doh-url
5*6236dae4SAndroid Build Coastguard WorkerArg: <URL>
6*6236dae4SAndroid Build Coastguard WorkerHelp: Resolve hostnames over DoH
7*6236dae4SAndroid Build Coastguard WorkerAdded: 7.62.0
8*6236dae4SAndroid Build Coastguard WorkerCategory: dns
9*6236dae4SAndroid Build Coastguard WorkerMulti: single
10*6236dae4SAndroid Build Coastguard WorkerSee-also:
11*6236dae4SAndroid Build Coastguard Worker  - doh-insecure
12*6236dae4SAndroid Build Coastguard WorkerExample:
13*6236dae4SAndroid Build Coastguard Worker  - --doh-url https://doh.example $URL
14*6236dae4SAndroid Build Coastguard Worker  - --doh-url https://doh.example --resolve doh.example:443:192.0.2.1 $URL
15*6236dae4SAndroid Build Coastguard Worker---
16*6236dae4SAndroid Build Coastguard Worker
17*6236dae4SAndroid Build Coastguard Worker# `--doh-url`
18*6236dae4SAndroid Build Coastguard Worker
19*6236dae4SAndroid Build Coastguard WorkerSpecifies which DNS-over-HTTPS (DoH) server to use to resolve hostnames,
20*6236dae4SAndroid Build Coastguard Workerinstead of using the default name resolver mechanism. The URL must be HTTPS.
21*6236dae4SAndroid Build Coastguard Worker
22*6236dae4SAndroid Build Coastguard WorkerSome SSL options that you set for your transfer also applies to DoH since the
23*6236dae4SAndroid Build Coastguard Workername lookups take place over SSL. However, the certificate verification
24*6236dae4SAndroid Build Coastguard Workersettings are not inherited but are controlled separately via --doh-insecure
25*6236dae4SAndroid Build Coastguard Workerand --doh-cert-status.
26*6236dae4SAndroid Build Coastguard Worker
27*6236dae4SAndroid Build Coastguard WorkerBy default, DoH is bypassed when initially looking up DNS records of the DoH server. You can specify the IP address(es) of the DoH server with --resolve to avoid this.
28*6236dae4SAndroid Build Coastguard Worker
29*6236dae4SAndroid Build Coastguard WorkerThis option is unset if an empty string "" is used as the URL.
30*6236dae4SAndroid Build Coastguard Worker(Added in 7.85.0)
31