DT-GETADDR(1)

💖 DT-GETADDR — like, the whole vibe 💖

okay bestie, welcome to the dt-getaddr era, a page from the User Commands chapter of the manual, and honestly? it's giving "tiny tool, huge job." let's get into it 🫶

---

✨ NAME ✨

dt-getaddr — a lil command-line test program for the val_getaddrinfo() function 🌸

---

🎀 SYNOPSIS 🎀

dt-getaddr [options] <hostname|IPv4 address|IPv6 address>

like. that's it. that's the whole entrance. 💅

---

🦋 DESCRIPTION 🦋

so this utility is literally just a command-line wrapper around the val_getaddrinfo() function, no cap. it invokes the val_getaddrinfo() operation for whatever command-line arguments you hand it, then shows you the return code that came back from the function and the contents of the addrinfo structure. it's a whole little reveal moment ✨

now the exit status, and this part matters so listen up:

• 1 — the answer you received is trusted 👑
• 2 — the answer you received is validated ✅
• -1 — an error happened 💀
• 0 — returned if no validation was performed, or if the result is neither trusted nor validated

where do those trusted/validated status values come from, you ask? they're obtained using the val_istrusted() and val_isvalidated() functions from libval(3). iconic behavior, fr fr.

---

💅 OPTIONS 💅

• -c, --canonname — use the AI_CANONNAME flag in val_getaddrinfo(). yes bestie, we're asking for the canonical name too 🎀
• -s, --service=PORT|SERVICE — use the transport-layer port or service name you specify here.
• -o, --output=<debug-level>:<dest-type>[:<dest-options>] — the output config situation, and it has layers (literally):
  • <debug-level> is 1-7, corresponding to syslog levels ALERT-DEBUG
  • <dest-type> is one of file, net, syslog, stderr, stdout
  • <dest-options> depends on <dest-type>:
    • file:<file-name> — opened in append mode
    • net[:<host-name>:<host-port>] — 127.0.0.1:1053
    • syslog[:facility] — 0-23 (default 1 USER)
• -h, --help — display the help and exit. bye bestie, you got your answers 🫶

---

🌈 PRE-REQUISITES 🌈

libval

like, you need it. that's the whole prerequisite list. no notes. 💜

---

⭐ COPYRIGHT ⭐

Copyright 2005-2013 SPARTA, Inc. All rights reserved. See the COPYING file included with the DNSSEC-Tools package for details.

(legal girlies, this one's for you 🎀)

---

👑 AUTHORS 👑

Abhijit Hayatnagarkar, Suresh Krishnaswamy, Robert Story

absolute legends, all three of them 💖

---

🔥 SEE ALSO 🔥

• val_getaddrinfo(3)
• libval(3)
• http://www.dnssec-tools.org

---

ok that's the page!! go forth and dt-getaddr responsibly, bestie 🦋

---

and a lil sign-off for the record: this page is from perl v5.14.3, dated 2013-02-27 — that's the DT-GETADDR(1) energy, periodt 💅✨