upstream/bind9
1
0
Fork 0
mirror of https://github.com/isc-projects/bind9.git synced 2026-06-10 00:10:00 -04:00
Code Issues Projects Releases Packages Wiki Activity Actions

Add examples to the dig man page

Browse source 
The goal here is to help new or infrequent users figure out the most
basic ways to use dig.

Notes on the choice of examples:

* I wrote examples that users can copy and paste exactly as is, without
  having to come up with an appropriate IP address or domain name to use.
  The one exception is the `dig -x` example which uses an IP from the
  example range.
* `dig +noall +answer` here is because learning about `+noall +answer`
  was lifechanging for me when I learned about it, I've heard from
  others that they find it helpful too, and it's pretty hard to infer
  from the man page as is that it might be useful
* I thought about adding `+trace` but left it out because 5 examples was
  already starting to feel like a lot.
This commit is contained in:
Julia Evans 2026-02-20 10:43:26 -05:00
parent 92d3c7d011
commit 8972ed9424
1 changed files with 23 additions and 0 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

23
bin/dig/dig.rst
View file

@ -839,6 +839,29 @@ Files
``${HOME}/.digrc``
Examples
~~~~~~~~
Only display the IP address(es) for example.com::
dig +short example.com
Query the nameserver f.gtld-servers.net for example.com::
dig @f.gtld-servers.net example.com
Look up the TXT record for example.com::
dig txt example.com
Look up the hostname for an IP with reverse DNS::
dig -x 192.0.2.1
Display a much shorter output with just the name, record type, TTL, and value for each answer::
dig +noall +answer example.com
See Also
~~~~~~~~