Djam/u-boot
1
0
Fork 0
mirror of https://github.com/u-boot/u-boot.git synced 2025-04-26 07:17:10 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions

tpm: update descriptions in tpm headers

Browse source 
* Provide a link to 'TPM 2.0 Library Specification'
* Remove outdated comment for TPM2_NUM_PCR_BANKS.
  The value 16 can be found in the current standard
  TCG TSS 2.0 Overview and Common Structures Specification 1.0, rev 10
* Describe some of the structures in Sphinx style.

Signed-off-by: Heinrich Schuchardt <heinrich.schuchardt@canonical.com>
Reviewed-by: Ilias Apalodimas <ilias.apalodimas@linaro.org>
Reviewed-by: Miquel Raynal <miquel.raynal@bootlin.com>
Signed-off-by: Ilias Apalodimas <ilias.apalodimas@linaro.org>
This commit is contained in:
Heinrich Schuchardt 2024-12-27 14:25:41 +02:00 • committed by Tom Rini
parent 3a054eca73
commit e587b6a844
2 changed files with 35 additions and 9 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

10
include/tpm-common.h
View file

@ -42,12 +42,10 @@ enum tpm_version {
TPM_V2, TPM_V2,
}; };
/* /**
* We deviate from this draft of the specification by increasing the value of * define TPM2_NUM_PCR_BANKS - number of PCR banks
* TPM2_NUM_PCR_BANKS from 3 to 16 to ensure compatibility with TPM2 * The value 16 can be found in the current standard
* implementations that have enabled a larger than typical number of PCR * TCG TSS 2.0 Overview and Common Structures Specification 1.0, rev 10
* banks. This larger value for TPM2_NUM_PCR_BANKS is expected to be included
* in a future revision of the specification.
*/ */
#define TPM2_NUM_PCR_BANKS 16 #define TPM2_NUM_PCR_BANKS 16

34
include/tpm-v2.h
View file

@ -6,6 +6,11 @@
* Copyright (c) 2020 Linaro * Copyright (c) 2020 Linaro
* Copyright (c) 2018 Bootlin * Copyright (c) 2018 Bootlin
* *
* The structures are described in
* Trusted Platform Module Library Part 2: Structures
* http://tcg.tjn.chef.causewaynow.com/resource/tpm-library-specification/
*
* C header files are listed in
* https://trustedcomputinggroup.org/resource/tss-overview-common-structures-specification/ * https://trustedcomputinggroup.org/resource/tss-overview-common-structures-specification/
* *
* Author: Miquel Raynal <miquel.raynal@bootlin.com> * Author: Miquel Raynal <miquel.raynal@bootlin.com>
@ -45,20 +50,43 @@ struct udevice;
#define TPM2_PT_MAX_COMMAND_SIZE (u32)(TPM2_PT_FIXED + 30) #define TPM2_PT_MAX_COMMAND_SIZE (u32)(TPM2_PT_FIXED + 30)
#define TPM2_PT_MAX_RESPONSE_SIZE (u32)(TPM2_PT_FIXED + 31) #define TPM2_PT_MAX_RESPONSE_SIZE (u32)(TPM2_PT_FIXED + 31)
/* TPMS_TAGGED_PROPERTY Structure */ /**
* struct tpms_tagged_property - TPMS_TAGGED_PROPERTY structure
*
* This structure is returned by TPM2_GetCapability() to report
* a u32 property value.
*
* @property: property identifier
* @value: value of the property
*/
struct tpms_tagged_property { struct tpms_tagged_property {
u32 property; u32 property;
u32 value; u32 value;
} __packed; } __packed;
/* TPMS_PCR_SELECTION Structure */ /**
* struct tpms_pcr_selection - TPMS_PCR_SELECTION structure
*
* This structure allows to specify a hash algorithm and a list of
* selected PCRs. A PCR is selected by setting the related bit in
* @pcr_select to 1.
*
* @hash: hash algorithm associated with the selection
* @size_of_select: size in bytes of the @pcr_select array
* @pcr_select: bit map of selected PCRs
*/
struct tpms_pcr_selection { struct tpms_pcr_selection {
u16 hash; u16 hash;
u8 size_of_select; u8 size_of_select;
u8 pcr_select[TPM2_PCR_SELECT_MAX]; u8 pcr_select[TPM2_PCR_SELECT_MAX];
} __packed; } __packed;
/* TPML_PCR_SELECTION Structure */ /**
* struct tpml_pcr_selection - TPML_PCR_SELECTION structure
*
* @count: number of selection structures, may be zero
* @selection: list of selections
*/
struct tpml_pcr_selection { struct tpml_pcr_selection {
u32 count; u32 count;
struct tpms_pcr_selection selection[TPM2_NUM_PCR_BANKS]; struct tpms_pcr_selection selection[TPM2_NUM_PCR_BANKS];