Tspi_T...entLog(3)

💖 Tspi_TPM_GetEventLog 💖

okay bestie, gather round, because we're diving into the TCG Software Stack Developer's Reference and this one is a whole vibe. it's Tspi_T...entLog(3) if you're being all formal about it, but we're gonna be on a first-name basis 🫶

✨ NAME ✨

Tspi_TPM_GetEventLog — get the entire PCR event log. the WHOLE thing. no crumbs left behind 💅

🌸 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_GetEventLog(TSS_HTPM        hTPM, UINT32* pulEventNumber,
                                TSS_PCR_EVENT** prgPcrEvents);

like yes, that's a lot of includes, but that's just how the TSS rolls, periodt ✨

🦋 DESCRIPTION 🦋

Tspi_TPM_GetEventLog hands you the whole entire event log — the one that was used to create all of the PCRs. not a snippet, not a highlight reel, the full saga. it's giving archivist energy and we're obsessed 👑

🎀 PARAMETERS 🎀

hTPM

the handle of the TPM object. your lil entry pass to the TPM world 🔑

pulEventNumber

this one receives the number of returned event data structures that live inside the prgPcrEvents parameter. it's the count, bestie, it's how many we got 📊

prgPcrEvents

receives a pointer to an array of PCR event data. IMPORTANT: if it's NULL, then only the number of elements gets returned in the pulEventNumber parameter. so you can absolutely do a lil recon mission first, then come back for the goods 👀

⭐ RETURN CODES ⭐

Tspi_TPM_GetEventLog returns TSS_SUCCESS on success — slay — otherwise one of these lil guys shows up instead:

• TSS_E_INVALID_HANDLE — hTPM is not a valid handle to the TPM object. the vibe check failed 💀
• TSS_E_INTERNAL_ERROR — an error occurred internal to the TSS. not our fault, not your fault, it's just internal drama 😭

🌈 CONFORMING TO 🌈

Tspi_TPM_GetEventLog conforms to the Trusted Computing Group Software Specification version 1.1 Golden. golden!! like the name says. iconic behavior fr fr ✨

💜 SEE ALSO 💜

• Tspi_TPM_GetEvent(3)
• Tspi_TPM_GetEvents(3)

iykyk, go read those next, they're the sibling chapters of this saga 📚

and that's the whole page, bestie!! this lil doc came from TSS 1.1, dated 2004-05-26 — vintage but still hitting different. mwah, go forth and log those events 💋🎀