164 lines
4.8 KiB
Plaintext
164 lines
4.8 KiB
Plaintext
awl(1) awl(1)
|
||
|
||
NAME
|
||
awl - DNS lookup tool
|
||
|
||
SYNOPSIS
|
||
awl [ OPTIONS ] name [ @server ] [ type ]
|
||
where
|
||
|
||
name is the query to make (example: froth.zone)
|
||
@server is the server to query (example: dns.froth.zone)
|
||
type is the DNS resource type (example: AAAA)
|
||
|
||
DESCRIPTION
|
||
awl (awls want licorice) is a simple tool designed to make DNS queries, much like
|
||
the venerable dig(1). An awl is a tool used to make small holes, typically used in
|
||
leatherworking.
|
||
|
||
awl is designed to be a more "modern" version of drill(1) by including some more
|
||
recent RFCs and output options. awl is still heavily Work-In-Progress so some fea‐
|
||
tures may get added or removed.
|
||
|
||
OPTIONS
|
||
Dig-like +[no]flags are supported, see dig(1)
|
||
|
||
-D, --dnssec, +dnssec
|
||
Enable DNSSEC. This needs to be manually enabled.
|
||
|
||
-v value
|
||
Set verbosity (currently WIP)
|
||
|
||
-V
|
||
Print the version and exit.
|
||
|
||
-h
|
||
Show a "short" help message.
|
||
|
||
Query Options
|
||
-4
|
||
Only make query over IPv4
|
||
|
||
-6
|
||
Only make query over IPv6
|
||
|
||
-p, --port port
|
||
Sets the port to query.
|
||
|
||
Default Ports:
|
||
• 53 for UDP and TCP
|
||
• 853 for TLS and QUIC
|
||
• 443 for HTTPS
|
||
|
||
-q, --query domain
|
||
Domain to query (eg. example.com)
|
||
|
||
-c, --class class
|
||
DNS class to query (eg. IN, CH)
|
||
|
||
-t, --qType type
|
||
DNS type to query (eg. A, NS)
|
||
|
||
--no-truncate, +ignore
|
||
Ignore UDP truncation (by default, awl retries with TCP)
|
||
|
||
--tcp, +tcp, +vc
|
||
Use TCP for the query (see RFC 7766)
|
||
|
||
--dnscrypt, +dnscrypt
|
||
Use DNSCrypt
|
||
|
||
-T, --tls, +tls
|
||
Use DNS-over-TLS, implies --tcp (see RFC 7858)
|
||
|
||
-H. --https, +https
|
||
Use DNS-over-HTTPS (see RFC 8484)
|
||
|
||
-Q. --quic, +quic
|
||
Use DNS-over-QUIC (see RFC 9250)
|
||
|
||
-x, --reverse
|
||
Do a reverse lookup. Sets default type to PTR.
|
||
awl automatically makes an IP or phone number canonical.
|
||
|
||
--timeout seconds, +timeout=seconds
|
||
Set the timeout period. Floating point numbers are accepted.
|
||
0.5 seconds is the minimum.
|
||
|
||
--retries int, +tries=int, + retry=int
|
||
Set the number of retries.
|
||
Retry is one more than tries, dig style
|
||
|
||
DNS Flags
|
||
--aa=[false], +[no]aaflag
|
||
(Set, Unset) AA (Authoritative Answer) flag
|
||
|
||
--ad=[false], +[no]adflag
|
||
(Set, Unset) AD (Authenticated Data) flag
|
||
|
||
--tc=[false], +[no]tcflag
|
||
(Set, Unset) TC (TrunCated) flag
|
||
|
||
-z=[false], +[no]zflag
|
||
(Set, Unset) Z (Zero) flag
|
||
|
||
--cd=[false], +[no]cdflag
|
||
(Set, Unset) CD (Checking Disabled) flag
|
||
|
||
--qr=[false], +[no]qrflag
|
||
(Set, Unset) QR (QueRy) flag
|
||
|
||
--rd=[true], +[no]rdflag
|
||
(Set, Unset) RD (Recursion Desired) flag
|
||
|
||
--ra=[false], +[no]raflag
|
||
(Set, Unset) RA (Recursion Available) flag
|
||
|
||
Output Display
|
||
--no-question, +noquestion
|
||
Do not display the Question section
|
||
|
||
--no-answer, +noanswer
|
||
Do not display the Answer section
|
||
|
||
--no-answer, +noanswer
|
||
Do not display the Answer section
|
||
|
||
--no-authority, +noauthority
|
||
Do not display the Authority section
|
||
|
||
--no-additional, +noadditional
|
||
Do not display the Additional section
|
||
|
||
--no-statistics, +nostats
|
||
Do not display the Statistics (additional comments) section
|
||
|
||
Output Formats
|
||
-j, --json, +json
|
||
Print the query results as JSON.
|
||
|
||
-X, --xml, +xml
|
||
Print the query results as XML.
|
||
|
||
-y, --yaml, +yaml
|
||
Print the query results as YAML.
|
||
|
||
-s, --short, +short
|
||
Print just the address of the answer.
|
||
|
||
EXAMPLES
|
||
awl grumbulon.xyz -j +cd
|
||
Run a query of your local resolver for the A records of grumbulon.xyz, print them as
|
||
JSON and disable DNSSEC verification.
|
||
|
||
awl +short example.com AAAA @1.1.1.1
|
||
Query 1.1.1.1 for the AAAA records of example.com, print just the answers
|
||
|
||
awl -xT PTR 8.8.4.4 @dns.google
|
||
Query dns.google over TLS for the PTR record to the IP address 8.8.4.4
|
||
|
||
SEE ALSO
|
||
drill(1), dig(1), the many DNS RFCs
|
||
|
||
awl(1)
|