dnsjit.cor....dns.label(3)

💖 dnsjit.core.object.dns.label — the DNS label container, bestie edition 💖

okay so real quick, this page lives in the dnsjit.cor....dns.label(3) corner of the Library Functions Manual and it's all about one lil' guy: the DNS label. let's get into it 🎀

✨ NAME ✨

dnsjit.core.object.dns.label — a container of a DNS label 🏷️

---

🦋 DESCRIPTION 🦋

so this is the object that describes a DNS label, periodt. if you wanna extract a domain name label, first check that have_dn is set — vibe check first, always — then use offset + 1 to say where in the payload the label actually starts, and length for how many bytes long it is. no cap, that's the whole trick 💅

🌸 Attributes 🌸

• is_end — yeah it's just... there. sitting pretty. (that's all the docs say bestie, I'm not making stuff up 🙈)
• have_length — set if there's a length. slay.
• have_offset — set if there's an offset. iconic.
• have_extension_bits — set if there are extension bits. okurr.
• have_dn — set if the label contained a domain name. 👑
• extension_bits — the extension bits themselves, obviously.
• length — the length of the domain name.
• offset — so if have_dn is set, this holds the offset within the payload to where this label starts. otherwise? it holds the offset to another label. two moods, one field ✨

💜 Functions 💜

• Label.new(size) — makes you a brand new array of labels. fresh out the box, size-many of them 🫶
• Label.tostring(dns, labels, num_labels, offset_labels) — returns the labels as a string plus an offset pointing to the next label. it takes labels, which is an array of labels returned by any of the parse functions, and num_labels, the number of labels in that array. the optional offset_labels lets you skip some labels at the start (very "I'm not reading allat" of you, and honestly valid). heads up though: the return string may be nil if the first label was an offset, and the return offset may be nil if the last label was an extension bits or end marker 😭
• Label.torfc1035(dns, labels, num_labels, offset_labels) — same energy but it returns an RFC1035 domain name of the labels and an offset to the next label. takes labels, an array of labels returned by any of the parse functions, and num_labels, number of labels in the array. optional offset_labels can be used to skip labels at the start. the return string may be nil if the first label was an offset, and the return offset may be nil if the last label was an extension bits or end marker 💀
• Label.tooffstr(dns, labels, num_labels, offset_labels) — returns the labels as a string that also includes a textual notation of the offset, in the form <offset>label. takes labels, an array of labels returned by any of the parse functions, and num_labels, the number of labels in the array. optional offset_labels can be used to skip labels at the start. cute lil annotated vibes 🌈

---

👀 SEE ALSO 👀

• dnsjit.core.object.dns(3)

---

👑 AUTHORS and CONTRIBUTORS 👑

the icons who built this:

• Jerry Lundström (DNS-OARC)
• Tomáš Křížek (CZ.NIC)
• Petr Špaček (ISC)

Maintained by DNS-OARC 💖

https://www.dns-oarc.net/

---

🐛 BUGS 🐛

found something broken or got a feature request? for issues and feature requests please use:

https://codeberg.org/DNS-OARC/dnsjit/issues

got questions or need help? for question and help please use:

admin@dns-oarc.net

---

and that's the whole page bestie, no notes 🎀 this was dnsjit version 1.5.1, straight from the dnsjit.cor....dns.label(3) manual — go forth and parse those labels, you absolute main character 💅✨🦋