doh(1)

📦 version 0.1^1.8654bc9, in fedora 43, fedora 44

👑 doh — like, the manual page, bestie

okay so welcome to doh(1), the manual for the doh command. yes the name is silly. no we are not changing it. this is the doh Manual and it is gonna be a whole vibe, so grab a boba and let's go 🧋✨

🌸 NAME 🌸

doh — query a DoH server 💅

(DoH = DNS-over-HTTPS. it's DNS but wearing a cute little HTTPS outfit. obsessed.)

✨ SYNOPSIS ✨

doh [options] [host] [server URL]

🦋 DESCRIPTION 🦋

so what doh does is it sends DNS queries to a DNS-over-HTTPS (DoH) server. that's the whole thing. that's the job. 🎀

and here's the tea: if you don't specify a server URL, it just defaults to Cloudflare's public server. no setup, no config, no drama. it just works. main character energy fr fr 🌈

💖 OPTIONS 💖

okay bestie this is the part you actually came for. every single flag, no skips, no cap:

  • -h — Show the help output. (the classic "help me" button, iconic)
  • -k — Run in insecure mode. it completely switches off certificate checking of the DoH server!
🚨 bestie. BESTIE. this turns off cert checking entirely. that's a big deal. only do this if you know exactly what you're doing, okay? 😭
  • -tTYPE — Set query type. the supported values are A, AAAA, CNAME and TXT. (yes, that's the whole list. no extra ones, don't @ me)
  • -T — Test mode. it returns an exit code if there isn't a proper DoH response. so like, a vibe check for your server 💀
  • -v — Verbose mode. shows lots of details from the underlying HTTPS connection and transfer. it's giving "tell me everything" and honestly? valid.
  • -4 — Use only IPv4 transport to DOH server.
  • -6 — Use only IPv6 transport to DOH server.
  • -r NAME:PORT:ADDRESS — Provide a fixed IP address for the given host name + port pair. This option can be provided several times. This preloads the DNS cache.

Example: "-r example.com:443:127.0.0.1"

(yes you can stack this one. multiple times. it preloads the cache. very girlboss of it 🫶)

  • -V — Show version number and exit. short and sweet, we love a quick exit 💅

🌈 WWW 🌈

https://github.com/curl/doh

go look at it. it's right there. the source of truth. the mothership. ⭐

okay that's the whole page, you ate it, you understood it, you're basically a DNS girlie now 💜

sign-off time 🎀 — this manual is for doh version 0.1, dated 17 Sep 2019. old but gold, and still slaying. periodt. ✨🦋

📦 where this page comes from