DT-GETRRSET(1)

πŸ“¦ version 2.2.3, in arch rolling, fedora 43, fedora 44

πŸ’– dt-getquery(1) β€” user commands, bestie edition πŸ’–

okay so this is the manual for dt-getquery, and it lives in the User Commands section of the manual pages. it's the command-line test program for the val_get_rrset() function. iykyk. πŸ¦‹


✨ NAME ✨

dt-getquery β€” a command-line test program for the val_get_rrset() function. yes, that's literally the whole job. it tests. it queries. it slays. πŸ’…


✨ SYNOPSIS ✨

dt-getquery [options] name

you give it a name, you give it some options, it does its thing. iconic behavior. ✨


✨ DESCRIPTION ✨

so bestie, here's the tea β˜• β€” this utility is a command-line wrapper around the val_get_rrset() function. like, it's a little glow-up jacket for that function so you can poke at it from your terminal instead of writing actual code. 🫢

what it does: it invokes val_get_rrset() with the command-line arguments you handed it, and then it shows you the returned data. but not just the data β€” for each resource record set returned in the response, it also displays:

  • the validated status 🌸
  • the trusted status πŸ‘‘
  • the non-existence status πŸ’€

and honestly? it also shows you any information about name aliases, because it's thorough like that. no crumbs left behind. πŸ“

the trusted and validated status values come from the val_istrusted() and val_isvalidated() functions over in libval(3). that's where the receipts live.

πŸ“Œ heads up: this program returns 0 on success and -1 on failure. that's it. that's the whole exit story.

✨ OPTIONS ✨

  • -t <type> β€” do the query for the given DNS record type. you want a specific type? say the word and it's done. πŸŽ€
  • -o, --output=<debug-level>:<dest-type>[:<dest-options>] β€” the output control option, aka where do you want your debug tea spilled and how loud. πŸ—£οΈ

here's how to read that lil string:

  • <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 "just tell me what's happening" button. πŸ’…

✨ PRE-REQUISITES ✨

libval

that's it. that's the list. get you a library that can do both. πŸ’œ


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

the whole squad. main character energy from every single one of them. πŸ‘‘πŸ‘‘πŸ‘‘πŸ‘‘


✨ SEE ALSO ✨


and that's the whole page, bestie πŸŽ€ β€” brought to you by perl v5.14.3, dated 2013-02-27, in the classic DT-GETRRSET(1) wrapper. she's been here since 2013 and she still ate. πŸ’–βœ¨πŸŒˆ

πŸ“¦ where this page comes from