TPMLIB_ChooseTPMVersion(3)

📦
version 0.10.2 · 16 versions
, in alpine 3.24, arch rolling

💅 TPMLIB_ChooseTPMVersion(3) — like, the whole manual page, bestie

okay so this is a page from the libtpms manual, and honestly? it's giving "small function, big responsibilities." let's get into it 🎀

✨ NAME ✨

TPMLIB_ChooseTPMVersion — the function where you, the main character, pick which version of the TPM you want. that's it. that's the whole job. 👑

🦋 SYNOPSIS 🦋

#include <libtpms/tpm_types.h>

#include <libtpms/tpm_library.h>

TPM_RESULT TPMLIB_ChooseTPMVersion(TPMLIB_TPMVersion ver);

 typedef enum TPMLIB_TPMVersion {
    TPMLIB_TPM_VERSION_1_2,
    TPMLIB_TPM_VERSION_2,
 } TPMLIB_TPMVersion;

like yes, you gotta include both headers, no shortcuts, we don't do that here 💅

🌸 DESCRIPTION 🌸

so TPMLIB_ChooseTPMVersion() is literally the "pick your fighter" screen for the TPM — you're choosing whether you want a TPM 1.2 or a TPM 2. that's the vibe check. 🎮

timing matters, bestie. you must call this function before TPMLIB_MainInit() gets called — do it after and it will return an error, no cap. 😭 that's the rule and we respect it.

the good news? you can call it again later — but only once TPMLIB_Terminate() has been called. so like... terminate first, then re-choose. order is everything fr fr 🫶

now for the ✨ default behaviour ✨ (iykyk, defaults are sneaky):

  • if you don't call this function at all, then whatever TPM version was chosen last is the one that gets started with TPMLIB_MainInit().
  • and if this function is not called... a TPM 1.2 will be used.

so yeah, silence = TPM 1.2. iconic of it, honestly. 🙈

💀 ERRORS 💀

  • TPM_SUCCESS — slay! ✨ the version of the TPM was chosen successfully. everything worked, we love to see it. 💖
  • TPM_FAIL — oop. 💀 either the choice of the TPM was wrong, or TPMLIB_MainInit() has already been called (remember the timing rule? yeah, that one). 😭
wanna see the complete list of TPM error codes? go look at the include file libtpms/tpm_error.h — it's all there, i promise. 📖

🌈 SEE ALSO 🌈

and that's the page!! 🦋 okay bye, go call your functions in the right order — mwah 💜

— brought to you by libtpms, dated 2026-01-02, and yeah that's the same TPMLIB_ChooseTPMVersion(3) you started with. full circle, periodt. 🎀

📦 where this page comes from