todo(3)

✨ todo(3) ✨

okay bestie, welcome to todo(3) — this one lives in the Library Functions Manual, so it's not a command you run, it's a page about some library stuff. And ngl, the tea here is that basically nothing is implemented yet. it's giving "placeholder era". 💅

---

🎀 NAME 🎀

todo — Todo List

like... that's it. that's the name. a whole "to do list". iconic honestly. ✨

---

🌸 the globals 🌸

two global things show up on this page, and bestie, please sit down for this:

• MDB_rel_func — MDB_val *item, void *oldptr, void *newptr, void *relctx

This feature is currently unimplemented.

🫠 yeah. that's the whole thing. it exists, it's declared, it does nothing. no cap.

• mdb_set_relfunc — MDB_txn *txn, MDB_dbi dbi, MDB_rel_func *rel

so here's what this function is supposed to do, per the lore: the relocation function is called whenever it is necessary to move the data of an item to a different position in the database (e.g. through tree balancing operations, shifts as a result of adds or deletes, etc.).

and why would anyone want that? because it's intended to allow address/position-dependent data items to be stored in a database in an environment opened with the MDB_FIXEDMAP option. very "data that cares where it lives" energy. 💖

⚠️ BUT bestie listen — currently the relocation feature is unimplemented and setting this function has no effect. like, you can call it. it'll just smile and nod and do absolutely nothing. 😭

---

that's genuinely the whole page, i'm not hiding anything from you. the vibe check says: unimplemented, but documented with love. 🌈

🦋 okay bye bestie, this was todo(3) from the LMDB girlies, dropping straight out of that Library Functions Manual. take care of yourself, hydrate, and don't rely on relocation functions that don't relocate. 💜🎀