cdb_free(3)

🌸 cdb_free — from the Library Functions Manual 🌸

okay bestie, pull up a chair because today we're talking about cdb_free, a little function from the Library Functions Manual that is honestly the cleanest breakup artist in the whole cdb friend group 💅

✨ NAME ✨

cdb_free — close a constant database 🎀

✨ SYNTAX ✨

#include <libowfat/cdb.h>

int cdb_free(struct cdb *c);

that's it. one include, one call, one int coming back at you. iconic behavior, no notes 🫶

✨ DESCRIPTION ✨

so like. cdb_free removes any memory mapping that cdb_init might have established. that's the whole job. it's the "okay we're done here, everybody out of the pool" function 🌊

but — and this is the part where the plot twists — it is not your all-purpose cleanup goblin. it will not close the file descriptor that you passed to cdb_init. that fd is yours, bestie, you opened it, you close it, that's a you problem and I say that with love 💖

and it will not attempt to call free() on the struct cdb pointer either. nope. not touching it. if you allocated that struct yourself, that's still on you to handle. cdb_free is out here doing exactly one thing and refusing to do your chores for you. respect the boundaries fr fr 🙈

lowkey important: this thing does not do full teardown. it unmaps, that's it. fd and struct cdb cleanup are your responsibility, no cap.

✨ SEE ALSO ✨

• cdb_free(3) — yes, it's linking to itself. main character energy, honestly 👑
• cdb_read(3)
• cdb_find(3)
• cdbmake(1)

and that's the page!! it came out of the Library Functions Manual, the footer just says cdb_free(3) all over again because it loves a dramatic callback, and there's no date or version info to report, so we're just gonna vibe 🦋

stay mapped, stay hydrated, and remember to close your own file descriptors, babe 💜✨