ldns(3)

💖 ldns_zone — the zone bestie manual 💖

okay so this is page ldns(3) from the Library Functions Manual, and it's literally all about creating, destroying and printing ldns_zone things. Buckle up, we're doing zones today. 🦋

---

✨ NAME ✨

ldns_zone, ldns_zone_new, ldns_zone_free, ldns_zone_deep_free, ldns_zone_new_frm_fp, ldns_zone_new_frm_fp_l, ldns_zone_print, ldns_zone_print_fmt — ldns_zone creation, destruction and printing. That's the whole vibe. Making zones, yeeting zones, showing zones off. 💅

---

🌸 SYNOPSIS 🌸

Bestie, here's what you gotta pull in first:

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

#include <ldns/ldns.h>

And here are the functions themselves, no cap, exactly as they are:

ldns_zone * ldns_zone_new(void);

void ldns_zone_free(ldns_zone *zone);

void ldns_zone_deep_free(ldns_zone *zone);

ldns_status ldns_zone_new_frm_fp(ldns_zone **z, FILE *fp, const ldns_rdf
*origin, uint32_t ttl, ldns_rr_class c);

ldns_status ldns_zone_new_frm_fp_l(ldns_zone **z, FILE *fp, const
ldns_rdf *origin, uint32_t ttl, ldns_rr_class c, int *line_nr);

void ldns_zone_print(FILE *output, const ldns_zone *z);

void ldns_zone_print_fmt(FILE *output, const ldns_output_format *fmt,
const ldns_zone *z);

---

🎀 DESCRIPTION 🎀

💜 ldns_zone

DNS Zone — say it with your chest. 👑

It's a list of RR's with some extra info that comes from the SOA RR. And heads up: literally nothing has been done to make this efficient (yet). It's giving "we'll optimize later" energy and honestly, same.

struct ldns_struct_zone
{
     the soa defines a zone:
     ldns_rr   *_soa;
     /* basically a zone is a list of rr's */
     ldns_rr_list   *_rrs;
     /* we could change this to be a b-tree etc etc todo */
};
typedef struct ldns_struct_zone ldns_zone;

Not the todo comment in the source 😭 iconic. Anyway.

---

🌈 ldns_zone_new()

Creates a brand new ldns_zone structure. ✨

Returns a pointer to a ldns_zone structure.

---

🧚 ldns_zone_free()

Frees the allocated memory for the zone, and the rr_list structure inside it.

• zone — the zone to free.

---

💀 ldns_zone_deep_free()

Okay this one goes deep deep. It frees the allocated memory for the zone, the soa rr inside it, and the rr_list structure inside it, including the rr's in that. Etc.

• zone — the zone to free.

Careful bestie — this is the deep one. It takes everything with it, not just the outer shell. 🙈

---

🦋 ldns_zone_new_frm_fp()

Creates a new zone from a file. 📂

• z — the new zone.
• *fp — the filepointer to use.
• *origin — the zones' origin.
• ttl — default ttl to use.
• c — default class to use (IN).

Returns an ldns_status mesg with an error, or LDNS_STATUS_OK if it ate. ✅

---

⭐ ldns_zone_new_frm_fp_l()

Same as above but it keeps track of the line numbering, which is lowkey so helpful when something breaks.

• z — the new zone.
• *fp — the filepointer to use.
• *origin — the zones' origin.
• ttl — default ttl to use.
• c — default class to use (IN).
• line_nr — used for error msg, to get to the line number.

Returns an ldns_status mesg with an error, or LDNS_STATUS_OK. 🫶

---

🌸 ldns_zone_print()

Prints a zone structure * to output. Note the SOA record is included in this output — it's not shy, it shows up. 💖

• output — the fd to print to.
• z — the zone to print.

---

🍓 ldns_zone_print_fmt()

Prints a zone structure * to output. Note the SOA record is included in this output too. Same deal, different format.

• output — the fd to print to.
• fmt — format of the textual representation.
• z — the zone to print.

---

👑 AUTHOR 👑

The ldns team at NLnet Labs. Absolute legends, fr fr.

---

🐛 REPORTING BUGS 🐛

Found a bug? Please report bugs to dns-team@nlnetlabs.nl or on GitHub at https://github.com/NLnetLabs/ldns/issues. Don't sit on it, bestie, tell them. 💌

---

📜 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. Read that again. No warranty. None. 😭

---

🔍 SEE ALSO 🔍

perldoc Net::DNS, RFC1034, RFC1035, RFC4033, RFC4034 and RFC4035. Go read them, iykyk. 📚

---

🫶 REMARKS 🫶

This manpage was automatically generated from the ldns source code. Not me finding out the manpage didn't even get hand-written 😭 the robots did it and they ate.

---

k byeee, this page was ldns(3) from the Library Functions Manual, dated 30 May 2006, and that's the whole thing. slay, stay safe, and always deep_free responsibly. 💖✨🎀🦋