A tiny and feature-rich command line DNS client with support for UDP, TCP, DoT, DoH, DoQ, and ODoH.
Usage:
q [OPTIONS] [@server] [type...] [name]
All long form (--) flags can be toggled with the dig-standard +[no]flag notation.
Application Options:
-q, --qname= Query name
-s, --server= DNS server
-t, --type= RR type (e.g. A, AAAA, MX, etc.) or type integer
-x, --reverse Reverse lookup
-d, --dnssec Set the DO (DNSSEC OK) bit in the OPT record
-n, --nsid Set EDNS0 NSID opt
--subnet= Set EDNS0 client subnet
-c, --chaos Use CHAOS query class
-p, --odoh-proxy= ODoH proxy
--timeout= Query timeout in seconds (default: 10)
--pad Set EDNS0 padding
-f, --format= Output format (pretty, json, yaml, raw) (default:
pretty)
--pretty-ttls Format TTLs in human readable format (default: true)
--color Enable color output
--question Show question section
--answer Show answer section (default: true)
--authority Show authority section
--additional Show additional section
--stats Show time statistics
--all Show all sections and statistics
--aa Set AA (Authoritative Answer) flag in query
--ad Set AD (Authentic Data) flag in query
--cd Set CD (Checking Disabled) flag in query
--rd Set RD (Recursion Desired) flag in query (default:
true)
--ra Set RA (Recursion Available) flag in query
--z Set Z (Zero) flag in query
--t Set TC (Truncated) flag in query
-i, --tls-no-verify Disable TLS certificate verification
--tls-min-version= Minimum TLS version to use (default: 1.0)
--tls-max-version= Maximum TLS version to use (default: 1.3)
--http-user-agent= HTTP user agent
--http-method= HTTP method (default: GET)
--quic-alpn-tokens= QUIC ALPN tokens (default: doq, doq-i11)
--quic-keep-alive QUIC keep-alive
--quic-no-pmtud Disable QUIC PMTU discovery
--quic-dial-timeout= QUIC dial timeout (default: 10)
--quic-idle-timeout= QUIC stream open timeout (default: 10)
--handshake-timeout= Handshake timeout (default: 10)
--udp-buffer= Set EDNS0 UDP size in query (default: 4096)
-v, --verbose Show verbose log messages
-V, --version Show version and exit
Help Options:
-h, --help Show this help message
- UDP/TCP DNS (RFC 1034)
- DNS over TLS (RFC 7858)
- DNS over HTTPS (RFC 8484)
- DNS over QUIC (draft-ietf-dprive-dnsoquic-12)
- Oblivious DNS over HTTPS (draft-pauly-dprive-oblivious-doh-11)
q is available from my public package repositories, as a binary
from releases, from the AUR
as q-dns-git, or from source
with git clone https://github.com/natesales/q && cd q && go build.
| Protocol | q | doggo | dog | kdig | dig | drill |
|---|---|---|---|---|---|---|
| RFC 1034 UDP/TCP | + | + | + | + | + | + |
| RFC 7858 DNS over TLS | + | + | + | + | - | - |
| RFC 8484 DNS over HTTPS | + | + | + | + | - | - |
| draft-ietf-dprive-dnsoquic-12 DNS over QUIC | + | + | - | - | - | - |
| draft-pauly-dprive-oblivious-doh-11 Oblivious DNS over HTTPS | + | - | - | - | - | - |
| Format | q | doggo | dog | kdig | dig | drill |
|---|---|---|---|---|---|---|
| Raw (dig-style) | + | - | + | + | + | + |
| Pretty colors | + | + | + | - | - | - |
| JSON | + | + | + | - | - | - |
| YAML | + | - | - | - | + | - |
| Option | q | doggo | dog | kdig | dig | drill |
|---|---|---|---|---|---|---|
| Toggle question section | + | - | - | + | + | - |
| Toggle answer section | + | - | - | + | + | - |
| Toggle authority section | + | - | - | + | + | - |
| Toggle additional section | + | - | - | + | + | - |
| Show query time | + | - | - | + | + | - |
| Flag | q | doggo | dog | kdig | dig | drill |
|---|---|---|---|---|---|---|
| AA | + | - | + | + | + | + |
| AD | + | - | + | + | + | + |
| CD | + | - | + | + | + | + |
| RD | + | - | - | + | + | + |
| Z | + | - | - | + | + | - |
| DO | + | - | + | + | + | + |
| TC | + | - | - | + | + | + |
| Flag | q | doggo | dog | kdig | dig | drill |
|---|---|---|---|---|---|---|
| HTTP Method | + | - | - | - | - | - |
| QUIC ALPN Tokens | + | - | - | - | - | - |
| QUIC Keepalive | + | - | - | - | - | - |
| QUIC toggle PMTU discovery | + | - | - | - | - | - |
| QUIC timeouts (dial and idle) | + | - | - | - | - | - |
| TLS handshake timeout | + | - | - | - | - | - |