| ============== |
| TPM2-SIMULATOR |
| ============== |
| |
| This project is the front end for a software TPM 2.0. It exposes libtpm2 |
| (src/third_party/tpm2) as two file descriptors to accept commands from a client. |
| |
| The main loop waits for requests on /dev/tpm-req, and writes responses to |
| /dev/tpm-resp. All reads and writes are synchronous. A client should read and |
| write to these file descriptors with the read() and write() syscalls. Multiple |
| clients using the simulator simultaneously is undefined behavior. The main loop |
| only exits when it receives an erroneous command. |
| |
| Execute 'tpm2-simulator' as root to inialize the software TPM and wait for |
| commands. |
| |
| An example of how a client can use 'tpm2-simulator' is in /src/platform2/trunks. |
| See trunks::TpmSimulatorHandle. To use trunks with the software TPM, start the |
| trunks daemon as root with the --simulator flag. |
| |
| ---- Notes ---- |
| * Because third_party/tpm2 builds a static library, if a change is made to any |
| file in /src/third_party/tpm2, /src/platform2/tpm2-simulator must be forcibly |
| rebuilt to refect this change. |
| |
| * If the simulator ever goes into lockout, failure, or other erroneous mode, |
| remove NVChip. |
