unbound-streamtcp(1)

✨ unbound-streamtcp β€” the unbound DNS lookup utility ✨

okay bestie, welcome to unbound-streamtcp(1), part of the unbound manual set πŸŽ€ this little cutie is a DNS lookup utility and it's literally about to be your new fave.


🌸 SYNOPSIS 🌸

unbound-streamtcp [-unsh] [-f ipaddr[@port]] [-d secs] name type class

πŸ’… DESCRIPTION πŸ’…

So here's the vibe: unbound-streamtcp takes a DNS Query β€” of whatever type and class you want, for whatever name you want β€” and sends it to the DNS server over TCP, then shows you the response. no cap. πŸ’–

And if you didn't tell it which server to hit with the -f option? It just defaults to localhost, aka 127.0.0.1. easy. And here's the cute part: you can stack more queries on one commandline and they get resolved in sequence, one after another. slay. ✨

The available options are:

  • name β€” this is the name being resolved (looked up in the DNS).
  • type β€” specify the type of data to lookup.
  • class β€” specify the class to lookup for.
  • -u β€” use UDP instead of TCP. heads up though, no retries are attempted.
  • -n β€” do not wait for the answer. bye, we're not sticking around πŸ¦‹
  • -a β€” print answers on arrival. what this means is queries get sent in sequence without waiting for the answer, but if answers show up during that time they get printed out. then after all the queries are sent, the program waits and prints whatever's left. bestie it's giving multitasking πŸ‘‘
  • -s β€” use SSL.
  • -h β€” print program usage.
  • -f ipaddr[@port] β€” specify the server to send the queries to. if you don't specify it, localhost (127.0.0.1) is what you get.
  • -d secs β€” delay after the connection before sending the query. this tests the timeout on the other side β€” like, if the timeout over there is shorter, the connection gets closed. πŸ”₯
  • -p client β€” use proxy protocol to send the query. specify the ipaddr@portnr of the client to include in PROXYv2.
  • IXFR=serial β€” pass the type of the query as IXFR=N to send an IXFR query with serial N.
  • NOTIFY[=serial] β€” pass the type of the query as NOTIFY[=N] to send a notify packet. the serial N of the new zone can be included. πŸ’œ

πŸ¦‹ EXAMPLES πŸ¦‹

Some examples of use. (yes these are iconic, yes you should copy them πŸ’…)

$ unbound-streamtcp www.example.com A IN
$ unbound-streamtcp -f 192.168.1.1 www.example.com SOA IN
$ unbound-streamtcp -f 192.168.1.1@1234 153.1.168.192.in-addr.arpa. PTR IN

⭐ EXIT CODE ⭐

The unbound-streamtcp program exits with status code 1 on error, and 0 on no error. periodt.


πŸŽ€ AUTHOR πŸŽ€

This manual page was written by Tomas Hozza <thozza@redhat.com>. thank you for your service bestie 🫢


and that's the whole page, no crumbs left πŸ’– NLnet Labs wrote this one, it's the Mar 21, 2013 edition, and it's from the unbound manual. go forth and query, queen πŸ‘‘βœ¨