TDB_STORE(3)

💖 TDB_STORE — okay bestie, let's file this away 💖

This is the tdb_store(3) page, straight out of the Linux Programmer's Manual 🌸 and she is so ready to teach you how to stash a record in a tdb database. No cap. Let's go. ✨

---

🎀 NAME 🎀

tdb_store — store a record in a tdb database. That's it, that's the whole job, and she does it flawlessly. 💅

---

✨ SYNOPSIS ✨

#include <tdb.h>

int tdb_store(TDB_CONTEXT *tdb, TDB_DATA key, TDB_DATA record, int flag);

Yes queen, four arguments, one function, zero drama. 🫶

---

🌈 DESCRIPTION 🌈

So the vibe is this: you've got a lump of data, and it's pointed to by record, and you want it living inside the tdb database under the index pointed to by key. That's the whole plot. 🦋

And the TDB_DATA structure — the one that both key and record are made of — is literally defined as:

typedef struct {
     char *dptr;
     size_t dsize;
} TDB_DATA;

A pointer and a size. Minimal. Iconic. She ate. 👑

Now here's the part you actually need to pay attention to, bestie: that flag argument? It's the whole personality of the call. It changes how tdb_store behaves, and it can be any one of these three values. Pick carefully, fr fr. 🍓

• TDB_REPLACE — insert a record, creating a new one or overwriting an existing one. She's flexible like that. Whatever's already there? Gone. Replaced. Slay. 💖
• TDB_INSERT — insert a new entry, but she refuses to overwrite an existing entry. New only. No touchy the old stuff. 🙈
• TDB_MODIFY — replace an existing record with a new one. And this one will fail if a record does not already exist. So like, she needs something to modify. Don't come to her empty-handed. 💀

---

⭐ RETURN VALUE ⭐

Super simple, super clean:

• 0 means success. 🎉
• -1 means failure. 😭

That's it. Binary. No in-between. Main character energy only. 👑

---

💜 AUTHORS 💜

Give credit where credit is due, always:

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

Legends, honestly. We thank them for their service. 🫶

---

🌸 SEE ALSO 🌸

• gdbm(3)
• tdb(3)

Go read those too, bestie, knowledge is free and it's giving ✨

---

And that's the whole page!! This one came from Samba, dated Aug 16, 2000 — so like, vintage, but the girlies still run it. 💖 Byeee, go store something responsibly!! 🎀🌈💅