Tspi_TPM_ClearOwner(3)

💖 Tspi_TPM_ClearOwner 💖

okay bestie, welcome to section 3 of the Library Functions Manual — this one's straight out of the TCG Software Stack Developer's Reference, and it's a banger ✨

🌸 NAME 🌸

Tspi_TPM_ClearOwner — clear TPM ownership 🧹💅

✨ SYNOPSIS ✨

#include <tss/platform.h>
#include <tss/tcpa_defines.h>
#include <tss/tcpa_typedef.h>
#include <tss/tcpa_struct.h>
#include <tss/tss_typedef.h>
#include <tss/tss_structs.h>
#include <tss/tspi.h>

TSS_RESULT Tspi_TPM_ClearOwner(TSS_HTPM hTPM, TSS_BOOL fForcedClear);

🦋 DESCRIPTION 🦋

so Tspi_TPM_ClearOwner wipes the TPM of everything but its endorsement key. literally everything else? gone. 🫶

and bestie, it will wipe the SRK — which means anything locked to the SRK also disappears the moment this command runs. no take-backs, no receipts, no "wait can I get that back". 😭

the way this is the only way to be certain that keys are gone, because it's the only way to guarantee that nothing can keep a copy of the key. that's the whole point, that's the assignment. 👑

and to even use this command you must assert either physical presence or owner authorization. you don't just get to do this, you have to prove it's you. 💅

🎀 PARAMETERS 🎀

hTPM

the hTPM parameter specifies the handle of the TPM object. it's giving "which TPM are we talking to" energy. 🌈

fForcedClear

the fForcedClear parameter tells you whether this command is being executed with owner authorization or with physical presence:

• if FALSE → TPM owner authorization is used ✨
• if TRUE → physical presence is required to clear the TPM 🫡

💀 RETURN CODES 💀

Tspi_TPM_ClearOwner returns TSS_SUCCESS on success 🎉 — otherwise, one of these lil guys comes back at you:

• TSS_E_INVALID_HANDLE — hTPM is not a valid handle 🙈
• TSS_E_INTERNAL_ERROR — an internal SW error has been detected 💀

👑 CONFORMING TO 👑

Tspi_TPM_ClearOwner conforms to the Trusted Computing Group Software Specification version 1.1 Golden. periodt. 💜

🌈 SEE ALSO 🌈

• Tspi_TPM_TakeOwnership(3)

okay that's the whole page bestie, you ate 🍓 no cap. this iconic lil number is from TSS 1.1, dated 2004-05-25 — yeah she's vintage and she's still main character energy. byeee 💖✨🎀🦋