TDB(3)

💖 TDB — the trivial database, bestie 💖

okay so this is the tdb manual page, from the Linux Programmer's Manual (section 3, library calls, iykyk 🫶).

---

✨ NAME ✨

tdb — the trivial database 🎀 like literally that's the name, it's not being shady, it's just honest

---

🌸 SYNOPSIS 🌸

A database that's similar to gdbm but — and this is the whole glow-up — it allows multiple simultaneous writers. 💅

---

🦋 DESCRIPTION 🦋

So this is a simple database API, no cap. 🍓

It was inspired by the realisation that in Samba there were like… several ad-hoc bits of code that were basically all just implementing small databases for sharing structures between parts of Samba. Which is fine, but it's giving copy-paste energy, bestie. 😭 And when the author was about to add another one, it hit: okay, a generic database module was clearly called for, to replace all the ad-hoc bits. Periodt. ✨

The interface was based on gdbm — based on, not is, okay, stay with me — because gdbm couldn't actually be used here. Why? Because we need to be able to have multiple writers to the databases at one time. 🫶 And gdbm said no. So tdb said yes. Main character energy fr fr. 👑

---

💜 AUTHORS 💜

• Software: Andrew Tridgell <tridge@linuxcare.com> and Luke Kenneth Casson Leighton
• Man page: Ben Woodard <ben@valinux.com>

Shoutout to the icons who built this and the icon who documented it. 🎀

---

🌈 SEE ALSO 🌈

The whole tdb cinematic universe, bestie — go read these next, they're all linked up:

• gdbm(3)
• tdb_open(3)
• tdb_close(3)
• tdb_delete(3)
• tdb_error(3)
• tdb_exists(3)
• tdb_fetch(3)
• tdb_firstkey(3)
• tdb_store(3)
• tdb_traverse(3)
• tdb_lockall(3)
• tdb_lockkeys(3)
• tdb_chainlock(3)

---

🫶 This one came out of Samba, dated Aug 16, 2000 — yes it's a whole adult now, and it's still slaying. Mwah. 💋 ✨🎀🦋🌸💅