Add examples to the dig man page

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.

(cherry picked from commit 8972ed9424)
This commit is contained in:
Julia Evans 2026-02-20 10:43:26 -05:00 committed by Ondřej Surý (GitLab job 6902933)
parent c0c4bf526a
commit ee0ae18a13

View file

@ -812,6 +812,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
~~~~~~~~