mirror of
https://github.com/stefanberger/libtpms
synced 2025-12-27 07:01:44 +00:00
a2b246e283
Signed-off-by: Corey Bryant <coreyb@linux.vnet.ibm.com> Acked-by: Stefan Berger <stefanb@linux.vnet.ibm.com>
87 lines
2.3 KiB
Plaintext
87 lines
2.3 KiB
Plaintext
What is libtpms?
|
|
----------------
|
|
|
|
Libtpms is a library that targets the integration of TPM functionality
|
|
into hypervisors, primarily into Qemu. Libtpms provides a very narrow
|
|
public API for this purpose so that integration is possible. Only the
|
|
minimum of necessary APIs are made publicly available.
|
|
|
|
It is assumed that the user of libtpms is familiar with the concepts
|
|
of the Trusted Platform Module (TPM). For the interaction with libtpms
|
|
it is necessary to know how to construct valid TPM commands and to
|
|
be able to parse their results. It is not within the scope of libtpms's
|
|
documentation to provide background on this. See the section on references
|
|
below.
|
|
|
|
|
|
What files does the libtpms package provide?
|
|
--------------------------------------------
|
|
|
|
The main libtpms package provides the following files:
|
|
|
|
/usr/lib64/libtpms.so.0
|
|
/usr/lib64/libtpms.so.0.5.1
|
|
/usr/share/doc/libtpms-0.5.1
|
|
/usr/share/doc/libtpms-0.5.1/CHANGES
|
|
/usr/share/doc/libtpms-0.5.1/LICENSE
|
|
/usr/share/doc/libtpms-0.5.1/README
|
|
|
|
Applications can link with -ltpms.
|
|
|
|
|
|
What files does the libtpms development package provide?
|
|
--------------------------------------------------------
|
|
|
|
The libtpms development package (libtpms-devel) provides the following
|
|
include files for applications to use:
|
|
|
|
tpm_error.h
|
|
tpm_library.h
|
|
tpm_memory.h
|
|
tpm_nvfilename.h
|
|
tpm_tis.h
|
|
tpm_types.h
|
|
|
|
These files contain the data structures, data types and API calls supported
|
|
by libtpms. It is recommended to not use any other API calls than those
|
|
provided in these include files.
|
|
|
|
All APIs are described in man pages. The man pages are part of the libtpms
|
|
development package as well:
|
|
|
|
TPMLIB_DecodeBlob
|
|
TPMLIB_GetTPMProperty
|
|
TPMLIB_GetVersion
|
|
TPMLIB_MainInit
|
|
TPMLIB_Process
|
|
TPMLIB_RegisterCallbacks
|
|
TPMLIB_Terminate
|
|
TPMLIB_VolatileAll_Store
|
|
TPM_Free
|
|
TPM_IO_Hash_Data
|
|
TPM_IO_Hash_End
|
|
TPM_IO_Hash_Start
|
|
TPM_IO_TpmEstablished_Get
|
|
TPM_Malloc
|
|
TPM_Realloc
|
|
|
|
|
|
How to contribute?
|
|
------------------
|
|
The mailing list for libtpms is libtpms@googlegroups.com.
|
|
|
|
|
|
Maintainers
|
|
-----------
|
|
libtpms is currently being maintained by Stefan Berger <stefanb@us.ibm.com>
|
|
and Corey Bryant <coreyb@linux.vnet.ibm.com>.
|
|
|
|
|
|
References:
|
|
-----------
|
|
|
|
Documentation about the Trusted Platform Module (TPM) can be downloaded
|
|
from the Trusted Computing Group's website at
|
|
|
|
http://www.trustedcomputinggroup.org
|