C Other
Clone or download
JuergenReppSIT and tstruk SAPI: Fix marshaling in Tss2_Sys_ECC_Parameters.
The base type of TPMI_ECC_CURVE is UNIT16 not UINT32.

Signed-off-by: Juergen Repp <Juergen.Repp@sit.fraunhofer.de>
Latest commit 4ed7f26 Jul 16, 2018
Permalink
Failed to load latest commit information.
dist build: Install udev rule to set ownership and permissions for TPM cha… Apr 23, 2018
doc TEST ESYS: Doxygen documentation added to integration tests. Jul 16, 2018
include/tss2 ESYS: Fix esys header file. Jun 25, 2018
lib build: Add Visual Studio solution for ESAPI Jul 5, 2018
m4 build: Add macro to simplify tests for required programs. Jul 6, 2018
man tcti-mssim: Replace liburiparser with custom key/value pair parser. Apr 24, 2018
script build: Add checks for 'netstat' @ configure and integration test time. May 11, 2018
src SAPI: Fix marshaling in Tss2_Sys_ECC_Parameters. Jul 16, 2018
test TEST ESYS: Doxygen documentation added to integration tests. Jul 16, 2018
.appveyor.yml build: Use OpenSSL library for crypto backend to tss2-esys. Jul 16, 2018
.gitattributes Added .gitattributes so that line endings come out right Nov 2, 2015
.gitignore Doc: Fix doxygen Apr 10, 2018
.travis.yml ci: Exclude dependencies and tests when collecting code coverage data. Jul 10, 2018
CHANGELOG.md CHANGELOG.md: Fix spacing, separate added & removed sections. Jun 21, 2018
CONTRIBUTING.md Fix Spelling Errors in Root Directory Files Apr 6, 2018
Dockerfile Use ADD instead of wget Jun 13, 2018
Doxyfile.in TEST ESYS: Doxygen documentation added to integration tests. Jul 16, 2018
INSTALL.md INSTALL.md: Docker dont clean build Jun 25, 2018
LICENSE Convert to SPDX-License-Indentifiers Jun 12, 2018
MAINTAINERS MAINTAINERS: Add Andreas. Apr 27, 2018
Makefile-test.am build: Use ESYSLDFLAGS instead of -lgcrypt directly. Jul 13, 2018
Makefile.am ESYS: Crypto backend for usage of openssl's libcrypto added. Jul 5, 2018
README.md Revert "build: Remove use of coveralls" Jul 9, 2018
RELEASE.md Fix Spelling Errors in Root Directory Files Apr 6, 2018
bootstrap ESYS: Crypto backend for usage of openssl's libcrypto added. Jul 5, 2018
configure.ac build: Check for programs required by the test harness @ configure time. Jul 6, 2018
tpm2-tss.sln build: Add Visual Studio solution for ESAPI Jul 5, 2018

README.md

Linux Build Status Windows Build status Coverity Scan Coverage Status

Overview

This repository hosts source code implementing the Trusted Computing Group's (TCG) TPM2 Software Stack (TSS). This stack consists of the following layers from top to bottom:

  • Enhanced System API (ESAPI) as described in the TSS 2.0 Enhanced System API (ESAPI) Specification. This API is a 1-to-1 mapping of the TPM2 commands documented in Part 3 of the TPM2 specification. Additionally there are asynchronous versions of each command. In addition to SAPI, the ESAPI performs tracking of meta data for TPM object and automatic calculation of session based authorization and encryption values. Both the synchronous and asynchronous API are exposed through a single library: libtss2-esys.
  • System API (SAPI) as described in the system level API and TPM command transmission interface specification. This API is a 1-to-1 mapping of the TPM2 commands documented in Part 3 of the TPM2 specification. Additionally there are asynchronous versions of each command. These asynchronous variants may be useful for integration into event-driven programming environments. Both the synchronous and asynchronous API are exposed through a single library: libtss2-sys.
  • Marshaling/Unmarshaling (MU) as described in the TCG TSS 2.0 Marshaling/Unmarshaling API Specification. This API provides a set of marshaling and unmarshaling functions for all data types define by the TPM library specification. The Marshaling/Unmarshaling API is exposed through a library called libtss2-mu.
  • TPM Command Transmission Interface (TCTI) that is described in the same specification. This API provides a standard interface to transmit / receive TPM command / response buffers. It is expected that any number of libraries implementing the TCTI API will be implemented as a way to abstract various platform specific IPC mechanisms. Currently this repository provides two TCTI implementations: libtss2-tcti-device and libtss2-tcti-mssim. The former should be used for direct access to the TPM through the Linux kernel driver. The latter implements the protocol exposed by the Microsoft software TPM2 simulator.
  • The TCG TSS 2.0 Overview and Common Structures Specification forms the basis for all implementations in this project. NOTE: We deviate from this draft of the specification by increasing the value of TPM2_NUM_PCR_BANKS from 3 to 16 to ensure compatibility with TPM2 implementations that have enabled a lareger than typical number of PCR banks. This larger value for TPM2_NUM_PCR_BANKS is expected to be included in a future revision of the specification.

