1TPMLIB_ValidateState(3) TPMLIB_ValidateState(3)
2
3
4
6 TPMLIB_ValidateState - Validate the state blobs of the TPM
7
9 TPM library (libtpms, -ltpms)
10
12 #include <libtpms/tpm_library.h>
13
14 uint32_t TPMLIB_ValidateState(TPMLIB_StateType st,
15 unsigned int flags);
16
18 The TPMLIB_ValidateState() function allows to validate the state blobs
19 that the TPM would read upon TPMLIB_MainInit() or once the TPM_Startup
20 command has been sent to it.
21
22 This function is useful for TPM state migration between possibly
23 different version of libtpms. Here the target libtpms needs to be able
24 to determine whether it can support the version of blobs that were
25 migrated and if this is not the case, the caller can refuse the
26 migration.
27
28 The tpmlib_state parameter can be a logical 'or' of one or multiple of
29 of the following: TPMLIB_STATE_PERMANENT, TPMLIB_STATE_VOLATILE, or
30 TPMLIB_STATE_SAVE_STATE. The flags parameter is curretnly not used and
31 should be set to 0.
32
33 The first state blob that should be loaded is the permanent state,
34 since for example the volatile state requires it to be available for
35 validation.
36
37 This function should be called before TPMLIB_MainInit() is invoked.
38
40 TPMLIB_MainInit(3), TPMLIB_Terminate(3)
41
42
43
44libtpms 2021-06-01 TPMLIB_ValidateState(3)