ldns(3)

💖 ldns — buffer limits and pointers 💖

okay bestie, welcome to ldns(3), the Library Functions Manual page for the ldns buffer squad 🫶 this is the one where we talk about limits, capacity, and all the little pointers that go brr inside your DNS buffer. it's giving very "I know where my bytes live" energy and honestly? iconic.

---

✨ NAME ✨

ldns_buffer_limit, ldns_buffer_set_limit, ldns_buffer_capacity, ldns_buffer_set_capacity, ldns_buffer_reserve, ldns_buffer_at, ldns_buffer_begin, ldns_buffer_end, ldns_buffer_current — buffer limits and pointers 🎀

---

✨ SYNOPSIS ✨

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

#include <ldns/ldns.h>

size_t ldns_buffer_limit(const ldns_buffer *buffer);

void ldns_buffer_set_limit(ldns_buffer *buffer, size_t limit);

size_t ldns_buffer_capacity(const ldns_buffer *buffer);

bool ldns_buffer_set_capacity(ldns_buffer *buffer, size_t capacity);

bool ldns_buffer_reserve(ldns_buffer *buffer, size_t amount);

uint8_t * ldns_buffer_at(const ldns_buffer *buffer, size_t at);

uint8_t * ldns_buffer_begin(const ldns_buffer *buffer);

uint8_t * ldns_buffer_end(const ldns_buffer *buffer);

uint8_t * ldns_buffer_current(const ldns_buffer *buffer);

---

✨ DESCRIPTION ✨

okay so let's go function by function, no cap. 💅

• ldns_buffer_limit() — returns the max size of the buffer.
  • buffer: the buffer
  • Returns the size
• ldns_buffer_set_limit() — changes the buffer's limit. and listen: if the buffer's position is greater than the new limit, the position gets set to the limit. so it's not gonna leave you stranded past the edge, bestie 🦋
  • buffer: the buffer
  • limit: the new limit
• ldns_buffer_capacity() — returns the number of bytes the buffer can hold.
  • buffer: the buffer
  • Returns the number of bytes
• ldns_buffer_set_capacity() — changes the buffer's capacity.

🚨 bestie WARNING: the data is reallocated, so any pointers to the data may become invalid. if you were holding a pointer, it's gone, it's not coming back, mourn it 😭

The buffer's limit is set to the buffer's new capacity.

• buffer: the buffer
• capacity: the capacity to use
• Returns whether this failed or succeeded

• ldns_buffer_reserve() — makes sure BUFFER can contain at least AMOUNT more bytes. the buffer's capacity is increased if necessary using buffer_set_capacity().

And the buffer's limit is always set to the (possibly increased) capacity. always. periodt.

• buffer: the buffer
• amount: amount to use
• Returns whether this failed or succeeded

• ldns_buffer_at() — returns a pointer to the data at the indicated position. 📍
  • buffer: the buffer
  • at: position
  • Returns the pointer to the data
• ldns_buffer_begin() — returns a pointer to the beginning of the buffer (the data at position 0). like, the very start, the origin story 💫
  • buffer: the buffer
  • Returns the pointer
• ldns_buffer_end() — returns a pointer to the end of the buffer (the data at the buffer's limit).
  • buffer: the buffer
  • Returns the pointer
• ldns_buffer_current() — returns a pointer to the data at the buffer's current position. main character position energy 👑
  • buffer: the buffer
  • Returns the pointer

---

✨ AUTHOR ✨

The ldns team at NLnet Labs. 🫶 absolute legends, fr fr.

---

✨ REPORTING BUGS ✨

Please report bugs to dns-team@nlnetlabs.nl or on GitHub at https://github.com/NLnetLabs/ldns/issues — they want the tea, spill it 💅

---

✨ 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, zero warranty. none. nada. you're on your own bestie 🙈

---

✨ SEE ALSO ✨

ldns_buffer. And perldoc Net::DNS, RFC1034, RFC1035, RFC4033, RFC4034 and RFC4035. go read, iykyk 📚✨

---

✨ REMARKS ✨

This manpage was automatically generated from the ldns source code. not me getting generated by a machine and still serving this hard 🤖💖

---

aaaand that's the whole page bestie, you ate it, you understood buffers, slay 🌈💜

signing off: this was ldns(3), dated 30 May 2006, and yes the manual name is right there in the title so we been knew 😌✨