Build and Installation Instructions:

Instructions to build and install tpm2-tss are available in the INSTALL file.

Getting in Touch:

If you're looking to discuss the source code in this project or get some questions answered you should join the 01.org TPM2 mailing list: https://lists.01.org/mailman/listinfo/tpm2. We also have an IRC channel set up on FreeNode called #tpm2.0-tss.

Test Suite

This repository contains a test suite intended to exercise the TCTI, SAPI and ESAPI code. This test suite is not intended to test a TPM implementation, so this test suite should only be run against a TPM simulator. If this test suite is executed against a TPM other than the software simulator it may cause damage to the TPM (NV storage wear out, etc.). You have been warned.

Simulator

The TPM library specification contains reference code sufficient to construct a software TPM 2.0 simulator. This code was provided by Microsoft and they provide a binary download for Windows here. IBM has repackaged this code with a few Makefiles so that the Microsoft code can be built and run on Linux systems. The Linux version of the Microsoft TPM 2.0 simulator can be obtained here. Once you've downloaded and successfully built and execute the simulator it will, by default, be accepting connections on the localhost, TCP ports 2321 and 2322.

Issues building or running the simulator should be reported to the IBM software TPM2 project.

NOTE: The Intel TCG TSS is currently tested against version 974 of the simulator. Compatibility with later versions has not yet been tested.

Testing

To test the various TCTI, SAPI and ESAPI api calls, unit and integration tests can be run by configuring the build to enable unit testing and running the "check" build target. It is recommended to use a simulator for testing, and the simulator will be automatically launched by the tests. Please review the dependency list in INSTALL for dependencies when building the test suite.

$ ./configure --enable-unit --enable-integration
$ make -j$(nproc) check

This will generate a file called "test-suite.log" in the root of the build directory.

Please report failures in a Github 'issue' with a full log of the test run.

NOTE: The unit and integration tests can be enabled independently. The --enable-unit option controls unit tests, and --enable-integration controls the integration tests.

Architecture/Block Diagram

SAPI library, TAB/RM, and Test Code Block Diagram: Architecture Block Diagram

Project Layout

├── doc : various bits of documentation
├── include : header files installed in $(includedir)
│ └── tss2 : all public headers for this project
├── lib : data files used by the build or installed into $(libdir)
├── m4 : autoconf support macros
├── man : man pages
├── script : scripts used by the build or CI
├── src : all source files
│ ├── tss2-esys : enhanced system API (ESAPI) implementation
│ │   └── api : ESAPI TPM API implementation
│ ├── tss2-mu : TPM2 type marshaling/unmarshaling (MU) API implementation
│ ├── tss2-sys : system API (SAPI) implementation
│ │   └── api : SAPI public API implementation
│ ├── tss2-tcti : TCTI implementations for device and mssim
│ └── util : Internal utility library (e.g. logging framework)
└── test : test code
   ├── integration : integration test harness and test cases
   ├── tpmclient : monolithic, legacy test application
   └── unit : unit tests