Tspi_TPM_StirRandom(3)

💖 Tspi_TPM_StirRandom(3) 💖

ok so bestie, this one is a page from the Library Functions Manual for Tspi_TPM_StirRandom — and yes it's giving ✨TCG Software Stack Developer's Reference✨ energy, we love a glow-up. grab a strawberry drink and let's get into it 🍓

🌸 NAME 🌸

Tspi_TPM_StirRandom — literally just add entropy to the TPM random number generator 🎲✨

🦋 SYNOPSIS 🦋

ok so first you gotta include all the headers, no skipping, they're the whole fit 💅

#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_StirRandom(TSS_HTPM hTPM, UINT32 ulEntropyDataLength, BYTE* rgbEntropyData);

👑 DESCRIPTION 👑

so the way that Tspi_TPM_StirRandom works is: it adds entropy to the TPM random number generator 💫, and the whole point of that is generating better random numbers. like, you're feeding the TPM a little snack so its randomness is more random. iconic behaviour, honestly 🌈

⚠️ important note bestie: the entropy variable should be assigned an appropriately seeded random number before this function is called. don't come in empty-handed, the TPM can tell 🙈

🎀 PARAMETERS 🎀

🌟 hTPM

hTPM is the param that specifies the handle of the TPM object. and get this — the command to get the TPM to test itself will be sent here. yes, really, that's what it says, I'm not making it up 🫶

🌟 ulEntropyDataLength

ulEntropyDataLength is the length in bytes of the rgbEntropyData parameter. so it's the little size tag for your entropy blob 📏

🌟 rgbEntropyData

rgbEntropyData is a pointer to the entropy data. that's it, that's the whole vibe, it's just pointing at your entropy ✨

💀 RETURN CODES 💀

Tspi_TPM_StirRandom returns TSS_SUCCESS on success 🎉 — otherwise one of these little gremlins shows up:

• TSS_E_INVALID_HANDLE — hTPM is not a valid handle 😭
• TSS_E_INTERNAL_ERROR — an internal SW error has been detected 💥
• TSS_E_BAD_PARAMETER — one or more parameters is bad 🙃

🧚 CONFORMING TO 🧚

Tspi_TPM_StirRandom conforms to the Trusted Computing Group Software Specification version 1.1 Golden 👑 periodt.

🫶 SEE ALSO 🫶

• Tspi_TPM_GetRandom(3).

so yeah, that's the whole page, no notes, slay 💅✨

TSS 1.1 · 2004-05-25 — this page has been serving since 2004-05-25, and it's still in the TSS 1.1 era, so it's vintage bestie 🎀 iykyk, drink water, stir your entropy, bye 💖🦋🌸