TDB_CHAINLOCK(3)

💖 tdb_chainlock — the manual page, but make it make sense 💖

okay bestie, welcome to tdb_chainlock(3), straight outta the Linux Programmer's Manual. this is the page about locking a whole lil group of keys at once, and honestly? it's giving power. 👑

---

✨ NAME ✨

tdb_chainlock — lock a group of keys

tdb_chainunlock — unlock a previously locked group of keys

---

🌸 SYNOPSIS 🌸

#include <tdb.h>

int tdb_chainlock(TDB_CONTEXT *tdb, TDB_DATA key);
void tdb_chainunlock(TDB_CONTEXT *tdb, TDB_DATA key);

like yes, that's the whole vibe check. two functions, one job. 🫶

---

💅 DESCRIPTION 💅

okay so tdb_chainlock is a low-level function, and when i say low-level i mean it is not here to hold your hand. it locks a particular key — and, plot twist, a number of other keys too — without any checking. no vibes check, no safety net, just lock. 🔒

the consequence? any other process that tries to do tdb operations on those keys is gonna block until tdb_chainunlock gets called. so it's just sitting there, waiting, like a bestie outside the fitting room. 🧍‍♀️

---

👀 NOTES 👀

⚠️ bestie, listen to me. it is the user's responsibility to make sure you do not deadlock the database with these functions. that's on you, not on tdb. no cap. 💀

and here's the wild part — that kind of deadlock is something which is impossible when you use the other access functions. so like… these two are the chaotic ones. the main character energy is real but so is the risk. 🌈

---

🎀 RETURN VALUE 🎀

• 0 — success, slay, we ate. ✨
• -1 — failure. it's giving tragedy. 😭

---

🦋 AUTHORS 🦋

• Software: Andrew Tridgell <tridge@linuxcare.com>
• Man page: Rusty.

---

⭐ SEE ALSO ⭐

• gdbm(3)
• tdb(3)
• tdb_lockall(3)

go read those too, iykyk. 👑

---

this page came to you courtesy of Samba, dated Oct 13, 2000 — yeah she's an icon from another era and she still serves. periodt. 💜