cdb_read(3)

💖 cdb_read(3) — Library Functions Manual 💖

okay bestie, so this is cdb_read, living in section 3 of the manual (that's the library-functions girlies ✨), and it is literally the "gimme those bytes" function for a constant database. no cap.

---

🌸 NAME 🌸

cdb_read — read bytes from a constant database 💅

---

✨ SYNTAX ✨

#include <libowfat/cdb.h>
#include <libowfat/uint32.h>

int cdb_read(struct cdb *c, char *buf, size_t len, uint32 position);

---

🦋 DESCRIPTION 🦋

okay so here's the tea 🍓 — cdb_read reads len bytes starting at position from c and drops them into buf. that's it, that's the whole job. main character energy, honestly 👑

and like, where do you even get those numbers? bestie:

• want the position? use cdb_datapos or cdb_keypos 💖
• want the len? use cdb_datalen or cdb_keylen ✨

and one super important thing, no skipping this part — buf needs to point to a memory region large enough to hold len bytes. like actually large enough. do not play with her 🙈 she will not check for you, iykyk.

---

🎀 RETURN VALUE 🎀

• 0 — everything went well, we ate, no crumbs 🔥
• -1 — an error happened, and it sets errno appropriately 😭

periodt.

---

💜 SEE ALSO 💜

• cdb_find(3)
• cdb_init(3)
• cdb_free(3)
• cdbmake(1)

---

and that's the page!! 🫶 the footer energy is just cdb_read(3) — no version number, no date, no source line, she's mysterious like that 🧚 honestly iconic of her. go forth and read your bytes, bestie 💅🌸