ldns(3)

💖 ldns(3) — the hosts-file parser era 💖

okay bestie, so this is a page from the ldns library manual (yes, ldns(3), library functions manual energy), and we're talking about three little functions that go rummaging through your /etc/hosts file and pull out all the hosts they can find. it's giving "who's home" but for DNS records. 🏠✨

---

🌸 NAME 🌸

ldns_get_rr_list_hosts_frm_file, ldns_get_rr_list_hosts_frm_fp, ldns_get_rr_list_hosts_frm_fp_l — parse /etc/hosts file

like. the whole squad is here. three functions, one job. 💅

---

✨ SYNOPSIS ✨

#include <stdint.h>
#include <stdbool.h>

#include <ldns/ldns.h>

ldns_rr_list* ldns_get_rr_list_hosts_frm_file(char *filename);

ldns_rr_list* ldns_get_rr_list_hosts_frm_fp(FILE *fp);

ldns_rr_list* ldns_get_rr_list_hosts_frm_fp_l(FILE *fp, int *line_nr);

no cap, that's the whole signature situation. 🎀

---

🦋 DESCRIPTION 🦋

ldns_get_rr_list_hosts_frm_file() — wade through fp (a /etc/hosts like file) and return a rr_list containing all the defined hosts in there

• filename: the filename to use (NULL for /etc/hosts)
• Returns ldns_rr_list * with the names

bestie, if you pass NULL it literally just defaults to /etc/hosts. iconic behavior honestly. 💖

ldns_get_rr_list_hosts_frm_fp() — wade through fp (a /etc/hosts like file) and return a rr_list containing all the defined hosts in there

• fp: the file pointer to use
• Returns ldns_rr_list * with the names

same vibe, but you're handing it a file pointer you already opened. main character move. 🔥

ldns_get_rr_list_hosts_frm_fp_l() — wade through fp (a /etc/hosts like file) and return a rr_list containing all the defined hosts in there

• fp: the file pointer to use
• line_nr: pointer to an integer containing the current line number (for debugging purposes)
• Returns ldns_rr_list * with the names

the _l at the end is for line numbers, and it's for debugging purposes — that's the whole reason she exists. she's the one who keeps receipts. 📝💀

---

👑 AUTHOR 👑

The ldns team at NLnet Labs.

periodt. that's the team. 🫶

---

🙈 REPORTING BUGS 🙈

Please report bugs to dns-team@nlnetlabs.nl or on GitHub at https://github.com/NLnetLabs/ldns/issues

like, fr fr, if something's cursed, tell them. they wanna know. 🐛

---

💜 COPYRIGHT 💜

Copyright (c) 2004 - 2006 NLnet Labs.

Licensed under the BSD License. There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

⚠️ okay so the all-caps is doing a lot of yelling but it's serious — NO warranty. none. not even the "well maybe it works for selling it" kind, and not even the "works for one specific purpose" kind. if it breaks, that's a you problem. 😭

---

🌈 SEE ALSO 🌈

ldns_rr_list, ldns_rr. And perldoc Net::DNS, RFC1034, RFC1035, RFC4033, RFC4034 and RFC4035.

go read the lore, iykyk. 📚✨

---

⭐ REMARKS ⭐

This manpage was automatically generated from the ldns source code.

yeah she's machine-made. still cute though. 🤖💅

---

that's the whole page bestie, every flag, every return type, every reference — nothing skipped, nothing invented. 🦋

sending you off with the classic: this was ldns(3) from 30 May 2006 — old enough to have its own vintage aesthetic, still parsing hosts files like a champ. 💖🎀🌸