DT-GETHOST(1)

📦 version 2.2.3, in arch rolling, fedora 43, fedora 44

🌸 DT-GETHOST 💅

okay bestie, welcome to dt-gethost — it lives in the User Commands section of the manual, and it is literally the little command-line test bestie for the val_gethostbyname() family of functions. 🎀

✨ NAME ✨

dt-gethost — a command-line test program for the val_gethostbyname() (and related) functions 🦋

🫶 SYNOPSIS 🫶

dt-gethost [options] name

💖 DESCRIPTION 💖

so basically, this utility is a command-line wrapper around the val_gethostbyname() (and related) functions. she's giving glorified test harness and honestly? iconic. 👑

what she does is call val_gethostbyname(), val_gethostbyname_r() and val_gethostbyname2() for whatever arguments you handed her on the command line, and then she shows you the returned hostent, the validation status value, and the value of the h_errno variable. the way that she just tells you everything — no cap, we love a transparent queen. 💅

now the exit status, because this is the part people always ask about:

  • 1 — the answer received is trusted 💚
  • 2 — the answer received is validated 💙
  • -1 — there was an error 😭
  • 0 — no validation was performed, or the result was neither trusted nor validated 😐

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

🔥 OPTIONS 🔥

  • -r, --reentrant — use the re-entrant query interface 🧚
  • -f, --family=[AF_INET|AF_INET6] — use the specified address family for the query 🌐
  • -o, --output=<debug-level>:<dest-type>[:<dest-options>] — set up where the output goes, bestie. here's the breakdown:
    • <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 🫡

🎀 PRE-REQUISITES 🎀

libval

like. you need her. periodt. 💜

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 🌟

🌈 SEE ALSO 🌈

and that's the whole page, babe 🦋 this one was rendered by perl v5.18.4 back on 2015-04-27 — so yeah, she's an elder but she still ate 💅✨

📦 where this page comes from