val_res_query(3)

💖 val_res_query(3) — Programmer's Manual energy, but make it make sense 💖

okay bestie, sit down, grab a strawberry 🍓 — this is val_res_query(3) from the Programmer's Manual, and it's genuinely one of the good ones. no cap.

---

✨ NAME ✨

val_res_query(), val_res_search() — DNSSEC-validated resolution of DNS queries 🛡️

---

🌸 SYNOPSIS 🌸

#include <validator/validator.h>

int val_res_query(const val_context_t *ctx,
                  const char *dname,
                  int class,
                  int type,
                  unsigned char *answer,
                  int anslen,
                  val_status_t *val_status);

int val_res_search(val_context_t * ctx,
          const char *dname,
          int class_h,
          int type,
          unsigned char * answer,
          int anslen,
          val_status_t * val_status);

like look at her. iconic. 💅

---

🦋 DESCRIPTION 🦋

So. The way that val_res_query() works is that it performs DNSSEC validation of DNS queries. It's the DNSSEC-aware glow-up of the legacy res_query(3) function — same vibe, but it actually checks the receipts. 🔥

And val_res_search()? She performs an operation similar to val_res_query(). In addition, she uses the search paths specified within the /etc/resolv.conf file to create the fully qualified domain name. val_res_search() is the DNSSEC-aware substitute for the res_search(3) function. bestie duo fr fr. 🫶

The ctx parameter is the validator context, and honestly? you can set it to NULL for default settings, she doesn't mind. More info about this field can be found in libval(3). ✨

The dname parameter specifies the domain name, class specifies the DNS class, and type specifies the DNS type. that's it, that's the trio. 👑

The validation status values for val_res_query() and val_res_search() functions are returned in their respective val_status fields. And because we love a support system:

• p_val_status() returns a brief string description of the error code. 💬
• val_istrusted() determines if the status code indicates that the response can be trusted. 🫡
• val_isvalidated() determines if the status code indicates that the response was validated. ✅

(like, see libval(3) for further information — she has the lore.)

---

⭐ RETURN VALUES ⭐

val_res_query() and val_res_search() return the number of bytes received on success and -1 on failure.

so if you see -1, that's not a vibe, that's an error. no cap. 💀

---

🎀 COPYRIGHT 🎀

Copyright 2004-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.

the literal founding mothers/fathers of this whole situation. respect. 🫶

---

🌈 SEE ALSO 🌈

• res_query(3)
• get_context(3), val_getaddrinfo(3), val_gethostbyname(3)
• libval(3)
• http://www.dnssec-tools.org

---

and that's the whole page, bestie. this manual page was living its perl v5.12.4 era and got dated 2013-03-08 — so if you're reading this, just know she's been serving DNSSEC knowledge since way back and she ate, periodt. 💖✨