tpm_sealdata(3)

💖 tpm_sealdata(3) — Library Functions Manual 💖

okay bestie, welcome to the TPM Management corner of the library. we're doing tpmUnsealFile, tpmUnsealShred, and tpmUnsealStrerror today and honestly? these three carry the whole unseal arc. 🫶

---

✨ NAME ✨

tpmUnsealFile, tpmUnsealShred, tpmUnsealStrerror — unseal routines

like. the unseal girlies. that's the name. periodt. 💅

---

🎀 SYNOPSIS 🎀

#include <tpm_unseal/tpm_unseal.h>

int tpmUnsealFile(char* file, char** data, int* size);
void tpmUnsealShred(char* data, int size);
char* tpmUnsealStrerror(int rc);

look at those signatures. so clean. so iconic. ✨

---

🦋 DESCRIPTION 🦋

so the whole tpmUnseal family exists for one reason and one reason only: getting you access to a piece of sensitive data that's been sealed to the TPM configuration of a given system. and it only lets you in if the conditions are right, which means:

• the SRK has not changed, and
• the PCRs (if any) that were specified at seal time are of the appropriate value.

that's it. that's the vibe check. no right conditions, no data. 💀

---

🍓 tpmUnsealFile 🍓

this one returns the contents of the file, unsealed, into the data buffer.

⚠️ bestie listen to me. the memory at *data must be freed by the caller. that's on you. not the library. you. don't make it weird. 😭

---

🧚 tpmUnsealShred 🧚

this one zeroes and frees the memory for you. it's giving responsible. it's giving cleanup crew. it's giving "i got you, bestie." 💖

---

🌸 tpmUnsealStrerror 🌸

this one takes the return code from tpmUnsealFile and converts it into a human comprehensible string, using an internal errno variable. so instead of staring at a sad little negative number like 👁️👄👁️ you get actual words. slay.

---

👑 Return Value 👑

• tpmUnsealFile — returns 0 on success and a negative number on error. 🫠
• tpmUnsealStrerror — returns the error string on success, and the empty string on an error. yes, the error function can error. iconic behaviour honestly. 💀

---

🌈 SEE ALSO 🌈

• tpm_sealdata(1) — the origin story. go read it. iykyk. 🎀

---

💜 REPORTING BUGS 💜

found a bug? don't sit on it, bestie, report it to:

<trousers-users@lists.sourceforge.net>

they're lovely. they'll help. fr fr. 🫶

---

and that's the whole page!! TPM Management, dated 2005-08-10 — yes she's an elder but she ate and left no crumbs. go unseal something responsibly, and remember: free your memory. literally. 💅✨👑