CLI Reference Guide
This guide provides a comprehensive list of all command-line options and flags available in Doggo.
Basic Syntax
doggo [--] [query options] [arguments...]Query Options
| Option | Description |
|---|---|
-q, --query=HOSTNAME | Hostname to query the DNS records for (e.g., example.com) |
-t, --type=TYPE | Type of the DNS Record (A, MX, NS, etc.) |
-n, --nameserver=ADDR | Address of a specific nameserver to send queries to (e.g., 9.9.9.9, 8.8.8.8) |
-c, --class=CLASS | Network class of the DNS record (IN, CH, HS, etc.) |
-x, --reverse | Performs a reverse DNS lookup for an IPv4 or IPv6 address |
Resolver Options
| Option | Description |
|---|---|
--strategy=STRATEGY | Specify strategy to query nameservers (all, random, first) |
--ndots=INT | Specify ndots parameter |
--search | Use the search list defined in resolv.conf (default: true) |
--timeout=DURATION | Specify timeout for the resolver to return a response (e.g., 5s, 400ms, 1m) |
-4, --ipv4 | Use IPv4 only |
-6, --ipv6 | Use IPv6 only |
--tls-hostname=HOSTNAME | Provide a hostname for TLS certificate verification |
--skip-hostname-verification | Skip TLS Hostname Verification for DoT lookups |
Query Flags
| Flag | Description |
|---|---|
--aa | Set Authoritative Answer flag |
--ad | Set Authenticated Data flag |
--cd | Set Checking Disabled flag |
--rd | Set Recursion Desired flag (default: true) |
--z | Set Z flag (reserved for future use) |
--do | Set DNSSEC OK flag |
Output Options
| Option | Description |
|---|---|
-J, --json | Format the output as JSON |
--short | Short output format (shows only the response section) |
--color | Enable/disable colored output (default: true) |
--debug | Enable debug logging |
--time | Show query response time |
Transport Options
Specify the protocol with a URL-type scheme. UDP is used if no scheme is specified.
| Scheme | Description | Example |
|---|---|---|
@udp:// | UDP query | @1.1.1.1 |
@tcp:// | TCP query | @tcp://1.1.1.1 |
@https:// | DNS over HTTPS (DoH) | @https://cloudflare-dns.com/dns-query |
@tls:// | DNS over TLS (DoT) | @tls://1.1.1.1 |
@sdns:// | DNSCrypt or DoH using DNS stamp | @sdns://... |
@quic:// | DNS over QUIC | @quic://dns.adguard.com |
Examples
-
Query a domain using defaults:
doggo example.com -
Query for a CNAME record:
doggo example.com CNAME -
Use a custom DNS resolver:
doggo example.com MX @9.9.9.9 -
Using named arguments:
doggo -q example.com -t MX -n 1.1.1.1 -
Query with specific flags:
doggo example.com --aa --ad
For more detailed usage examples, refer to the Examples section.