1TPMLIB_ValidateState(3)                                TPMLIB_ValidateState(3)
2
3
4

NAME

6       TPMLIB_ValidateState  - Validate the state blobs of the TPM
7

LIBRARY

9       TPM library (libtpms, -ltpms)
10

SYNOPSIS

12       #include <libtpms/tpm_library.h>
13
14       uint32_t TPMLIB_ValidateState(TPMLIB_StateType st,
15                                     unsigned int flags);
16

DESCRIPTION

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 currently 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

SEE ALSO

40       TPMLIB_MainInit(3), TPMLIB_Terminate(3)
41
42
43
44libtpms                           2023-07-17           TPMLIB_ValidateState(3)
Impressum