fwupd/plugins/tpm
2023-02-06 10:24:03 +00:00
..
fuzzing Merge tpm-eventlog into the tpm plugin 2021-11-02 13:47:25 +00:00
tests Add HSI check that PCR registers 0-7 are not empty 2021-11-17 16:21:52 +00:00
fu-self-test.c Build many more plugins as builtin 2022-09-28 17:01:23 +01:00
fu-tpm-device.c trivial: Fix a tiny coverity-spotted memory leak on error 2023-02-06 10:24:03 +00:00
fu-tpm-device.h Move the TPM handling into the TPM place 2021-11-01 14:51:27 +00:00
fu-tpm-eventlog-common.c tpm: Add support for sha384 2022-12-17 08:18:48 -06:00
fu-tpm-eventlog-common.h tpm: Add support for sha384 2022-12-17 08:18:48 -06:00
fu-tpm-eventlog-parser.c tpm: Add support for sha384 2022-12-17 08:18:48 -06:00
fu-tpm-eventlog-parser.h Merge tpm-eventlog into the tpm plugin 2021-11-02 13:47:25 +00:00
fu-tpm-eventlog.c Split out the string helpers to a new source file 2022-06-14 14:36:52 -05:00
fu-tpm-plugin.c tpm: don't require event log to have all reconstructions 2022-12-17 13:00:51 -06:00
fu-tpm-plugin.h Build many more plugins as builtin 2022-09-28 17:01:23 +01:00
fu-tpm-v1-device.c Remove duplicate ->probe() calls to speed up startup by 150ms 2022-06-14 21:01:57 +01:00
fu-tpm-v1-device.h Move the TPM handling into the TPM place 2021-11-01 14:51:27 +00:00
fu-tpm-v2-device.c trivial: Add new convenience API to make plugins simpler 2022-12-20 20:54:12 +00:00
fu-tpm-v2-device.h Move the TPM handling into the TPM place 2021-11-01 14:51:27 +00:00
meson.build trivial: Enable all the builtin plugins 2022-09-30 12:30:11 +01:00
README.md Include the plugin README text in the generated docs 2023-01-10 14:58:30 +00:00
tpm.quirk Simplify the quirk file format 2021-03-03 08:30:34 +00:00

title: Plugin: TPM

Introduction

This allows enumerating Trusted Platform Modules, also known as "TPM" devices, although it does not allow the user to update the firmware on them.

The TPM Event Log records which events are registered for the PCR0 hash, which may help in explaining why PCR0 values are differing for some firmware.

The device exposed is not upgradable in any way and is just for debugging. The created device will be a child device of the system TPM device, which may or may not be upgradable.

GUID Generation

These devices use custom GUIDs:

  • TPM\VEN_$(manufacturer)&DEV_$(type)
  • TPM\VEN_$(manufacturer)&MOD_$(vendor-string)
  • TPM\VEN_$(manufacturer)&DEV_$(type)_VER_$(family),
  • TPM\VEN_$(manufacturer)&MOD_$(vendor-string)_VER_$(family)

...where family is either 2.0 or 1.2

Example GUIDs from a real system containing a TPM from Intel:

  Guid:                 34801700-3a50-5b05-820c-fe14580e4c2d <- TPM\VEN_INTC&DEV_0000
  Guid:                 03f304f4-223e-54f4-b2c1-c3cf3b5817c6 <- TPM\VEN_INTC&DEV_0000&VER_2.0

Vendor ID Security

The device is not upgradable and thus requires no vendor ID set.

External Interface Access

This plugin uses the tpm2-tss library to access the TPM. It requires access to /sys/class/tpm and optionally requires read only access to /sys/kernel/security/tpm0/binary_bios_measurements.