TPMLIB_GetInfo(3) TPMLIB_GetInfo(3)

TPMLIB_GetInfo - Get Information about the TPM implementation

TPM library (libtpms, -ltpms)

#include <libtpms/tpm_library.h>

char *TPMLIB_GetInfo(TPMLIB_InfoFlags flags);

The TPMLIB_GetInfo() function allows a user to query for TPM implementation specifics and get a JSON string in return. Which data is to be returned can be specified in the flags parameter that may be a logical 'or' concatenation of flags. If passed flags are not supported, nothing is returned . If a 0 is passed in, an empty JSON Object '{}' is returned.

The following flags are defined and return JSON objects as shown:

{"TPMSpecification":{"family":"1.2","level":2,"revision":116}}
{"TPMAttributes":{"manufacturer":"id:00001014", "version":"id:00740001","model":"swtpm"}}
{"TPMFeatures":{"RSAKeySizes":[1024,2048,3072]}}

This JSON object may be extended in the future.

This function returns a JSON string on success and a NULL pointer if a memory allocation failure occurred.

The caller must free() the returned string.

2024-03-31 libtpms