1 /* SPDX-License-Identifier: BSD-2-Clause */ 2 /***********************************************************************; 3 * Copyright (c) 2015 - 2018 Intel Corporation 4 * All rights reserved. 5 ***********************************************************************/ 6 7 #ifndef TSS2_TPMS_TYPES_H 8 #define TSS2_TPMS_TYPES_H 9 10 #include "tss2_common.h" 11 12 #ifndef TSS2_API_VERSION_1_2_1_108 13 #error Version mismatch among TSS2 header files. 14 #endif /* TSS2_API_VERSION_1_2_1_108 */ 15 16 #include <stdint.h> 17 18 #define TPM2_MAX_COMMAND_SIZE 4096 /* maximum size of a command */ 19 #define TPM2_MAX_RESPONSE_SIZE 4096 /* maximum size of a response */ 20 21 /* TPM constants for buffer sizes */ 22 #define TPM2_NUM_PCR_BANKS 16 23 #define TPM2_MAX_DIGEST_BUFFER 1024 24 #define TPM2_MAX_NV_BUFFER_SIZE 2048 25 #define TPM2_MAX_PCRS 32 26 #define TPM2_MAX_ALG_LIST_SIZE 128 27 #define TPM2_MAX_CAP_CC 256 28 #define TPM2_MAX_CAP_BUFFER 1024 29 #define TPM2_MAX_CONTEXT_SIZE 5120 30 31 /* Hash algorithm sizes */ 32 #define TPM2_SHA_DIGEST_SIZE 20 33 #define TPM2_SHA1_DIGEST_SIZE 20 34 #define TPM2_SHA256_DIGEST_SIZE 32 35 #define TPM2_SHA384_DIGEST_SIZE 48 36 #define TPM2_SHA512_DIGEST_SIZE 64 37 #define TPM2_SM3_256_DIGEST_SIZE 32 38 39 /* Encryption algorithm sizes */ 40 #define TPM2_MAX_SYM_BLOCK_SIZE 16 41 #define TPM2_MAX_SYM_DATA 256 42 #define TPM2_MAX_ECC_KEY_BYTES 128 43 #define TPM2_MAX_SYM_KEY_BYTES 32 44 #define TPM2_MAX_RSA_KEY_BYTES 512 45 46 /* Capability buffer sizes*/ 47 #define TPM2_LABEL_MAX_BUFFER 32 48 #define TPM2_PCR_SELECT_MAX ((TPM2_MAX_PCRS + 7) / 8) 49 #define TPM2_MAX_CAP_HANDLES ((TPM2_MAX_CAP_BUFFER - sizeof(TPM2_CAP) - \ 50 sizeof(UINT32)) / sizeof(TPM2_HANDLE)) 51 #define TPM2_MAX_CAP_ALGS ((TPM2_MAX_CAP_BUFFER - sizeof(TPM2_CAP) - \ 52 sizeof(UINT32)) / sizeof(TPMS_ALG_PROPERTY)) 53 #define TPM2_MAX_TPM_PROPERTIES ((TPM2_MAX_CAP_BUFFER - sizeof(TPM2_CAP) - \ 54 sizeof(UINT32)) / sizeof(TPMS_TAGGED_PROPERTY)) 55 #define TPM2_MAX_PCR_PROPERTIES ((TPM2_MAX_CAP_BUFFER - sizeof(TPM2_CAP) - \ 56 sizeof(UINT32)) / sizeof(TPMS_TAGGED_PCR_SELECT)) 57 #define TPM2_MAX_ECC_CURVES ((TPM2_MAX_CAP_BUFFER - sizeof(TPM2_CAP) - \ 58 sizeof(UINT32)) / sizeof(TPM2_ECC_CURVE)) 59 #define TPM2_MAX_TAGGED_POLICIES ((TPM2_MAX_CAP_BUFFER - sizeof(TPM2_CAP) - \ 60 sizeof(UINT32)) / sizeof(TPMS_TAGGED_POLICY)) 61 #define TPM2_PRIVATE_VENDOR_SPECIFIC_BYTES ((TPM2_MAX_RSA_KEY_BYTES / 2) * (3 + 2)) 62 63 /* Vendor Specific Defines */ 64 #define TPM2_MAX_PTT_PROPERTIES (TPM2_MAX_CAP_BUFFER / sizeof(UINT32)) 65 66 /* Attached Component Capabilities */ 67 #define TPM2_MAX_AC_CAPABILITIES (TPM2_MAX_CAP_BUFFER / sizeof(TPMS_AC_OUTPUT)) 68 69 /* From TCG Algorithm Registry: Definition of TPM2_ALG_ID Constants */ 70 typedef UINT16 TPM2_ALG_ID; 71 72 #define TPM2_ALG_ERROR ((TPM2_ALG_ID) 0x0000) 73 #define TPM2_ALG_RSA ((TPM2_ALG_ID) 0x0001) 74 #define TPM2_ALG_TDES ((TPM2_ALG_ID) 0x0003) 75 #define TPM2_ALG_SHA ((TPM2_ALG_ID) 0x0004) 76 #define TPM2_ALG_SHA1 ((TPM2_ALG_ID) 0x0004) 77 #define TPM2_ALG_HMAC ((TPM2_ALG_ID) 0x0005) 78 #define TPM2_ALG_AES ((TPM2_ALG_ID) 0x0006) 79 #define TPM2_ALG_MGF1 ((TPM2_ALG_ID) 0x0007) 80 #define TPM2_ALG_KEYEDHASH ((TPM2_ALG_ID) 0x0008) 81 #define TPM2_ALG_XOR ((TPM2_ALG_ID) 0x000A) 82 #define TPM2_ALG_SHA256 ((TPM2_ALG_ID) 0x000B) 83 #define TPM2_ALG_SHA384 ((TPM2_ALG_ID) 0x000C) 84 #define TPM2_ALG_SHA512 ((TPM2_ALG_ID) 0x000D) 85 #define TPM2_ALG_NULL ((TPM2_ALG_ID) 0x0010) 86 #define TPM2_ALG_SM3_256 ((TPM2_ALG_ID) 0x0012) 87 #define TPM2_ALG_SM4 ((TPM2_ALG_ID) 0x0013) 88 #define TPM2_ALG_RSASSA ((TPM2_ALG_ID) 0x0014) 89 #define TPM2_ALG_RSAES ((TPM2_ALG_ID) 0x0015) 90 #define TPM2_ALG_RSAPSS ((TPM2_ALG_ID) 0x0016) 91 #define TPM2_ALG_OAEP ((TPM2_ALG_ID) 0x0017) 92 #define TPM2_ALG_ECDSA ((TPM2_ALG_ID) 0x0018) 93 #define TPM2_ALG_ECDH ((TPM2_ALG_ID) 0x0019) 94 #define TPM2_ALG_ECDAA ((TPM2_ALG_ID) 0x001A) 95 #define TPM2_ALG_SM2 ((TPM2_ALG_ID) 0x001B) 96 #define TPM2_ALG_ECSCHNORR ((TPM2_ALG_ID) 0x001C) 97 #define TPM2_ALG_ECMQV ((TPM2_ALG_ID) 0x001D) 98 #define TPM2_ALG_KDF1_SP800_56A ((TPM2_ALG_ID) 0x0020) 99 #define TPM2_ALG_KDF2 ((TPM2_ALG_ID) 0x0021) 100 #define TPM2_ALG_KDF1_SP800_108 ((TPM2_ALG_ID) 0x0022) 101 #define TPM2_ALG_ECC ((TPM2_ALG_ID) 0x0023) 102 #define TPM2_ALG_SYMCIPHER ((TPM2_ALG_ID) 0x0025) 103 #define TPM2_ALG_CAMELLIA ((TPM2_ALG_ID) 0x0026) 104 #define TPM2_ALG_CMAC ((TPM2_ALG_ID) 0x003F) 105 #define TPM2_ALG_CTR ((TPM2_ALG_ID) 0x0040) 106 #define TPM2_ALG_SHA3_256 ((TPM2_ALG_ID) 0x0027) 107 #define TPM2_ALG_SHA3_384 ((TPM2_ALG_ID) 0x0028) 108 #define TPM2_ALG_SHA3_512 ((TPM2_ALG_ID) 0x0029) 109 #define TPM2_ALG_OFB ((TPM2_ALG_ID) 0x0041) 110 #define TPM2_ALG_CBC ((TPM2_ALG_ID) 0x0042) 111 #define TPM2_ALG_CFB ((TPM2_ALG_ID) 0x0043) 112 #define TPM2_ALG_ECB ((TPM2_ALG_ID) 0x0044) 113 #define TPM2_ALG_FIRST ((TPM2_ALG_ID) 0x0001) 114 #define TPM2_ALG_LAST ((TPM2_ALG_ID) 0x0044) 115 116 /* From TCG Algorithm Registry: Definition of TPM2_ECC_CURVE Constants */ 117 typedef UINT16 TPM2_ECC_CURVE; 118 #define TPM2_ECC_NONE ((TPM2_ECC_CURVE) 0x0000) 119 #define TPM2_ECC_NIST_P192 ((TPM2_ECC_CURVE) 0x0001) 120 #define TPM2_ECC_NIST_P224 ((TPM2_ECC_CURVE) 0x0002) 121 #define TPM2_ECC_NIST_P256 ((TPM2_ECC_CURVE) 0x0003) 122 #define TPM2_ECC_NIST_P384 ((TPM2_ECC_CURVE) 0x0004) 123 #define TPM2_ECC_NIST_P521 ((TPM2_ECC_CURVE) 0x0005) 124 #define TPM2_ECC_BN_P256 ((TPM2_ECC_CURVE) 0x0010) 125 #define TPM2_ECC_BN_P638 ((TPM2_ECC_CURVE) 0x0011) 126 #define TPM2_ECC_SM2_P256 ((TPM2_ECC_CURVE) 0x0020) 127 128 /* From TPM 2.0 Part 2: Definition of TPM2_CC Constants */ 129 typedef UINT32 TPM2_CC; 130 #define TPM2_CC_NV_UndefineSpaceSpecial ((TPM2_CC) 0x0000011f) 131 #define TPM2_CC_FIRST TPM2_CC_NV_UndefineSpaceSpecial 132 #define TPM2_CC_EvictControl ((TPM2_CC) 0x00000120) 133 #define TPM2_CC_HierarchyControl ((TPM2_CC) 0x00000121) 134 #define TPM2_CC_NV_UndefineSpace ((TPM2_CC) 0x00000122) 135 #define TPM2_CC_ChangeEPS ((TPM2_CC) 0x00000124) 136 #define TPM2_CC_ChangePPS ((TPM2_CC) 0x00000125) 137 #define TPM2_CC_Clear ((TPM2_CC) 0x00000126) 138 #define TPM2_CC_ClearControl ((TPM2_CC) 0x00000127) 139 #define TPM2_CC_ClockSet ((TPM2_CC) 0x00000128) 140 #define TPM2_CC_HierarchyChangeAuth ((TPM2_CC) 0x00000129) 141 #define TPM2_CC_NV_DefineSpace ((TPM2_CC) 0x0000012a) 142 #define TPM2_CC_PCR_Allocate ((TPM2_CC) 0x0000012b) 143 #define TPM2_CC_PCR_SetAuthPolicy ((TPM2_CC) 0x0000012c) 144 #define TPM2_CC_PP_Commands ((TPM2_CC) 0x0000012d) 145 #define TPM2_CC_SetPrimaryPolicy ((TPM2_CC) 0x0000012e) 146 #define TPM2_CC_FieldUpgradeStart ((TPM2_CC) 0x0000012f) 147 #define TPM2_CC_ClockRateAdjust ((TPM2_CC) 0x00000130) 148 #define TPM2_CC_CreatePrimary ((TPM2_CC) 0x00000131) 149 #define TPM2_CC_NV_GlobalWriteLock ((TPM2_CC) 0x00000132) 150 #define TPM2_CC_GetCommandAuditDigest ((TPM2_CC) 0x00000133) 151 #define TPM2_CC_NV_Increment ((TPM2_CC) 0x00000134) 152 #define TPM2_CC_NV_SetBits ((TPM2_CC) 0x00000135) 153 #define TPM2_CC_NV_Extend ((TPM2_CC) 0x00000136) 154 #define TPM2_CC_NV_Write ((TPM2_CC) 0x00000137) 155 #define TPM2_CC_NV_WriteLock ((TPM2_CC) 0x00000138) 156 #define TPM2_CC_DictionaryAttackLockReset ((TPM2_CC) 0x00000139) 157 #define TPM2_CC_DictionaryAttackParameters ((TPM2_CC) 0x0000013a) 158 #define TPM2_CC_NV_ChangeAuth ((TPM2_CC) 0x0000013b) 159 #define TPM2_CC_PCR_Event ((TPM2_CC) 0x0000013c) 160 #define TPM2_CC_PCR_Reset ((TPM2_CC) 0x0000013d) 161 #define TPM2_CC_SequenceComplete ((TPM2_CC) 0x0000013e) 162 #define TPM2_CC_SetAlgorithmSet ((TPM2_CC) 0x0000013f) 163 #define TPM2_CC_SetCommandCodeAuditStatus ((TPM2_CC) 0x00000140) 164 #define TPM2_CC_FieldUpgradeData ((TPM2_CC) 0x00000141) 165 #define TPM2_CC_IncrementalSelfTest ((TPM2_CC) 0x00000142) 166 #define TPM2_CC_SelfTest ((TPM2_CC) 0x00000143) 167 #define TPM2_CC_Startup ((TPM2_CC) 0x00000144) 168 #define TPM2_CC_Shutdown ((TPM2_CC) 0x00000145) 169 #define TPM2_CC_StirRandom ((TPM2_CC) 0x00000146) 170 #define TPM2_CC_ActivateCredential ((TPM2_CC) 0x00000147) 171 #define TPM2_CC_Certify ((TPM2_CC) 0x00000148) 172 #define TPM2_CC_PolicyNV ((TPM2_CC) 0x00000149) 173 #define TPM2_CC_CertifyCreation ((TPM2_CC) 0x0000014a) 174 #define TPM2_CC_Duplicate ((TPM2_CC) 0x0000014b) 175 #define TPM2_CC_GetTime ((TPM2_CC) 0x0000014c) 176 #define TPM2_CC_GetSessionAuditDigest ((TPM2_CC) 0x0000014d) 177 #define TPM2_CC_NV_Read ((TPM2_CC) 0x0000014e) 178 #define TPM2_CC_NV_ReadLock ((TPM2_CC) 0x0000014f) 179 #define TPM2_CC_ObjectChangeAuth ((TPM2_CC) 0x00000150) 180 #define TPM2_CC_PolicySecret ((TPM2_CC) 0x00000151) 181 #define TPM2_CC_Rewrap ((TPM2_CC) 0x00000152) 182 #define TPM2_CC_Create ((TPM2_CC) 0x00000153) 183 #define TPM2_CC_ECDH_ZGen ((TPM2_CC) 0x00000154) 184 #define TPM2_CC_HMAC ((TPM2_CC) 0x00000155) 185 #define TPM2_CC_Import ((TPM2_CC) 0x00000156) 186 #define TPM2_CC_Load ((TPM2_CC) 0x00000157) 187 #define TPM2_CC_Quote ((TPM2_CC) 0x00000158) 188 #define TPM2_CC_RSA_Decrypt ((TPM2_CC) 0x00000159) 189 #define TPM2_CC_HMAC_Start ((TPM2_CC) 0x0000015b) 190 #define TPM2_CC_SequenceUpdate ((TPM2_CC) 0x0000015c) 191 #define TPM2_CC_Sign ((TPM2_CC) 0x0000015d) 192 #define TPM2_CC_Unseal ((TPM2_CC) 0x0000015e) 193 #define TPM2_CC_PolicySigned ((TPM2_CC) 0x00000160) 194 #define TPM2_CC_ContextLoad ((TPM2_CC) 0x00000161) 195 #define TPM2_CC_ContextSave ((TPM2_CC) 0x00000162) 196 #define TPM2_CC_ECDH_KeyGen ((TPM2_CC) 0x00000163) 197 #define TPM2_CC_EncryptDecrypt ((TPM2_CC) 0x00000164) 198 #define TPM2_CC_FlushContext ((TPM2_CC) 0x00000165) 199 #define TPM2_CC_LoadExternal ((TPM2_CC) 0x00000167) 200 #define TPM2_CC_MakeCredential ((TPM2_CC) 0x00000168) 201 #define TPM2_CC_NV_ReadPublic ((TPM2_CC) 0x00000169) 202 #define TPM2_CC_PolicyAuthorize ((TPM2_CC) 0x0000016a) 203 #define TPM2_CC_PolicyAuthValue ((TPM2_CC) 0x0000016b) 204 #define TPM2_CC_PolicyCommandCode ((TPM2_CC) 0x0000016c) 205 #define TPM2_CC_PolicyCounterTimer ((TPM2_CC) 0x0000016d) 206 #define TPM2_CC_PolicyCpHash ((TPM2_CC) 0x0000016e) 207 #define TPM2_CC_PolicyLocality ((TPM2_CC) 0x0000016f) 208 #define TPM2_CC_PolicyNameHash ((TPM2_CC) 0x00000170) 209 #define TPM2_CC_PolicyOR ((TPM2_CC) 0x00000171) 210 #define TPM2_CC_PolicyTicket ((TPM2_CC) 0x00000172) 211 #define TPM2_CC_ReadPublic ((TPM2_CC) 0x00000173) 212 #define TPM2_CC_RSA_Encrypt ((TPM2_CC) 0x00000174) 213 #define TPM2_CC_StartAuthSession ((TPM2_CC) 0x00000176) 214 #define TPM2_CC_VerifySignature ((TPM2_CC) 0x00000177) 215 #define TPM2_CC_ECC_Parameters ((TPM2_CC) 0x00000178) 216 #define TPM2_CC_FirmwareRead ((TPM2_CC) 0x00000179) 217 #define TPM2_CC_GetCapability ((TPM2_CC) 0x0000017a) 218 #define TPM2_CC_GetRandom ((TPM2_CC) 0x0000017b) 219 #define TPM2_CC_GetTestResult ((TPM2_CC) 0x0000017c) 220 #define TPM2_CC_Hash ((TPM2_CC) 0x0000017d) 221 #define TPM2_CC_PCR_Read ((TPM2_CC) 0x0000017e) 222 #define TPM2_CC_PolicyPCR ((TPM2_CC) 0x0000017f) 223 #define TPM2_CC_PolicyRestart ((TPM2_CC) 0x00000180) 224 #define TPM2_CC_ReadClock ((TPM2_CC) 0x00000181) 225 #define TPM2_CC_PCR_Extend ((TPM2_CC) 0x00000182) 226 #define TPM2_CC_PCR_SetAuthValue ((TPM2_CC) 0x00000183) 227 #define TPM2_CC_NV_Certify ((TPM2_CC) 0x00000184) 228 #define TPM2_CC_EventSequenceComplete ((TPM2_CC) 0x00000185) 229 #define TPM2_CC_HashSequenceStart ((TPM2_CC) 0x00000186) 230 #define TPM2_CC_PolicyPhysicalPresence ((TPM2_CC) 0x00000187) 231 #define TPM2_CC_PolicyDuplicationSelect ((TPM2_CC) 0x00000188) 232 #define TPM2_CC_PolicyGetDigest ((TPM2_CC) 0x00000189) 233 #define TPM2_CC_TestParms ((TPM2_CC) 0x0000018a) 234 #define TPM2_CC_Commit ((TPM2_CC) 0x0000018b) 235 #define TPM2_CC_PolicyPassword ((TPM2_CC) 0x0000018c) 236 #define TPM2_CC_ZGen_2Phase ((TPM2_CC) 0x0000018d) 237 #define TPM2_CC_EC_Ephemeral ((TPM2_CC) 0x0000018e) 238 #define TPM2_CC_PolicyNvWritten ((TPM2_CC) 0x0000018f) 239 #define TPM2_CC_PolicyTemplate ((TPM2_CC) 0x00000190) 240 #define TPM2_CC_CreateLoaded ((TPM2_CC) 0x00000191) 241 #define TPM2_CC_PolicyAuthorizeNV ((TPM2_CC) 0x00000192) 242 #define TPM2_CC_EncryptDecrypt2 ((TPM2_CC) 0x00000193) 243 #define TPM2_CC_AC_GetCapability ((TPM2_CC) 0x00000194) 244 #define TPM2_CC_AC_Send ((TPM2_CC) 0x00000195) 245 #define TPM2_CC_Policy_AC_SendSelect ((TPM2_CC) 0x00000196) 246 #define TPM2_CC_LAST ((TPM2_CC) 0x00000196) 247 #define TPM2_CC_Vendor_TCG_Test ((TPM2_CC) 0x20000000) 248 249 /* Definition of Types for Documentation Clarity */ 250 typedef UINT32 TPM2_ALGORITHM_ID; /* this is the 1.2 compatible form of the TPM2_ALG_ID */ 251 typedef UINT32 TPM2_MODIFIER_INDICATOR; 252 typedef UINT32 TPM2_AUTHORIZATION_SIZE; /* the authorizationSize parameter in a command */ 253 typedef UINT32 TPM2_PARAMETER_SIZE; /* the parameterSize parameter in a command */ 254 typedef UINT16 TPM2_KEY_SIZE; /* a key size in octets */ 255 typedef UINT16 TPM2_KEY_BITS; /* a key size in bits */ 256 257 /* Definition of UINT32 TPM2_SPEC Constants <> */ 258 typedef UINT32 TPM2_SPEC; 259 #define TPM2_SPEC_FAMILY ((TPM2_SPEC) 0x322E3000) /* ASCII 2.0 with null terminator */ 260 #define TPM2_SPEC_LEVEL ((TPM2_SPEC) 00) /* the level number for the specification */ 261 #define TPM2_SPEC_VERSION ((TPM2_SPEC) 126) /* the version number of the spec 001.26 * 100 */ 262 #define TPM2_SPEC_YEAR ((TPM2_SPEC) 2015) /* the year of the version */ 263 #define TPM2_SPEC_DAY_OF_YEAR ((TPM2_SPEC) 233) /* the day of the year August 21 2015 */ 264 265 /* Definition of UINT32 TPM2_GENERATED Constants <O> */ 266 typedef UINT32 TPM2_GENERATED; 267 #define TPM2_GENERATED_VALUE ((TPM2_GENERATED) (0xff544347)) /* 0xFF TCG FF 54 43 4716 */ 268 269 /* Definition of UINT32 TPM2_RC Constants Actions <OUT> */ 270 typedef UINT32 TPM2_RC; 271 #define TPM2_RC_SUCCESS ((TPM2_RC) 0x000) 272 #define TPM2_RC_BAD_TAG ((TPM2_RC) 0x01E) /* defined for compatibility with TPM 1.2 */ 273 #define TPM2_RC_VER1 ((TPM2_RC) 0x100) /* set for all format 0 response codes */ 274 #define TPM2_RC_INITIALIZE ((TPM2_RC) (TPM2_RC_VER1 + 0x000)) /* TPM not initialized by TPM2_Startup or already initialized */ 275 #define TPM2_RC_FAILURE ((TPM2_RC) (TPM2_RC_VER1 + 0x001)) /* commands not being accepted because of a TPM failure. NOTE This may be returned by TPM2_GetTestResult as the testResult parameter. */ 276 #define TPM2_RC_SEQUENCE ((TPM2_RC) (TPM2_RC_VER1 + 0x003)) /* improper use of a sequence handle */ 277 #define TPM2_RC_PRIVATE ((TPM2_RC) (TPM2_RC_VER1 + 0x00B)) /* not currently used */ 278 #define TPM2_RC_HMAC ((TPM2_RC) (TPM2_RC_VER1 + 0x019)) /* not currently used */ 279 #define TPM2_RC_DISABLED ((TPM2_RC) (TPM2_RC_VER1 + 0x020)) /* the command is disabled */ 280 #define TPM2_RC_EXCLUSIVE ((TPM2_RC) (TPM2_RC_VER1 + 0x021)) /* command failed because audit sequence required exclusivity */ 281 #define TPM2_RC_AUTH_TYPE ((TPM2_RC) (TPM2_RC_VER1 + 0x024)) /* authorization handle is not correct for command */ 282 #define TPM2_RC_AUTH_MISSING ((TPM2_RC) (TPM2_RC_VER1 + 0x025)) /* command requires an authorization session for handle and it is not present. */ 283 #define TPM2_RC_POLICY ((TPM2_RC) (TPM2_RC_VER1 + 0x026)) /* policy failure in math operation or an invalid authPolicy value */ 284 #define TPM2_RC_PCR ((TPM2_RC) (TPM2_RC_VER1 + 0x027)) /* PCR check fail */ 285 #define TPM2_RC_PCR_CHANGED ((TPM2_RC) (TPM2_RC_VER1 + 0x028)) /* PCR have changed since checked. */ 286 #define TPM2_RC_UPGRADE ((TPM2_RC) (TPM2_RC_VER1 + 0x02D)) /* For all commands, other than TPM2_FieldUpgradeData, this code indicates that the TPM is in field upgrade mode. For TPM2_FieldUpgradeData, this code indicates that the TPM is not in field upgrade mode */ 287 #define TPM2_RC_TOO_MANY_CONTEXTS ((TPM2_RC) (TPM2_RC_VER1 + 0x02E)) /* context ID counter is at maximum. */ 288 #define TPM2_RC_AUTH_UNAVAILABLE ((TPM2_RC) (TPM2_RC_VER1 + 0x02F)) /* authValue or authPolicy is not available for selected entity. */ 289 #define TPM2_RC_REBOOT ((TPM2_RC) (TPM2_RC_VER1 + 0x030)) /* a _TPM_Init and StartupCLEAR is required before the TPM can resume operation. */ 290 #define TPM2_RC_UNBALANCED ((TPM2_RC) (TPM2_RC_VER1 + 0x031)) /* the protection algorithms hash and symmetric are not reasonably balanced. The digest size of the hash must be larger than the key size of the symmetric algorithm. */ 291 #define TPM2_RC_COMMAND_SIZE ((TPM2_RC) (TPM2_RC_VER1 + 0x042)) /* command commandSize value is inconsistent with contents of the command buffer. Either the size is not the same as the octets loaded by the hardware interface layer or the value is not large enough to hold a command header */ 292 #define TPM2_RC_COMMAND_CODE ((TPM2_RC) (TPM2_RC_VER1 + 0x043)) /* command code not supported */ 293 #define TPM2_RC_AUTHSIZE ((TPM2_RC) (TPM2_RC_VER1 + 0x044)) /* the value of authorizationSize is out of range or the number of octets in the Authorization Area is greater than required */ 294 #define TPM2_RC_AUTH_CONTEXT ((TPM2_RC) (TPM2_RC_VER1 + 0x045)) /* use of an authorization session with a context command or another command that cannot have an authorization session. */ 295 #define TPM2_RC_NV_RANGE ((TPM2_RC) (TPM2_RC_VER1 + 0x046)) /* NV offset+size is out of range. */ 296 #define TPM2_RC_NV_SIZE ((TPM2_RC) (TPM2_RC_VER1 + 0x047)) /* Requested allocation size is larger than allowed. */ 297 #define TPM2_RC_NV_LOCKED ((TPM2_RC) (TPM2_RC_VER1 + 0x048)) /* NV access locked. */ 298 #define TPM2_RC_NV_AUTHORIZATION ((TPM2_RC) (TPM2_RC_VER1 + 0x049)) /* NV access authorization fails in command actions this failure does not affect lockout.action */ 299 #define TPM2_RC_NV_UNINITIALIZED ((TPM2_RC) (TPM2_RC_VER1 + 0x04A)) /* an NV Index is used before being initialized or the state saved by TPM2_ShutdownSTATE could not be restored */ 300 #define TPM2_RC_NV_SPACE ((TPM2_RC) (TPM2_RC_VER1 + 0x04B)) /* insufficient space for NV allocation */ 301 #define TPM2_RC_NV_DEFINED ((TPM2_RC) (TPM2_RC_VER1 + 0x04C)) /* NV Index or persistent object already defined */ 302 #define TPM2_RC_BAD_CONTEXT ((TPM2_RC) (TPM2_RC_VER1 + 0x050)) /* context in TPM2_ContextLoad is not valid */ 303 #define TPM2_RC_CPHASH ((TPM2_RC) (TPM2_RC_VER1 + 0x051)) /* cpHash value already set or not correct for use */ 304 #define TPM2_RC_PARENT ((TPM2_RC) (TPM2_RC_VER1 + 0x052)) /* handle for parent is not a valid parent */ 305 #define TPM2_RC_NEEDS_TEST ((TPM2_RC) (TPM2_RC_VER1 + 0x053)) /* some function needs testing. */ 306 #define TPM2_RC_NO_RESULT ((TPM2_RC) (TPM2_RC_VER1 + 0x054)) /* returned when an internal function cannot process a request due to an unspecified problem. This code is usually related to invalid parameters that are not properly filtered by the input unmarshaling code. */ 307 #define TPM2_RC_SENSITIVE ((TPM2_RC) (TPM2_RC_VER1 + 0x055)) /* the sensitive area did not unmarshal correctly after decryption. This code is used in lieu of the other unmarshaling errors so that an attacker cannot determine where the unmarshaling error occurred */ 308 #define TPM2_RC_MAX_FM0 ((TPM2_RC) (TPM2_RC_VER1 + 0x07F)) /* largest version 1 code that is not a warning */ 309 #define TPM2_RC_FMT1 ((TPM2_RC) 0x080) /* This bit is SET in all format 1 response codes. The codes in this group may have a value added to them to indicate the handle session or parameter to which they apply. */ 310 #define TPM2_RC_ASYMMETRIC ((TPM2_RC) (TPM2_RC_FMT1 + 0x001)) /* asymmetric algorithm not supported or not correct */ 311 #define TPM2_RC_ATTRIBUTES ((TPM2_RC) (TPM2_RC_FMT1 + 0x002)) /* inconsistent attributes */ 312 #define TPM2_RC_HASH ((TPM2_RC) (TPM2_RC_FMT1 + 0x003)) /* hash algorithm not supported or not appropriate */ 313 #define TPM2_RC_VALUE ((TPM2_RC) (TPM2_RC_FMT1 + 0x004)) /* value is out of range or is not correct for the context */ 314 #define TPM2_RC_HIERARCHY ((TPM2_RC) (TPM2_RC_FMT1 + 0x005)) /* hierarchy is not enabled or is not correct for the use */ 315 #define TPM2_RC_KEY_SIZE ((TPM2_RC) (TPM2_RC_FMT1 + 0x007)) /* key size is not supported */ 316 #define TPM2_RC_MGF ((TPM2_RC) (TPM2_RC_FMT1 + 0x008)) /* mask generation function not supported */ 317 #define TPM2_RC_MODE ((TPM2_RC) (TPM2_RC_FMT1 + 0x009)) /* mode of operation not supported */ 318 #define TPM2_RC_TYPE ((TPM2_RC) (TPM2_RC_FMT1 + 0x00A)) /* the type of the value is not appropriate for the use */ 319 #define TPM2_RC_HANDLE ((TPM2_RC) (TPM2_RC_FMT1 + 0x00B)) /* the handle is not correct for the use */ 320 #define TPM2_RC_KDF ((TPM2_RC) (TPM2_RC_FMT1 + 0x00C)) /* unsupported key derivation function or function not appropriate for use */ 321 #define TPM2_RC_RANGE ((TPM2_RC) (TPM2_RC_FMT1 + 0x00D)) /* value was out of allowed range. */ 322 #define TPM2_RC_AUTH_FAIL ((TPM2_RC) (TPM2_RC_FMT1 + 0x00E)) /* the authorization HMAC check failed and DA counter incremented */ 323 #define TPM2_RC_NONCE ((TPM2_RC) (TPM2_RC_FMT1 + 0x00F)) /* invalid nonce size or nonce value mismatch */ 324 #define TPM2_RC_PP ((TPM2_RC) (TPM2_RC_FMT1 + 0x010)) /* authorization requires assertion of PP */ 325 #define TPM2_RC_SCHEME ((TPM2_RC) (TPM2_RC_FMT1 + 0x012)) /* unsupported or incompatible scheme */ 326 #define TPM2_RC_SIZE ((TPM2_RC) (TPM2_RC_FMT1 + 0x015)) /* structure is the wrong size */ 327 #define TPM2_RC_SYMMETRIC ((TPM2_RC) (TPM2_RC_FMT1 + 0x016)) /* unsupported symmetric algorithm or key size or not appropriate for instance */ 328 #define TPM2_RC_TAG ((TPM2_RC) (TPM2_RC_FMT1 + 0x017)) /* incorrect structure tag */ 329 #define TPM2_RC_SELECTOR ((TPM2_RC) (TPM2_RC_FMT1 + 0x018)) /* union selector is incorrect */ 330 #define TPM2_RC_INSUFFICIENT ((TPM2_RC) (TPM2_RC_FMT1 + 0x01A)) /* the TPM was unable to unmarshal a value because there were not enough octets in the input buffer */ 331 #define TPM2_RC_SIGNATURE ((TPM2_RC) (TPM2_RC_FMT1 + 0x01B)) /* the signature is not valid */ 332 #define TPM2_RC_KEY ((TPM2_RC) (TPM2_RC_FMT1 + 0x01C)) /* key fields are not compatible with the selected use */ 333 #define TPM2_RC_POLICY_FAIL ((TPM2_RC) (TPM2_RC_FMT1 + 0x01D)) /* a policy check failed */ 334 #define TPM2_RC_INTEGRITY ((TPM2_RC) (TPM2_RC_FMT1 + 0x01F)) /* integrity check failed */ 335 #define TPM2_RC_TICKET ((TPM2_RC) (TPM2_RC_FMT1 + 0x020)) /* invalid ticket */ 336 #define TPM2_RC_RESERVED_BITS ((TPM2_RC) (TPM2_RC_FMT1 + 0x021)) /* reserved bits not set to zero as required */ 337 #define TPM2_RC_BAD_AUTH ((TPM2_RC) (TPM2_RC_FMT1 + 0x022)) /* authorization failure without DA implications */ 338 #define TPM2_RC_EXPIRED ((TPM2_RC) (TPM2_RC_FMT1 + 0x023)) /* the policy has expired */ 339 #define TPM2_RC_POLICY_CC ((TPM2_RC) (TPM2_RC_FMT1 + 0x024)) /* the commandCode in the policy is not the commandCode of the command or the command code in a policy command references a command that is not implemented */ 340 #define TPM2_RC_BINDING ((TPM2_RC) (TPM2_RC_FMT1 + 0x025)) /* public and sensitive portions of an object are not cryptographically bound */ 341 #define TPM2_RC_CURVE ((TPM2_RC) (TPM2_RC_FMT1 + 0x026)) /* curve not supported */ 342 #define TPM2_RC_ECC_POINT ((TPM2_RC) (TPM2_RC_FMT1 + 0x027)) /* point is not on the required curve. */ 343 #define TPM2_RC_WARN ((TPM2_RC) 0x900) /* set for warning response codes */ 344 #define TPM2_RC_CONTEXT_GAP ((TPM2_RC) (TPM2_RC_WARN + 0x001)) /* gap for context ID is too large */ 345 #define TPM2_RC_OBJECT_MEMORY ((TPM2_RC) (TPM2_RC_WARN + 0x002)) /* out of memory for object contexts */ 346 #define TPM2_RC_SESSION_MEMORY ((TPM2_RC) (TPM2_RC_WARN + 0x003)) /* out of memory for session contexts */ 347 #define TPM2_RC_MEMORY ((TPM2_RC) (TPM2_RC_WARN + 0x004)) /* out of shared objectsession memory or need space for internal operations */ 348 #define TPM2_RC_SESSION_HANDLES ((TPM2_RC) (TPM2_RC_WARN + 0x005)) /* out of session handles a session must be flushed before a new session may be created */ 349 #define TPM2_RC_OBJECT_HANDLES ((TPM2_RC) (TPM2_RC_WARN + 0x006)) /* out of object handles. The handle space for objects is depleted and a reboot is required. NOTE This cannot occur on the reference implementation. NOTE There is no reason why an implementation would implement a design that would deplete handle space. Platform specifications are encouraged to forbid it. */ 350 #define TPM2_RC_LOCALITY ((TPM2_RC) (TPM2_RC_WARN + 0x007)) /* bad locality */ 351 #define TPM2_RC_YIELDED ((TPM2_RC) (TPM2_RC_WARN + 0x008)) /* the TPM has suspended operation on the command forward progress was made and the command may be retried. See TPM 2.0 Part 1 Multitasking. NOTE This cannot occur on the reference implementation. */ 352 #define TPM2_RC_CANCELED ((TPM2_RC) (TPM2_RC_WARN + 0x009)) /* the command was canceled */ 353 #define TPM2_RC_TESTING ((TPM2_RC) (TPM2_RC_WARN + 0x00A)) /* TPM is performing selftests */ 354 #define TPM2_RC_REFERENCE_H0 ((TPM2_RC) (TPM2_RC_WARN + 0x010)) /* the 1st handle in the handle area references a transient object or session that is not loaded */ 355 #define TPM2_RC_REFERENCE_H1 ((TPM2_RC) (TPM2_RC_WARN + 0x011)) /* the 2nd handle in the handle area references a transient object or session that is not loaded */ 356 #define TPM2_RC_REFERENCE_H2 ((TPM2_RC) (TPM2_RC_WARN + 0x012)) /* the 3rd handle in the handle area references a transient object or session that is not loaded */ 357 #define TPM2_RC_REFERENCE_H3 ((TPM2_RC) (TPM2_RC_WARN + 0x013)) /* the 4th handle in the handle area references a transient object or session that is not loaded */ 358 #define TPM2_RC_REFERENCE_H4 ((TPM2_RC) (TPM2_RC_WARN + 0x014)) /* the 5th handle in the handle area references a transient object or session that is not loaded */ 359 #define TPM2_RC_REFERENCE_H5 ((TPM2_RC) (TPM2_RC_WARN + 0x015)) /* the 6th handle in the handle area references a transient object or session that is not loaded */ 360 #define TPM2_RC_REFERENCE_H6 ((TPM2_RC) (TPM2_RC_WARN + 0x016)) /* the 7th handle in the handle area references a transient object or session that is not loaded */ 361 #define TPM2_RC_REFERENCE_S0 ((TPM2_RC) (TPM2_RC_WARN + 0x018)) /* the 1st authorization session handle references a session that is not loaded */ 362 #define TPM2_RC_REFERENCE_S1 ((TPM2_RC) (TPM2_RC_WARN + 0x019)) /* the 2nd authorization session handle references a session that is not loaded */ 363 #define TPM2_RC_REFERENCE_S2 ((TPM2_RC) (TPM2_RC_WARN + 0x01A)) /* the 3rd authorization session handle references a session that is not loaded */ 364 #define TPM2_RC_REFERENCE_S3 ((TPM2_RC) (TPM2_RC_WARN + 0x01B)) /* the 4th authorization session handle references a session that is not loaded */ 365 #define TPM2_RC_REFERENCE_S4 ((TPM2_RC) (TPM2_RC_WARN + 0x01C)) /* the 5th session handle references a session that is not loaded */ 366 #define TPM2_RC_REFERENCE_S5 ((TPM2_RC) (TPM2_RC_WARN + 0x01D)) /* the 6th session handle references a session that is not loaded */ 367 #define TPM2_RC_REFERENCE_S6 ((TPM2_RC) (TPM2_RC_WARN + 0x01E)) /* the 7th authorization session handle references a session that is not loaded */ 368 #define TPM2_RC_NV_RATE ((TPM2_RC) (TPM2_RC_WARN + 0x020)) /* the TPM is rate limiting accesses to prevent wearout of NV */ 369 #define TPM2_RC_LOCKOUT ((TPM2_RC) (TPM2_RC_WARN + 0x021)) /* authorizations for objects subject to DA protection are not allowed at this time because the TPM is in DA lockout mode */ 370 #define TPM2_RC_RETRY ((TPM2_RC) (TPM2_RC_WARN + 0x022)) /* the TPM was not able to start the command */ 371 #define TPM2_RC_NV_UNAVAILABLE ((TPM2_RC) (TPM2_RC_WARN + 0x023)) /* the command may require writing of NV and NV is not current accessible */ 372 #define TPM2_RC_NOT_USED ((TPM2_RC) (TPM2_RC_WARN + 0x07F)) /* this value is reserved and shall not be returned by the TPM */ 373 #define TPM2_RC_H ((TPM2_RC) 0x000) /* add to a handle related error */ 374 #define TPM2_RC_P ((TPM2_RC) 0x040) /* add to a parameter-related error */ 375 #define TPM2_RC_S ((TPM2_RC) 0x800) /* add to a session-related error */ 376 #define TPM2_RC_1 ((TPM2_RC) 0x100) /* add to a parameter handle or session-related error */ 377 #define TPM2_RC_2 ((TPM2_RC) 0x200) /* add to a parameter handle or session-related error */ 378 #define TPM2_RC_3 ((TPM2_RC) 0x300) /* add to a parameter handle or session-related error */ 379 #define TPM2_RC_4 ((TPM2_RC) 0x400) /* add to a parameter handle or session-related error */ 380 #define TPM2_RC_5 ((TPM2_RC) 0x500) /* add to a parameter handle or session-related error */ 381 #define TPM2_RC_6 ((TPM2_RC) 0x600) /* add to a parameter handle or session-related error */ 382 #define TPM2_RC_7 ((TPM2_RC) 0x700) /* add to a parameter handle or session-related error */ 383 #define TPM2_RC_8 ((TPM2_RC) 0x800) /* add to a parameter-related error */ 384 #define TPM2_RC_9 ((TPM2_RC) 0x900) /* add to a parameter-related error */ 385 #define TPM2_RC_A ((TPM2_RC) 0xA00) /* add to a parameter-related error */ 386 #define TPM2_RC_B ((TPM2_RC) 0xB00) /* add to a parameter-related error */ 387 #define TPM2_RC_C ((TPM2_RC) 0xC00) /* add to a parameter-related error */ 388 #define TPM2_RC_D ((TPM2_RC) 0xD00) /* add to a parameter-related error */ 389 #define TPM2_RC_E ((TPM2_RC) 0xE00) /* add to a parameter-related error */ 390 #define TPM2_RC_F ((TPM2_RC) 0xF00) /* add to a parameter-related error */ 391 #define TPM2_RC_N_MASK ((TPM2_RC) 0xF00) /* number mask */ 392 393 /* Definition of INT8 TPM2_CLOCK_ADJUST Constants <IN> */ 394 typedef INT8 TPM2_CLOCK_ADJUST; 395 #define TPM2_CLOCK_COARSE_SLOWER ((TPM2_CLOCK_ADJUST) -3) /* Slow the Clock update rate by one coarse adjustment step. */ 396 #define TPM2_CLOCK_MEDIUM_SLOWER ((TPM2_CLOCK_ADJUST) -2) /* Slow the Clock update rate by one medium adjustment step. */ 397 #define TPM2_CLOCK_FINE_SLOWER ((TPM2_CLOCK_ADJUST) -1) /* Slow the Clock update rate by one fine adjustment step. */ 398 #define TPM2_CLOCK_NO_CHANGE ((TPM2_CLOCK_ADJUST) 0) /* No change to the Clock update rate. */ 399 #define TPM2_CLOCK_FINE_FASTER ((TPM2_CLOCK_ADJUST) 1) /* Speed the Clock update rate by one fine adjustment step. */ 400 #define TPM2_CLOCK_MEDIUM_FASTER ((TPM2_CLOCK_ADJUST) 2) /* Speed the Clock update rate by one medium adjustment step. */ 401 #define TPM2_CLOCK_COARSE_FASTER ((TPM2_CLOCK_ADJUST) 3) /* Speed the Clock update rate by one coarse adjustment step. */ 402 403 /* Definition of UINT16 TPM2_EO Constants <INOUT> */ 404 typedef UINT16 TPM2_EO; 405 #define TPM2_EO_EQ ((TPM2_EO) 0x0000) /* A B */ 406 #define TPM2_EO_NEQ ((TPM2_EO) 0x0001) /* A B */ 407 #define TPM2_EO_SIGNED_GT ((TPM2_EO) 0x0002) /* A > B signed */ 408 #define TPM2_EO_UNSIGNED_GT ((TPM2_EO) 0x0003) /* A > B unsigned */ 409 #define TPM2_EO_SIGNED_LT ((TPM2_EO) 0x0004) /* A < B signed */ 410 #define TPM2_EO_UNSIGNED_LT ((TPM2_EO) 0x0005) /* A < B unsigned */ 411 #define TPM2_EO_SIGNED_GE ((TPM2_EO) 0x0006) /* A B signed */ 412 #define TPM2_EO_UNSIGNED_GE ((TPM2_EO) 0x0007) /* A B unsigned */ 413 #define TPM2_EO_SIGNED_LE ((TPM2_EO) 0x0008) /* A B signed */ 414 #define TPM2_EO_UNSIGNED_LE ((TPM2_EO) 0x0009) /* A B unsigned */ 415 #define TPM2_EO_BITSET ((TPM2_EO) 0x000A) /* All bits SET in B are SET in A. ABB */ 416 #define TPM2_EO_BITCLEAR ((TPM2_EO) 0x000B) /* All bits SET in B are CLEAR in A. AB0 */ 417 418 /* Definition of UINT16 TPM2_ST Constants <INOUT S> */ 419 typedef UINT16 TPM2_ST; 420 #define TPM2_ST_RSP_COMMAND ((TPM2_ST) 0x00C4) /* Tag value for a response used when there is an error in the tag. This is also the value returned from a TPM 1.2 when an error occurs. This value is used in this specification because an error in the command tag may prevent determination of the family. When this tag is used in the response the response code will be TPM2_RC_BAD_TAG 0 1E16 which has the same numeric value as the TPM 1.2 response code for TPM_BADTAG. NOTE In a previously published version of this specification TPM2_RC_BAD_TAG was incorrectly assigned a value of 0x030 instead of 30 0x01e. Some implementations my return the old value instead of the new value. */ 421 #define TPM2_ST_NULL ((TPM2_ST) 0X8000) /* no structure type specified */ 422 #define TPM2_ST_NO_SESSIONS ((TPM2_ST) 0x8001) /* tag value for a command response for a command defined in this specification indicating that the command response has no attached sessions and no authorizationSizeparameterSize value is present. If the responseCode from the TPM is not TPM2_RC_SUCCESS then the response tag shall have this value. */ 423 #define TPM2_ST_SESSIONS ((TPM2_ST) 0x8002) /* tag value for a command response for a command defined in this specification indicating that the command response has one or more attached sessions and the authorizationSizeparameterSize field is present */ 424 #define TPM2_ST_RESERVED1 ((TPM2_ST) 0x8003) /* When used between application software and the TPM resource manager, this tag indicates that the command has no sessions and the handles are using the Name format rather than the 32-bit handle format. NOTE 1 The response to application software will have a tag of TPM2_ST_NO_SESSIONS. Between the TRM and TPM, this tag would occur in a response from a TPM that overlaps the tag parameter of a request with the tag parameter of a response when the response has no associated sessions. NOTE 2 This tag is not used by all TPM or TRM implementations. */ 425 #define TPM2_ST_RESERVED2 ((TPM2_ST) 0x8004) /* When used between application software and the TPM resource manager. This tag indicates that the command has sessions and the handles are using the Name format rather than the 32-bit handle format. NOTE 1 If the command completes successfully the response to application software will have a tag of TPM2_ST_SESSIONS. Between the TRM and TPM would occur in a response from a TPM that overlaps the tag parameter of a request with the tag parameter of a response when the response has authorization sessions. NOTE 2 This tag is not used by all TPM or TRM implementations. */ 426 #define TPM2_ST_ATTEST_NV ((TPM2_ST) 0x8014) /* tag for an attestation structure */ 427 #define TPM2_ST_ATTEST_COMMAND_AUDIT ((TPM2_ST) 0x8015) /* tag for an attestation structure */ 428 #define TPM2_ST_ATTEST_SESSION_AUDIT ((TPM2_ST) 0x8016) /* tag for an attestation structure */ 429 #define TPM2_ST_ATTEST_CERTIFY ((TPM2_ST) 0x8017) /* tag for an attestation structure */ 430 #define TPM2_ST_ATTEST_QUOTE ((TPM2_ST) 0x8018) /* tag for an attestation structure */ 431 #define TPM2_ST_ATTEST_TIME ((TPM2_ST) 0x8019) /* tag for an attestation structure */ 432 #define TPM2_ST_ATTEST_CREATION ((TPM2_ST) 0x801A) /* tag for an attestation structure */ 433 #define TPM2_ST_RESERVED3 ((TPM2_ST) 0x801B) /* do not use . NOTE This was previously assigned to TPM2_ST_ATTEST_NV. The tag is changed because the structure has changed */ 434 #define TPM2_ST_CREATION ((TPM2_ST) 0x8021) /* tag for a ticket type */ 435 #define TPM2_ST_VERIFIED ((TPM2_ST) 0x8022) /* tag for a ticket type */ 436 #define TPM2_ST_AUTH_SECRET ((TPM2_ST) 0x8023) /* tag for a ticket type */ 437 #define TPM2_ST_HASHCHECK ((TPM2_ST) 0x8024) /* tag for a ticket type */ 438 #define TPM2_ST_AUTH_SIGNED ((TPM2_ST) 0x8025) /* tag for a ticket type */ 439 #define TPM2_ST_FU_MANIFEST ((TPM2_ST) 0x8029) /* tag for a structure describing a Field Upgrade Policy */ 440 441 /* Definition of UINT16 TPM2_SU Constants <IN> */ 442 typedef UINT16 TPM2_SU; 443 #define TPM2_SU_CLEAR ((TPM2_SU) 0x0000) /* On TPM2_Shutdown indicates that the TPM should prepare for loss of power and save state required for an orderly startup TPM Reset. On TPM2_Startup indicates that the TPM should perform TPM Reset or TPM Restart */ 444 #define TPM2_SU_STATE ((TPM2_SU) 0x0001) /* On TPM2_Shutdown indicates that the TPM should prepare for loss of power and save state required for an orderly startup. TPM Restart or TPM Resume on TPM2_Startup indicates that the TPM should restore the state saved by TPM2_Shutdown TPM2_SU_STATE */ 445 446 /* Definition of UINT8 TPM2_SE Constants <IN> */ 447 typedef UINT8 TPM2_SE; 448 #define TPM2_SE_HMAC ((TPM2_SE) 0x00) 449 #define TPM2_SE_POLICY ((TPM2_SE) 0x01) 450 #define TPM2_SE_TRIAL ((TPM2_SE) 0x03) /* The policy session is being used to compute the policyHash and not for command authorization.This setting modifies some policy commands and prevents session from being used to authorize a command. */ 451 452 /* Definition of UINT32 TPM2_CAP Constants */ 453 typedef UINT32 TPM2_CAP; 454 #define TPM2_CAP_FIRST ((TPM2_CAP) 0x00000000) 455 #define TPM2_CAP_ALGS ((TPM2_CAP) 0x00000000) /* TPM2_ALG_ID1 */ 456 #define TPM2_CAP_HANDLES ((TPM2_CAP) 0x00000001) /* TPM2_HANDLE */ 457 #define TPM2_CAP_COMMANDS ((TPM2_CAP) 0x00000002) /* TPM2_CC */ 458 #define TPM2_CAP_PP_COMMANDS ((TPM2_CAP) 0x00000003) /* TPM2_CC */ 459 #define TPM2_CAP_AUDIT_COMMANDS ((TPM2_CAP) 0x00000004) /* TPM2_CC */ 460 #define TPM2_CAP_PCRS ((TPM2_CAP) 0x00000005) /* reserved */ 461 #define TPM2_CAP_TPM_PROPERTIES ((TPM2_CAP) 0x00000006) /* TPM2_PT */ 462 #define TPM2_CAP_PCR_PROPERTIES ((TPM2_CAP) 0x00000007) /* TPM2_PT_PCR */ 463 #define TPM2_CAP_ECC_CURVES ((TPM2_CAP) 0x00000008) /* TPM2_ECC_CURVE1 */ 464 #define TPM2_CAP_LAST ((TPM2_CAP) 0x00000008) 465 #define TPM2_CAP_VENDOR_PROPERTY ((TPM2_CAP) 0x00000100) /* manufacturer specific */ 466 467 /* Definition of UINT32 TPM2_PT Constants <INOUT S> */ 468 typedef UINT32 TPM2_PT; 469 #define TPM2_PT_NONE ((TPM2_PT) 0x00000000) /* indicates no property type */ 470 #define TPM2_PT_GROUP ((TPM2_PT) 0x00000100) /* The number of properties in each group. NOTE The first group with any properties is group 1 TPM2_PT_GROUP * 1. Group 0 is reserved. */ 471 #define TPM2_PT_FIXED ((TPM2_PT) (TPM2_PT_GROUP * 1)) /* the group of fixed properties returned as TPMS_TAGGED_PROPERTY. The values in this group are only changed due to a firmware change in the TPM. */ 472 #define TPM2_PT_FAMILY_INDICATOR ((TPM2_PT) (TPM2_PT_FIXED + 0)) /* a 4-octet character string containing the TPM Family value TPM2_SPEC_FAMILY */ 473 #define TPM2_PT_LEVEL ((TPM2_PT) (TPM2_PT_FIXED + 1)) /* the level of the specification. NOTE 1 For this specification the level is zero. NOTE 2 The level is on the title page of the specification. */ 474 #define TPM2_PT_REVISION ((TPM2_PT) (TPM2_PT_FIXED + 2)) /* the specification Revision times 100. EXAMPLE Revision 01.01 would have a value of 101. NOTE The Revision value is on the title page of the specification. */ 475 #define TPM2_PT_DAY_OF_YEAR ((TPM2_PT) (TPM2_PT_FIXED + 3)) /* the specification day of year using TCG calendar. EXAMPLE November 15 2010 has a day of year value of 319 00 00 01 3F16. NOTE The specification date is on the title page of the specification. */ 476 #define TPM2_PT_YEAR ((TPM2_PT) (TPM2_PT_FIXED + 4)) /* the specification year using the CE. EXAMPLE The year 2010 has a value of 00 00 07 DA16. NOTE The specification date is on the title page of the specification. */ 477 #define TPM2_PT_MANUFACTURER ((TPM2_PT) (TPM2_PT_FIXED + 5)) /* the vendor ID unique to each TPM manufacturer */ 478 #define TPM2_PT_VENDOR_STRING_1 ((TPM2_PT) (TPM2_PT_FIXED + 6)) /* the first four characters of the vendor ID string. NOTE When the vendor string is fewer than 16 octets the additional property values do not have to be present. A vendor string of 4 octets can be represented in one 32-bit value and no null terminating character is required. */ 479 #define TPM2_PT_VENDOR_STRING_2 ((TPM2_PT) (TPM2_PT_FIXED + 7)) /* the second four characters of the vendor ID string */ 480 #define TPM2_PT_VENDOR_STRING_3 ((TPM2_PT) (TPM2_PT_FIXED + 8)) /* the third four characters of the vendor ID string */ 481 #define TPM2_PT_VENDOR_STRING_4 ((TPM2_PT) (TPM2_PT_FIXED + 9)) /* the fourth four characters of the vendor ID sting */ 482 #define TPM2_PT_VENDOR_TPM_TYPE ((TPM2_PT) (TPM2_PT_FIXED + 10)) /* vendor defined value indicating the TPM model */ 483 #define TPM2_PT_FIRMWARE_VERSION_1 ((TPM2_PT) (TPM2_PT_FIXED + 11)) /* the most significant 32 bits of a TPM vendor-specific value indicating the version number of the firmware. See 10.12.2 and 10.12.8. */ 484 #define TPM2_PT_FIRMWARE_VERSION_2 ((TPM2_PT) (TPM2_PT_FIXED + 12)) /* the least significant 32 bits of a TPM vendor-specific value indicating the version number of the firmware. See 10.12.2 and 10.12.8. */ 485 #define TPM2_PT_INPUT_BUFFER ((TPM2_PT) (TPM2_PT_FIXED + 13)) /* the maximum size of a parameter typically a TPM2B_MAX_BUFFER */ 486 #define TPM2_PT_HR_TRANSIENT_MIN ((TPM2_PT) (TPM2_PT_FIXED + 14)) /* the minimum number of transient objects that can be held in TPM RAM. NOTE This minimum shall be no less than the minimum value required by the platforms-pecific specification to which the TPM is built. */ 487 #define TPM2_PT_HR_PERSISTENT_MIN ((TPM2_PT) (TPM2_PT_FIXED + 15)) /* the minimum number of persistent objects that can be held in TPM NV memory. NOTE This minimum shall be no less than the minimum value required by the platform-specific specification to which the TPM is built. */ 488 #define TPM2_PT_HR_LOADED_MIN ((TPM2_PT) (TPM2_PT_FIXED + 16)) /* the minimum number of authorization sessions that can be held in TPM RAM . NOTE This minimum shall be no less than the minimum value required by the platform-specific specification to which the TPM is built. */ 489 #define TPM2_PT_ACTIVE_SESSIONS_MAX ((TPM2_PT) (TPM2_PT_FIXED + 17)) /* the number of authorization sessions that may be active at a time. A session is active when it has a context associated with its handle. The context may either be in TPM RAM or be context saved. NOTE This value shall be no less than the minimum value required by the platform-specific specification to which the TPM is built. */ 490 #define TPM2_PT_PCR_COUNT ((TPM2_PT) (TPM2_PT_FIXED + 18)) /* the number of PCR implemented. NOTE This number is determined by the defined attributes not the number of PCR that are populated. */ 491 #define TPM2_PT_PCR_SELECT_MIN ((TPM2_PT) (TPM2_PT_FIXED + 19)) /* the minimum number of octets in a TPMS_PCR_SELECT.sizeofSelect. NOTE This value is not determined by the number of PCR implemented but by the number of PCR required by the platform-specific specification with which the TPM is compliant or by the implementer if not adhering to a platform-specific specification. */ 492 #define TPM2_PT_CONTEXT_GAP_MAX ((TPM2_PT) (TPM2_PT_FIXED + 20)) /* the maximum allowed difference unsigned between the contextID values of two saved session contexts. This value shall be 2n1 where n is at least 16. */ 493 #define TPM2_PT_NV_COUNTERS_MAX ((TPM2_PT) (TPM2_PT_FIXED + 22)) /* the maximum number of NV Indexes that are allowed to have the TPM2_NT_COUNTER attribute. NOTE It is allowed for this value to be larger than the number of NV Indexes that can be defined. This would be indicative of a TPM implementation that did not use different implementation technology for different NV Index types. */ 494 #define TPM2_PT_NV_INDEX_MAX ((TPM2_PT) (TPM2_PT_FIXED + 23)) /* the maximum size of an NV Index data area */ 495 #define TPM2_PT_MEMORY ((TPM2_PT) (TPM2_PT_FIXED + 24)) /* a TPMA_MEMORY indicating the memory management method for the TPM */ 496 #define TPM2_PT_CLOCK_UPDATE ((TPM2_PT) (TPM2_PT_FIXED + 25)) /* interval in milliseconds between updates to the copy of TPMS_CLOCK_INFO.clock in NV */ 497 #define TPM2_PT_CONTEXT_HASH ((TPM2_PT) (TPM2_PT_FIXED + 26)) /* the algorithm used for the integrity HMAC on saved contexts and for hashing the fuData of TPM2_FirmwareRead */ 498 #define TPM2_PT_CONTEXT_SYM ((TPM2_PT) (TPM2_PT_FIXED + 27)) /* TPM2_ALG_ID the algorithm used for encryption of saved contexts */ 499 #define TPM2_PT_CONTEXT_SYM_SIZE ((TPM2_PT) (TPM2_PT_FIXED + 28)) /* TPM2_KEY_BITS the size of the key used for encryption of saved contexts */ 500 #define TPM2_PT_ORDERLY_COUNT ((TPM2_PT) (TPM2_PT_FIXED + 29)) /* the modulus 1 of the count for NV update of an orderly counter. The returned value is MAX_ORDERLY_COUNT. This will have a value of 2N 1 where 1 N 32. NOTE An orderly counter is an NV Index with an TPM2_NT of TPM_NV_COUNTER and TPMA_NV_ORDERLY SET. NOTE When the low-order bits of a counter equal this value an NV write occurs on the next increment. */ 501 #define TPM2_PT_MAX_COMMAND_SIZE ((TPM2_PT) (TPM2_PT_FIXED + 30)) /* the maximum value for commandSize in a command */ 502 #define TPM2_PT_MAX_RESPONSE_SIZE ((TPM2_PT) (TPM2_PT_FIXED + 31)) /* the maximum value for responseSize in a response */ 503 #define TPM2_PT_MAX_DIGEST ((TPM2_PT) (TPM2_PT_FIXED + 32)) /* the maximum size of a digest that can be produced by the TPM */ 504 #define TPM2_PT_MAX_OBJECT_CONTEXT ((TPM2_PT) (TPM2_PT_FIXED + 33)) /* the maximum size of an object context that will be returned by TPM2_ContextSave */ 505 #define TPM2_PT_MAX_SESSION_CONTEXT ((TPM2_PT) (TPM2_PT_FIXED + 34)) /* the maximum size of a session context that will be returned by TPM2_ContextSave */ 506 #define TPM2_PT_PS_FAMILY_INDICATOR ((TPM2_PT) (TPM2_PT_FIXED + 35)) /* platform-specific family. A TPM2_PS value. See Table 25. NOTE The platform-specific values for the TPM2_PT_PS parameters are in the relevant platform-specific specification. In the reference implementation all of these values are 0. */ 507 #define TPM2_PT_PS_LEVEL ((TPM2_PT) (TPM2_PT_FIXED + 36)) /* the level of the platform-specific specification */ 508 #define TPM2_PT_PS_REVISION ((TPM2_PT) (TPM2_PT_FIXED + 37)) /* the specification Revision times 100 for the platform-specific specification */ 509 #define TPM2_PT_PS_DAY_OF_YEAR ((TPM2_PT) (TPM2_PT_FIXED + 38)) /* the platform-specific specification day of year using TCG calendar */ 510 #define TPM2_PT_PS_YEAR ((TPM2_PT) (TPM2_PT_FIXED + 39)) /* the platform-specific specification year using the CE */ 511 #define TPM2_PT_SPLIT_MAX ((TPM2_PT) (TPM2_PT_FIXED + 40)) /* the number of split signing operations supported by the TPM */ 512 #define TPM2_PT_TOTAL_COMMANDS ((TPM2_PT) (TPM2_PT_FIXED + 41)) /* total number of commands implemented in the TPM */ 513 #define TPM2_PT_LIBRARY_COMMANDS ((TPM2_PT) (TPM2_PT_FIXED + 42)) /* number of commands from the TPM library that are implemented */ 514 #define TPM2_PT_VENDOR_COMMANDS ((TPM2_PT) (TPM2_PT_FIXED + 43)) /* number of vendor commands that are implemented */ 515 #define TPM2_PT_NV_BUFFER_MAX ((TPM2_PT) (TPM2_PT_FIXED + 44)) /* the maximum data size in one NV write command */ 516 #define TPM2_PT_MODES ((TPM2_PT) (TPM2_PT_FIXED + 45)) /* a TPMA_MODES value indicating that the TPM is designed for these modes. */ 517 #define TPM2_PT_MAX_CAP_BUFFER ((TPM2_PT) (TPM2_PT_FIXED + 46)) /* the maximum size of a TPMS_CAPABILITY_DATA structure returned in TPM2_GetCapability(). */ 518 #define TPM2_PT_VAR ((TPM2_PT) (TPM2_PT_GROUP * 2)) /* the group of variable properties returned as TPMS_TAGGED_PROPERTY. The properties in this group change because of a Protected Capability other than a firmware update. The values are not necessarily persistent across all power transitions. */ 519 #define TPM2_PT_PERMANENT ((TPM2_PT) (TPM2_PT_VAR + 0)) /* TPMA_PERMANENT */ 520 #define TPM2_PT_STARTUP_CLEAR ((TPM2_PT) (TPM2_PT_VAR + 1)) /* TPMA_STARTUP_CLEAR */ 521 #define TPM2_PT_HR_NV_INDEX ((TPM2_PT) (TPM2_PT_VAR + 2)) /* the number of NV Indexes currently defined */ 522 #define TPM2_PT_HR_LOADED ((TPM2_PT) (TPM2_PT_VAR + 3)) /* the number of authorization sessions currently loaded into TPM RAM */ 523 #define TPM2_PT_HR_LOADED_AVAIL ((TPM2_PT) (TPM2_PT_VAR + 4)) /* the number of additional authorization sessions of any type that could be loaded into TPM RAM. This value is an estimate. If this value is at least 1 then at least one authorization session of any type may be loaded. Any command that changes the RAM memory allocation can make this estimate invalid. NOTE A valid implementation may return 1 even if more than one authorization session would fit into RAM. */ 524 #define TPM2_PT_HR_ACTIVE ((TPM2_PT) (TPM2_PT_VAR + 5)) /* the number of active authorization sessions currently being tracked by the TPMThis is the sum of the loaded and saved sessions. */ 525 #define TPM2_PT_HR_ACTIVE_AVAIL ((TPM2_PT) (TPM2_PT_VAR + 6)) /* the number of additional authorization sessions of any type that could be created. This value is an estimate. If this value is at least 1 then at least one authorization session of any type may be created. Any command that changes the RAM memory allocation can make this estimate invalid. NOTE A valid implementation may return 1 even if more than one authorization session could be created. */ 526 #define TPM2_PT_HR_TRANSIENT_AVAIL ((TPM2_PT) (TPM2_PT_VAR + 7)) /* estimate of the number of additional transient objects that could be loaded into TPM RAM. This value is an estimate. If this value is at least 1 then at least one object of any type may be loaded. Any command that changes the memory allocation can make this estimate invalid. NOTE A valid implementation may return 1 even if more than one transient object would fit into RAM. */ 527 #define TPM2_PT_HR_PERSISTENT ((TPM2_PT) (TPM2_PT_VAR + 8)) /* the number of persistent objects currently loaded into TPM NV memory */ 528 #define TPM2_PT_HR_PERSISTENT_AVAIL ((TPM2_PT) (TPM2_PT_VAR + 9)) /* the number of additional persistent objects that could be loaded into NV memory. This value is an estimate. If this value is at least 1 then at least one object of any type may be made persistent. Any command that changes the NV memory allocation can make this estimate invalid. NOTE A valid implementation may return 1 even if more than one persistent object would fit into NV memory. */ 529 #define TPM2_PT_NV_COUNTERS ((TPM2_PT) (TPM2_PT_VAR + 10)) /* the number of defined NV Indexes that have NV the TPM2_NT_COUNTER attribute */ 530 #define TPM2_PT_NV_COUNTERS_AVAIL ((TPM2_PT) (TPM2_PT_VAR + 11)) /* the number of additional NV Indexes that can be defined with their TPM2_NT of TPM_NV_COUNTER and the TPMA_NV_ORDERLY attribute SET. This value is an estimate. If this value is at least 1 then at least one NV Index may be created with a TPM2_NT of TPM_NV_COUNTER and the TPMA_NV_ORDERLY attributes. Any command that changes the NV memory allocation can make this estimate invalid. NOTE A valid implementation may return 1 even if more than one NV counter could be defined. */ 531 #define TPM2_PT_ALGORITHM_SET ((TPM2_PT) (TPM2_PT_VAR + 12)) /* code that limits the algorithms that may be used with the TPM */ 532 #define TPM2_PT_LOADED_CURVES ((TPM2_PT) (TPM2_PT_VAR + 13)) /* the number of loaded ECC curves */ 533 #define TPM2_PT_LOCKOUT_COUNTER ((TPM2_PT) (TPM2_PT_VAR + 14)) /* the current value of the lockout counter failedTries */ 534 #define TPM2_PT_MAX_AUTH_FAIL ((TPM2_PT) (TPM2_PT_VAR + 15)) /* the number of authorization failures before DA lockout is invoked */ 535 #define TPM2_PT_LOCKOUT_INTERVAL ((TPM2_PT) (TPM2_PT_VAR + 16)) /* the number of seconds before the value reported by TPM2_PT_LOCKOUT_COUNTER is decremented */ 536 #define TPM2_PT_LOCKOUT_RECOVERY ((TPM2_PT) (TPM2_PT_VAR + 17)) /* the number of seconds after a lockoutAuth failure before use of lockoutAuth may be attempted again */ 537 #define TPM2_PT_NV_WRITE_RECOVERY ((TPM2_PT) (TPM2_PT_VAR + 18)) /* number of milliseconds before the TPM will accept another command that will modify NVThis value is an approximation and may go up or down over time. */ 538 #define TPM2_PT_AUDIT_COUNTER_0 ((TPM2_PT) (TPM2_PT_VAR + 19)) /* the high-order 32 bits of the command audit counter */ 539 #define TPM2_PT_AUDIT_COUNTER_1 ((TPM2_PT) (TPM2_PT_VAR + 20)) /* the low-order 32 bits of the command audit counter */ 540 541 /* Definition of UINT32 TPM2_PT_PCR Constants <INOUT S> */ 542 typedef UINT32 TPM2_PT_PCR; 543 #define TPM2_PT_TPM2_PCR_FIRST ((TPM2_PT_PCR) 0x00000000) /* bottom of the range of TPM2_PT_PCR properties */ 544 #define TPM2_PT_PCR_SAVE ((TPM2_PT_PCR) 0x00000000) /* a SET bit in the TPMS_PCR_SELECT indicates that the PCR is saved and restored by TPM2_SU_STATE */ 545 #define TPM2_PT_PCR_EXTEND_L0 ((TPM2_PT_PCR) 0x00000001) /* a SET bit in the TPMS_PCR_SELECT indicates that the PCR may be extended from locality 0This property is only present if a locality other than 0 is implemented. */ 546 #define TPM2_PT_PCR_RESET_L0 ((TPM2_PT_PCR) 0x00000002) /* a SET bit in the TPMS_PCR_SELECT indicates that the PCR may be reset by TPM2_PCR_Reset from locality 0 */ 547 #define TPM2_PT_PCR_EXTEND_L1 ((TPM2_PT_PCR) 0x00000003) /* a SET bit in the TPMS_PCR_SELECT indicates that the PCR may be extended from locality 1 This property is only present if locality 1 is implemented. */ 548 #define TPM2_PT_PCR_RESET_L1 ((TPM2_PT_PCR) 0x00000004) /* a SET bit in the TPMS_PCR_SELECT indicates that the PCR may be reset by TPM2_PCR_Reset from locality 1This property is only present if locality 1 is implemented. */ 549 #define TPM2_PT_PCR_EXTEND_L2 ((TPM2_PT_PCR) 0x00000005) /* a SET bit in the TPMS_PCR_SELECT indicates that the PCR may be extended from locality 2 This property is only present if localities 1 and 2 are implemented. */ 550 #define TPM2_PT_PCR_RESET_L2 ((TPM2_PT_PCR) 0x00000006) /* a SET bit in the TPMS_PCR_SELECT indicates that the PCR may be reset by TPM2_PCR_Reset from locality 2This property is only present if localities 1 and 2 are implemented. */ 551 #define TPM2_PT_PCR_EXTEND_L3 ((TPM2_PT_PCR) 0x00000007) /* a SET bit in the TPMS_PCR_SELECT indicates that the PCR may be extended from locality 3This property is only present if localities 1 2 and 3 are implemented. */ 552 #define TPM2_PT_PCR_RESET_L3 ((TPM2_PT_PCR) 0x00000008) /* a SET bit in the TPMS_PCR_SELECT indicates that the PCR may be reset by TPM2_PCR_Reset from locality 3This property is only present if localities 1 2 and 3 are implemented. */ 553 #define TPM2_PT_PCR_EXTEND_L4 ((TPM2_PT_PCR) 0x00000009) /* a SET bit in the TPMS_PCR_SELECT indicates that the PCR may be extended from locality 4This property is only present if localities 1 2 3 and 4 are implemented. */ 554 #define TPM2_PT_PCR_RESET_L4 ((TPM2_PT_PCR) 0x0000000A) /* a SET bit in the TPMS_PCR_SELECT indicates that the PCR may be reset by TPM2_PCR_Reset from locality 4This property is only present if localities 1 2 3 and 4 are implemented. */ 555 /* NOTE: The values in the range 0x0000000B - 0x00000010 are reserved. 556 * They correspond to values that may be used to describe attributes 557 * associated with the extended localities (32-255). 558 * The meaning of these properties need not be the same as the meaning 559 * for the Extend and Reset properties above. 560 */ 561 #define TPM2_PT_PCR_NO_INCREMENT ((TPM2_PT_PCR) 0x00000011) /* a SET bit in the TPMS_PCR_SELECT indicates that modifications to this PCR reset or Extend will not increment the pcrUpdateCounter */ 562 #define TPM2_PT_PCR_DRTM_RESET ((TPM2_PT_PCR) 0x00000012) /* a SET bit in the TPMS_PCR_SELECT indicates that the PCR is reset by a DRTM event. These PCR are reset to 1 on TPM2_Startup and reset to 0 on a _TPM_Hash_End event following a _TPM_Hash_Start event. */ 563 #define TPM2_PT_PCR_POLICY ((TPM2_PT_PCR) 0x00000013) /* a SET bit in the TPMS_PCR_SELECT indicates that the PCR is controlled by policy. This property is only present if the TPM supports policy control of a PCR. */ 564 #define TPM2_PT_PCR_AUTH ((TPM2_PT_PCR) 0x00000014) /* a SET bit in the TPMS_PCR_SELECT indicates that the PCR is controlled by an authorization value. This property is only present if the TPM supports authorization control of a PCR. */ 565 #define TPM2_PT_TPM2_PCR_LAST ((TPM2_PT_PCR) 0x00000014) /* top of the range of TPM2_PT_PCR properties of the implementation. If the TPM receives a request for a PCR property with a value larger than this the TPM will return a zero length list and set the moreData parameter to NO. NOTE This is an implementation-specific value. The value shown reflects the reference code implementation. */ 566 /* NOTE: The following values are reserved: 567 * 0x00000015 is reserved for the next 2nd TPM2_PT_PCR_POLICY set. 568 * 0x00000016 is reserved for the next 2nd TPM2_PT_PCR_AUTH set. 569 * 0x00000017 - 0x00000210 are reserved for the 2nd through 255th TPM2_PT_PCR_POLICY and TPM2_PT_PCR_AUTH values. 570 * 0x00000211 is reserved to the 256th and highest allowed TPM2_PT_PCR_POLICY set. 571 * 0x00000212 is reserved to the 256th and highest allowed TPM2_PT_PCR_AUTH set. 572 * A new PCR property values may be assigned starting with value 0x00000213. 573 */ 574 575 /* Definition of UINT32 TPM2_PS Constants <OUT> */ 576 typedef UINT32 TPM2_PS; 577 #define TPM2_PS_MAIN ((TPM2_PS) 0x00000000) /* not platform-specific */ 578 #define TPM2_PS_PC ((TPM2_PS) 0x00000001) /* PC Client */ 579 #define TPM2_PS_PDA ((TPM2_PS) 0x00000002) /* PDA includes all mobile devices that are not specifically cell phones */ 580 #define TPM2_PS_CELL_PHONE ((TPM2_PS) 0x00000003) /* Cell Phone */ 581 #define TPM2_PS_SERVER ((TPM2_PS) 0x00000004) /* Server WG */ 582 #define TPM2_PS_PERIPHERAL ((TPM2_PS) 0x00000005) /* Peripheral WG */ 583 #define TPM2_PS_TSS ((TPM2_PS) 0x00000006) /* TSS WG */ 584 #define TPM2_PS_STORAGE ((TPM2_PS) 0x00000007) /* Storage WG */ 585 #define TPM2_PS_AUTHENTICATION ((TPM2_PS) 0x00000008) /* Authentication WG */ 586 #define TPM2_PS_EMBEDDED ((TPM2_PS) 0x00000009) /* Embedded WG */ 587 #define TPM2_PS_HARDCOPY ((TPM2_PS) 0x0000000A) /* Hardcopy WG */ 588 #define TPM2_PS_INFRASTRUCTURE ((TPM2_PS) 0x0000000B) /* Infrastructure WG */ 589 #define TPM2_PS_VIRTUALIZATION ((TPM2_PS) 0x0000000C) /* Virtualization WG */ 590 #define TPM2_PS_TNC ((TPM2_PS) 0x0000000D) /* Trusted Network Connect WG */ 591 #define TPM2_PS_MULTI_TENANT ((TPM2_PS) 0x0000000E) /* Multi-tenant WG */ 592 #define TPM2_PS_TC ((TPM2_PS) 0x0000000F) /* Technical Committee */ 593 594 /* Definition of Types for Handles */ 595 typedef UINT32 TPM2_HANDLE; 596 597 /* Definition of UINT8 TPM2_HT Constants <S> */ 598 typedef UINT8 TPM2_HT; 599 #define TPM2_HT_PCR ((TPM2_HT) 0x00) /* PCR consecutive numbers starting at 0 that reference the PCR registers. A platform-specific specification will set the minimum number of PCR and an implementation may have more. */ 600 #define TPM2_HT_NV_INDEX ((TPM2_HT) 0x01) /* NV Index assigned by the caller */ 601 #define TPM2_HT_HMAC_SESSION ((TPM2_HT) 0x02) /* HMAC Authorization Session assigned by the TPM when the session is created */ 602 #define TPM2_HT_LOADED_SESSION ((TPM2_HT) 0x02) /* Loaded Authorization Session used only in the context of TPM2_GetCapability. This type references both loaded HMAC and loaded policy authorization sessions. */ 603 #define TPM2_HT_POLICY_SESSION ((TPM2_HT) 0x03) /* Policy Authorization Session assigned by the TPM when the session is created */ 604 #define TPM2_HT_SAVED_SESSION ((TPM2_HT) 0x03) /* Saved Authorization Session used only in the context of TPM2_GetCapability. This type references saved authorization session contexts for which the TPM is maintaining tracking information. */ 605 #define TPM2_HT_PERMANENT ((TPM2_HT) 0x40) /* Permanent Values assigned by this specification in */ 606 #define TPM2_HT_TRANSIENT ((TPM2_HT) 0x80) /* Transient Objects assigned by the TPM when an object is loaded into transient object memory or when a persistent object is converted to a transient object */ 607 #define TPM2_HT_PERSISTENT ((TPM2_HT) 0x81) /* Persistent Objects assigned by the TPM when a loaded transient object is made persistent */ 608 609 /* Definition of TPM2_HANDLE TPM2_RH Constants <S> */ 610 typedef TPM2_HANDLE TPM2_RH; 611 #define TPM2_RH_FIRST ((TPM2_RH) 0x40000000) /* R */ 612 #define TPM2_RH_SRK ((TPM2_RH) 0x40000000) /* R */ 613 #define TPM2_RH_OWNER ((TPM2_RH) 0x40000001) /* K A P */ 614 #define TPM2_RH_REVOKE ((TPM2_RH) 0x40000002) /* R */ 615 #define TPM2_RH_TRANSPORT ((TPM2_RH) 0x40000003) /* R */ 616 #define TPM2_RH_OPERATOR ((TPM2_RH) 0x40000004) /* R */ 617 #define TPM2_RH_ADMIN ((TPM2_RH) 0x40000005) /* R */ 618 #define TPM2_RH_EK ((TPM2_RH) 0x40000006) /* R */ 619 #define TPM2_RH_NULL ((TPM2_RH) 0x40000007) /* K A P */ 620 #define TPM2_RH_UNASSIGNED ((TPM2_RH) 0x40000008) /* R */ 621 #define TPM2_RS_PW ((TPM2_RH) 0x40000009) /* S */ 622 #define TPM2_RH_LOCKOUT ((TPM2_RH) 0x4000000A) /* A */ 623 #define TPM2_RH_ENDORSEMENT ((TPM2_RH) 0x4000000B) /* K A P */ 624 #define TPM2_RH_PLATFORM ((TPM2_RH) 0x4000000C) /* K A P */ 625 #define TPM2_RH_PLATFORM_NV ((TPM2_RH) 0x4000000D) /* C */ 626 #define TPM2_RH_AUTH_00 ((TPM2_RH) 0x40000010) /* A */ 627 #define TPM2_RH_AUTH_FF ((TPM2_RH) 0x4000010F) /* A */ 628 #define TPM2_RH_LAST ((TPM2_RH) 0x4000010F) /* R */ 629 630 /* Definition of TPM2_HANDLE TPM2_HC Constants <S> */ 631 typedef TPM2_HANDLE TPM2_HC; 632 #define TPM2_HR_HANDLE_MASK ((TPM2_HC) 0x00FFFFFF) /* to mask off the HR */ 633 #define TPM2_HR_RANGE_MASK ((TPM2_HC) 0xFF000000) /* to mask off the variable part */ 634 #define TPM2_HR_SHIFT ((TPM2_HC) 24) 635 #define TPM2_HR_PCR ((TPM2_HC) (TPM2_HT_PCR << TPM2_HR_SHIFT)) 636 #define TPM2_HR_HMAC_SESSION ((TPM2_HC) (TPM2_HT_HMAC_SESSION << TPM2_HR_SHIFT)) 637 #define TPM2_HR_POLICY_SESSION ((TPM2_HC) (TPM2_HT_POLICY_SESSION << TPM2_HR_SHIFT)) 638 #define TPM2_HR_TRANSIENT ((TPM2_HC) (TPM2_HT_TRANSIENT << TPM2_HR_SHIFT)) 639 #define TPM2_HR_PERSISTENT ((TPM2_HC) (TPM2_HT_PERSISTENT << TPM2_HR_SHIFT)) 640 #define TPM2_HR_NV_INDEX ((TPM2_HC) (TPM2_HT_NV_INDEX << TPM2_HR_SHIFT)) 641 #define TPM2_HR_PERMANENT ((TPM2_HC) (TPM2_HT_PERMANENT << TPM2_HR_SHIFT)) 642 #define TPM2_PCR_FIRST ((TPM2_HC) (TPM2_HR_PCR + 0)) /* first PCR */ 643 #define TPM2_PCR_LAST ((TPM2_HC) (TPM2_PCR_FIRST + TPM2_MAX_PCRS - 1)) /* last PCR */ 644 #define TPM2_HMAC_SESSION_FIRST ((TPM2_HC) (TPM2_HR_HMAC_SESSION + 0)) /* first HMAC session */ 645 #define TPM2_HMAC_SESSION_LAST ((TPM2_HC) (TPM2_HMAC_SESSION_FIRST + 0x00fffffe)) /* last HMAC session */ 646 #define TPM2_LOADED_SESSION_FIRST ((TPM2_HC) TPM2_HMAC_SESSION_FIRST) /* used in GetCapability */ 647 #define TPM2_LOADED_SESSION_LAST ((TPM2_HC) TPM2_HMAC_SESSION_LAST) /* used in GetCapability */ 648 #define TPM2_POLICY_SESSION_FIRST ((TPM2_HC) (TPM2_HR_POLICY_SESSION + 0)) /* first policy session */ 649 #define TPM2_POLICY_SESSION_LAST ((TPM2_HC) (TPM2_POLICY_SESSION_FIRST + 0x00fffffe)) /* last policy session */ 650 #define TPM2_TRANSIENT_FIRST ((TPM2_HC) (TPM2_HR_TRANSIENT + 0)) /* first transient object */ 651 #define TPM2_ACTIVE_SESSION_FIRST ((TPM2_HC) TPM2_POLICY_SESSION_FIRST) /* used in GetCapability */ 652 #define TPM2_ACTIVE_SESSION_LAST ((TPM2_HC) TPM2_POLICY_SESSION_LAST) /* used in GetCapability */ 653 #define TPM2_TRANSIENT_LAST ((TPM2_HC) (TPM2_TRANSIENT_FIRST + 0x00fffffe)) /* last transient object */ 654 #define TPM2_PERSISTENT_FIRST ((TPM2_HC) (TPM2_HR_PERSISTENT + 0)) /* first persistent object */ 655 #define TPM2_PERSISTENT_LAST ((TPM2_HC) (TPM2_PERSISTENT_FIRST + 0x00FFFFFF)) /* last persistent object */ 656 #define TPM2_PLATFORM_PERSISTENT ((TPM2_HC) (TPM2_PERSISTENT_FIRST + 0x00800000)) /* first platform persistent object */ 657 #define TPM2_NV_INDEX_FIRST ((TPM2_HC) (TPM2_HR_NV_INDEX + 0)) /* first allowed NV Index */ 658 #define TPM2_NV_INDEX_LAST ((TPM2_HC) (TPM2_NV_INDEX_FIRST + 0x00FFFFFF)) /* last allowed NV Index */ 659 #define TPM2_PERMANENT_FIRST ((TPM2_HC) TPM2_RH_FIRST) 660 #define TPM2_PERMANENT_LAST ((TPM2_HC) TPM2_RH_LAST) 661 662 /* Definition of UINT32 TPMA_ALGORITHM Bits */ 663 typedef uint32_t TPMA_ALGORITHM; 664 665 #define TPMA_ALGORITHM_ASYMMETRIC ((TPMA_ALGORITHM) 0x00000001) /* SET 1 an asymmetric algorithm with public and private portions. CLEAR 0 not an asymmetric algorithm */ 666 #define TPMA_ALGORITHM_SYMMETRIC ((TPMA_ALGORITHM) 0x00000002) /* SET 1 a symmetric block cipher. CLEAR 0 not a symmetric block cipher */ 667 #define TPMA_ALGORITHM_HASH ((TPMA_ALGORITHM) 0x00000004) /* SET 1 a hash algorithm. CLEAR 0 not a hash algorithm */ 668 #define TPMA_ALGORITHM_OBJECT ((TPMA_ALGORITHM) 0x00000008) /* SET 1 an algorithm that may be used as an object type. CLEAR 0 an algorithm that is not used as an object type */ 669 #define TPMA_ALGORITHM_RESERVED1_MASK ((TPMA_ALGORITHM) 0x000000F0) 670 #define TPMA_ALGORITHM_SIGNING ((TPMA_ALGORITHM) 0x00000100) /* SET 1 a signing algorithm. The setting of asymmetric symmetric and hash will indicate the type of signing algorithm. CLEAR 0 not a signing algorithm */ 671 #define TPMA_ALGORITHM_ENCRYPTING ((TPMA_ALGORITHM) 0x00000200) /* SET 1 an encryptiondecryption algorithm. The setting of asymmetric symmetric and hash will indicate the type of encryptiondecryption algorithm. CLEAR 0 not an encryption-decryption algorithm */ 672 #define TPMA_ALGORITHM_METHOD ((TPMA_ALGORITHM) 0x00000400) /* SET 1 a method such as a key derivative function KDF. CLEAR 0 not a method */ 673 #define TPMA_ALGORITHM_RESERVED2_MASK ((TPMA_ALGORITHM) 0xFFFFF800) 674 675 /* Definition of UINT32 TPMA_OBJECT Bits */ 676 typedef uint32_t TPMA_OBJECT; 677 678 #define TPMA_OBJECT_RESERVED1_MASK ((TPMA_OBJECT) 0x00000001) /* shall be zero */ 679 #define TPMA_OBJECT_FIXEDTPM ((TPMA_OBJECT) 0x00000002) /* SET 1 The hierarchy of the object as indicated by its Qualified Name may not change. CLEAR 0 The hierarchy of the object may change as a result of this object or an ancestor key being duplicated for use in another hierarchy. */ 680 #define TPMA_OBJECT_STCLEAR ((TPMA_OBJECT) 0x00000004) /* SET 1 Previously saved contexts of this object may not be loaded after StartupCLEAR. CLEAR 0 Saved contexts of this object may be used after a ShutdownSTATE and subsequent Startup. */ 681 #define TPMA_OBJECT_RESERVED2_MASK ((TPMA_OBJECT) 0x00000008) /* shall be zero */ 682 #define TPMA_OBJECT_FIXEDPARENT ((TPMA_OBJECT) 0x00000010) /* SET 1 The parent of the object may not change. CLEAR 0 The parent of the object may change as the result of a TPM2_Duplicate of the object. */ 683 #define TPMA_OBJECT_SENSITIVEDATAORIGIN ((TPMA_OBJECT) 0x00000020) /* SET 1 Indicates that when the object was created with TPM2_Create or TPM2_CreatePrimary the TPM generated all of the sensitive data other than the authValue. CLEAR 0 A portion of the sensitive data other than the authValue was provided by the caller. */ 684 #define TPMA_OBJECT_USERWITHAUTH ((TPMA_OBJECT) 0x00000040) /* SET 1 Approval of USER role actions with this object may be with an HMAC session or with a password using the authValue of the object or a policy session. CLEAR 0 Approval of USER role actions with this object may only be done with a policy session. */ 685 #define TPMA_OBJECT_ADMINWITHPOLICY ((TPMA_OBJECT) 0x00000080) /* SET 1 Approval of ADMIN role actions with this object may only be done with a policy session. CLEAR 0 Approval of ADMIN role actions with this object may be with an HMAC session or with a password using the authValue of the object or a policy session. */ 686 #define TPMA_OBJECT_RESERVED3_MASK ((TPMA_OBJECT) 0x00000300) /* shall be zero */ 687 #define TPMA_OBJECT_NODA ((TPMA_OBJECT) 0x00000400) /* SET 1 The object is not subject to dictionary attack protections. CLEAR 0 The object is subject to dictionary attack protections. */ 688 #define TPMA_OBJECT_ENCRYPTEDDUPLICATION ((TPMA_OBJECT) 0x00000800) /* SET 1 If the object is duplicated then symmetricAlg shall not be TPM2_ALG_NULL and newParentHandle shall not be TPM2_RH_NULL. CLEAR 0 The object may be duplicated without an inner wrapper on the private portion of the object and the new parent may be TPM2_RH_NULL. */ 689 #define TPMA_OBJECT_RESERVED4_MASK ((TPMA_OBJECT) 0x0000F000) /* shall be zero */ 690 #define TPMA_OBJECT_RESTRICTED ((TPMA_OBJECT) 0x00010000) /* SET 1 Key usage is restricted to manipulate structures of known format the parent of this key shall have restricted SET. CLEAR 0 Key usage is not restricted to use on special formats. */ 691 #define TPMA_OBJECT_DECRYPT ((TPMA_OBJECT) 0x00020000) /* SET 1 The private portion of the key may be used to decrypt. CLEAR 0 The private portion of the key may not be used to decrypt. */ 692 #define TPMA_OBJECT_SIGN_ENCRYPT ((TPMA_OBJECT) 0x00040000) /* SET 1 For a symmetric cipher object the private portion of the key may be used to encrypt. For other objects the private portion of the key may be used to sign. CLEAR 0 The private portion of the key may not be used to sign or encrypt. */ 693 #define TPMA_OBJECT_RESERVED5_MASK ((TPMA_OBJECT) 0xFFF80000) /* shall be zero */ 694 695 /* Definition of UINT8 TPMA_SESSION Bits <INOUT> */ 696 typedef UINT8 TPMA_SESSION; 697 698 #define TPMA_SESSION_CONTINUESESSION ((TPMA_SESSION) 0x00000001) /* SET 1 In a command this setting indicates that the session is to remain active after successful completion of the command. In a response it indicates that the session is still active. If SET in the command this attribute shall be SET in the response. CLEAR 0 In a command this setting indicates that the TPM should close the session and flush any related context when the command completes successfully. In a response it indicates that the session is closed and the context is no longer active. This attribute has no meaning for a password authorization and the TPM will allow any setting of the attribute in the command and SET the attribute in the response. This attribute will only be CLEAR in one response for a logical session. If the attribute is CLEAR the context associated with the session is no longer in use and the space is available. A session created after another session is ended may have the same handle but logically is not the same session. This attribute has no effect if the command does not complete successfully. */ 699 #define TPMA_SESSION_AUDITEXCLUSIVE ((TPMA_SESSION) 0x00000002) /* SET 1 In a command this setting indicates that the command should only be executed if the session is exclusive at the start of the command. In a response it indicates that the session is exclusive. This setting is only allowed if the audit attribute is SET TPM2_RC_ATTRIBUTES. CLEAR 0 In a command indicates that the session need not be exclusive at the start of the command. In a response indicates that the session is not exclusive. In this revision if audit is CLEAR auditExclusive must be CLEAR in the command and will be CLEAR in the response. In a future revision this bit may have a different meaning if audit is CLEAR. See Exclusive Audit Session clause in TPM 2.0 Part 1. */ 700 #define TPMA_SESSION_AUDITRESET ((TPMA_SESSION) 0x00000004) /* SET 1 In a command this setting indicates that the audit digest of the session should be initialized and the exclusive status of the session SET. This setting is only allowed if the audit attribute is SET TPM2_RC_ATTRIBUTES. CLEAR 0 In a command indicates that the audit digest should not be initialized. This bit is always CLEAR in a response. In this revision if audit is CLEAR auditReset must be clear in the command and will be CLEAR in the response. In a future revision this bit may have a different meaning if audit is CLEAR. */ 701 #define TPMA_SESSION_RESERVED1_MASK ((TPMA_SESSION) 0x00000018) /* shall be CLEAR */ 702 #define TPMA_SESSION_DECRYPT ((TPMA_SESSION) 0x00000020) /* SET 1 In a command this setting indicates that the first parameter in the command is symmetrically encrypted using the parameter encryption scheme described in TPM 2.0 Part 1. The TPM will decrypt the parameter after performing any HMAC computations and before unmarshaling the parameter. In a response the attribute is copied from the request but has no effect on the response. CLEAR 0 Session not used for encryption. For a password authorization this attribute will be CLEAR in both the command and response. This attribute may only be SET in one session per command. This attribute may be SET in a session that is not associated with a command handle. Such a session is provided for purposes of encrypting a parameter and not for authorization. This attribute may be SET in combination with any other session attributes. This attribute may only be SET if the first parameter of the command is a sized buffer TPM2B_. */ 703 #define TPMA_SESSION_ENCRYPT ((TPMA_SESSION) 0x00000040) /* SET 1 In a command this setting indicates that the TPM should use this session to encrypt the first parameter in the response. In a response it indicates that the attribute was set in the command and that the TPM used the session to encrypt the first parameter in the response using the parameter encryption scheme described in TPM 2.0 Part 1. CLEAR 0 Session not used for encryption. For a password authorization this attribute will be CLEAR in both the command and response. This attribute may only be SET in one session per command. This attribute may be SET in a session that is not associated with a command handle. Such a session is provided for purposes of encrypting a parameter and not for authorization. This attribute may only be SET if the first parameter of a response is a sized buffer TPM2B_. */ 704 #define TPMA_SESSION_AUDIT ((TPMA_SESSION) 0x00000080) /* SET 1 In a command or response this setting indicates that the session is for audit and that auditExclusive and auditReset have meaning. This session may also be used for authorization encryption or decryption. The encrypted and encrypt fields may be SET or CLEAR. CLEAR 0 Session is not used for audit. This attribute may only be SET in one session per command or response. If SET in the command then this attribute will be SET in the response. */ 705 706 /* Definition of UINT8 TPMA_LOCALITY Bits <INOUT> */ 707 typedef UINT8 TPMA_LOCALITY; 708 709 #define TPMA_LOCALITY_TPM2_LOC_ZERO ((TPMA_LOCALITY) 0x00000001) 710 #define TPMA_LOCALITY_TPM2_LOC_ONE ((TPMA_LOCALITY) 0x00000002) 711 #define TPMA_LOCALITY_TPM2_LOC_TWO ((TPMA_LOCALITY) 0x00000004) 712 #define TPMA_LOCALITY_TPM2_LOC_THREE ((TPMA_LOCALITY) 0x00000008) 713 #define TPMA_LOCALITY_TPM2_LOC_FOUR ((TPMA_LOCALITY) 0x00000010) 714 #define TPMA_LOCALITY_EXTENDED_MASK ((TPMA_LOCALITY) 0x000000E0) /* If any of these bits is set an extended locality is indicated */ 715 #define TPMA_LOCALITY_EXTENDED_SHIFT (5) 716 717 /* Definition of UINT32 TPMA_PERMANENT Bits <OUT> */ 718 typedef uint32_t TPMA_PERMANENT; 719 720 #define TPMA_PERMANENT_OWNERAUTHSET ((TPMA_PERMANENT) 0x00000001) /* SET 1 TPM2_HierarchyChangeAuth with ownerAuth has been executed since the last TPM2_Clear. CLEAR 0 ownerAuth has not been changed since TPM2_Clear. */ 721 #define TPMA_PERMANENT_ENDORSEMENTAUTHSET ((TPMA_PERMANENT) 0x00000002) /* SET 1 TPM2_HierarchyChangeAuth with endorsementAuth has been executed since the last TPM2_Clear. CLEAR 0 endorsementAuth has not been changed since TPM2_Clear. */ 722 #define TPMA_PERMANENT_LOCKOUTAUTHSET ((TPMA_PERMANENT) 0x00000004) /* SET 1 TPM2_HierarchyChangeAuth with lockoutAuth has been executed since the last TPM2_Clear. CLEAR 0 lockoutAuth has not been changed since TPM2_Clear. */ 723 #define TPMA_PERMANENT_RESERVED1_MASK ((TPMA_PERMANENT) 0x000000F8) 724 #define TPMA_PERMANENT_DISABLECLEAR ((TPMA_PERMANENT) 0x00000100) /* SET 1 TPM2_Clear is disabled. CLEAR 0 TPM2_Clear is enabled. NOTE See TPM2_ClearControl in TPM 2.0 Part 3 for details on changing this attribute. */ 725 #define TPMA_PERMANENT_INLOCKOUT ((TPMA_PERMANENT) 0x00000200) /* SET 1 The TPM is in lockout and commands that require authorization with other than Platform Authorization or Lockout Authorization will not succeed. */ 726 #define TPMA_PERMANENT_TPMGENERATEDEPS ((TPMA_PERMANENT) 0x00000400) /* SET 1 The EPS was created by the TPM. CLEAR 0 The EPS was created outside of the TPM using a manufacturer specific process. */ 727 #define TPMA_PERMANENT_RESERVED2_MASK ((TPMA_PERMANENT) 0xFFFFF800) 728 729 /* Definition of UINT32 TPMA_STARTUP_CLEAR Bits <OUT> */ 730 typedef uint32_t TPMA_STARTUP_CLEAR; 731 732 #define TPMA_STARTUP_CLEAR_PHENABLE ((TPMA_STARTUP_CLEAR) 0x00000001) /* SET 1 The platform hierarchy is enabled and platformAuth or platformPolicy may be used for authorization. CLEAR 0 platformAuth and platformPolicy may not be used for authorizations and objects in the platform hierarchy including persistent objects cannot be used. NOTE See TPM2_HierarchyControl in TPM 2.0 Part 3 for details on changing this attribute. */ 733 #define TPMA_STARTUP_CLEAR_SHENABLE ((TPMA_STARTUP_CLEAR) 0x00000002) /* SET 1 The Storage hierarchy is enabled and ownerAuth or ownerPolicy may be used for authorization. NV indices defined using owner authorization are accessible. CLEAR 0 ownerAuth and ownerPolicy may not be used for authorizations and objects in the Storage hierarchy persistent objects and NV indices defined using owner authorization cannot be used. NOTE See TPM2_HierarchyControl in TPM 2.0 Part 3 for details on changing this attribute. */ 734 #define TPMA_STARTUP_CLEAR_EHENABLE ((TPMA_STARTUP_CLEAR) 0x00000004) /* SET 1 The EPS hierarchy is enabled and Endorsement Authorization may be used to authorize commands. CLEAR 0 Endorsement Authorization may not be used for authorizations and objects in the endorsement hierarchy including persistent objects cannot be used. NOTE See TPM2_HierarchyControl in TPM 2.0 Part 3 for details on changing this attribute. */ 735 #define TPMA_STARTUP_CLEAR_PHENABLENV ((TPMA_STARTUP_CLEAR) 0x00000008) /* SET 1 NV indices that have TPMA_PLATFORM_CREATE SET may be read or written. The platform can create define and undefine indices. CLEAR 0 NV indices that have TPMA_PLATFORM_CREATE SET may not be read or written TPM2_RC_HANDLE. The platform cannot define TPM2_RC_HIERARCHY or undefined TPM2_RC_HANDLE indices. NOTE See TPM2_HierarchyControl in TPM 2.0 Part 3 for details on changing this attribute. NOTE read refers to these commands TPM2_NV_Read TPM2_NV_ReadPublic TPM_NV_Certify TPM2_PolicyNVwrite refers to these commands TPM2_NV_Write TPM2_NV_Increment TPM2_NV_Extend TPM2_NV_SetBitsNOTE The TPM must query the index TPMA_PLATFORM_CREATE attribute to determine whether phEnableNV is applicable. Since the TPM will return TPM2_RC_HANDLE if the index does not exist it also returns this error code if the index is disabled. Otherwise the TPM would leak the existence of an index even when disabled. */ 736 #define TPMA_STARTUP_CLEAR_RESERVED1_MASK ((TPMA_STARTUP_CLEAR) 0x7FFFFFF0) /* shall be zero */ 737 #define TPMA_STARTUP_CLEAR_ORDERLY ((TPMA_STARTUP_CLEAR) 0x80000000) /* SET 1 The TPM received a TPM2_Shutdown and a matching TPM2_Startup. CLEAR 0 TPM2_StartupTPM2_SU_CLEAR was not preceded by a TPM2_Shutdown of any type. NOTE A shutdown is orderly if the TPM receives a TPM2_Shutdown of any type followed by a TPM2_Startup of any type. However the TPM will return an error if TPM2_StartupTPM2_SU_STATE was not preceded by TPM2_State_SaveTPM2_SU_STATE. */ 738 739 /* Definition of UINT32 TPMA_MEMORY Bits <Out> */ 740 typedef uint32_t TPMA_MEMORY; 741 742 #define TPMA_MEMORY_SHAREDRAM ((TPMA_MEMORY) 0x00000001) /* SET 1 indicates that the RAM memory used for authorization session contexts is shared with the memory used for transient objects. CLEAR 0 indicates that the memory used for authorization sessions is not shared with memory used for transient objects */ 743 #define TPMA_MEMORY_SHAREDNV ((TPMA_MEMORY) 0x00000002) /* SET 1 indicates that the NV memory used for persistent objects is shared with the NV memory used for NV Index values. CLEAR 0 indicates that the persistent objects and NV Index values are allocated from separate sections of NV */ 744 #define TPMA_MEMORY_OBJECTCOPIEDTORAM ((TPMA_MEMORY) 0x00000004) /* SET 1 indicates that the TPM copies persistent objects to a transientobject slot in RAM when the persistent object is referenced in a command. The TRM is required to make sure that an object slot is available. CLEAR 0 indicates that the TPM does not use transientobject slots when persistent objects are referenced */ 745 #define TPMA_MEMORY_RESERVED1_MASK ((TPMA_MEMORY) 0xFFFFFFF8) /* shall be zero */ 746 747 /* Definition of TPM2_CC TPMA_CC Bits <OUT> */ 748 typedef uint32_t TPMA_CC; 749 750 #define TPMA_CC_COMMANDINDEX_MASK ((TPMA_CC) 0x0000FFFF) /* indicates the command being selected */ 751 #define TPMA_CC_COMMANDINDEX_SHIFT (0) 752 #define TPMA_CC_RESERVED1_MASK ((TPMA_CC) 0x003F0000) /* shall be zero */ 753 #define TPMA_CC_NV ((TPMA_CC) 0x00400000) /* SET 1 indicates that the command may write to NV. CLEAR 0 indicates that the command does not write to NV */ 754 #define TPMA_CC_EXTENSIVE ((TPMA_CC) 0x00800000) /* SET 1 This command could flush any number of loaded contexts. CLEAR 0 no additional changes other than indicated by the flushed attribute */ 755 #define TPMA_CC_FLUSHED ((TPMA_CC) 0x01000000) /* SET 1 The context associated with any transient handle in the command will be flushed when this command completes. CLEAR 0 No context is flushed as a side effect of this command. */ 756 #define TPMA_CC_CHANDLES_MASK ((TPMA_CC) 0x0E000000) /* indicates the number of the handles in the handle area for this command */ 757 #define TPMA_CC_CHANDLES_SHIFT (25) 758 #define TPMA_CC_RHANDLE ((TPMA_CC) 0x10000000) /* SET 1 indicates the presence of the handle area in the response */ 759 #define TPMA_CC_V ((TPMA_CC) 0x20000000) /* SET 1 indicates that the command is vendor-specific. CLEAR 0 indicates that the command is defined in a version of this specification */ 760 #define TPMA_CC_RES_MASK ((TPMA_CC) 0xC0000000) /* allocated for software shall be zero */ 761 #define TPMA_CC_RES_SHIFT (30) 762 763 /* Definition of UINT32 TPMA_MODES Bits <Out> */ 764 typedef uint32_t TPMA_MODES; 765 766 #define TPMA_MODES_FIPS_140_2 ((TPMA_MODES) 0x00000001) /* SET 1 indicates that the TPM is designed to comply with all of the FIPS 1402 requirements at Level 1 or higher. */ 767 #define TPMA_MODES_RESERVED1_MASK ((TPMA_MODES) 0xFFFFFFFE) /* shall be zero */ 768 769 /* Definition of BYTE TPMI_YES_NO Type */ 770 typedef BYTE TPMI_YES_NO; 771 #define TPM2_NO 0 /* a value of 0 */ 772 #define TPM2_YES 1 /* a value of 1 */ 773 774 /* Definition of TPM2_HANDLE TPMI_DH_OBJECT Type */ 775 typedef TPM2_HANDLE TPMI_DH_OBJECT; 776 777 /* Definition of TPM2_HANDLE TPMI_DH_PERSISTENT Type */ 778 typedef TPM2_HANDLE TPMI_DH_PERSISTENT; 779 780 /* Definition of TPM2_HANDLE TPMI_DH_ENTITY Type <IN> */ 781 typedef TPM2_HANDLE TPMI_DH_ENTITY; 782 783 /* Definition of TPM2_HANDLE TPMI_DH_PCR Type <IN> */ 784 typedef TPM2_HANDLE TPMI_DH_PCR; 785 786 /* Definition of TPM2_HANDLE TPMI_SH_AUTH_SESSION Type <INOUT> */ 787 typedef TPM2_HANDLE TPMI_SH_AUTH_SESSION; 788 789 /* Definition of TPM2_HANDLE TPMI_SH_HMAC Type <INOUT> */ 790 typedef TPM2_HANDLE TPMI_SH_HMAC; 791 792 /* Definition of TPM2_HANDLE TPMI_SH_POLICY Type <INOUT> */ 793 typedef TPM2_HANDLE TPMI_SH_POLICY; 794 795 /* Definition of TPM2_HANDLE TPMI_DH_CONTEXT Type */ 796 typedef TPM2_HANDLE TPMI_DH_CONTEXT; 797 798 /* Definition of TPM2_HANDLE TPMI_RH_HIERARCHY Type */ 799 typedef TPM2_HANDLE TPMI_RH_HIERARCHY; 800 801 /* Definition of TPM2_HANDLE TPMI_RH_ENABLES Type */ 802 typedef TPM2_HANDLE TPMI_RH_ENABLES; 803 804 /* Definition of TPM2_HANDLE TPMI_RH_HIERARCHY_AUTH Type <IN> */ 805 typedef TPM2_HANDLE TPMI_RH_HIERARCHY_AUTH; 806 807 /* Definition of TPM2_HANDLE TPMI_RH_PLATFORM Type <IN> */ 808 typedef TPM2_HANDLE TPMI_RH_PLATFORM; 809 810 /* Definition of TPM2_HANDLE TPMI_RH_OWNER Type <IN> */ 811 typedef TPM2_HANDLE TPMI_RH_OWNER; 812 813 /* Definition of TPM2_HANDLE TPMI_RH_ENDORSEMENT Type <IN> */ 814 typedef TPM2_HANDLE TPMI_RH_ENDORSEMENT; 815 816 /* Definition of TPM2_HANDLE TPMI_RH_PROVISION Type <IN> */ 817 typedef TPM2_HANDLE TPMI_RH_PROVISION; 818 819 /* Definition of TPM2_HANDLE TPMI_RH_CLEAR Type <IN> */ 820 typedef TPM2_HANDLE TPMI_RH_CLEAR; 821 822 /* Definition of TPM2_HANDLE TPMI_RH_NV_AUTH Type <IN> */ 823 typedef TPM2_HANDLE TPMI_RH_NV_AUTH; 824 825 /* Definition of TPM2_HANDLE TPMI_RH_LOCKOUT Type <IN> */ 826 typedef TPM2_HANDLE TPMI_RH_LOCKOUT; 827 828 /* Definition of TPM2_HANDLE TPMI_RH_NV_INDEX Type <INOUT> */ 829 typedef TPM2_HANDLE TPMI_RH_NV_INDEX; 830 831 /* Definition of TPM2_ALG_ID TPMI_ALG_HASH Type */ 832 typedef TPM2_ALG_ID TPMI_ALG_HASH; 833 834 /* Definition of TPM2_ALG_ID TPMI_ALG_ASYM Type */ 835 typedef TPM2_ALG_ID TPMI_ALG_ASYM; 836 837 /* Definition of TPM2_ALG_ID TPMI_ALG_SYM Type */ 838 typedef TPM2_ALG_ID TPMI_ALG_SYM; 839 840 /* Definition of TPM2_ALG_ID TPMI_ALG_SYM_OBJECT Type */ 841 typedef TPM2_ALG_ID TPMI_ALG_SYM_OBJECT; 842 843 /* Definition of TPM2_ALG_ID TPMI_ALG_SYM_MODE Type */ 844 typedef TPM2_ALG_ID TPMI_ALG_SYM_MODE; 845 846 /* Definition of TPM2_ALG_ID TPMI_ALG_KDF Type */ 847 typedef TPM2_ALG_ID TPMI_ALG_KDF; 848 849 /* Definition of TPM2_ALG_ID TPMI_ALG_SIG_SCHEME Type */ 850 typedef TPM2_ALG_ID TPMI_ALG_SIG_SCHEME; 851 852 /* Definition of TPM2_ALG_IDECC TPMI_ECC_KEY_EXCHANGE Type */ 853 typedef TPM2_ALG_ID TPMI_ECC_KEY_EXCHANGE; 854 855 /* Definition of TPM2_ST TPMI_ST_COMMAND_TAG Type */ 856 typedef TPM2_ST TPMI_ST_COMMAND_TAG; 857 858 /* Definition of TPMS_EMPTY Structure <INOUT> */ 859 typedef struct { 860 BYTE empty[1]; /* a structure with no member */ 861 } TPMS_EMPTY; 862 863 /* Definition of TPMS_ALGORITHM_DESCRIPTION Structure <OUT> */ 864 typedef struct { 865 TPM2_ALG_ID alg; /* an algorithm */ 866 TPMA_ALGORITHM attributes; /* the attributes of the algorithm */ 867 } TPMS_ALGORITHM_DESCRIPTION; 868 869 /* Definition of TPMU_HA Union <INOUT S> */ 870 typedef union { 871 BYTE sha1[TPM2_SHA1_DIGEST_SIZE]; 872 BYTE sha256[TPM2_SHA256_DIGEST_SIZE]; 873 BYTE sha384[TPM2_SHA384_DIGEST_SIZE]; 874 BYTE sha512[TPM2_SHA512_DIGEST_SIZE]; 875 BYTE sm3_256[TPM2_SM3_256_DIGEST_SIZE]; 876 } TPMU_HA; 877 878 /* Definition of TPMT_HA Structure <INOUT> */ 879 typedef struct { 880 TPMI_ALG_HASH hashAlg; /* selector of the hash contained in the digest that implies the size of the digest. NOTE The leading + on the type indicates that this structure should pass an indication to the unmarshaling function for TPMI_ALG_HASH so that TPM2_ALG_NULL will be allowed if a use of a TPMT_HA allows TPM2_ALG_NULL. */ 881 TPMU_HA digest; /* the digest data */ 882 } TPMT_HA; 883 884 /* Definition of TPM2B_DIGEST Structure */ 885 typedef struct { 886 UINT16 size; 887 BYTE buffer[sizeof(TPMU_HA)]; 888 } TPM2B_DIGEST; 889 890 /* Definition of TPM2B_DATA Structure */ 891 typedef struct { 892 UINT16 size; 893 BYTE buffer[sizeof(TPMU_HA)]; 894 } TPM2B_DATA; 895 896 /* Definition of Types for TPM2B_NONCE */ 897 typedef TPM2B_DIGEST TPM2B_NONCE; /* size limited to the same as the digest structure */ 898 899 /* Definition of Types for TPM2B_AUTH */ 900 typedef TPM2B_DIGEST TPM2B_AUTH; /* size limited to the same as the digest structure */ 901 902 /* Definition of Types for TPM2B_OPERAND */ 903 typedef TPM2B_DIGEST TPM2B_OPERAND; /* size limited to the same as the digest structure */ 904 905 /* Definition of TPM2B_EVENT Structure */ 906 typedef struct { 907 UINT16 size; 908 BYTE buffer[1024]; 909 } TPM2B_EVENT; 910 911 /* Definition of TPM2B_MAX_BUFFER Structure */ 912 typedef struct { 913 UINT16 size; 914 BYTE buffer[TPM2_MAX_DIGEST_BUFFER]; 915 } TPM2B_MAX_BUFFER; 916 917 /* Definition of TPM2B_MAX_NV_BUFFER Structure */ 918 typedef struct { 919 UINT16 size; 920 BYTE buffer[TPM2_MAX_NV_BUFFER_SIZE]; 921 } TPM2B_MAX_NV_BUFFER; 922 923 /* Definition of Types for TPM2B_TIMEOUT */ 924 typedef TPM2B_DIGEST TPM2B_TIMEOUT; /* size limited to the same as the digest structure */ 925 926 /* Definition of TPM2B_IV Structure <INOUT> */ 927 typedef struct { 928 UINT16 size; 929 BYTE buffer[TPM2_MAX_SYM_BLOCK_SIZE]; 930 } TPM2B_IV; 931 932 /* Definition of TPMU_NAME Union <> */ 933 typedef union { 934 TPMT_HA digest; /* when the Name is a digest */ 935 TPM2_HANDLE handle; /* when the Name is a handle */ 936 } TPMU_NAME; 937 938 /* Definition of TPM2B_NAME Structure */ 939 typedef struct { 940 UINT16 size; 941 BYTE name[sizeof(TPMU_NAME)]; 942 } TPM2B_NAME; 943 944 /* Definition of TPMS_PCR_SELECT Structure */ 945 typedef struct { 946 UINT8 sizeofSelect; /* the size in octets of the pcrSelect array */ 947 BYTE pcrSelect[TPM2_PCR_SELECT_MAX]; /* the bit map of selected PCR */ 948 } TPMS_PCR_SELECT; 949 950 /* Definition of TPMS_PCR_SELECTION Structure */ 951 typedef struct { 952 TPMI_ALG_HASH hash; /* the hash algorithm associated with the selection */ 953 UINT8 sizeofSelect; /* the size in octets of the pcrSelect array */ 954 BYTE pcrSelect[TPM2_PCR_SELECT_MAX]; /* the bit map of selected PCR */ 955 } TPMS_PCR_SELECTION; 956 957 /* Definition of TPMT_TK_CREATION Structure */ 958 typedef struct { 959 TPM2_ST tag; /* ticket structure tag */ 960 TPMI_RH_HIERARCHY hierarchy; /* the hierarchy containing name */ 961 TPM2B_DIGEST digest; /* This shall be the HMAC produced using a proof value of hierarchy. */ 962 } TPMT_TK_CREATION; 963 964 /* Definition of TPMT_TK_VERIFIED Structure */ 965 typedef struct { 966 TPM2_ST tag; /* ticket structure tag */ 967 TPMI_RH_HIERARCHY hierarchy; /* the hierarchy containing keyName */ 968 TPM2B_DIGEST digest; /* This shall be the HMAC produced using a proof value of hierarchy. */ 969 } TPMT_TK_VERIFIED; 970 971 /* Definition of TPMT_TK_AUTH Structure */ 972 typedef struct { 973 TPM2_ST tag; /* ticket structure tag */ 974 TPMI_RH_HIERARCHY hierarchy; /* the hierarchy of the object used to produce the ticket */ 975 TPM2B_DIGEST digest; /* This shall be the HMAC produced using a proof value of hierarchy. */ 976 } TPMT_TK_AUTH; 977 978 /* Definition of TPMT_TK_HASHCHECK Structure */ 979 typedef struct { 980 TPM2_ST tag; /* ticket structure tag */ 981 TPMI_RH_HIERARCHY hierarchy; /* the hierarchy */ 982 TPM2B_DIGEST digest; /* This shall be the HMAC produced using a proof value of hierarchy. */ 983 } TPMT_TK_HASHCHECK; 984 985 /* Definition of TPMS_ALG_PROPERTY Structure <OUT> */ 986 typedef struct { 987 TPM2_ALG_ID alg; /* an algorithm identifier */ 988 TPMA_ALGORITHM algProperties; /* the attributes of the algorithm */ 989 } TPMS_ALG_PROPERTY; 990 991 /* Definition of TPMS_TAGGED_PROPERTY Structure <OUT> */ 992 typedef struct { 993 TPM2_PT property; /* a property identifier */ 994 UINT32 value; /* the value of the property */ 995 } TPMS_TAGGED_PROPERTY; 996 997 /* Definition of TPMS_TAGGED_PCR_SELECT Structure <OUT> */ 998 typedef struct { 999 TPM2_PT_PCR tag; /* the property identifier */ 1000 UINT8 sizeofSelect; /* the size in octets of the pcrSelect array */ 1001 BYTE pcrSelect[TPM2_PCR_SELECT_MAX]; /* the bit map of PCR with the identified property */ 1002 } TPMS_TAGGED_PCR_SELECT; 1003 1004 /* Definition of TPMS_TAGGED_POLICY Structure */ 1005 typedef struct { 1006 TPM2_HANDLE handle; 1007 TPMT_HA policyHash; 1008 } TPMS_TAGGED_POLICY; 1009 1010 /* Definition of TPML_CC Structure */ 1011 typedef struct { 1012 UINT32 count; /* number of commands in the commandCode list may be 0 */ 1013 TPM2_CC commandCodes[TPM2_MAX_CAP_CC]; /* a list of command codes. The maximum only applies to a command code list in a command. The response size is limited only by the size of the parameter buffer. */ 1014 } TPML_CC; 1015 1016 /* Definition of TPML_CCA Structure <OUT> */ 1017 typedef struct { 1018 UINT32 count; /* number of values in the commandAttributes list may be 0 */ 1019 TPMA_CC commandAttributes[TPM2_MAX_CAP_CC]; /* a list of command codes attributes */ 1020 } TPML_CCA; 1021 1022 /* Definition of TPML_ALG Structure */ 1023 typedef struct { 1024 UINT32 count; /* number of algorithms in the algorithms list may be 0 */ 1025 TPM2_ALG_ID algorithms[TPM2_MAX_ALG_LIST_SIZE]; /* a list of algorithm IDs. The maximum only applies to an algorithm list in a command. The response size is limited only by the size of the parameter buffer. */ 1026 } TPML_ALG; 1027 1028 /* Definition of TPML_HANDLE Structure <OUT> */ 1029 typedef struct { 1030 UINT32 count; /* the number of handles in the list. May have a value of 0 */ 1031 TPM2_HANDLE handle[TPM2_MAX_CAP_HANDLES]; /* an array of handles */ 1032 } TPML_HANDLE; 1033 1034 /* Definition of TPML_DIGEST Structure */ 1035 typedef struct { 1036 UINT32 count; /* number of digests in the list minimum is two for TPM2_PolicyOR. */ 1037 TPM2B_DIGEST digests[8]; /* a list of digestsFor TPM2_PolicyOR all digests will have been computed using the digest of the policy session. For TPM2_PCR_Read each digest will be the size of the digest for the bank containing the PCR. */ 1038 } TPML_DIGEST; 1039 1040 /* Definition of TPML_DIGEST_VALUES Structure */ 1041 typedef struct { 1042 UINT32 count; /* number of digests in the list */ 1043 TPMT_HA digests[TPM2_NUM_PCR_BANKS]; /* a list of tagged digests */ 1044 } TPML_DIGEST_VALUES; 1045 1046 /* Definition of TPML_PCR_SELECTION Structure */ 1047 typedef struct { 1048 UINT32 count; /* number of selection structures. A value of zero is allowed. */ 1049 TPMS_PCR_SELECTION pcrSelections[TPM2_NUM_PCR_BANKS]; /* list of selections */ 1050 } TPML_PCR_SELECTION; 1051 1052 /* Definition of TPML_ALG_PROPERTY Structure <OUT> */ 1053 typedef struct { 1054 UINT32 count; /* number of algorithm properties structures. A value of zero is allowed. */ 1055 TPMS_ALG_PROPERTY algProperties[TPM2_MAX_CAP_ALGS]; /* list of properties */ 1056 } TPML_ALG_PROPERTY; 1057 1058 /* Definition of TPML_TAGGED_TPM_PROPERTY Structure <OUT> */ 1059 typedef struct { 1060 UINT32 count; /* number of properties. A value of zero is allowed. */ 1061 TPMS_TAGGED_PROPERTY tpmProperty[TPM2_MAX_TPM_PROPERTIES]; /* an array of tagged properties */ 1062 } TPML_TAGGED_TPM_PROPERTY; 1063 1064 /* Definition of TPML_TAGGED_PCR_PROPERTY Structure <OUT> */ 1065 typedef struct { 1066 UINT32 count; /* number of properties. A value of zero is allowed. */ 1067 TPMS_TAGGED_PCR_SELECT pcrProperty[TPM2_MAX_PCR_PROPERTIES]; /* a tagged PCR selection */ 1068 } TPML_TAGGED_PCR_PROPERTY; 1069 1070 /* Definition of ECC TPML_ECC_CURVE Structure <OUT> */ 1071 typedef struct { 1072 UINT32 count; /* number of curves. A value of zero is allowed. */ 1073 TPM2_ECC_CURVE eccCurves[TPM2_MAX_ECC_CURVES]; /* array of ECC curve identifiers */ 1074 } TPML_ECC_CURVE; 1075 1076 /* Implementation specific structure to hold Intel PTT specific property data. */ 1077 typedef struct { 1078 UINT32 count; /* number of properties zero is allowed. */ 1079 UINT32 property[TPM2_MAX_PTT_PROPERTIES]; /* property value */ 1080 } TPML_INTEL_PTT_PROPERTY; 1081 1082 /* Definition of TPMU_CAPABILITIES Union <OUT> */ 1083 typedef union { 1084 TPML_ALG_PROPERTY algorithms; 1085 TPML_HANDLE handles; 1086 TPML_CCA command; 1087 TPML_CC ppCommands; 1088 TPML_CC auditCommands; 1089 TPML_PCR_SELECTION assignedPCR; 1090 TPML_TAGGED_TPM_PROPERTY tpmProperties; 1091 TPML_TAGGED_PCR_PROPERTY pcrProperties; 1092 TPML_ECC_CURVE eccCurves; 1093 TPML_INTEL_PTT_PROPERTY intelPttProperty; 1094 } TPMU_CAPABILITIES; 1095 1096 /* Definition of TPMS_CAPABILITY_DATA Structure <OUT> */ 1097 typedef struct { 1098 TPM2_CAP capability; /* the capability */ 1099 TPMU_CAPABILITIES data; /* the capability data */ 1100 } TPMS_CAPABILITY_DATA; 1101 1102 /* Definition of TPMS_CLOCK_INFO Structure */ 1103 typedef struct { 1104 UINT64 clock; /* time in milliseconds during which the TPM has been powered. This structure element is used to report on the TPMs Clock value. The value of Clock shall be recorded in nonvolatile memory no less often than once per 69.9 minutes, 222 milliseconds of TPM operation. The reference for the millisecond timer is the TPM oscillator. This value is reset to zero when the Storage Primary Seed is changed TPM2_Clear. This value may be advanced by TPM2_AdvanceClock. */ 1105 UINT32 resetCount; /* number of occurrences of TPM Reset since the last TPM2_Clear */ 1106 UINT32 restartCount; /* number of times that TPM2_Shutdown or _TPM_Hash_Start have occurred since the last TPM Reset or TPM2_Clear. */ 1107 TPMI_YES_NO safe; /* no value of Clock greater than the current value of Clock has been previously reported by the TPM. Set to YES on TPM2_Clear. */ 1108 } TPMS_CLOCK_INFO; 1109 1110 /* Definition of TPMS_TIME_INFO Structure */ 1111 typedef struct { 1112 UINT64 time; /* time in milliseconds since the last _TPM_Init or TPM2_Startup. This structure element is used to report on the TPMs Time value. */ 1113 TPMS_CLOCK_INFO clockInfo; /* a structure containing the clock information */ 1114 } TPMS_TIME_INFO; 1115 1116 /* Definition of TPMS_TIME_ATTEST_INFO Structure <OUT> */ 1117 typedef struct { 1118 TPMS_TIME_INFO time; /* the Time Clock resetCount restartCount and Safe indicator */ 1119 UINT64 firmwareVersion; /* a TPM vendor-specific value indicating the version number of the firmware */ 1120 } TPMS_TIME_ATTEST_INFO; 1121 1122 /* Definition of TPMS_CERTIFY_INFO Structure <OUT> */ 1123 typedef struct { 1124 TPM2B_NAME name; /* Name of the certified object */ 1125 TPM2B_NAME qualifiedName; /* Qualified Name of the certified object */ 1126 } TPMS_CERTIFY_INFO; 1127 1128 /* Definition of TPMS_QUOTE_INFO Structure <OUT> */ 1129 typedef struct { 1130 TPML_PCR_SELECTION pcrSelect; /* information on algID PCR selected and digest */ 1131 TPM2B_DIGEST pcrDigest; /* digest of the selected PCR using the hash of the signing key */ 1132 } TPMS_QUOTE_INFO; 1133 1134 /* Definition of TPMS_COMMAND_AUDIT_INFO Structure <OUT> */ 1135 typedef struct { 1136 UINT64 auditCounter; /* the monotonic audit counter */ 1137 TPM2_ALG_ID digestAlg; /* hash algorithm used for the command audit */ 1138 TPM2B_DIGEST auditDigest; /* the current value of the audit digest */ 1139 TPM2B_DIGEST commandDigest; /* digest of the command codes being audited using digestAlg */ 1140 } TPMS_COMMAND_AUDIT_INFO; 1141 1142 /* Definition of TPMS_SESSION_AUDIT_INFO Structure <OUT> */ 1143 typedef struct { 1144 TPMI_YES_NO exclusiveSession; /* current exclusive status of the session. TRUE if all of the commands recorded in the sessionDigest were executed without any intervening TPM command that did not use this audit session */ 1145 TPM2B_DIGEST sessionDigest; /* the current value of the session audit digest */ 1146 } TPMS_SESSION_AUDIT_INFO; 1147 1148 /* Definition of TPMS_CREATION_INFO Structure <OUT> */ 1149 typedef struct { 1150 TPM2B_NAME objectName; /* Name of the object */ 1151 TPM2B_DIGEST creationHash; /* creationHash */ 1152 } TPMS_CREATION_INFO; 1153 1154 /* Definition of TPMS_NV_CERTIFY_INFO Structure <OUT> */ 1155 typedef struct { 1156 TPM2B_NAME indexName; /* Name of the NV Index */ 1157 UINT16 offset; /* the offset parameter of TPM2_NV_Certify */ 1158 TPM2B_MAX_NV_BUFFER nvContents; /* contents of the NV Index */ 1159 } TPMS_NV_CERTIFY_INFO; 1160 1161 /* Definition of TPM2_ST TPMI_ST_ATTEST Type <OUT> */ 1162 typedef TPM2_ST TPMI_ST_ATTEST; 1163 1164 /* Definition of TPMU_ATTEST Union <OUT> */ 1165 typedef union { 1166 TPMS_CERTIFY_INFO certify; 1167 TPMS_CREATION_INFO creation; 1168 TPMS_QUOTE_INFO quote; 1169 TPMS_COMMAND_AUDIT_INFO commandAudit; 1170 TPMS_SESSION_AUDIT_INFO sessionAudit; 1171 TPMS_TIME_ATTEST_INFO time; 1172 TPMS_NV_CERTIFY_INFO nv; 1173 } TPMU_ATTEST; 1174 1175 /* Definition of TPMS_ATTEST Structure <OUT> */ 1176 typedef struct { 1177 TPM2_GENERATED magic; /* the indication that this structure was created by a TPM always TPM2_GENERATED_VALUE */ 1178 TPMI_ST_ATTEST type; /* type of the attestation structure */ 1179 TPM2B_NAME qualifiedSigner; /* Qualified Name of the signing key */ 1180 TPM2B_DATA extraData; /* external information supplied by caller. NOTE A TPM2B_DATA structure provides room for a digest and a method indicator to indicate the components of the digest. The definition of this method indicator is outside the scope of this specification. */ 1181 TPMS_CLOCK_INFO clockInfo; /* Clock resetCount restartCount and Safe */ 1182 UINT64 firmwareVersion; /* TPM vendor-specific value identifying the version number of the firmware */ 1183 TPMU_ATTEST attested; /* the type-specific attestation information */ 1184 } TPMS_ATTEST; 1185 1186 /* Definition of TPM2B_ATTEST Structure <OUT> */ 1187 typedef struct { 1188 UINT16 size; 1189 BYTE attestationData[sizeof(TPMS_ATTEST)]; 1190 } TPM2B_ATTEST; 1191 1192 /* Definition of TPMS_AUTH_COMMAND Structure <IN> */ 1193 typedef struct { 1194 TPMI_SH_AUTH_SESSION sessionHandle; /* the session handle */ 1195 TPM2B_NONCE nonce; /* the session nonce may be the Empty Buffer */ 1196 TPMA_SESSION sessionAttributes; /* the session attributes */ 1197 TPM2B_AUTH hmac; /* either an HMAC a password or an EmptyAuth */ 1198 } TPMS_AUTH_COMMAND; 1199 1200 /* Definition of TPMS_AUTH_RESPONSE Structure <OUT> */ 1201 typedef struct { 1202 TPM2B_NONCE nonce; /* the session nonce may be the Empty Buffer */ 1203 TPMA_SESSION sessionAttributes; /* the session attributes */ 1204 TPM2B_AUTH hmac; /* either an HMAC or an EmptyAuth */ 1205 } TPMS_AUTH_RESPONSE; 1206 1207 /* Definition of AES TPM2_KEY_BITS TPMI_AES_KEY_BITS Type */ 1208 typedef TPM2_KEY_BITS TPMI_AES_KEY_BITS; 1209 1210 /* Definition of SM4 TPM2_KEY_BITS TPMI_SM4_KEY_BITS Type */ 1211 typedef TPM2_KEY_BITS TPMI_SM4_KEY_BITS; 1212 1213 /* Definition of CAMELLIA TPM2_KEY_BITS TPMI_CAMELLIA_KEY_BITS Type */ 1214 typedef TPM2_KEY_BITS TPMI_CAMELLIA_KEY_BITS; 1215 1216 /* Definition of TPMU_SYM_KEY_BITS Union */ 1217 typedef union { 1218 TPMI_AES_KEY_BITS aes; /* all symmetric algorithms */ 1219 TPMI_SM4_KEY_BITS sm4; /* all symmetric algorithms */ 1220 TPMI_CAMELLIA_KEY_BITS camellia; /* all symmetric algorithms */ 1221 TPM2_KEY_BITS sym; /* when selector may be any of the symmetric block ciphers */ 1222 TPMI_ALG_HASH exclusiveOr; /* overload for using xor. NOTE TPM2_ALG_NULL is not allowed */ 1223 } TPMU_SYM_KEY_BITS; 1224 1225 /* Definition of TPMU_SYM_MODE Union */ 1226 typedef union { 1227 TPMI_ALG_SYM_MODE aes; 1228 TPMI_ALG_SYM_MODE sm4; 1229 TPMI_ALG_SYM_MODE camellia; 1230 TPMI_ALG_SYM_MODE sym; /* when selector may be any of the symmetric block ciphers */ 1231 } TPMU_SYM_MODE; 1232 1233 /* Definition of TPMT_SYM_DEF Structure */ 1234 typedef struct { 1235 TPMI_ALG_SYM algorithm; /* indicates a symmetric algorithm */ 1236 TPMU_SYM_KEY_BITS keyBits; /* a supported key size */ 1237 TPMU_SYM_MODE mode; /* the mode for the key */ 1238 } TPMT_SYM_DEF; 1239 1240 /* Definition of TPMT_SYM_DEF_OBJECT Structure */ 1241 typedef struct { 1242 TPMI_ALG_SYM_OBJECT algorithm; /* selects a symmetric block cipher */ 1243 TPMU_SYM_KEY_BITS keyBits; /* the key size */ 1244 TPMU_SYM_MODE mode; /* default mode */ 1245 } TPMT_SYM_DEF_OBJECT; 1246 1247 /* Definition of TPM2B_SYM_KEY Structure */ 1248 typedef struct { 1249 UINT16 size; 1250 BYTE buffer[TPM2_MAX_SYM_KEY_BYTES]; 1251 } TPM2B_SYM_KEY; 1252 1253 /* Definition of TPMS_SYMCIPHER_PARMS Structure */ 1254 typedef struct { 1255 TPMT_SYM_DEF_OBJECT sym; /* a symmetric block cipher */ 1256 } TPMS_SYMCIPHER_PARMS; 1257 1258 /* Definition of TPM2B_SENSITIVE_DATA Structure */ 1259 typedef struct { 1260 UINT16 size; 1261 BYTE buffer[TPM2_MAX_SYM_DATA]; 1262 } TPM2B_SENSITIVE_DATA; 1263 1264 /* Definition of TPMS_SENSITIVE_CREATE Structure <IN> */ 1265 typedef struct { 1266 TPM2B_AUTH userAuth; /* the USER auth secret value */ 1267 TPM2B_SENSITIVE_DATA data; /* data to be sealed */ 1268 } TPMS_SENSITIVE_CREATE; 1269 1270 /* Definition of TPM2B_SENSITIVE_CREATE Structure <IN S> */ 1271 typedef struct { 1272 UINT16 size; 1273 TPMS_SENSITIVE_CREATE sensitive; 1274 } TPM2B_SENSITIVE_CREATE; 1275 1276 /* Definition of TPMS_SCHEME_HASH Structure */ 1277 typedef struct { 1278 TPMI_ALG_HASH hashAlg; /* the hash algorithm used to digest the message */ 1279 } TPMS_SCHEME_HASH; 1280 1281 /* Definition of ECC TPMS_SCHEME_ECDAA Structure */ 1282 typedef struct { 1283 TPMI_ALG_HASH hashAlg; /* the hash algorithm used to digest the message */ 1284 UINT16 count; /* the counter value that is used between TPM2_Commit and the sign operation */ 1285 } TPMS_SCHEME_ECDAA; 1286 1287 /* Definition of TPM2_ALG_ID TPMI_ALG_KEYEDHASH_SCHEME Type */ 1288 typedef TPM2_ALG_ID TPMI_ALG_KEYEDHASH_SCHEME; 1289 1290 /* Definition of Types for HMAC_SIG_SCHEME */ 1291 typedef TPMS_SCHEME_HASH TPMS_SCHEME_HMAC; 1292 1293 /* Definition of TPMS_SCHEME_XOR Structure */ 1294 typedef struct { 1295 TPMI_ALG_HASH hashAlg; /* the hash algorithm used to digest the message */ 1296 TPMI_ALG_KDF kdf; /* the key derivation function */ 1297 } TPMS_SCHEME_XOR; 1298 1299 /* Definition of TPMU_SCHEME_KEYEDHASH Union <INOUT S> */ 1300 typedef union { 1301 TPMS_SCHEME_HMAC hmac; /* the signing scheme */ 1302 TPMS_SCHEME_XOR exclusiveOr; /* the obfuscation scheme */ 1303 } TPMU_SCHEME_KEYEDHASH; 1304 1305 /* Definition of TPMT_KEYEDHASH_SCHEME Structure */ 1306 typedef struct { 1307 TPMI_ALG_KEYEDHASH_SCHEME scheme; /* selects the scheme */ 1308 TPMU_SCHEME_KEYEDHASH details; /* the scheme parameters */ 1309 } TPMT_KEYEDHASH_SCHEME; 1310 1311 /* Definition of RSA Types for RSA Signature Schemes */ 1312 typedef TPMS_SCHEME_HASH TPMS_SIG_SCHEME_RSASSA; 1313 typedef TPMS_SCHEME_HASH TPMS_SIG_SCHEME_RSAPSS; 1314 1315 /* Definition of ECC Types for ECC Signature Schemes */ 1316 typedef TPMS_SCHEME_HASH TPMS_SIG_SCHEME_ECDSA; /* all asymmetric signing schemes */ 1317 typedef TPMS_SCHEME_HASH TPMS_SIG_SCHEME_SM2; /* all asymmetric signing schemes */ 1318 typedef TPMS_SCHEME_HASH TPMS_SIG_SCHEME_ECSCHNORR; /* all asymmetric signing schemes */ 1319 typedef TPMS_SCHEME_ECDAA TPMS_SIG_SCHEME_ECDAA; /* schemes that need a hash and a count */ 1320 1321 /* Definition of TPMU_SIG_SCHEME Union <INOUT S> */ 1322 typedef union { 1323 TPMS_SIG_SCHEME_RSASSA rsassa; /* all signing schemes including anonymous schemes */ 1324 TPMS_SIG_SCHEME_RSAPSS rsapss; /* all signing schemes including anonymous schemes */ 1325 TPMS_SIG_SCHEME_ECDSA ecdsa; /* all signing schemes including anonymous schemes */ 1326 TPMS_SIG_SCHEME_ECDAA ecdaa; /* all signing schemes including anonymous schemes */ 1327 TPMS_SIG_SCHEME_SM2 sm2; /* all signing schemes including anonymous schemes */ 1328 TPMS_SIG_SCHEME_ECSCHNORR ecschnorr; /* all signing schemes including anonymous schemes */ 1329 TPMS_SCHEME_HMAC hmac; /* the HMAC scheme */ 1330 TPMS_SCHEME_HASH any; /* selector that allows access to digest for any signing scheme */ 1331 } TPMU_SIG_SCHEME; 1332 1333 /* Definition of TPMT_SIG_SCHEME Structure */ 1334 typedef struct { 1335 TPMI_ALG_SIG_SCHEME scheme; /* scheme selector */ 1336 TPMU_SIG_SCHEME details; /* scheme parameters */ 1337 } TPMT_SIG_SCHEME; 1338 1339 /* Definition of Types for RSA Encryption Schemes */ 1340 typedef TPMS_SCHEME_HASH TPMS_ENC_SCHEME_OAEP; /* schemes that only need a hash */ 1341 typedef TPMS_EMPTY TPMS_ENC_SCHEME_RSAES; /* schemes that need nothing */ 1342 1343 /* Definition of Types for ECC ECC Key Exchange */ 1344 typedef TPMS_SCHEME_HASH TPMS_KEY_SCHEME_ECDH; /* schemes that need a hash */ 1345 typedef TPMS_SCHEME_HASH TPMS_KEY_SCHEME_ECMQV; /* schemes that need a hash */ 1346 1347 /* Definition of Types for KDF Schemes */ 1348 typedef TPMS_SCHEME_HASH TPMS_SCHEME_MGF1; /* hash-based key or mask generation functions */ 1349 typedef TPMS_SCHEME_HASH TPMS_SCHEME_KDF1_SP800_56A; /* hash-based key or mask generation functions */ 1350 typedef TPMS_SCHEME_HASH TPMS_SCHEME_KDF2; /* hash-based key or mask generation functions */ 1351 typedef TPMS_SCHEME_HASH TPMS_SCHEME_KDF1_SP800_108; /* hash-based key or mask generation functions */ 1352 1353 /* Definition of TPMU_KDF_SCHEME Union <INOUT S> */ 1354 typedef union { 1355 TPMS_SCHEME_MGF1 mgf1; 1356 TPMS_SCHEME_KDF1_SP800_56A kdf1_sp800_56a; 1357 TPMS_SCHEME_KDF2 kdf2; 1358 TPMS_SCHEME_KDF1_SP800_108 kdf1_sp800_108; 1359 } TPMU_KDF_SCHEME; 1360 1361 /* Definition of TPMT_KDF_SCHEME Structure */ 1362 typedef struct { 1363 TPMI_ALG_KDF scheme; /* scheme selector */ 1364 TPMU_KDF_SCHEME details; /* scheme parameters */ 1365 } TPMT_KDF_SCHEME; 1366 1367 /* Definition of TPM2_ALG_ID TPMI_ALG_ASYM_SCHEME Type <> */ 1368 typedef TPM2_ALG_ID TPMI_ALG_ASYM_SCHEME; 1369 1370 /* Definition of TPMU_ASYM_SCHEME Union */ 1371 typedef union { 1372 TPMS_KEY_SCHEME_ECDH ecdh; 1373 TPMS_KEY_SCHEME_ECMQV ecmqv; 1374 TPMS_SIG_SCHEME_RSASSA rsassa; /* signing and anonymous signing */ 1375 TPMS_SIG_SCHEME_RSAPSS rsapss; /* signing and anonymous signing */ 1376 TPMS_SIG_SCHEME_ECDSA ecdsa; /* signing and anonymous signing */ 1377 TPMS_SIG_SCHEME_ECDAA ecdaa; /* signing and anonymous signing */ 1378 TPMS_SIG_SCHEME_SM2 sm2; /* signing and anonymous signing */ 1379 TPMS_SIG_SCHEME_ECSCHNORR ecschnorr; /* signing and anonymous signing */ 1380 TPMS_ENC_SCHEME_RSAES rsaes; /* schemes with no hash */ 1381 TPMS_ENC_SCHEME_OAEP oaep; /* schemes with no hash */ 1382 TPMS_SCHEME_HASH anySig; 1383 } TPMU_ASYM_SCHEME; 1384 1385 /* Definition of TPMT_ASYM_SCHEME Structure <> */ 1386 typedef struct { 1387 TPMI_ALG_ASYM_SCHEME scheme; /* scheme selector */ 1388 TPMU_ASYM_SCHEME details; /* scheme parameters */ 1389 } TPMT_ASYM_SCHEME; 1390 1391 /* Definition of TPM2_ALG_ID RSA TPMI_ALG_RSA_SCHEME Type */ 1392 typedef TPM2_ALG_ID TPMI_ALG_RSA_SCHEME; 1393 1394 /* Definition of RSA TPMT_RSA_SCHEME Structure */ 1395 typedef struct { 1396 TPMI_ALG_RSA_SCHEME scheme; /* scheme selector */ 1397 TPMU_ASYM_SCHEME details; /* scheme parameters */ 1398 } TPMT_RSA_SCHEME; 1399 1400 /* Definition of TPM2_ALG_ID RSA TPMI_ALG_RSA_DECRYPT Type */ 1401 typedef TPM2_ALG_ID TPMI_ALG_RSA_DECRYPT; 1402 1403 /* Definition of RSA TPMT_RSA_DECRYPT Structure */ 1404 typedef struct { 1405 TPMI_ALG_RSA_DECRYPT scheme; /* scheme selector */ 1406 TPMU_ASYM_SCHEME details; /* scheme parameters */ 1407 } TPMT_RSA_DECRYPT; 1408 1409 /* Definition of RSA TPM2B_PUBLIC_KEY_RSA Structure */ 1410 typedef struct { 1411 UINT16 size; 1412 BYTE buffer[TPM2_MAX_RSA_KEY_BYTES]; 1413 } TPM2B_PUBLIC_KEY_RSA; 1414 1415 /* Definition of RSA TPM2_KEY_BITS TPMI_RSA_KEY_BITS Type */ 1416 typedef TPM2_KEY_BITS TPMI_RSA_KEY_BITS; 1417 1418 /* Definition of RSA TPM2B_PRIVATE_KEY_RSA Structure */ 1419 typedef struct { 1420 UINT16 size; 1421 BYTE buffer[TPM2_MAX_RSA_KEY_BYTES/2]; 1422 } TPM2B_PRIVATE_KEY_RSA; 1423 1424 /* Definition of ECC TPM2B_ECC_PARAMETER Structure */ 1425 typedef struct { 1426 UINT16 size; 1427 BYTE buffer[TPM2_MAX_ECC_KEY_BYTES]; 1428 } TPM2B_ECC_PARAMETER; 1429 1430 /* Definition of ECC TPMS_ECC_POINT Structure */ 1431 typedef struct { 1432 TPM2B_ECC_PARAMETER x; /* X coordinate */ 1433 TPM2B_ECC_PARAMETER y; /* Y coordinate */ 1434 } TPMS_ECC_POINT; 1435 1436 /* Definition of ECC TPM2B_ECC_POINT Structure */ 1437 typedef struct { 1438 UINT16 size; 1439 TPMS_ECC_POINT point; 1440 } TPM2B_ECC_POINT; 1441 1442 /* Definition of TPM2_ALG_ID ECC TPMI_ALG_ECC_SCHEME Type */ 1443 typedef TPM2_ALG_ID TPMI_ALG_ECC_SCHEME; 1444 1445 /* Definition of ECC TPM2_ECC_CURVE TPMI_ECC_CURVE Type */ 1446 typedef TPM2_ECC_CURVE TPMI_ECC_CURVE; 1447 1448 /* Definition of TPMT_SIG_SCHEME ECC TPMT_ECC_SCHEME Structure */ 1449 typedef struct { 1450 TPMI_ALG_ECC_SCHEME scheme; /* scheme selector */ 1451 TPMU_ASYM_SCHEME details; /* scheme parameters */ 1452 } TPMT_ECC_SCHEME; 1453 1454 /* Definition of ECC TPMS_ALGORITHM_DETAIL_ECC Structure <OUT> */ 1455 typedef struct { 1456 TPM2_ECC_CURVE curveID; /* identifier for the curve */ 1457 UINT16 keySize; /* Size in bits of the key */ 1458 TPMT_KDF_SCHEME kdf; /* if not TPM2_ALG_NULL the required KDF and hash algorithm used in secret sharing operations */ 1459 TPMT_ECC_SCHEME sign; /* If not TPM2_ALG_NULL this is the mandatory signature scheme that is required to be used with this curve. */ 1460 TPM2B_ECC_PARAMETER p; /* Fp the modulus */ 1461 TPM2B_ECC_PARAMETER a; /* coefficient of the linear term in the curve equation */ 1462 TPM2B_ECC_PARAMETER b; /* constant term for curve equation */ 1463 TPM2B_ECC_PARAMETER gX; /* x coordinate of base point G */ 1464 TPM2B_ECC_PARAMETER gY; /* y coordinate of base point G */ 1465 TPM2B_ECC_PARAMETER n; /* order of G */ 1466 TPM2B_ECC_PARAMETER h; /* cofactor a size of zero indicates a cofactor of 1 */ 1467 } TPMS_ALGORITHM_DETAIL_ECC; 1468 1469 /* Definition of RSA TPMS_SIGNATURE_RSA Structure */ 1470 typedef struct { 1471 TPMI_ALG_HASH hash; /* the hash algorithm used to digest the message. TPM2_ALG_NULL is not allowed. */ 1472 TPM2B_PUBLIC_KEY_RSA sig; /* The signature is the size of a public key. */ 1473 } TPMS_SIGNATURE_RSA; 1474 1475 /* Definition of Types for RSA Signature */ 1476 typedef TPMS_SIGNATURE_RSA TPMS_SIGNATURE_RSASSA; 1477 typedef TPMS_SIGNATURE_RSA TPMS_SIGNATURE_RSAPSS; 1478 1479 /* Definition of ECC TPMS_SIGNATURE_ECC Structure */ 1480 typedef struct { 1481 TPMI_ALG_HASH hash; /* the hash algorithm used in the signature processTPM2_ALG_NULL is not allowed. */ 1482 TPM2B_ECC_PARAMETER signatureR; 1483 TPM2B_ECC_PARAMETER signatureS; 1484 } TPMS_SIGNATURE_ECC; 1485 1486 /* Definition of Types for ECC TPMS_SIGNATURE_ECC */ 1487 typedef TPMS_SIGNATURE_ECC TPMS_SIGNATURE_ECDSA; 1488 typedef TPMS_SIGNATURE_ECC TPMS_SIGNATURE_ECDAA; 1489 typedef TPMS_SIGNATURE_ECC TPMS_SIGNATURE_SM2; 1490 typedef TPMS_SIGNATURE_ECC TPMS_SIGNATURE_ECSCHNORR; 1491 1492 /* Definition of TPMU_SIGNATURE Union <INOUT S> */ 1493 typedef union { 1494 TPMS_SIGNATURE_RSASSA rsassa; /* all asymmetric signatures */ 1495 TPMS_SIGNATURE_RSAPSS rsapss; /* all asymmetric signatures */ 1496 TPMS_SIGNATURE_ECDSA ecdsa; /* all asymmetric signatures */ 1497 TPMS_SIGNATURE_ECDAA ecdaa; /* all asymmetric signatures */ 1498 TPMS_SIGNATURE_SM2 sm2; /* all asymmetric signatures */ 1499 TPMS_SIGNATURE_ECSCHNORR ecschnorr; /* all asymmetric signatures */ 1500 TPMT_HA hmac; /* HMAC signature required to be supported */ 1501 TPMS_SCHEME_HASH any; /* used to access the hash */ 1502 } TPMU_SIGNATURE; 1503 1504 /* Definition of TPMT_SIGNATURE Structure */ 1505 typedef struct { 1506 TPMI_ALG_SIG_SCHEME sigAlg; /* selector of the algorithm used to construct the signature */ 1507 TPMU_SIGNATURE signature; /* This shall be the actual signature information. */ 1508 } TPMT_SIGNATURE; 1509 1510 /* Definition of TPMU_ENCRYPTED_SECRET Union <S> */ 1511 typedef union { 1512 BYTE ecc[sizeof(TPMS_ECC_POINT)]; 1513 BYTE rsa[TPM2_MAX_RSA_KEY_BYTES]; 1514 BYTE symmetric[sizeof(TPM2B_DIGEST)]; 1515 BYTE keyedHash[sizeof(TPM2B_DIGEST)]; /* Any symmetrically encrypted secret value will be limited to be no larger than a digest. */ 1516 } TPMU_ENCRYPTED_SECRET; 1517 1518 /* Definition of TPM2B_ENCRYPTED_SECRET Structure */ 1519 typedef struct { 1520 UINT16 size; 1521 BYTE secret[sizeof(TPMU_ENCRYPTED_SECRET)]; 1522 } TPM2B_ENCRYPTED_SECRET; 1523 1524 /* Definition of TPM2_ALG_ID TPMI_ALG_PUBLIC Type */ 1525 typedef TPM2_ALG_ID TPMI_ALG_PUBLIC; 1526 1527 /* Definition of TPMU_PUBLIC_ID Union <INOUT S> */ 1528 typedef union { 1529 TPM2B_DIGEST keyedHash; 1530 TPM2B_DIGEST sym; 1531 TPM2B_PUBLIC_KEY_RSA rsa; 1532 TPMS_ECC_POINT ecc; 1533 } TPMU_PUBLIC_ID; 1534 1535 /* Definition of TPMS_KEYEDHASH_PARMS Structure */ 1536 typedef struct { 1537 TPMT_KEYEDHASH_SCHEME scheme; /* Indicates the signing method used for a keyedHash signing object. This field also determines the size of the data field for a data object created with TPM2_Create or TPM2_CreatePrimary. */ 1538 } TPMS_KEYEDHASH_PARMS; 1539 1540 /* Definition of TPMS_ASYM_PARMS Structure <> */ 1541 typedef struct { 1542 TPMT_SYM_DEF_OBJECT symmetric; /* the companion symmetric algorithm for a restricted decryption key and shall be set to a supported symmetric algorithm. This field is optional for keys that are not decryption keys and shall be set to TPM2_ALG_NULL if not used. */ 1543 TPMT_ASYM_SCHEME scheme; /* For a key with the sign attribute SET a valid signing scheme for the key type. For a key with the decrypt attribute SET a valid key exchange protocol. For a key with sign and decrypt attributes shall be TPM2_ALG_NULL */ 1544 } TPMS_ASYM_PARMS; 1545 1546 /* Definition of RSA TPMS_RSA_PARMS Structure */ 1547 typedef struct { 1548 TPMT_SYM_DEF_OBJECT symmetric; /* for a restricted decryption key shall be set to a supported symmetric algorithm key size and mode. if the key is not a restricted decryption key this field shall be set to TPM2_ALG_NULL. */ 1549 TPMT_RSA_SCHEME scheme; /* scheme. scheme shall before an unrestricted signing key either TPM2_ALG_RSAPSS TPM2_ALG_RSASSA or TPM2_ALG_NULLfor a restricted signing key either TPM2_ALG_RSAPSS or TPM2_ALG_RSASSA for an unrestricted decryption key TPM2_ALG_RSAES TPM2_ALG_OAEP or TPM2_ALG_NULL unless the object also has the sign attribute for a restricted decryption key TPM2_ALG_NULL. NOTE When both sign and decrypt are SET restricted shall be CLEAR and scheme shall be TPM2_ALG_NULL. */ 1550 TPMI_RSA_KEY_BITS keyBits; /* number of bits in the public modulus */ 1551 UINT32 exponent; /* the public exponent A prime number greater than 2. When zero indicates that the exponent is the default of 216 + 1 */ 1552 } TPMS_RSA_PARMS; 1553 1554 /* Definition of ECC TPMS_ECC_PARMS Structure */ 1555 typedef struct { 1556 TPMT_SYM_DEF_OBJECT symmetric; /* for a restricted decryption key shall be set to a supported symmetric algorithm key size. and mode. if the key is not a restricted decryption key this field shall be set to TPM2_ALG_NULL. */ 1557 TPMT_ECC_SCHEME scheme; /* If the sign attribute of the key is SET then this shall be a valid signing scheme. NOTE If the sign parameter in curveID indicates a mandatory scheme then this field shall have the same value. If the decrypt attribute of the key is SET then this shall be a valid key exchange scheme or TPM2_ALG_NULL. If the key is a Storage Key then this field shall be TPM2_ALG_NULL. */ 1558 TPMI_ECC_CURVE curveID; /* ECC curve ID */ 1559 TPMT_KDF_SCHEME kdf; /* an optional key derivation scheme for generating a symmetric key from a Z value. If the kdf parameter associated with curveID is not TPM2_ALG_NULL then this is required to be NULL. NOTE There are currently no commands where this parameter has effect and in the reference code this field needs to be set to TPM2_ALG_NULL. */ 1560 } TPMS_ECC_PARMS; 1561 1562 /* Definition of TPMU_PUBLIC_PARMS Union <INOUT S> */ 1563 typedef union { 1564 TPMS_KEYEDHASH_PARMS keyedHashDetail; /* sign decrypt neither */ 1565 TPMS_SYMCIPHER_PARMS symDetail; /* a symmetric block cipher */ 1566 TPMS_RSA_PARMS rsaDetail; /* decrypt + sign2 */ 1567 TPMS_ECC_PARMS eccDetail; /* decrypt + sign2 */ 1568 TPMS_ASYM_PARMS asymDetail; /* common scheme structure for RSA and ECC keys */ 1569 } TPMU_PUBLIC_PARMS; 1570 1571 /* Definition of TPMT_PUBLIC_PARMS Structure */ 1572 typedef struct { 1573 TPMI_ALG_PUBLIC type; /* the algorithm to be tested */ 1574 TPMU_PUBLIC_PARMS parameters; /* the algorithm details */ 1575 } TPMT_PUBLIC_PARMS; 1576 1577 /* Definition of TPMT_PUBLIC Structure */ 1578 typedef struct { 1579 TPMI_ALG_PUBLIC type; /* algorithm associated with this object */ 1580 TPMI_ALG_HASH nameAlg; /* algorithm used for computing the Name of the object NOTE The + indicates that the instance of a TPMT_PUBLIC may have a + to indicate that the nameAlg may be TPM2_ALG_NULL. */ 1581 TPMA_OBJECT objectAttributes; /* attributes that along with type determine the manipulations of this object */ 1582 TPM2B_DIGEST authPolicy; /* optional policy for using this key. The policy is computed using the nameAlg of the object. NOTE Shall be the Empty Policy if no authorization policy is present. */ 1583 TPMU_PUBLIC_PARMS parameters; /* the algorithm or structure details */ 1584 TPMU_PUBLIC_ID unique; /* the unique identifier of the structure. For an asymmetric key this would be the public key. */ 1585 } TPMT_PUBLIC; 1586 1587 /* Definition of TPM2B_PUBLIC Structure */ 1588 typedef struct { 1589 UINT16 size; 1590 TPMT_PUBLIC publicArea; 1591 } TPM2B_PUBLIC; 1592 1593 /* Definition of TPM2B_TEMPLATE Structure */ 1594 typedef struct { 1595 UINT16 size; 1596 BYTE buffer[sizeof(TPMT_PUBLIC)]; 1597 } TPM2B_TEMPLATE; 1598 1599 /* Definition of TPM2B_PRIVATE_VENDOR_SPECIFIC Structure<> */ 1600 typedef struct { 1601 UINT16 size; 1602 BYTE buffer[TPM2_PRIVATE_VENDOR_SPECIFIC_BYTES]; 1603 } TPM2B_PRIVATE_VENDOR_SPECIFIC; 1604 1605 /* Definition of TPMU_SENSITIVE_COMPOSITE Union <INOUT S> */ 1606 typedef union { 1607 TPM2B_PRIVATE_KEY_RSA rsa; /* a prime factor of the public key */ 1608 TPM2B_ECC_PARAMETER ecc; /* the integer private key */ 1609 TPM2B_SENSITIVE_DATA bits; /* the private data */ 1610 TPM2B_SYM_KEY sym; /* the symmetric key */ 1611 TPM2B_PRIVATE_VENDOR_SPECIFIC any; /* vendor-specific size for key storage */ 1612 } TPMU_SENSITIVE_COMPOSITE; 1613 1614 /* Definition of TPMT_SENSITIVE Structure */ 1615 typedef struct { 1616 TPMI_ALG_PUBLIC sensitiveType; /* identifier for the sensitive area. This shall be the same as the type parameter of the associated public area. */ 1617 TPM2B_AUTH authValue; /* user authorization data. The authValue may be a zero-length string. This value shall not be larger than the size of the digest produced by the nameAlg of the object. */ 1618 TPM2B_DIGEST seedValue; /* for asymmetric key object the optional protection seed for other objects the obfuscation value. This value shall not be larger than the size of the digest produced by nameAlg of the object. */ 1619 TPMU_SENSITIVE_COMPOSITE sensitive; /* the type-specific private data */ 1620 } TPMT_SENSITIVE; 1621 1622 /* Definition of TPM2B_SENSITIVE Structure <INOUT> */ 1623 typedef struct { 1624 UINT16 size; 1625 TPMT_SENSITIVE sensitiveArea; 1626 } TPM2B_SENSITIVE; 1627 1628 /* Definition of _PRIVATE Structure <> */ 1629 typedef struct { 1630 TPM2B_DIGEST integrityOuter; 1631 TPM2B_DIGEST integrityInner; /* could also be a TPM2B_IV */ 1632 TPM2B_SENSITIVE sensitive; /* the sensitive area */ 1633 } _PRIVATE; 1634 1635 /* Definition of TPM2B_PRIVATE Structure <INOUT S> */ 1636 typedef struct { 1637 UINT16 size; 1638 BYTE buffer[sizeof(_PRIVATE)]; 1639 } TPM2B_PRIVATE; 1640 1641 /* Definition of TPMS_ID_OBJECT Structure <> */ 1642 typedef struct { 1643 TPM2B_DIGEST integrityHMAC; /* HMAC using the nameAlg of the storage key on the target TPM */ 1644 TPM2B_DIGEST encIdentity; /* credential protector information returned if name matches the referenced objectAll of the encIdentity is encrypted including the size field. NOTE The TPM is not required to check that the size is not larger than the digest of the nameAlg. However if the size is larger the ID object may not be usable on a TPM that has no digest larger than produced by nameAlg. */ 1645 } TPMS_ID_OBJECT; 1646 1647 /* Definition of TPM2B_ID_OBJECT Structure <INOUT> */ 1648 typedef struct { 1649 UINT16 size; 1650 BYTE credential[sizeof(TPMS_ID_OBJECT)]; 1651 } TPM2B_ID_OBJECT; 1652 1653 /* Definition of UINT32 TPM2_NV_INDEX Bits <> */ 1654 typedef uint32_t TPM2_NV_INDEX; 1655 1656 #define TPM2_NV_INDEX_INDEX_MASK ((TPM2_NV_INDEX) 0x00FFFFFF) /* The Index of the NV location */ 1657 #define TPM2_NV_INDEX_INDEX_SHIFT (0) 1658 #define TPM2_NV_INDEX_RH_NV_MASK ((TPM2_NV_INDEX) 0xFF000000) /* constant value of TPM2_HT_NV_INDEX indicating the NV Index range */ 1659 #define TPM2_NV_INDEX_RH_NV_SHIFT (24) 1660 1661 /* Definition of TPM2_NT Constants */ 1662 typedef UINT8 TPM2_NT; 1663 1664 #define TPM2_NT_ORDINARY ((TPM2_NT) 0x0) /* Ordinary contains data that is opaque to the TPM that can only be modified using TPM2_NV_Write. */ 1665 #define TPM2_NT_COUNTER ((TPM2_NT) 0x1) /* Counter contains an 8-octet value that is to be used as a counter and can only be modified with TPM2_NV_Increment */ 1666 #define TPM2_NT_BITS ((TPM2_NT) 0x2) /* Bit Field contains an 8-octet value to be used as a bit field and can only be modified with TPM2_NV_SetBits. */ 1667 #define TPM2_NT_EXTEND ((TPM2_NT) 0x4) /* Extend contains a digestsized value used like a PCR. The Index can only be modified using TPM2_NV_Extend. The extend will use the nameAlg of the Index. */ 1668 #define TPM2_NT_PIN_FAIL ((TPM2_NT) 0x8) /* PIN Fail contains a pinCount that increments on a PIN authorization failure and a pinLimit */ 1669 #define TPM2_NT_PIN_PASS ((TPM2_NT) 0x9) /* PIN Pass contains a pinCount that increments on a PIN authorization success and a pinLimit */ 1670 1671 /* Definition of TPMS_NV_PIN_COUNTER_PARAMETERS Structure */ 1672 typedef struct { 1673 UINT32 pinCount; /* This counter shows the current number of successful authValue authorization attempts to access a TPM2_NT_PIN_PASS index or the current number of unsuccessful authValue authorization attempts to access a TPM2_NT_PIN_FAIL index. */ 1674 UINT32 pinLimit; /* This threshold is the value of pinCount at which the authValue authorization of the host TPM2_NT_PIN_PASS or TPM2_NT_PIN_FAIL index is locked out. */ 1675 } TPMS_NV_PIN_COUNTER_PARAMETERS; 1676 1677 /* Definition of UINT32 TPMA_NV Bits */ 1678 typedef uint32_t TPMA_NV; 1679 1680 #define TPMA_NV_PPWRITE ((TPMA_NV) 0x00000001) /* SET 1 The Index data can be written if Platform Authorization is provided. CLEAR 0 Writing of the Index data cannot be authorized with Platform Authorization. */ 1681 #define TPMA_NV_OWNERWRITE ((TPMA_NV) 0x00000002) /* SET 1 The Index data can be written if Owner Authorization is provided. CLEAR 0 Writing of the Index data cannot be authorized with Owner Authorization. */ 1682 #define TPMA_NV_AUTHWRITE ((TPMA_NV) 0x00000004) /* SET 1 Authorizations to change the Index contents that require USER role may be provided with an HMAC session or password. CLEAR 0 Authorizations to change the Index contents that require USER role may not be provided with an HMAC session or password. */ 1683 #define TPMA_NV_POLICYWRITE ((TPMA_NV) 0x00000008) /* SET 1 Authorizations to change the Index contents that require USER role may be provided with a policy session. CLEAR 0 Authorizations to change the Index contents that require USER role may not be provided with a policy session. NOTE TPM2_NV_ChangeAuth always requires that authorization be provided in a policy session. */ 1684 #define TPMA_NV_TPM2_NT_MASK ((TPMA_NV) 0x000000F0) /* The type of the index. NOTE A TPM is not required to support all TPM2_NT values */ 1685 #define TPMA_NV_TPM2_NT_SHIFT (4) 1686 #define TPMA_NV_RESERVED1_MASK ((TPMA_NV) 0x00000300) /* shall be zero. Reserved for future use */ 1687 #define TPMA_NV_POLICY_DELETE ((TPMA_NV) 0x00000400) /* SET 1 Index may not be deleted unless the authPolicy is satisfied using TPM2_NV_UndefineSpaceSpecial. CLEAR 0 Index may be deleted with proper platform or owner authorization using TPM2_NV_UndefineSpace. */ 1688 #define TPMA_NV_WRITELOCKED ((TPMA_NV) 0x00000800) /* SET 1 Index cannot be written. CLEAR 0 Index can be written. */ 1689 #define TPMA_NV_WRITEALL ((TPMA_NV) 0x00001000) /* SET 1 A partial write of the Index data is not allowed. The write size shall match the defined space size. CLEAR 0 Partial writes are allowed. This setting is required if the .dataSize of the Index is larger than NV_MAX_BUFFER_SIZE for the implementation. */ 1690 #define TPMA_NV_WRITEDEFINE ((TPMA_NV) 0x00002000) /* SET 1 TPM2_NV_WriteLock may be used to prevent further writes to this location. CLEAR 0 TPM2_NV_WriteLock does not block subsequent writes if TPMA_NV_WRITE_STCLEAR is also CLEAR. */ 1691 #define TPMA_NV_WRITE_STCLEAR ((TPMA_NV) 0x00004000) /* SET 1 TPM2_NV_WriteLock may be used to prevent further writes to this location until the next TPM Reset or TPM Restart. CLEAR 0 TPM2_NV_WriteLock does not block subsequent writes if TPMA_NV_WRITEDEFINE is also CLEAR. */ 1692 #define TPMA_NV_GLOBALLOCK ((TPMA_NV) 0x00008000) /* SET 1 If TPM2_NV_GlobalWriteLock is successful then further writes to this location are not permitted until the next TPM Reset or TPM Restart. CLEAR 0 TPM2_NV_GlobalWriteLock has no effect on the writing of the data at this Index. */ 1693 #define TPMA_NV_PPREAD ((TPMA_NV) 0x00010000) /* SET 1 The Index data can be read if Platform Authorization is provided. CLEAR 0 Reading of the Index data cannot be authorized with Platform Authorization. */ 1694 #define TPMA_NV_OWNERREAD ((TPMA_NV) 0x00020000) /* SET 1 The Index data can be read if Owner Authorization is provided. CLEAR 0 Reading of the Index data cannot be authorized with Owner Authorization. */ 1695 #define TPMA_NV_AUTHREAD ((TPMA_NV) 0x00040000) /* SET 1 The Index data may be read if the authValue is provided. CLEAR 0 Reading of the Index data cannot be authorized with the Index authValue. */ 1696 #define TPMA_NV_POLICYREAD ((TPMA_NV) 0x00080000) /* SET 1 The Index data may be read if the authPolicy is satisfied. CLEAR 0 Reading of the Index data cannot be authorized with the Index authPolicy. */ 1697 #define TPMA_NV_RESERVED2_MASK ((TPMA_NV) 0x01F00000) /* shall be zero. Reserved for future use */ 1698 #define TPMA_NV_NO_DA ((TPMA_NV) 0x02000000) /* SET 1 Authorization failures of the Index do not affect the DA logic and authorization of the Index is not blocked when the TPM is in Lockout mode. CLEAR 0 Authorization failures of the Index will increment the authorization failure counter and authorizations of this Index are not allowed when the TPM is in Lockout mode. */ 1699 #define TPMA_NV_ORDERLY ((TPMA_NV) 0x04000000) /* SET 1 NV Index state is only required to be saved when the TPM performs an orderly shutdown TPM2_Shutdown. CLEAR 0 NV Index state is required to be persistent after the command to update the Index completes successfully, that is, the NV update is synchronous with the update command. */ 1700 #define TPMA_NV_CLEAR_STCLEAR ((TPMA_NV) 0x08000000) /* SET 1 TPMA_NV_WRITTEN for the Index is CLEAR by TPM Reset or TPM Restart. CLEAR 0 TPMA_NV_WRITTEN is not changed by TPM Restart. NOTE 1 This attribute may only be SET if TPM2_NT is not TPM2_NT_COUNTER. NOTE 2 If the TPMA_NV_ORDERLY is SET TPMA_NV_WRITTEN will be CLEAR by TPM Reset. */ 1701 #define TPMA_NV_READLOCKED ((TPMA_NV) 0x10000000) /* SET 1 Reads of the Index are blocked until the next TPM Reset or TPM Restart. CLEAR 0 Reads of the Index are allowed if proper authorization is provided. */ 1702 #define TPMA_NV_WRITTEN ((TPMA_NV) 0x20000000) /* SET 1 Index has been written. CLEAR 0 Index has not been written. */ 1703 #define TPMA_NV_PLATFORMCREATE ((TPMA_NV) 0x40000000) /* SET 1 This Index may be undefined with Platform Authorization but not with Owner Authorization. CLEAR 0 This Index may be undefined using Owner Authorization but not with Platform Authorization. The TPM will validate that this attribute is SET when the Index is defined using Platform Authorization and will validate that this attribute is CLEAR when the Index is defined using Owner Authorization. */ 1704 #define TPMA_NV_READ_STCLEAR ((TPMA_NV) 0x80000000) /* SET 1 TPM2_NV_ReadLock may be used to SET TPMA_NV_READLOCKED for this Index. CLEAR 0 TPM2_NV_ReadLock has no effect on this Index. */ 1705 1706 /* Definition of TPMS_NV_PUBLIC Structure */ 1707 typedef struct { 1708 TPMI_RH_NV_INDEX nvIndex; /* the handle of the data area */ 1709 TPMI_ALG_HASH nameAlg; /* hash algorithm used to compute the name of the Index and used for the authPolicy. For an extend index the hash algorithm used for the extend. */ 1710 TPMA_NV attributes; /* the Index attributes */ 1711 TPM2B_DIGEST authPolicy; /* optional access policy for the Index. The policy is computed using the nameAlg . NOTE: this shall be the Empty Policy if no authorization policy is present. */ 1712 UINT16 dataSize; /* the size of the data area. The maximum size is implementation dependent. The minimum maximum size is platform-specific. */ 1713 } TPMS_NV_PUBLIC; 1714 1715 /* Definition of TPM2B_NV_PUBLIC Structure */ 1716 typedef struct { 1717 UINT16 size; 1718 TPMS_NV_PUBLIC nvPublic; 1719 } TPM2B_NV_PUBLIC; 1720 1721 /* Definition of TPM2B_CONTEXT_SENSITIVE Structure <INOUT> */ 1722 typedef struct { 1723 UINT16 size; 1724 BYTE buffer[TPM2_MAX_CONTEXT_SIZE]; 1725 } TPM2B_CONTEXT_SENSITIVE; 1726 1727 /* Definition of TPMS_CONTEXT_DATA Structure <INOUT S> */ 1728 typedef struct { 1729 TPM2B_DIGEST integrity; /* the integrity value */ 1730 TPM2B_CONTEXT_SENSITIVE encrypted; /* the sensitive area */ 1731 } TPMS_CONTEXT_DATA; 1732 1733 /* Definition of TPM2B_CONTEXT_DATA Structure <INOUT> */ 1734 typedef struct { 1735 UINT16 size; 1736 BYTE buffer[sizeof(TPMS_CONTEXT_DATA)]; 1737 } TPM2B_CONTEXT_DATA; 1738 1739 /* Definition of TPMS_CONTEXT Structure */ 1740 typedef struct { 1741 UINT64 sequence; /* the sequence number of the context. NOTE Transient object contexts and session contexts used different counters. */ 1742 TPMI_DH_CONTEXT savedHandle; /* a handle indicating if the context is a session object or sequence objectSee Context Handle Values */ 1743 TPMI_RH_HIERARCHY hierarchy; /* the hierarchy of the context */ 1744 TPM2B_CONTEXT_DATA contextBlob; /* the context data and integrity HMAC */ 1745 } TPMS_CONTEXT; 1746 1747 /* Definition of TPMS_CREATION_DATA Structure <OUT> */ 1748 typedef struct { 1749 TPML_PCR_SELECTION pcrSelect; /* list indicating the PCR included in pcrDigest */ 1750 TPM2B_DIGEST pcrDigest; /* digest of the selected PCR using nameAlg of the object for which this structure is being created. pcrDigest.size shall be zero if the pcrSelect list is empty. */ 1751 TPMA_LOCALITY locality; /* the locality at which the object was created */ 1752 TPM2_ALG_ID parentNameAlg; /* nameAlg of the parent */ 1753 TPM2B_NAME parentName; /* Name of the parent at time of creation. The size will match digest size associated with parentNameAlg unless it is TPM2_ALG_NULL in which case the size will be 4 and parentName will be the hierarchy handle. */ 1754 TPM2B_NAME parentQualifiedName; /* Qualified Name of the parent at the time of creationSize is the same as parentName. */ 1755 TPM2B_DATA outsideInfo; /* association with additional information added by the key creator. This will be the contents of the outsideInfo parameter in TPM2_Create or TPM2_CreatePrimary. */ 1756 } TPMS_CREATION_DATA; 1757 1758 /* Definition of TPM2B_CREATION_DATA Structure <OUT> */ 1759 typedef struct { 1760 UINT16 size; 1761 TPMS_CREATION_DATA creationData; 1762 } TPM2B_CREATION_DATA; 1763 1764 typedef UINT32 TPM_AT; 1765 1766 /* Definition of (UINT32) TPM_AT Constants. 1767 * Note: values of ((TPM_AT) 0x80000000) through 0xFFFFFFFF are reserved for vendor-specific use */ 1768 #define TPM_AT_ANY ((TPM_AT) 0x00000000) /* In a command, a non-specific request for AC information. In a response, indicates that outputData is not meaningful */ 1769 #define TPM_AT_ERROR ((TPM_AT) 0x00000001) /* Indicates a TCG defined, device-specific error */ 1770 #define TPM_AT_PV1 ((TPM_AT) 0x00000002) /* Indicates the most significant 32 bits of a pairing value for the AC */ 1771 #define TPM_AT_VEND ((TPM_AT) 0x80000000) /* Value added to a TPM_AT to indicate a vendor-specific tag value */ 1772 1773 typedef UINT32 TPM_EA; 1774 1775 #define TPM_AE_NONE ((TPM_EA)0x00000000) /* In a command, a non-specific request for AC information. In a response, indicates that outputData is not meaningful */ 1776 1777 typedef TPM2_HANDLE TPMI_RH_AC; /* Interface used to identify an attached component */ 1778 1779 /* Definition of TPMS_AC_OUTPUT Structure <OUT> */ 1780 typedef struct { 1781 TPM_AT tag; /* Indicates the contents of data */ 1782 UINT32 data; /* Data returned from the AC */ 1783 } TPMS_AC_OUTPUT; 1784 1785 /* Definition of TPML_AC_CAPABILITIES Structure <OUT> */ 1786 typedef struct { 1787 UINT32 count; /* Number of values in the acCapabilities list. May be 0 */ 1788 TPMS_AC_OUTPUT acCapabilities[TPM2_MAX_AC_CAPABILITIES]; /* List of AC values */ 1789 } TPML_AC_CAPABILITIES; 1790 #endif 1791