Tspi_K...ateKey(3)

✨ NAME ✨

okay so this is the Tspi_Key_CreateKey page from the TCG Software Stack Developer's Reference (that's the Tspi_K...ateKey(3) one, bestie, the name got squished in the header but it's her 💅) —

Tspi_Key_CreateKey — makes a key pair inside the TPM, and wraps it with the key that hWrappingKey points at 🎀

🌸 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_Key_CreateKey(TSS_HKEY hKey, TSS_HKEY hWrappingKey, TSS_HPCRS hPcrComposite);

💖 DESCRIPTION 💖

So TSS_Key_CreateKey literally calls the TPM command TPM_CreateWrapKey. That's the whole vibe. 🦋

And here's the tea: if hPcrComposite is not set to NULL, the key blob she creates gets bound to those PCR values. No cap.

Also, the key object that hKey addresses? She has to already contain the key info needed for the creation. Like, she can't cook without ingredients, periodt. 👑

🎀 PARAMETERS 🎀

hKey

The handle of the key object you wanna create. 🫶

hWrappingKey

The handle to the key that's gonna wrap the brand-new baby key. 🌯✨

hPcrComposite

The handle to an object — and if the value of that handle doesn't equal NULL, the newly created key gets bound to the PCR values described by this object. 👀

🔥 RETURN CODES 🔥

Tspi_Key_CreateKey returns TSS_SUCCESS when everything slays, otherwise one of these comes back at you:

• TSS_E_INVALID_HANDLE — either hKey, hWrappingKey or hPcrComposite are invalid parameters. 😭
• TSS_E_INTERNAL_ERROR — an error occurred internal to the TSS. 💀

👑 CONFORMING TO 👑

Tspi_Key_CreateKey conforms to the Trusted Computing Group Software Specification version 1.1 Golden. iconic behavior, honestly ⭐

🌈 SEE ALSO 🌈

• Tspi_Key_WrapKey(3)
• Tspi_Key_CertifyKey(3)
• Tspi_Key_RegisterKey(3)

and that's the whole page, bestie 💜 this one came out of TSS 1.1 and it's dated 2004-05-26 — she's vintage, she's a legend, she ate and left no crumbs 🧚🍓