Signed-off-by: Sam Therapy <sam@samtherapy.net>
This commit is contained in:
parent
12ea0e094d
commit
3a4256fb37
1 changed files with 40 additions and 20 deletions
|
@ -41,8 +41,11 @@ Anything in [brackets] is optional.
|
|||
- _1_: Log warnings. *This is the default.*
|
||||
- _2_: Log information *Default when specifying just* _-v_.
|
||||
- _3_: Log information useful for debugging.
|
||||
|
||||
Setting a value lower than 0 disables logging entirely.
|
||||
|
||||
By default, specifying just *-v* sets the verbosity to 2 (info).
|
||||
|
||||
*-V*
|
||||
Print the version and exit.
|
||||
|
||||
|
@ -78,13 +81,13 @@ Anything in [brackets] is optional.
|
|||
Ignore UDP truncation (by default, awl *retries with TCP*).
|
||||
|
||||
*--tcp*, *+tcp*, *+vc*
|
||||
Use TCP for the query (see *RFC 7766*).
|
||||
Use TCP for the query (see RFC 7766).
|
||||
|
||||
*--dnscrypt*, *+dnscrypt*
|
||||
Use DNSCrypt.
|
||||
|
||||
*-T*, *--tls*, *+tls*
|
||||
Use DNS-over-TLS, implies _--tcp_ (see *RFC 7858*)
|
||||
Use DNS-over-TLS, implies *--tcp* (see RFC 7858)
|
||||
|
||||
*--tls-host* _string_
|
||||
Set hostname to use for TLS certificate validation.
|
||||
|
@ -94,10 +97,10 @@ Anything in [brackets] is optional.
|
|||
Ignore TLS validation when performing a DNS query.
|
||||
|
||||
*-H*. *--https*, *+https*
|
||||
Use DNS-over-HTTPS (see *RFC 8484*).
|
||||
Use DNS-over-HTTPS (see RFC 8484).
|
||||
|
||||
*-Q*. *--quic*, *+quic*
|
||||
Use DNS-over-QUIC (see *RFC 9250*).
|
||||
Use DNS-over-QUIC (see RFC 9250).
|
||||
|
||||
*-x*, *--reverse*
|
||||
Do a reverse lookup. Sets default *type* to PTR.
|
||||
|
@ -113,32 +116,32 @@ Anything in [brackets] is optional.
|
|||
|
||||
## DNS Flags
|
||||
|
||||
*--aa*=[_false_], *+[no]aaflag*
|
||||
*--aa*[=_bool_], *+[no]aaflag*
|
||||
(Set, Unset) AA (Authoritative Answer) flag.
|
||||
|
||||
*--ad*=[_false_], *+[no]adflag*
|
||||
*--ad*[=_bool_], *+[no]adflag*
|
||||
(Set, Unset) AD (Authenticated Data) flag.
|
||||
|
||||
*--tc*=[_false_], *+[no]tcflag*
|
||||
*--tc*[=_bool_], *+[no]tcflag*
|
||||
(Set, Unset) TC (TrunCated) flag
|
||||
|
||||
*-z*=[_false_], *+[no]zflag*
|
||||
*-z*[=_bool_], *+[no]zflag*
|
||||
(Set, Unset) Z (Zero) flag.
|
||||
|
||||
*--cd*=[_false_], *+[no]cdflag*
|
||||
*--cd*[=_bool_], *+[no]cdflag*
|
||||
(Set, Unset) CD (Checking Disabled) flag.
|
||||
|
||||
*--qr*=[_false_], *+[no]qrflag*
|
||||
*--qr*[=_bool_], *+[no]qrflag*
|
||||
(Set, Unset) QR (QueRy) flag.
|
||||
|
||||
*--rd*=[_true_], *+[no]rdflag*
|
||||
*--rd*[=_bool_], *+[no]rdflag*
|
||||
(Set, Unset) RD (Recursion Desired) flag.
|
||||
|
||||
*--ra*=[_false_], *+[no]raflag*
|
||||
*--ra*[=_bool_], *+[no]raflag*
|
||||
(Set, Unset) RA (Recursion Available) flag.
|
||||
|
||||
## EDNS
|
||||
All of these options except disabling EDNS imply _+edns_.
|
||||
All of these options except disabling EDNS imply *+edns*.
|
||||
|
||||
*--no-edns*, *+noedns*
|
||||
Disable EDNS.
|
||||
|
@ -172,9 +175,9 @@ All of these options except disabling EDNS imply _+edns_.
|
|||
Trying to set DO will be ignored.
|
||||
|
||||
*--subnet* _ip_[_/prefix_], *+[no]subnet*=_ip_[_/prefix_]
|
||||
Send an EDNS Client Subnet option with the specified address.++
|
||||
++
|
||||
Like *dig*(1), setting the IP to _0.0.0.0/0_, _::/0_ or _0_ will signal the resolver to not use any client information when returning the query.
|
||||
Send an EDNS Client Subnet option with the specified address.
|
||||
|
||||
Like *dig*(1), setting the IP to _0.0.0.0/0_, _::/0_ or _0_ will signal the resolver to not use any client information when returning the query.
|
||||
|
||||
## Output Display
|
||||
|
||||
|
@ -210,6 +213,11 @@ Like *dig*(1), setting the IP to _0.0.0.0/0_, _::/0_ or _0_ will signal the reso
|
|||
*-s*, *--short*, *+short*
|
||||
Print just the address of the answer.
|
||||
|
||||
# EXIT STATUS
|
||||
|
||||
The exit code is 0 when a query is successfully made and received.
|
||||
This includes SERVFAILs, NOTIMPL among others.
|
||||
|
||||
# EXAMPLES
|
||||
|
||||
```
|
||||
|
@ -233,10 +241,22 @@ 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
|
||||
(https://www.statdns.com/rfc/)
|
||||
*drill*(1), *dig*(1)
|
||||
|
||||
# STANDARDS
|
||||
|
||||
RFC 1034,1035 (UDP), 7766 (TCP), 7858 (TLS), 8484 (HTTPS), 9230 (QUIC)
|
||||
|
||||
Probably more, _https://www.statdns.com/rfc_
|
||||
|
||||
# BUGS
|
||||
|
||||
Likely numerous, report them either to https://git.froth.zone/sam/awl/issues
|
||||
or via email ~sammefishe/awl-dev@lists.sr.ht
|
||||
OPT records are only printed when using a standard output, not JSON/XML/YAML.
|
||||
|
||||
Full parity with *dig*(1) is not complete.
|
||||
|
||||
This man page is probably not complete.
|
||||
|
||||
Likely numerous more, report them either to the tracker
|
||||
_https://git.froth.zone/sam/awl/issues_ or via email
|
||||
_~sammefishe/awl-dev@lists.sr.ht_
|
||||
|
|
Loading…
Reference in a new issue