ldns(3)

💖 ldns — the ldns(3) girlies' guide to wire → host conversion 💖

okay bestie so this is the ldns(3) manual page, from the Library Functions Manual, and it's literally the "we're going from wire format to host type" chapter. no cap. four functions, one vibe: take those raw bytes off the network and turn them into actual grown-up structs. slay. 🦋

---

✨ NAME ✨

ldns_wire2rr, ldns_wire2pkt, ldns_wire2rdf, ldns_wire2dname — convert from wire format to host type. that's the whole assignment, and they ate. 💅

---

✨ SYNOPSIS ✨

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

#include <ldns/ldns.h>

ldns_status ldns_wire2rr(ldns_rr **rr, const uint8_t *wire, size_t max,
size_t *pos, ldns_pkt_section section);

ldns_status ldns_wire2pkt(ldns_pkt **packet, const uint8_t *data, size_t
len);

ldns_status ldns_wire2rdf(ldns_rr *rr, const uint8_t *wire, size_t max,
size_t *pos);

ldns_status ldns_wire2dname(ldns_rdf **dname, const uint8_t *wire,
size_t max, size_t *pos);

like, that's the whole incantation. include the headers, call the function, get a struct back. periodt. 🎀

---

✨ DESCRIPTION ✨

okay so here's the tea on each one of these babies. ☕

🌈 ldns_wire2rr()

ldns_wire2rr() converts the data on the uint8_t bytearray (in wire format) to a DNS resource record. this function will initialize and allocate memory space for the rr structure. the length of the wiredata of this rr is added to the *pos value. ✨

• rr: pointer to the structure to hold the rdata value
• wire: pointer to the buffer with the data
• max: the length of the data buffer (in bytes)
• pos: the position of the rr in the buffer (ie. the number of bytes from the start of the buffer)
• section: the section in the packet the rr is meant for
• Returns LDNS_STATUS_OK if everything succeeds, error otherwise

🌈 ldns_wire2pkt()

ldns_wire2pkt() converts the data on the uint8_t bytearray (in wire format) to a DNS packet. this function will initialize and allocate memory space for the packet structure. 🫶

• packet: pointer to the structure to hold the packet
• data: pointer to the buffer with the data
• len: the length of the data buffer (in bytes)
• Returns LDNS_STATUS_OK if everything succeeds, error otherwise

🌈 ldns_wire2rdf()

ldns_wire2rdf() converts the data on the uint8_t bytearray (in wire format) to DNS rdata fields, and adds them to the list of rdfs of the given rr. this function will initialize and allocate memory space for the dname structures. the length of the wiredata of these rdfs is added to the *pos value. 🧚

all rdfs belonging to the RR are read; the rr should have no rdfs yet. an error is returned if the format cannot be parsed. (so like, don't hand it a half-filled rr, bestie, it will simply not cope 😭)

• rr: pointer to the ldns_rr structure to hold the rdata value
• wire: pointer to the buffer with the data
• max: the length of the data buffer (in bytes)
• pos: the position of the rdf in the buffer (ie. the number of bytes from the start of the buffer)
• Returns LDNS_STATUS_OK if everything succeeds, error otherwise

🌈 ldns_wire2dname()

ldns_wire2dname() converts the data on the uint8_t bytearray (in wire format) to a DNS dname rdata field. this function will initialize and allocate memory space for the dname structure. the length of the wiredata of this rdf is added to the *pos value. 💜

• dname: pointer to the structure to hold the rdata value
• wire: pointer to the buffer with the data
• max: the length of the data buffer (in bytes)
• pos: the position of the rdf in the buffer (ie. the number of bytes from the start of the buffer)
• Returns LDNS_STATUS_OK if everything succeeds, error otherwise

---

✨ AUTHOR ✨

the ldns team at NLnet Labs. 👑 absolute icons, honestly.

---

✨ REPORTING BUGS ✨

please report bugs to dns-team@nlnetlabs.nl or on GitHub at https://github.com/NLnetLabs/ldns/issues. not me asking you to file an issue… okay yes it's me, file the issue, it's giving responsible. 🙈

---

✨ 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. like literally none, bestie, zero, nada. 💀

---

✨ SEE ALSO ✨

ldns_rr2wire, ldns_pkt2wire, ldns_rdf2wire, ldns_dname2wire — the reverse girlies, the ones going the other way. 🔥

and perldoc Net::DNS, RFC1034, RFC1035, RFC4033, RFC4034 and RFC4035. iykyk, the classic literature. 📚

---

✨ REMARKS ✨

this manpage was automatically generated from the ldns source code. so nobody hand-wrote the boring bits, we just gave them a glow-up. 💖

---

and that's the whole page, bestie — <rainbow>30 May 2006, ldns(3)` 🌸 mwah, go convert some wire format, you're doing amazing. 🎀✨