commit | 7a10ee307ffa87d01c678822ffbe9cca536c37f6 | [log] [tgz] |
---|---|---|
author | Philip Tricca <philip.b.tricca@intel.com> | Tue Mar 06 12:48:39 2018 -0800 |
committer | Philip Tricca <philip.b.tricca@intel.com> | Tue Mar 06 18:51:50 2018 -0800 |
tree | 80375ec7cc6b7d5cae5c91bcce7778f282073c7b | |
parent | fa14abe9e9d84b64a93d148c8ee3ca06ed406bb2 [diff] |
tcti: Get rid of unnecessary 4k buffer in TCTI header. The device TCTI was being lazy and wasn't implementing some features that the receive function should have. All of this resulted in a completely unnecessary 4k buffer being allocated as part of every TCTI context. In order to support a feature that allows a caller to discover the size of the response before allocating the response buffer we had to fix this. The receive algorithm in the device TCTI now reads the response header first to get the size of the response. If the caller hasn't supplied a resposne buffer we just return them the size in the supplied parameter. If they have supplied a response buffer and it's large enough to hold the response we grab the rest of the response and put it directly into the caller supplied buffer. As part of getting this 4k back we had to do some refactoring as well to get the header parsing function into a module not specific to the socket TCTI code. This commit also adds a unit test for the new feature of the receive function. Signed-off-by: Philip Tricca <philip.b.tricca@intel.com>
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:
Instructions to build and install tpm2-tss are available in the INSTALL file.
If you're looking to discuss the source code in this project or get some questions answered you should join the 01org TPM2 mailing list: https://lists.01.org/mailman/listinfo/tpm2. We've also got an IRC channel set up on FreeNode called #tpm2.0-tss.
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 and 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.
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, port 2321.
Issues building or running the simulator should be reported to the IBM software TPM2 project.
NOTE: The Intel TCG TSS is currently tested against the 974 version of the simulator. Compatibility with later versions has not yet been tested.
To test the various TCTI, SAPI and ESAPI api calls, unit and integraion 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 --with-simulatorbin=$HOME/ibmtpm/src/tpm_server $ 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 uint tests, and --with-simulatorbin controls the integration test.
SAPI library, TAB/RM, and Test Code Block Diagram:
├── common : utility functions used by multiple components
├── doc : various bits of documentation
├── esapi : system API implementation
│ ├── esapi : enhanced system API implementation
│ └── esapi_util : utility functions used by ESAPI implementation
├── include : header files unstalled in $(includedir)
│ ├── esapi : header file for ESAPI library
│ ├── sapi : header files for TPM2 types and core libraries
│ └── tcti : header files for TCTI libraries
├── lib : data files used by the build or installed into $(libdir)
├── log : logging functions
├── m4 : autoconf support macros
├── man : man pages
├── marshal : TPM2 type marshalling library implementation
├── script : scripts used by the build or CI
├── sysapi : system API implementation
│ ├── include : headers internal to the SAPI
│ ├── sysapi : system API implementation
│ └── sysapi_util : utility functions used by system API implementation
├── tcti : TCTI implementation
└── test : test code
├── integration : integration test harness and test cases
├── tpmclient : monolithic, legacy test application
└── unit : unit tests