ldns(3)

πŸ“¦
version 1.9.2 Β· 2 versions
, in alpine 3.22, alpine 3.23, alpine 3.24, arch rolling, debian trixie, fedora 43, fedora 44, nixos 26.05, nixpkgs unstable, opensuse-leap 16.0, ubuntu questing, ubuntu resolute, ubuntu stonking

πŸ’– ldns(3) β€” the ldns_rr_list bestie page πŸ’–

okay so bestie, welcome to the ldns(3) manual, aka the group chat where we talk about wrangling ldns_rr_lists. this is the library functions manual for ldns and we're gonna go through it together, no skimming, no cap. πŸ¦‹


✨ NAME ✨

ldns_rr_list_cat, ldns_rr_list_push_rr, ldns_rr_list_pop_rr β€” literally just ldns_rr_list manipulation, that's the whole vibe. πŸ’…


🌸 SYNOPSIS 🌸

okay here's the part where you gotta pull in the right headers first, like putting on your outfit before you leave the house:

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

#include <ldns/ldns.h>

bool ldns_rr_list_cat(ldns_rr_list *left, const ldns_rr_list *right);

bool ldns_rr_list_push_rr(ldns_rr_list *rr_list, const ldns_rr *rr);

ldns_rr* ldns_rr_list_pop_rr(ldns_rr_list *rr_list);

three functions, three signatures, all copied exactly, we do not play with the facts here. ✨


πŸŽ€ DESCRIPTION πŸŽ€

πŸ’– ldns_rr_list_cat() β€” the merge, the crossover episode

this one concatenates two ldns_rr_lists together. and listen, it modifies *left β€” like actually reaches in there, extends it, and adds the pointers from *right into it. so yeah, left is not coming out of this the same girl she was before. πŸ‘‘

  • left: the leftside
  • right: the rightside

Returns a left with right concatenated to it. periodt.

πŸ’… ldns_rr_list_push_rr() β€” push it, push it

this pushes an rr onto an rrlist. adding to the squad, one rr at a time. 🫢

  • rr_list: the rr_list to push to
  • rr: the rr to push

Returns false on error, otherwise true. so if you get a false back, something went wrong, and if you get true, slay.

πŸ¦‹ ldns_rr_list_pop_rr() β€” the last one out

this pops the last rr off an rrlist. last in, first out, it's giving stack energy fr fr.

  • rr_list: the rr_list to pop from

Returns NULL if there's nothing to pop (sad, empty list, we've all been there 😭). Otherwise it hands you the popped RR.


🌈 AUTHOR 🌈

The ldns team at NLnet Labs. iconic behavior, honestly. πŸ‘‘


πŸ™ˆ REPORTING BUGS πŸ™ˆ

found a bug? don't suffer in silence bestie, please report bugs to dns-team@nlnetlabs.nl or on GitHub at https://github.com/NLnetLabs/ldns/issues. they wanna hear it, fr. πŸ’œ


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 this part is serious, no jokes: there is genuinely no warranty. not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. it says it in all caps, so you know they mean it. πŸ’€

πŸ”₯ SEE ALSO πŸ”₯

go check out ldns_rr, ldns_rr_list. And perldoc Net::DNS, RFC1034, RFC1035, RFC4033, RFC4034 and RFC4035. required reading, iykyk. πŸ“š


🧚 REMARKS 🧚

This manpage was automatically generated from the ldns source code. so if it sounds a lil stiff in places, that's why β€” but not anymore, because now it's ours. πŸ’–


and that's the whole page, bestie!! this was the ldns(3) manpage, dated 30 May 2006, from the ldns library functions manual β€” go forth and manipulate those rr_lists, you're gonna ate πŸ’…βœ¨πŸŽ€