DT-GETQUERY(1)

💖 DT-GETQUERY 💖

okay bestie, so this is the manual page for dt-getquery, a lil User Command that lives in section 1 of the manual. she's a command-line test program for the val_res_query() function. that's the whole vibe. let's get into it 🫶

---

✨ NAME ✨

dt-getquery — a command-line test program for the val_res_query() function, no cap 💅

---

🌸 SYNOPSIS 🌸

dt-getquery [options] name

---

🦋 DESCRIPTION 🦋

so basically, this utility is a command-line wrapper around the val_res_query() function. it takes the arguments you gave it on the command line, hands them straight to val_res_query(), and then shows you what came back as a DNS-style response. iconic behavior tbh ✨

it also shows you the validation status value for the records that came back for your query. like, it's not just "here's your answer", it's "here's your answer AND here's whether we trust it". main character energy fr fr 👑

now the exit status, and listen closely because this part is literally the whole point:

• 1 — the answer received is trusted
• 2 — the answer received is validated
• -1 — that's an error bestie 💀
• 0 — the result was neither trusted nor validated, so, neutral. not slaying, not failing. just existing 🙈

the trusted and validated status values come from the val_istrusted() and val_isvalidated() functions in libval(3). iykyk 🎀

---

💅 OPTIONS 💅

• -t <type> — perform the query for the given DNS record type. tell her what you're looking for and she'll go get it 🦋
• -o, --output=*<debug-level>*:*<dest-type>*[:*<dest-options>`] — the output config situation, and okay there's layers here so stay with me:
  • <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. the classic. the "just tell me what to do" button 🌈

---

🧚 PRE-REQUISITES 🧚

• libval

(yeah you need her. she's the whole foundation. no libval, no vibes 😭)

---

⭐ COPYRIGHT ⭐

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

---

👑 AUTHORS 👑

Abhijit Hayatnagarkar, Suresh Krishnaswamy, Robert Story, Michael Baer

(legends, all four of them, we stan 🫶)

---

🔥 SEE ALSO 🔥

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

---

and that's the page!! this one was generated by perl v5.14.3 and dated 2013-02-27, so shoutout to the perl era for bringing us this absolute gem 💜✨ go run your queries bestie, and remember: trusted is 1, validated is 2, error is -1, and everything else is just 0 🎀