Go to file
Stefan Berger 017c810393 Use boostrap.sh to build rpm on Fedora machines
Use bootstrap.sh before running configure when building an rpm.
Reorder the tools in bootstrap.sh to avoid error messages.

Rename configure.in to configure.ac to quite down more recent autotools.

Signed-off-by: Stefan Berger <stefanb@linux.vnet.ibm.com>
Signed-off-by: Joel Schopp <jschopp@linux.vnet.ibm.com>
2014-01-21 14:21:36 -06:00
dist Use boostrap.sh to build rpm on Fedora machines 2014-01-21 14:21:36 -06:00
include Remove unnecessary build files from repository 2014-01-13 16:39:13 -05:00
man Remove unnecessary build files from repository 2014-01-13 16:39:13 -05:00
src Build dll on cygwin and build OpenSSL build cleanup 2014-01-13 16:41:06 -05:00
tests Remove unnecessary build files from repository 2014-01-13 16:39:13 -05:00
.gitignore Ignore patch files in gitignore 2014-01-13 20:49:32 -05:00
bootstrap.sh Use boostrap.sh to build rpm on Fedora machines 2014-01-21 14:21:36 -06:00
CHANGES Initial import of project 2013-10-31 15:33:22 -05:00
config.guess Initial import of project 2013-10-31 15:33:22 -05:00
config.h.in Make libtpms compileable with OpenSSL 2014-01-08 11:43:51 -05:00
config.sub Initial import of project 2013-10-31 15:33:22 -05:00
configure.ac Use boostrap.sh to build rpm on Fedora machines 2014-01-21 14:21:36 -06:00
CREDITS Add CREDITS file 2013-10-31 16:37:33 -04:00
depcomp Initial import of project 2013-10-31 15:33:22 -05:00
INSTALL Remove unnecessary build files from repository 2014-01-13 16:39:13 -05:00
install-sh Initial import of project 2013-10-31 15:33:22 -05:00
libtpms.pc.in Initial import of project 2013-10-31 15:33:22 -05:00
LICENSE Initial import of project 2013-10-31 15:33:22 -05:00
Makefile.am Use boostrap.sh to build rpm on Fedora machines 2014-01-21 14:21:36 -06:00
missing Initial import of project 2013-10-31 15:33:22 -05:00
README Maintainer change 2014-01-16 14:35:02 -05:00

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 Joel Schopp <jschopp@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