val_getaddrinfo(3)

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

💖 val_getaddrinfo(3) — the DNSSEC-validated glow-up of getaddrinfo 💖

okay bestie, sit down, we're doing a val_getaddrinfo(3) deep dive and it's genuinely iconic. this is a Programmer's Manual page, so grab a strawberry something and let's go 🍓✨

✨ NAME ✨

val_getaddrinfo() — get DNSSEC-validated network address and service translation

like, it's the version of getaddrinfo that actually checked its sources first. no cap. 💅

🌈 SYNOPSIS 🌈

#include <validator/validator.h>

int val_getaddrinfo(const struct val_context *ctx,
                    const char *nodename,
                    const char *servname,
                    const struct addrinfo *hints,
                    struct addrinfo **res,
                    val_status_t * val_status);

int val_getnameinfo(val_context_t * ctx,
                    const struct sockaddr *sa,
                    socklen_t salen,
                    char *host,
                    size_t hostlen,
                    char *serv,
                    size_t servlen,
                    int flags,
                    val_status_t * val_status);

two functions, one page, both serving. 👑

🦋 DESCRIPTION 🦋

so val_getaddrinfo() and val_getnameinfo do DNSSEC validation of DNS queries. they're literally designed to be the DNSSEC-aware replacements for getaddrinfo(3) and getnameinfo(3). glow-up era fr fr.

val_getaddrinfo() returns a network address value of type struct addrinfo in the res parameter. and val_getnameinfo is the one you call to convert a sockaddr structure into a pair of host name and service strings. two different jobs, both eating. 🔥

val_status gives the combined validation status value for all answers returned by the each of the functions. and listen — val_istrusted() and val_isvalidated() are your besties for figuring out whether data is actually trustworthy, and p_val_status() can show that status value to the user in ASCII format. (See libval(3) more for information.) 👀

the ctx parameter specifies the validation context, and you can set it to NULL for default values. (see libval(3) and dnsval.conf for more details on validation contexts and validation policy.) like, NULL = just use the defaults, it's giving low-effort-but-correct. 🎀

the nodename, servname, and hints parameters have similar syntax and semantics as the corresponding parameters for the original getaddrinfo() function. the res parameter is similar to the res parameter for getaddrinfo(). and please, bestie, see the manual page for getaddrinfo(3) for more details about these parameters. i'm not gatekeeping, i'm just pointing you to the source. 📚

💀 RETURN VALUES 💀

val_getaddrinfo() returns 0 on success and a non-zero error code on failure. slay when it's 0, screaming crying when it's not. 😭

*res will point to a dynamically allocated linked list of addrinfo structures on success, and will be NULL if no answer was available. so if you get NULL, that's not a bug, that's the vibe. 🫶

the val_status parameter gives an indication for trustworthiness of data. if *res is NULL, this value gives an indication of whether the non-existence of data can be trusted or not. so even the "nothing here" has lore. 💅

⭐ EXAMPLE ⭐

here's the whole thing, verbatim, no edits, we respect the source code in this house:

#include <stdio.h>
#include <stdlib.h>
#include <validator.h>

int main(int argc, char *argv[])
{
         struct addrinfo *ainfo = NULL;
         int retval;

         if (argc < 2) {
                 printf("Usage: %s <hostname>\n", argv[0]);
                 exit(1);
         }

         retval = val_getaddrinfo(NULL, argv[1], NULL, NULL, &ainfo);

         if ((retval == 0) && (ainfo != NULL)) {

                 printf("Validation Status = %d [%s]\n",
                        ainfo->ai_val_status,
                        p_val_status(ainfo->ai_val_status));

                 val_freeaddrinfo(ainfo);
         }

         return 0;
}

not the val_freeaddrinfo(ainfo) at the end though — clean up after yourself, bestie, memory leaks are NOT the aesthetic. 🧚

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

(legal stuff but make it fashion 💜)

👑 AUTHORS 👑

Abhijit Hayatnagarkar, Michael Baer

the icons who wrote this. we stan. 🌸

🌈 SEE ALSO 🌈

and that's the page, bestie!! 💖 this whole thing shipped as perl v5.18.4 dated 2015-04-27 — yeah, she's vintage, she's a classic, and she still validates. periodt. 💅✨🦋

📦 where this page comes from