tld_free(9)

💅 tld_free(9) — like, the Kernel API Manual page for tld_free ✨

okay bestie, pull up a chair, because this one is short but it matters 🫶

---

🌸 NAME 🌸

tld_free — frees the task local data memory of the thread that's calling it, no cap 💖

---

✨ SYNOPSIS ✨

void tld_free (void );

that's it. that's the whole signature. she's simple, she's iconic 👑

---

🎀 ARGUMENTS 🎀

• void — literally no arguments. nothing. zero. the void is voiding 🙈

---

🦋 DESCRIPTION 🦋

so for the calling thread, every pointer to TLDs that you acquired before this call? yeah, after tld_free they all become invalid. gone. not your problem anymore 💀

like, users must call tld_free on thread exit to prevent a memory leak — that's not a suggestion, that's the vibe check you have to pass ⭐

alternatively, you can define TLD_FREE_DATA_ON_THREAD_EXIT and a thread exit handler gets registered to free the memory automatically for you. set it and forget it, main character energy fr fr 💅

⚠️ and now the warning, because we care: calling tld_free before thread exit is undefined behavior, which may lead to a null-pointer dereference. so like… don't 😭 that's the dangerous one. undefined behavior is not a cute look, bestie 🚨

---

🔥 SEE ALSO 🔥

• Kernel file ./tools/testing/selftests/bpf/prog_tests/task_local_data.h
• TLD_DEFINE_KEY(9)
• tld_create_key(9)
• tld_get_data(9)

all the siblings, go read them too 🧚💜

---

and that's the page!! mwah 💋 this one comes from ./tools/testing/selftests/bpf/... and it's dated October 2026 — so yeah, she's from the future, we stan a time-traveling manpage 🌈👑