]> git.proxmox.com Git - mirror_edk2.git/blob - MdePkg/Include/IndustryStandard/Tpm12.h
projects / mirror_edk2.git / blob
? search:
summary | shortlog | log | commit | commitdiff | tree
blame | history | raw | HEAD
update comments and add assert for these files.
[mirror_edk2.git] / MdePkg / Include / IndustryStandard / Tpm12.h
1 /**
2 @file
3 TPM Specification data structures (TCG TPM Specification Version 1.2 Revision 94)
4 See http://trustedcomputinggroup.org for latest specification updates
5
6 Copyright (c) 2006 - 2007, Intel Corporation
7 All rights reserved. This program and the accompanying materials
8 are licensed and made available under the terms and conditions of the BSD License
9 which accompanies this distribution. The full text of the license may be found at
10 http://opensource.org/licenses/bsd-license.php
11
12 THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
13 WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
14 **/
15
16
17 #ifndef _TPM12_H_
18 #define _TPM12_H_
19
20 //
21 // The start of TPM return codes
22 //
23 #define TPM_BASE (EFI_MAX_BIT + (EFI_MAX_BIT >> 1))
24
25 //
26 // Structures are all packed on 1-byte alignment
27 //
28
29 #pragma pack (push)
30 #pragma pack (1)
31
32 //
33 // Part 2, section 2.2: Basic types & Helper redefinitions
34 //
35 typedef UINT8 TPM_AUTH_DATA_USAGE;
36 typedef UINT8 TPM_PAYLOAD_TYPE;
37 typedef UINT8 TPM_VERSION_BYTE;
38 typedef UINT16 TPM_TAG;
39 typedef UINT16 TPM_PROTOCOL_ID;
40 typedef UINT16 TPM_STARTUP_TYPE;
41 typedef UINT16 TPM_ENC_SCHEME;
42 typedef UINT16 TPM_SIG_SCHEME;
43 typedef UINT16 TPM_MIGRATE_SCHEME;
44 typedef UINT16 TPM_PHYSICAL_PRESENCE;
45 typedef UINT16 TPM_ENTITY_TYPE;
46 typedef UINT16 TPM_KEY_USAGE;
47 typedef UINT16 TPM_EK_TYPE;
48 typedef UINT16 TPM_STRUCTURE_TAG;
49 typedef UINT16 TPM_PLATFORM_SPECIFIC;
50 typedef UINT32 TPM_COMMAND_CODE;
51 typedef UINT32 TPM_CAPABILITY_AREA;
52 typedef UINT32 TPM_KEY_FLAGS;
53 typedef UINT32 TPM_ALGORITHM_ID;
54 typedef UINT32 TPM_MODIFIER_INDICATOR;
55 typedef UINT32 TPM_ACTUAL_COUNT;
56 typedef UINT32 TPM_TRANSPORT_ATTRIBUTES;
57 typedef UINT32 TPM_AUTHHANDLE;
58 typedef UINT32 TPM_DIRINDEX;
59 typedef UINT32 TPM_KEY_HANDLE;
60 typedef UINT32 TPM_PCRINDEX;
61 typedef UINT32 TPM_RESULT;
62 typedef UINT32 TPM_RESOURCE_TYPE;
63 typedef UINT32 TPM_KEY_CONTROL;
64 typedef UINT32 TPM_NV_INDEX;
65 typedef UINT32 TPM_FAMILY_ID;
66 typedef UINT32 TPM_FAMILY_VERIFICATION;
67 typedef UINT32 TPM_STARTUP_EFFECTS;
68 typedef UINT32 TPM_SYM_MODE;
69 typedef UINT32 TPM_FAMILY_FLAGS;
70 typedef UINT32 TPM_DELEGATE_INDEX;
71 typedef UINT32 TPM_CMK_DELEGATE;
72 typedef UINT32 TPM_COUNT_ID;
73 typedef UINT32 TPM_REDIT_COMMAND;
74 typedef UINT32 TPM_TRANSHANDLE;
75 typedef UINT32 TPM_HANDLE;
76 typedef UINT32 TPM_FAMILY_OPERATION;
77
78 //
79 // Part 2, section 2.2.4: Vendor specific
80 // The following defines allow for the quick specification of a
81 // vendor specific item.
82 //
83 #define TPM_Vendor_Specific32 ((UINT32) 0x00000400)
84 #define TPM_Vendor_Specific8 ((UINT8) 0x80)
85
86 //
87 // Part 2, section 3.1: Structure TAGs
88 //
89 #define TPM_TAG_CONTEXTBLOB ((TPM_STRUCTURE_TAG) 0x0001)
90 #define TPM_TAG_CONTEXT_SENSITIVE ((TPM_STRUCTURE_TAG) 0x0002)
91 #define TPM_TAG_CONTEXTPOINTER ((TPM_STRUCTURE_TAG) 0x0003)
92 #define TPM_TAG_CONTEXTLIST ((TPM_STRUCTURE_TAG) 0x0004)
93 #define TPM_TAG_SIGNINFO ((TPM_STRUCTURE_TAG) 0x0005)
94 #define TPM_TAG_PCR_INFO_LONG ((TPM_STRUCTURE_TAG) 0x0006)
95 #define TPM_TAG_PERSISTENT_FLAGS ((TPM_STRUCTURE_TAG) 0x0007)
96 #define TPM_TAG_VOLATILE_FLAGS ((TPM_STRUCTURE_TAG) 0x0008)
97 #define TPM_TAG_PERSISTENT_DATA ((TPM_STRUCTURE_TAG) 0x0009)
98 #define TPM_TAG_VOLATILE_DATA ((TPM_STRUCTURE_TAG) 0x000A)
99 #define TPM_TAG_SV_DATA ((TPM_STRUCTURE_TAG) 0x000B)
100 #define TPM_TAG_EK_BLOB ((TPM_STRUCTURE_TAG) 0x000C)
101 #define TPM_TAG_EK_BLOB_AUTH ((TPM_STRUCTURE_TAG) 0x000D)
102 #define TPM_TAG_COUNTER_VALUE ((TPM_STRUCTURE_TAG) 0x000E)
103 #define TPM_TAG_TRANSPORT_INTERNAL ((TPM_STRUCTURE_TAG) 0x000F)
104 #define TPM_TAG_TRANSPORT_LOG_IN ((TPM_STRUCTURE_TAG) 0x0010)
105 #define TPM_TAG_TRANSPORT_LOG_OUT ((TPM_STRUCTURE_TAG) 0x0011)
106 #define TPM_TAG_AUDIT_EVENT_IN ((TPM_STRUCTURE_TAG) 0x0012)
107 #define TPM_TAG_AUDIT_EVENT_OUT ((TPM_STRUCTURE_TAG) 0x0013)
108 #define TPM_TAG_CURRENT_TICKS ((TPM_STRUCTURE_TAG) 0x0014)
109 #define TPM_TAG_KEY ((TPM_STRUCTURE_TAG) 0x0015)
110 #define TPM_TAG_STORED_DATA12 ((TPM_STRUCTURE_TAG) 0x0016)
111 #define TPM_TAG_NV_ATTRIBUTES ((TPM_STRUCTURE_TAG) 0x0017)
112 #define TPM_TAG_NV_DATA_PUBLIC ((TPM_STRUCTURE_TAG) 0x0018)
113 #define TPM_TAG_NV_DATA_SENSITIVE ((TPM_STRUCTURE_TAG) 0x0019)
114 #define TPM_TAG_DELEGATIONS ((TPM_STRUCTURE_TAG) 0x001A)
115 #define TPM_TAG_DELEGATE_PUBLIC ((TPM_STRUCTURE_TAG) 0x001B)
116 #define TPM_TAG_DELEGATE_TABLE_ROW ((TPM_STRUCTURE_TAG) 0x001C)
117 #define TPM_TAG_TRANSPORT_AUTH ((TPM_STRUCTURE_TAG) 0x001D)
118 #define TPM_TAG_TRANSPORT_PUBLIC ((TPM_STRUCTURE_TAG) 0x001E)
119 #define TPM_TAG_PERMANENT_FLAGS ((TPM_STRUCTURE_TAG) 0x001F)
120 #define TPM_TAG_STCLEAR_FLAGS ((TPM_STRUCTURE_TAG) 0x0020)
121 #define TPM_TAG_STANY_FLAGS ((TPM_STRUCTURE_TAG) 0x0021)
122 #define TPM_TAG_PERMANENT_DATA ((TPM_STRUCTURE_TAG) 0x0022)
123 #define TPM_TAG_STCLEAR_DATA ((TPM_STRUCTURE_TAG) 0x0023)
124 #define TPM_TAG_STANY_DATA ((TPM_STRUCTURE_TAG) 0x0024)
125 #define TPM_TAG_FAMILY_TABLE_ENTRY ((TPM_STRUCTURE_TAG) 0x0025)
126 #define TPM_TAG_DELEGATE_SENSITIVE ((TPM_STRUCTURE_TAG) 0x0026)
127 #define TPM_TAG_DELG_KEY_BLOB ((TPM_STRUCTURE_TAG) 0x0027)
128 #define TPM_TAG_KEY12 ((TPM_STRUCTURE_TAG) 0x0028)
129 #define TPM_TAG_CERTIFY_INFO2 ((TPM_STRUCTURE_TAG) 0x0029)
130 #define TPM_TAG_DELEGATE_OWNER_BLOB ((TPM_STRUCTURE_TAG) 0x002A)
131 #define TPM_TAG_EK_BLOB_ACTIVATE ((TPM_STRUCTURE_TAG) 0x002B)
132 #define TPM_TAG_DAA_BLOB ((TPM_STRUCTURE_TAG) 0x002C)
133 #define TPM_TAG_DAA_CONTEXT ((TPM_STRUCTURE_TAG) 0x002D)
134 #define TPM_TAG_DAA_ENFORCE ((TPM_STRUCTURE_TAG) 0x002E)
135 #define TPM_TAG_DAA_ISSUER ((TPM_STRUCTURE_TAG) 0x002F)
136 #define TPM_TAG_CAP_VERSION_INFO ((TPM_STRUCTURE_TAG) 0x0030)
137 #define TPM_TAG_DAA_SENSITIVE ((TPM_STRUCTURE_TAG) 0x0031)
138 #define TPM_TAG_DAA_TPM ((TPM_STRUCTURE_TAG) 0x0032)
139 #define TPM_TAG_CMK_MIGAUTH ((TPM_STRUCTURE_TAG) 0x0033)
140 #define TPM_TAG_CMK_SIGTICKET ((TPM_STRUCTURE_TAG) 0x0034)
141 #define TPM_TAG_CMK_MA_APPROVAL ((TPM_STRUCTURE_TAG) 0x0035)
142 #define TPM_TAG_QUOTE_INFO2 ((TPM_STRUCTURE_TAG) 0x0036)
143
144 //
145 // Part 2, section 4: TPM Types
146 //
147
148 //
149 // Part 2, section 4.1: TPM_RESOURCE_TYPE
150 //
151 #define TPM_RT_KEY ((TPM_RESOURCE_TYPE) 0x00000001) // The handle is a key handle and is the result of a LoadKey type operation
152 #define TPM_RT_AUTH ((TPM_RESOURCE_TYPE) 0x00000002) // The handle is an authorization handle. Auth handles come from TPM_OIAP, TPM_OSAP and TPM_DSAP
153 #define TPM_RT_HASH ((TPM_RESOURCE_TYPE) 0x00000003) // Reserved for hashes
154 #define TPM_RT_TRANS ((TPM_RESOURCE_TYPE) 0x00000004) // The handle is for a transport session. Transport handles come from TPM_EstablishTransport
155 #define TPM_RT_CONTEXT ((TPM_RESOURCE_TYPE) 0x00000005) // Resource wrapped and held outside the TPM using the context save/restore commands
156 #define TPM_RT_COUNTER ((TPM_RESOURCE_TYPE) 0x00000006) // Reserved for counters
157 #define TPM_RT_DELEGATE ((TPM_RESOURCE_TYPE) 0x00000007) // The handle is for a delegate row. These are the internal rows held in NV storage by the TPM
158 #define TPM_RT_DAA_TPM ((TPM_RESOURCE_TYPE) 0x00000008) // The value is a DAA TPM specific blob
159 #define TPM_RT_DAA_V0 ((TPM_RESOURCE_TYPE) 0x00000009) // The value is a DAA V0 parameter
160 #define TPM_RT_DAA_V1 ((TPM_RESOURCE_TYPE) 0x0000000A) // The value is a DAA V1 parameter
161
162 //
163 // Part 2, section 4.2: TPM_PAYLOAD_TYPE
164 //
165 #define TPM_PT_ASYM ((TPM_PAYLOAD_TYPE) 0x01) // The entity is an asymmetric key
166 #define TPM_PT_BIND ((TPM_PAYLOAD_TYPE) 0x02) // The entity is bound data
167 #define TPM_PT_MIGRATE ((TPM_PAYLOAD_TYPE) 0x03) // The entity is a migration blob
168 #define TPM_PT_MAINT ((TPM_PAYLOAD_TYPE) 0x04) // The entity is a maintenance blob
169 #define TPM_PT_SEAL ((TPM_PAYLOAD_TYPE) 0x05) // The entity is sealed data
170 #define TPM_PT_MIGRATE_RESTRICTED ((TPM_PAYLOAD_TYPE) 0x06) // The entity is a restricted-migration asymmetric key
171 #define TPM_PT_MIGRATE_EXTERNAL ((TPM_PAYLOAD_TYPE) 0x07) // The entity is a external migratable key
172 #define TPM_PT_CMK_MIGRATE ((TPM_PAYLOAD_TYPE) 0x08) // The entity is a CMK migratable blob
173 #define TPM_PT_VENDOR_SPECIFIC ((TPM_PAYLOAD_TYPE) 0x80) // 0x80 - 0xFF Vendor specific payloads
174
175 //
176 // Part 2, section 4.3: TPM_ENTIRY_TYPE
177 //
178 #define TPM_ET_KEYHANDLE ((UINT16) 0x0001) // The entity is a keyHandle or key
179 #define TPM_ET_OWNER ((UINT16) 0x0002) // The entity is the TPM Owner
180 #define TPM_ET_DATA ((UINT16) 0x0003) // The entity is some data
181 #define TPM_ET_SRK ((UINT16) 0x0004) // The entity is the SRK
182 #define TPM_ET_KEY ((UINT16) 0x0005) // The entity is a key or keyHandle
183 #define TPM_ET_REVOKE ((UINT16) 0x0006) // The entity is the RevokeTrust value
184 #define TPM_ET_DEL_OWNER_BLOB ((UINT16) 0x0007) // The entity is a delegate owner blob
185 #define TPM_ET_DEL_ROW ((UINT16) 0x0008) // The entity is a delegate row
186 #define TPM_ET_DEL_KEY_BLOB ((UINT16) 0x0009) // The entity is a delegate key blob
187 #define TPM_ET_COUNTER ((UINT16) 0x000A) // The entity is a counter
188 #define TPM_ET_NV ((UINT16) 0x000B) // The entity is a NV index
189 #define TPM_ET_RESERVED_HANDLE ((UINT16) 0x0040) // Reserved. This value avoids collisions with the handle MSB setting.
190 //
191 // TPM_ENTITY_TYPE MSB Values: The MSB is used to indicate the ADIP encryption sheme when applicable
192 //
193 #define TPM_ET_XOR ((UINT16) 0x0000) // ADIP encryption scheme: XOR
194 #define TPM_ET_AES128 ((UINT16) 0x0006) // ADIP encryption scheme: AES 128 bits
195
196 //
197 // Part 2, section 4.4.1: Reserved Key Handles
198 //
199 #define TPM_KH_SRK ((TPM_KEY_HANDLE) 0x40000000) // The handle points to the SRK
200 #define TPM_KH_OWNER ((TPM_KEY_HANDLE) 0x40000001) // The handle points to the TPM Owner
201 #define TPM_KH_REVOKE ((TPM_KEY_HANDLE) 0x40000002) // The handle points to the RevokeTrust value
202 #define TPM_KH_TRANSPORT ((TPM_KEY_HANDLE) 0x40000003) // The handle points to the EstablishTransport static authorization
203 #define TPM_KH_OPERATOR ((TPM_KEY_HANDLE) 0x40000004) // The handle points to the Operator auth
204 #define TPM_KH_ADMIN ((TPM_KEY_HANDLE) 0x40000005) // The handle points to the delegation administration auth
205 #define TPM_KH_EK ((TPM_KEY_HANDLE) 0x40000006) // The handle points to the PUBEK, only usable with TPM_OwnerReadInternalPub
206
207 //
208 // Part 2, section 4.5: TPM_STARTUP_TYPE
209 //
210 #define TPM_ST_CLEAR ((TPM_STARTUP_TYPE) 0x0001) // The TPM is starting up from a clean state
211 #define TPM_ST_STATE ((TPM_STARTUP_TYPE) 0x0002) // The TPM is starting up from a saved state
212 #define TPM_ST_DEACTIVATED ((TPM_STARTUP_TYPE) 0x0003) // The TPM is to startup and set the deactivated flag to TRUE
213
214 //
215 // Part 2, section 4.6: TPM_STATUP_EFFECTS
216 // The table makeup is still an open issue.
217 //
218
219 //
220 // Part 2, section 4.7: TPM_PROTOCOL_ID
221 //
222 #define TPM_PID_OIAP ((TPM_PROTOCOL_ID) 0x0001) // The OIAP protocol.
223 #define TPM_PID_OSAP ((TPM_PROTOCOL_ID) 0x0002) // The OSAP protocol.
224 #define TPM_PID_ADIP ((TPM_PROTOCOL_ID) 0x0003) // The ADIP protocol.
225 #define TPM_PID_ADCP ((TPM_PROTOCOL_ID) 0x0004) // The ADCP protocol.
226 #define TPM_PID_OWNER ((TPM_PROTOCOL_ID) 0x0005) // The protocol for taking ownership of a TPM.
227 #define TPM_PID_DSAP ((TPM_PROTOCOL_ID) 0x0006) // The DSAP protocol
228 #define TPM_PID_TRANSPORT ((TPM_PROTOCOL_ID) 0x0007) // The transport protocol
229
230 //
231 // Part 2, section 4.8: TPM_ALGORITHM_ID
232 // The TPM MUST support the algorithms TPM_ALG_RSA, TPM_ALG_SHA, TPM_ALG_HMAC,
233 // TPM_ALG_MGF1
234 //
235 #define TPM_ALG_RSA ((TPM_ALGORITHM_ID) 0x00000001) // The RSA algorithm.
236 #define TPM_ALG_DES ((TPM_ALGORITHM_ID) 0x00000002) // The DES algorithm
237 #define TPM_ALG_3DES ((TPM_ALGORITHM_ID) 0x00000003) // The 3DES algorithm in EDE mode
238 #define TPM_ALG_SHA ((TPM_ALGORITHM_ID) 0x00000004) // The SHA1 algorithm
239 #define TPM_ALG_HMAC ((TPM_ALGORITHM_ID) 0x00000005) // The RFC 2104 HMAC algorithm
240 #define TPM_ALG_AES128 ((TPM_ALGORITHM_ID) 0x00000006) // The AES algorithm, key size 128
241 #define TPM_ALG_MGF1 ((TPM_ALGORITHM_ID) 0x00000007) // The XOR algorithm using MGF1 to create a string the size of the encrypted block
242 #define TPM_ALG_AES192 ((TPM_ALGORITHM_ID) 0x00000008) // AES, key size 192
243 #define TPM_ALG_AES256 ((TPM_ALGORITHM_ID) 0x00000009) // AES, key size 256
244 #define TPM_ALG_XOR ((TPM_ALGORITHM_ID) 0x0000000A) // XOR using the rolling nonces
245
246 //
247 // Part 2, section 4.9: TPM_PHYSICAL_PRESENCE
248 //
249 #define TPM_PHYSICAL_PRESENCE_HW_DISABLE ((TPM_PHYSICAL_PRESENCE) 0x0200) // Sets the physicalPresenceHWEnable to FALSE
250 #define TPM_PHYSICAL_PRESENCE_CMD_DISABLE ((TPM_PHYSICAL_PRESENCE) 0x0100) // Sets the physicalPresenceCMDEnable to FALSE
251 #define TPM_PHYSICAL_PRESENCE_LIFETIME_LOCK ((TPM_PHYSICAL_PRESENCE) 0x0080) // Sets the physicalPresenceLifetimeLock to TRUE
252 #define TPM_PHYSICAL_PRESENCE_HW_ENABLE ((TPM_PHYSICAL_PRESENCE) 0x0040) // Sets the physicalPresenceHWEnable to TRUE
253 #define TPM_PHYSICAL_PRESENCE_CMD_ENABLE ((TPM_PHYSICAL_PRESENCE) 0x0020) // Sets the physicalPresenceCMDEnable to TRUE
254 #define TPM_PHYSICAL_PRESENCE_NOTPRESENT ((TPM_PHYSICAL_PRESENCE) 0x0010) // Sets PhysicalPresence = FALSE
255 #define TPM_PHYSICAL_PRESENCE_PRESENT ((TPM_PHYSICAL_PRESENCE) 0x0008) // Sets PhysicalPresence = TRUE
256 #define TPM_PHYSICAL_PRESENCE_LOCK ((TPM_PHYSICAL_PRESENCE) 0x0004) // Sets PhysicalPresenceLock = TRUE
257
258 //
259 // Part 2, section 4.10: TPM_MIGRATE_SCHEME
260 //
261 #define TPM_MS_MIGRATE ((TPM_MIGRATE_SCHEME) 0x0001) // A public key that can be used with all TPM migration commands other than 'ReWrap' mode.
262 #define TPM_MS_REWRAP ((TPM_MIGRATE_SCHEME) 0x0002) // A public key that can be used for the ReWrap mode of TPM_CreateMigrationBlob.
263 #define TPM_MS_MAINT ((TPM_MIGRATE_SCHEME) 0x0003) // A public key that can be used for the Maintenance commands
264 #define TPM_MS_RESTRICT_MIGRATE ((TPM_MIGRATE_SCHEME) 0x0004) // The key is to be migrated to a Migration Authority.
265 #define TPM_MS_RESTRICT_APPROVE_DOUBLE ((TPM_MIGRATE_SCHEME) 0x0005) // The key is to be migrated to an entity approved by a Migration Authority using double wrapping
266
267 //
268 // Part 2, section 4.11: TPM_EK_TYPE
269 //
270 #define TPM_EK_TYPE_ACTIVATE ((TPM_EK_TYPE) 0x0001) // The blob MUST be TPM_EK_BLOB_ACTIVATE
271 #define TPM_EK_TYPE_AUTH ((TPM_EK_TYPE) 0x0002) // The blob MUST be TPM_EK_BLOB_AUTH
272
273 //
274 // Part 2, section 4.12: TPM_PLATFORM_SPECIFIC
275 //
276 #define TPM_PS_PC_11 ((TPM_PLATFORM_SPECIFIC) 0x0001) // PC Specific version 1.1
277 #define TPM_PS_PC_12 ((TPM_PLATFORM_SPECIFIC) 0x0002) // PC Specific version 1.2
278 #define TPM_PS_PDA_12 ((TPM_PLATFORM_SPECIFIC) 0x0003) // PDA Specific version 1.2
279 #define TPM_PS_Server_12 ((TPM_PLATFORM_SPECIFIC) 0x0004) // Server Specific version 1.2
280 #define TPM_PS_Mobile_12 ((TPM_PLATFORM_SPECIFIC) 0x0005) // Mobil Specific version 1.2
281
282 //
283 // Part 2, section 5: Basic Structures
284 //
285
286 //
287 // Part 2, section 5.1: TPM_STRUCT_VER
288 //
289 typedef struct tdTPM_STRUCT_VER {
290 UINT8 major;
291 UINT8 minor;
292 UINT8 revMajor;
293 UINT8 revMinor;
294 } TPM_STRUCT_VER;
295
296 //
297 // Part 2, section 5.3: TPM_VERSION
298 //
299 typedef struct tdTPM_VERSION {
300 TPM_VERSION_BYTE major;
301 TPM_VERSION_BYTE minor;
302 UINT8 revMajor;
303 UINT8 revMinor;
304 } TPM_VERSION;
305
306 //
307 // Part 2, section 5.4: TPM_DIGEST
308 //
309 #define TPM_SHA1_160_HASH_LEN 0x14
310 #define TPM_SHA1BASED_NONCE_LEN TPM_SHA1_160_HASH_LEN
311
312 typedef struct tdTPM_DIGEST{
313 UINT8 digest[TPM_SHA1_160_HASH_LEN];
314 } TPM_DIGEST;
315
316 typedef TPM_DIGEST TPM_CHOSENID_HASH; // This SHALL be the digest of the chosen identityLabel and privacyCA for a new TPM identity.
317 typedef TPM_DIGEST TPM_COMPOSITE_HASH; // This SHALL be the hash of a list of PCR indexes and PCR values that a key or data is bound to.
318 typedef TPM_DIGEST TPM_DIRVALUE; // This SHALL be the value of a DIR register
319 typedef TPM_DIGEST TPM_HMAC;
320 typedef TPM_DIGEST TPM_PCRVALUE; // The value inside of the PCR
321 typedef TPM_DIGEST TPM_AUDITDIGEST; // This SHALL be the value of the current internal audit state
322 typedef TPM_DIGEST TPM_DAA_TPM_SEED; // This SHALL be a random value generated by a TPM immediately after the EK is installed in that TPM, whenever an EK is installed in that TPM
323 typedef TPM_DIGEST TPM_DAA_CONTEXT_SEED; // This SHALL be a random value
324
325 //
326 // Part 2, section 5.5: TPM_NONCE
327 //
328 typedef struct tdTPM_NONCE{
329 UINT8 nonce[20];
330 } TPM_NONCE;
331
332 //
333 // Part 2, section 5.6: TPM_AUTHDATA
334 //
335 typedef UINT8 tdTPM_AUTHDATA[20];
336 typedef tdTPM_AUTHDATA TPM_AUTHDATA;
337 typedef TPM_AUTHDATA TPM_SECRET;
338 typedef TPM_AUTHDATA TPM_ENCAUTH;
339
340 //
341 // Part 2, section 5.7: TPM_KEY_HANDLE_LIST
342 // Size of handle is loaded * sizeof(TPM_KEY_HANDLE)
343 //
344 typedef struct tdTPM_KEY_HANDLE_LIST {
345 UINT16 loaded;
346 TPM_KEY_HANDLE handle[1];
347 } TPM_KEY_HANDLE_LIST;
348
349 //
350 // Part 2, section 5.8: TPM_KEY_USAGE values
351 //
352
353 #define TPM_KEY_SIGNING ((UINT16) 0x0010)
354 // TPM_KEY_SIGNING SHALL indicate a signing key. The [private] key SHALL be
355 // used for signing operations, only. This means that it MUST be a leaf of the
356 // Protected Storage key hierarchy.
357
358 #define TPM_KEY_STORAGE ((UINT16) 0x0011)
359 // TPM_KEY_STORAGE SHALL indicate a storage key. The key SHALL be used to wrap
360 // and unwrap other keys in the Protected Storage hierarchy
361
362 #define TPM_KEY_IDENTITY ((UINT16) 0x0012)
363 // TPM_KEY_IDENTITY SHALL indicate an identity key. The key SHALL be used for
364 // operations that require a TPM identity, only.
365
366 #define TPM_KEY_AUTHCHANGE ((UINT16) 0x0013)
367 // TPM_KEY_AUTHCHANGE SHALL indicate an ephemeral key that is in use during
368 // the ChangeAuthAsym process, only.
369
370 #define TPM_KEY_BIND ((UINT16) 0x0014)
371 // TPM_KEY_BIND SHALL indicate a key that can be used for TPM_Bind and
372 // TPM_Unbind operations only.
373
374 #define TPM_KEY_LEGACY ((UINT16) 0x0015)
375 // TPM_KEY_LEGACY SHALL indicate a key that can perform signing and binding
376 // operations. The key MAY be used for both signing and binding operations.
377 // The TPM_KEY_LEGACY key type is to allow for use by applications where both
378 // signing and encryption operations occur with the same key. The use of this
379 // key type is not recommended TPM_KEY_MIGRATE 0x0016 This SHALL indicate a
380 // key in use for TPM_MigrateKey
381
382 #define TPM_KEY_MIGRATE ((UINT16) 0x0016)
383 // TPM_KEY_MIGRAGE SHALL indicate a key in use for TPM_MigrateKey
384
385 //
386 // Part 2, section 5.8.1: Encryption/Signature schemes
387 //
388
389 #define TPM_ES_NONE ((TPM_ENC_SCHEME) 0x0001)
390 #define TPM_ES_RSAESPKCSv15 ((TPM_ENC_SCHEME) 0x0002)
391 #define TPM_ES_RSAESOAEP_SHA1_MGF1 ((TPM_ENC_SCHEME) 0x0003)
392 #define TPM_ES_SYM_CNT ((TPM_ENC_SCHEME) 0x0004)
393 #define TPM_ES_SYM_OFB ((TPM_ENC_SCHEME) 0x0005)
394
395 #define TPM_SS_NONE ((TPM_SIG_SCHEME) 0x0001)
396 #define TPM_SS_RSASSAPKCS1v15_SHA1 ((TPM_SIG_SCHEME) 0x0002)
397 #define TPM_SS_RSASSAPKCS1v15_DER ((TPM_SIG_SCHEME) 0x0003)
398 #define TPM_SS_RSASSAPKCS1v15_INFO ((TPM_SIG_SCHEME) 0x0004)
399
400 //
401 // Part 2, section 5.9: TPM_AUTH_DATA_USAGE values
402 //
403 #define TPM_AUTH_NEVER ((TPM_AUTH_DATA_USAGE) 0x00)
404 #define TPM_AUTH_ALWAYS ((TPM_AUTH_DATA_USAGE) 0x01)
405 #define TPM_AUTH_PRIV_USE_ONLY ((TPM_AUTH_DATA_USAGE) 0x03)
406
407 //
408 // Part 2, section 5.10: TPM_KEY_FLAGS
409 //
410 enum tdTPM_KEY_FLAGS {
411 redirection = 0x00000001,
412 migratable = 0x00000002,
413 isVolatile = 0x00000004,
414 pcrIgnoredOnRead = 0x00000008,
415 migrateAuthority = 0x00000010
416 };
417
418 //
419 // Part 2, section 5.11: TPM_CHANGEAUTH_VALIDATE
420 //
421 typedef struct tdTPM_CHANGEAUTH_VALIDATE {
422 TPM_SECRET newAuthSecret;
423 TPM_NONCE n1;
424 } TPM_CHANGEAUTH_VALIDATE;
425
426 //
427 // Part 2, section 5.12: TPM_MIGRATIONKEYAUTH
428 // decalared after section 10 to catch declaration of TPM_PUBKEY
429 //
430 // Part 2 section 10.1: TPM_KEY_PARMS
431 // [size_is(parmSize)] BYTE* parms;
432 //
433 typedef struct tdTPM_KEY_PARMS {
434 TPM_ALGORITHM_ID algorithmID;
435 TPM_ENC_SCHEME encScheme;
436 TPM_SIG_SCHEME sigScheme;
437 UINT32 parmSize;
438 UINT8 *parms;
439 } TPM_KEY_PARMS;
440
441 //
442 // Part 2, section 10.4: TPM_STORE_PUBKEY
443 //
444 typedef struct tdTPM_STORE_PUBKEY {
445 UINT32 keyLength;
446 UINT8 key[1];
447 } TPM_STORE_PUBKEY;
448
449 //
450 // Part 2, section 10.5: TPM_PUBKEY
451 //
452 typedef struct tdTPM_PUBKEY{
453 TPM_KEY_PARMS algorithmParms;
454 TPM_STORE_PUBKEY pubKey;
455 } TPM_PUBKEY;
456
457 //
458 // Part 2, section 5.12: TPM_MIGRATIONKEYAUTH
459 //
460 typedef struct tdTPM_MIGRATIONKEYAUTH{
461 TPM_PUBKEY migrationKey;
462 TPM_MIGRATE_SCHEME migrationScheme;
463 TPM_DIGEST digest;
464 } TPM_MIGRATIONKEYAUTH;
465
466 //
467 // Part 2, section 5.13: TPM_COUNTER_VALUE
468 //
469 typedef struct tdTPM_COUNTER_VALUE{
470 TPM_STRUCTURE_TAG tag;
471 UINT8 label[4];
472 TPM_ACTUAL_COUNT counter;
473 } TPM_COUNTER_VALUE;
474
475 //
476 // Part 2, section 5.14: TPM_SIGN_INFO
477 // Size of data indicated by dataLen
478 //
479 typedef struct tdTPM_SIGN_INFO {
480 TPM_STRUCTURE_TAG tag;
481 UINT8 fixed[4];
482 TPM_NONCE replay;
483 UINT32 dataLen;
484 UINT8 *data;
485 } TPM_SIGN_INFO;
486
487 //
488 // Part 2, section 5.15: TPM_MSA_COMPOSITE
489 // Number of migAuthDigest indicated by MSAlist
490 //
491 typedef struct tdTPM_MSA_COMPOSITE {
492 UINT32 MSAlist;
493 TPM_DIGEST migAuthDigest[1];
494 } TPM_MSA_COMPOSITE;
495
496 //
497 // Part 2, section 5.16: TPM_CMK_AUTH
498 //
499 typedef struct tdTPM_CMK_AUTH{
500 TPM_DIGEST migrationAuthorityDigest;
501 TPM_DIGEST destinationKeyDigest;
502 TPM_DIGEST sourceKeyDigest;
503 } TPM_CMK_AUTH;
504
505 //
506 // Part 2, section 5.17: TPM_CMK_DELEGATE
507 //
508 #define TPM_CMK_DELEGATE_SIGNING (((TPM_CMK_DELEGATE)1) << 31)
509 #define TPM_CMK_DELEGATE_STORAGE (((TPM_CMK_DELEGATE)1) << 30)
510 #define TPM_CMK_DELEGATE_BIND (((TPM_CMK_DELEGATE)1) << 29)
511 #define TPM_CMK_DELEGATE_LEGACY (((TPM_CMK_DELEGATE)1) << 28)
512 #define TPM_CMK_DELEGATE_MIGRATE (((TPM_CMK_DELEGATE)1) << 27)
513
514 //
515 // Part 2, section 5.18: TPM_SELECT_SIZE
516 //
517 typedef struct tdTPM_SELECT_SIZE {
518 UINT8 major;
519 UINT8 minor;
520 UINT16 reqSize;
521 } TPM_SELECT_SIZE;
522
523 //
524 // Part 2, section 5,19: TPM_CMK_MIGAUTH
525 //
526 typedef struct tdTPM_CMK_MIGAUTH{
527 TPM_STRUCTURE_TAG tag;
528 TPM_DIGEST msaDigest;
529 TPM_DIGEST pubKeyDigest;
530 } TPM_CMK_MIGAUTH;
531
532 //
533 // Part 2, section 5.20: TPM_CMK_SIGTICKET
534 //
535 typedef struct tdTPM_CMK_SIGTICKET{
536 TPM_STRUCTURE_TAG tag;
537 TPM_DIGEST verKeyDigest;
538 TPM_DIGEST signedData;
539 } TPM_CMK_SIGTICKET;
540
541 //
542 // Part 2, section 5.21: TPM_CMK_MA_APPROVAL
543 //
544 typedef struct tdTPM_CMK_MA_APPROVAL{
545 TPM_STRUCTURE_TAG tag;
546 TPM_DIGEST migrationAuthorityDigest;
547 } TPM_CMK_MA_APPROVAL;
548
549 //
550 // Part 2, section 6: Command Tags
551 //
552 #define TPM_TAG_RQU_COMMAND ((TPM_STRUCTURE_TAG) 0x00C1)
553 #define TPM_TAG_RQU_AUTH1_COMMAND ((TPM_STRUCTURE_TAG) 0x00C2)
554 #define TPM_TAG_RQU_AUTH2_COMMAND ((TPM_STRUCTURE_TAG) 0x00C3)
555 #define TPM_TAG_RSP_COMMAND ((TPM_STRUCTURE_TAG) 0x00C4)
556 #define TPM_TAG_RSP_AUTH1_COMMAND ((TPM_STRUCTURE_TAG) 0x00C5)
557 #define TPM_TAG_RSP_AUTH2_COMMAND ((TPM_STRUCTURE_TAG) 0x00C6)
558
559 //
560 // Part 2, section 7.1: TPM_PERMANENT_FLAGS
561 //
562 typedef struct tdTPM_PERMANENT_FLAGS{
563 TPM_STRUCTURE_TAG tag;
564 BOOLEAN disable;
565 BOOLEAN ownership;
566 BOOLEAN deactivated;
567 BOOLEAN readPubek;
568 BOOLEAN disableOwnerClear;
569 BOOLEAN allowMaintenance;
570 BOOLEAN physicalPresenceLifetimeLock;
571 BOOLEAN physicalPresenceHWEnable;
572 BOOLEAN physicalPresenceCMDEnable;
573 BOOLEAN CEKPUsed;
574 BOOLEAN TPMpost;
575 BOOLEAN TPMpostLock;
576 BOOLEAN FIPS;
577 BOOLEAN operator;
578 BOOLEAN enableRevokeEK;
579 BOOLEAN nvLocked;
580 BOOLEAN readSRKPub;
581 BOOLEAN tpmEstablished;
582 BOOLEAN maintenanceDone;
583 } TPM_PERMANENT_FLAGS;
584
585 //
586 // Part 2, section 7.1.1: PERMANENT_FLAGS Subcap for SetCapability
587 //
588 #define TPM_PF_DISABLE ((TPM_CAPABILITY_AREA) 1)
589 #define TPM_PF_OWNERSHIP ((TPM_CAPABILITY_AREA) 2)
590 #define TPM_PF_DEACTIVATED ((TPM_CAPABILITY_AREA) 3)
591 #define TPM_PF_READPUBEK ((TPM_CAPABILITY_AREA) 4)
592 #define TPM_PF_DISABLEOWNERCLEAR ((TPM_CAPABILITY_AREA) 5)
593 #define TPM_PF_ALLOWMAINTENANCE ((TPM_CAPABILITY_AREA) 6)
594 #define TPM_PF_PHYSICALPRESENCELIFETIMELOCK ((TPM_CAPABILITY_AREA) 7)
595 #define TPM_PF_PHYSICALPRESENCEHWENABLE ((TPM_CAPABILITY_AREA) 8)
596 #define TPM_PF_PHYSICALPRESENCECMDENABLE ((TPM_CAPABILITY_AREA) 9)
597 #define TPM_PF_CEKPUSED ((TPM_CAPABILITY_AREA) 10)
598 #define TPM_PF_TPMPOST ((TPM_CAPABILITY_AREA) 11)
599 #define TPM_PF_TPMPOSTLOCK ((TPM_CAPABILITY_AREA) 12)
600 #define TPM_PF_FIPS ((TPM_CAPABILITY_AREA) 13)
601 #define TPM_PF_OPERATOR ((TPM_CAPABILITY_AREA) 14)
602 #define TPM_PF_ENABLEREVOKEEK ((TPM_CAPABILITY_AREA) 15)
603 #define TPM_PF_NV_LOCKED ((TPM_CAPABILITY_AREA) 16)
604 #define TPM_PF_READSRKPUB ((TPM_CAPABILITY_AREA) 17)
605 #define TPM_PF_TPMESTABLISHED ((TPM_CAPABILITY_AREA) 18)
606 #define TPM_PF_MAINTENANCEDONE ((TPM_CAPABILITY_AREA) 19)
607
608 //
609 // Part 2, section 7.2: TPM_STCLEAR_FLAGS
610 //
611 typedef struct tdTPM_STCLEAR_FLAGS{
612 TPM_STRUCTURE_TAG tag;
613 BOOLEAN deactivated;
614 BOOLEAN disableForceClear;
615 BOOLEAN physicalPresence;
616 BOOLEAN physicalPresenceLock;
617 BOOLEAN bGlobalLock;
618 } TPM_STCLEAR_FLAGS;
619
620 //
621 // Part 2, section 7.2.1: STCLEAR_FLAGS Subcap for SetCapability
622 //
623 #define TPM_SF_DEACTIVATED ((TPM_CAPABILITY_AREA) 1)
624 #define TPM_SF_DISABLEFORCECLEAR ((TPM_CAPABILITY_AREA) 2)
625 #define TPM_SF_PHYSICALPRESENCE ((TPM_CAPABILITY_AREA) 3)
626 #define TPM_SF_PHYSICALPRESENCELOCK ((TPM_CAPABILITY_AREA) 4)
627 #define TPM_SF_BGLOBALLOCK ((TPM_CAPABILITY_AREA) 5)
628
629 //
630 // Part 2, section 7.3: TPM_STANY_FLAGS
631 //
632 typedef struct tdTPM_STANY_FLAGS{
633 TPM_STRUCTURE_TAG tag;
634 BOOLEAN postInitialise;
635 TPM_MODIFIER_INDICATOR localityModifier;
636 BOOLEAN transportExclusive;
637 BOOLEAN TOSPresent;
638 } TPM_STANY_FLAGS;
639
640 //
641 // Part 2, section 7.3.1: STANY_FLAGS Subcap for SetCapability
642 //
643 #define TPM_AF_POSTINITIALISE ((TPM_CAPABILITY_AREA) 1)
644 #define TPM_AF_LOCALITYMODIFIER ((TPM_CAPABILITY_AREA) 2)
645 #define TPM_AF_TRANSPORTEXCLUSIVE ((TPM_CAPABILITY_AREA) 3)
646 #define TPM_AF_TOSPRESENT ((TPM_CAPABILITY_AREA) 4)
647
648 //
649 // All those structures (section 7.4, 7.5, 7.6) are not normative and
650 // thus no definitions here
651 //
652 // Part 2, section 7.4: TPM_PERMANENT_DATA
653 //
654 //#define TPM_MIN_COUNTERS 4 // the minimum number of counters is 4
655 //#define TPM_DELEGATE_KEY TPM_KEY
656 //#define TPM_NUM_PCR 16
657 //#define TPM_MAX_NV_WRITE_NOOWNER 64
658 //typedef struct tdTPM_PERMANENT_DATA
659 //{
660 // TPM_STRUCTURE_TAG tag;
661 // UINT8 revMajor;
662 // UINT8 revMinor;
663 // TPM_NONCE tpmProof;
664 // TPM_NONCE ekReset;
665 // TPM_SECRET ownerAuth;
666 // TPM_SECRET operatorAuth;
667 // TPM_DIRVALUE authDIR[1];
668 // TPM_PUBKEY manuMaintPub;
669 // TPM_KEY endorsementKey;
670 // TPM_KEY srk;
671 // TPM_KEY contextKey;
672 // TPM_KEY delegateKey;
673 // TPM_COUNTER_VALUE auditMonotonicCounter;
674 // TPM_COUNTER_VALUE monitonicCounter[TPM_MIN_COUNTERS];
675 // TPM_PCR_ATTRIBUTES pcrAttrib[TPM_NUM_PCR];
676 // UINT8 ordinalAuditStatus[];
677 // UINT8 *rngState;
678 // TPM_FAMILY_TABLE familyTable;
679 // TPM_DELEGATE_TABLE delegateTable;
680 // UINT32 maxNVBufSize;
681 // UINT32 lastFamilyID;
682 // UINT32 noOwnerNVWrite;
683 // TPM_CMK_DELEGATE restrictDelegate;
684 // TPM_DAA_TPM_SEED tpmDAASeed;
685 //} TPM_PERMANENT_DATA;
686
687 //
688 // Part 2, section 7.5: TPM_STCLEAR_DATA
689 // available inside TPM only
690 //
691 //typedef struct tdTPM_STCLEAR_DATA
692 //{
693 // TPM_STRUCTURE_TAG tag;
694 // TPM_NONCE contextNonceKey;
695 // TPM_COUNT_ID countID;
696 // UINT32 ownerReference;
697 // BOOLEAN disableResetLock;
698 //} TPM_STCLEAR_DATA;
699
700 //
701 // Part 2, section 7.6: TPM_STANY_DATA
702 // available inside TPM only
703 //
704 //typedef struct tdTPM_STANY_DATA
705 //{
706 // TPM_STRUCTURE_TAG tag;
707 // TPM_NONCE contextNonceSession;
708 // TPM_DIGEST auditDigest;
709 // TPM_CURRENT_TICKS currentTicks;
710 // UINT32 contextCount;
711 // UINT32 contextList[TPM_MIN_SESSION_LIST];
712 // TPM_SESSION_DATA sessions[TPM_MIN_SESSIONS];
713 //} TPM_STANY_DATA;
714
715 //
716 // Part 2, section 8: PCR Structures
717 //
718
719 //
720 // Part 2, section 8.1: TPM_PCR_SELECTION
721 // Size of pcrSelect[] indicated by sizeOfSelect
722 //
723 typedef struct tdTPM_PCR_SELECTION {
724 UINT16 sizeOfSelect;
725 UINT8 pcrSelect[1];
726 } TPM_PCR_SELECTION;
727
728 //
729 // Part 2, section 8.2: TPM_PCR_COMPOSITE
730 // Size of pcrValue[] indicated by valueSize
731 //
732 typedef struct tdTPM_PCR_COMPOSITE {
733 TPM_PCR_SELECTION select;
734 UINT32 valueSize;
735 TPM_PCRVALUE pcrValue[1];
736 } TPM_PCR_COMPOSITE;
737
738 //
739 // Part 2, section 8.3: TPM_PCR_INFO
740 //
741 typedef struct tdTPM_PCR_INFO {
742 TPM_PCR_SELECTION pcrSelection;
743 TPM_COMPOSITE_HASH digestAtRelease;
744 TPM_COMPOSITE_HASH digestAtCreation;
745 } TPM_PCR_INFO;
746
747 //
748 // Part 2, section 8.6: TPM_LOCALITY_SELECTION
749 //
750 typedef UINT8 TPM_LOCALITY_SELECTION;
751
752 #define TPM_LOC_FOUR ((UINT8) 0x10)
753 #define TPM_LOC_THREE ((UINT8) 0x08)
754 #define TPM_LOC_TWO ((UINT8) 0x04)
755 #define TPM_LOC_ONE ((UINT8) 0x02)
756 #define TPM_LOC_ZERO ((UINT8) 0x01)
757
758 //
759 // Part 2, section 8.4: TPM_PCR_INFO_LONG
760 //
761 typedef struct tdTPM_PCR_INFO_LONG {
762 TPM_STRUCTURE_TAG tag;
763 TPM_LOCALITY_SELECTION localityAtCreation;
764 TPM_LOCALITY_SELECTION localityAtRelease;
765 TPM_PCR_SELECTION creationPCRSelection;
766 TPM_PCR_SELECTION releasePCRSelection;
767 TPM_COMPOSITE_HASH digestAtCreation;
768 TPM_COMPOSITE_HASH digestAtRelease;
769 } TPM_PCR_INFO_LONG;
770
771 //
772 // Part 2, section 8.5: TPM_PCR_INFO_SHORT
773 //
774 typedef struct tdTPM_PCR_INFO_SHORT{
775 TPM_PCR_SELECTION pcrSelection;
776 TPM_LOCALITY_SELECTION localityAtRelease;
777 TPM_COMPOSITE_HASH digestAtRelease;
778 } TPM_PCR_INFO_SHORT;
779
780 //
781 // Part 2, section 8.8: TPM_PCR_ATTRIBUTES
782 //
783 typedef struct tdTPM_PCR_ATTRIBUTES{
784 BOOLEAN pcrReset;
785 TPM_LOCALITY_SELECTION pcrExtendLocal;
786 TPM_LOCALITY_SELECTION pcrResetLocal;
787 } TPM_PCR_ATTRIBUTES;
788
789 //
790 // Part 2, section 9: Storage Structures
791 //
792
793 //
794 // Part 2, section 9.1: TPM_STORED_DATA
795 // [size_is(sealInfoSize)] BYTE* sealInfo;
796 // [size_is(encDataSize)] BYTE* encData;
797 //
798 typedef struct tdTPM_STORED_DATA {
799 TPM_STRUCT_VER ver;
800 UINT32 sealInfoSize;
801 UINT8 *sealInfo;
802 UINT32 encDataSize;
803 UINT8 *encData;
804 } TPM_STORED_DATA;
805
806 //
807 // Part 2, section 9.2: TPM_STORED_DATA12
808 // [size_is(sealInfoSize)] BYTE* sealInfo;
809 // [size_is(encDataSize)] BYTE* encData;
810 //
811 typedef struct tdTPM_STORED_DATA12 {
812 TPM_STRUCTURE_TAG tag;
813 TPM_ENTITY_TYPE et;
814 UINT32 sealInfoSize;
815 UINT8 *sealInfo;
816 UINT32 encDataSize;
817 UINT8 *encData;
818 } TPM_STORED_DATA12;
819
820 //
821 // Part 2, section 9.3: TPM_SEALED_DATA
822 // [size_is(dataSize)] BYTE* data;
823 //
824 typedef struct tdTPM_SEALED_DATA {
825 TPM_PAYLOAD_TYPE payload;
826 TPM_SECRET authData;
827 TPM_NONCE tpmProof;
828 TPM_DIGEST storedDigest;
829 UINT32 dataSize;
830 UINT8 *data;
831 } TPM_SEALED_DATA;
832
833 //
834 // Part 2, section 9.4: TPM_SYMMETRIC_KEY
835 // [size_is(size)] BYTE* data;
836 //
837 typedef struct tdTPM_SYMMETRIC_KEY {
838 TPM_ALGORITHM_ID algId;
839 TPM_ENC_SCHEME encScheme;
840 UINT16 dataSize;
841 UINT8 *data;
842 } TPM_SYMMETRIC_KEY;
843
844 //
845 // Part 2, section 9.5: TPM_BOUND_DATA
846 //
847 typedef struct tdTPM_BOUND_DATA {
848 TPM_STRUCT_VER ver;
849 TPM_PAYLOAD_TYPE payload;
850 UINT8 payloadData[1];
851 } TPM_BOUND_DATA;
852
853 //
854 // Part 2 section 10: TPM_KEY complex
855 //
856
857 //
858 // Part 2, section 10.2: TPM_KEY
859 // [size_is(encDataSize)] BYTE* encData;
860 //
861 typedef struct tdTPM_KEY{
862 TPM_STRUCT_VER ver;
863 TPM_KEY_USAGE keyUsage;
864 TPM_KEY_FLAGS keyFlags;
865 TPM_AUTH_DATA_USAGE authDataUsage;
866 TPM_KEY_PARMS algorithmParms;
867 UINT32 PCRInfoSize;
868 UINT8 *PCRInfo;
869 TPM_STORE_PUBKEY pubKey;
870 UINT32 encDataSize;
871 UINT8 *encData;
872 } TPM_KEY;
873
874 //
875 // Part 2, section 10.3: TPM_KEY12
876 // [size_is(encDataSize)] BYTE* encData;
877 //
878 typedef struct tdTPM_KEY12{
879 TPM_STRUCTURE_TAG tag;
880 UINT16 fill;
881 TPM_KEY_USAGE keyUsage;
882 TPM_KEY_FLAGS keyFlags;
883 TPM_AUTH_DATA_USAGE authDataUsage;
884 TPM_KEY_PARMS algorithmParms;
885 UINT32 PCRInfoSize;
886 UINT8 *PCRInfo;
887 TPM_STORE_PUBKEY pubKey;
888 UINT32 encDataSize;
889 UINT8 *encData;
890 } TPM_KEY12;
891
892 //
893 // Part 2, section 10.7: TPM_STORE_PRIVKEY
894 // [size_is(keyLength)] BYTE* key;
895 //
896 typedef struct tdTPM_STORE_PRIVKEY {
897 UINT32 keyLength;
898 UINT8 *key;
899 } TPM_STORE_PRIVKEY;
900
901 //
902 // Part 2, section 10.6: TPM_STORE_ASYMKEY
903 //
904 typedef struct tdTPM_STORE_ASYMKEY { // pos len total
905 TPM_PAYLOAD_TYPE payload; // 0 1 1
906 TPM_SECRET usageAuth; // 1 20 21
907 TPM_SECRET migrationAuth; // 21 20 41
908 TPM_DIGEST pubDataDigest; // 41 20 61
909 TPM_STORE_PRIVKEY privKey; // 61 132-151 193-214
910 } TPM_STORE_ASYMKEY;
911
912 //
913 // Part 2, section 10.8: TPM_MIGRATE_ASYMKEY
914 // [size_is(partPrivKeyLen)] BYTE* partPrivKey;
915 //
916 typedef struct tdTPM_MIGRATE_ASYMKEY { // pos len total
917 TPM_PAYLOAD_TYPE payload; // 0 1 1
918 TPM_SECRET usageAuth; // 1 20 21
919 TPM_DIGEST pubDataDigest; // 21 20 41
920 UINT32 partPrivKeyLen; // 41 4 45
921 UINT8 *partPrivKey; // 45 112-127 157-172
922 } TPM_MIGRATE_ASYMKEY;
923
924 //
925 // Part 2, section 10.9: TPM_KEY_CONTROL
926 //
927 #define TPM_KEY_CONTROL_OWNER_EVICT ((UINT32) 0x00000001)
928
929 //
930 // Part 2, section 11: Signed Structures
931 //
932
933 typedef struct tdTPM_CERTIFY_INFO
934 {
935 TPM_STRUCT_VER version;
936 TPM_KEY_USAGE keyUsage;
937 TPM_KEY_FLAGS keyFlags;
938 TPM_AUTH_DATA_USAGE authDataUsage;
939 TPM_KEY_PARMS algorithmParms;
940 TPM_DIGEST pubkeyDigest;
941 TPM_NONCE data;
942 BOOLEAN parentPCRStatus;
943 UINT32 PCRInfoSize;
944 UINT8 *PCRInfo;
945 } TPM_CERTIFY_INFO;
946
947 typedef struct tdTPM_CERTIFY_INFO2
948 {
949 TPM_STRUCTURE_TAG tag;
950 UINT8 fill;
951 TPM_PAYLOAD_TYPE payloadType;
952 TPM_KEY_USAGE keyUsage;
953 TPM_KEY_FLAGS keyFlags;
954 TPM_AUTH_DATA_USAGE authDataUsage;
955 TPM_KEY_PARMS algorithmParms;
956 TPM_DIGEST pubkeyDigest;
957 TPM_NONCE data;
958 BOOLEAN parentPCRStatus;
959 UINT32 PCRInfoSize;
960 UINT8 *PCRInfo;
961 UINT32 migrationAuthoritySize;
962 UINT8 *migrationAuthority;
963 } TPM_CERTIFY_INFO2;
964
965 typedef struct tdTPM_QUOTE_INFO
966 {
967 TPM_STRUCT_VER version;
968 UINT8 fixed[4];
969 TPM_COMPOSITE_HASH digestValue;
970 TPM_NONCE externalData;
971 } TPM_QUOTE_INFO;
972
973 typedef struct tdTPM_QUOTE_INFO2
974 {
975 TPM_STRUCTURE_TAG tag;
976 UINT8 fixed[4];
977 TPM_NONCE externalData;
978 TPM_PCR_INFO_SHORT infoShort;
979 } TPM_QUOTE_INFO2;
980
981 //
982 // Part 2, section 12: Identity Structures
983 //
984
985 typedef struct tdTPM_EK_BLOB
986 {
987 TPM_STRUCTURE_TAG tag;
988 TPM_EK_TYPE ekType;
989 UINT32 blobSize;
990 UINT8 *blob;
991 } TPM_EK_BLOB;
992
993 typedef struct tdTPM_EK_BLOB_ACTIVATE
994 {
995 TPM_STRUCTURE_TAG tag;
996 TPM_SYMMETRIC_KEY sessionKey;
997 TPM_DIGEST idDigest;
998 TPM_PCR_INFO_SHORT pcrInfo;
999 } TPM_EK_BLOB_ACTIVATE;
1000
1001 typedef struct tdTPM_EK_BLOB_AUTH
1002 {
1003 TPM_STRUCTURE_TAG tag;
1004 TPM_SECRET authValue;
1005 } TPM_EK_BLOB_AUTH;
1006
1007
1008 typedef struct tdTPM_IDENTITY_CONTENTS
1009 {
1010 TPM_STRUCT_VER ver;
1011 UINT32 ordinal;
1012 TPM_CHOSENID_HASH labelPrivCADigest;
1013 TPM_PUBKEY identityPubKey;
1014 } TPM_IDENTITY_CONTENTS;
1015
1016 typedef struct tdTPM_IDENTITY_REQ
1017 {
1018 UINT32 asymSize;
1019 UINT32 symSize;
1020 TPM_KEY_PARMS asymAlgorithm;
1021 TPM_KEY_PARMS symAlgorithm;
1022 UINT8 *asymBlob;
1023 UINT8 *symBlob;
1024 } TPM_IDENTITY_REQ;
1025
1026 typedef struct tdTPM_IDENTITY_PROOF
1027 {
1028 TPM_STRUCT_VER ver;
1029 UINT32 labelSize;
1030 UINT32 identityBindingSize;
1031 UINT32 endorsementSize;
1032 UINT32 platformSize;
1033 UINT32 conformanceSize;
1034 TPM_PUBKEY identityKey;
1035 UINT8 *labelArea;
1036 UINT8 *identityBinding;
1037 UINT8 *endorsementCredential;
1038 UINT8 *platformCredential;
1039 UINT8 *conformanceCredential;
1040 } TPM_IDENTITY_PROOF;
1041
1042 typedef struct tdTPM_ASYM_CA_CONTENTS
1043 {
1044 TPM_SYMMETRIC_KEY sessionKey;
1045 TPM_DIGEST idDigest;
1046 } TPM_ASYM_CA_CONTENTS;
1047
1048 typedef struct tdTPM_SYM_CA_ATTESTATION
1049 {
1050 UINT32 credSize;
1051 TPM_KEY_PARMS algorithm;
1052 UINT8 *credential;
1053 } TPM_SYM_CA_ATTESTATION;
1054
1055 //
1056 // Part 2, section 15: TPM_CURRENT_TICKS
1057 // Placed here out of order because definitions are used in section 13.
1058 //
1059 typedef struct tdTPM_CURRENT_TICKS {
1060 TPM_STRUCTURE_TAG tag;
1061 UINT64 currentTicks;
1062 UINT16 tickRate;
1063 TPM_NONCE tickNonce;
1064 } TPM_CURRENT_TICKS;
1065
1066 //
1067 // Part 2, section 13: Transport structures
1068 //
1069
1070 #define TPM_TRANSPORT_ENCRYPT ((UINT32)0x00000001)
1071 #define TPM_TRANSPORT_LOG ((UINT32)0x00000002)
1072 #define TPM_TRANSPORT_EXCLUSIVE ((UINT32)0x00000004)
1073
1074 typedef struct tdTPM_TRANSPORT_PUBLIC
1075 {
1076 TPM_STRUCTURE_TAG tag;
1077 TPM_TRANSPORT_ATTRIBUTES transAttributes;
1078 TPM_ALGORITHM_ID algId;
1079 TPM_ENC_SCHEME encScheme;
1080 } TPM_TRANSPORT_PUBLIC;
1081
1082 typedef struct tdTPM_TRANSPORT_INTERNAL
1083 {
1084 TPM_STRUCTURE_TAG tag;
1085 TPM_AUTHDATA authData;
1086 TPM_TRANSPORT_PUBLIC transPublic;
1087 TPM_TRANSHANDLE transHandle;
1088 TPM_NONCE transNonceEven;
1089 TPM_DIGEST transDigest;
1090 } TPM_TRANSPORT_INTERNAL;
1091
1092 typedef struct tdTPM_TRANSPORT_LOG_IN
1093 {
1094 TPM_STRUCTURE_TAG tag;
1095 TPM_DIGEST parameters;
1096 TPM_DIGEST pubKeyHash;
1097 } TPM_TRANSPORT_LOG_IN;
1098
1099 typedef struct tdTPM_TRANSPORT_LOG_OUT
1100 {
1101 TPM_STRUCTURE_TAG tag;
1102 TPM_CURRENT_TICKS currentTicks;
1103 TPM_DIGEST parameters;
1104 TPM_MODIFIER_INDICATOR locality;
1105 } TPM_TRANSPORT_LOG_OUT;
1106
1107 typedef struct tdTPM_TRANSPORT_AUTH
1108 {
1109 TPM_STRUCTURE_TAG tag;
1110 TPM_AUTHDATA authData;
1111 } TPM_TRANSPORT_AUTH;
1112
1113 //
1114 // Part 2, section 14: Audit Structures
1115 //
1116
1117 typedef struct tdTPM_AUDIT_EVENT_IN
1118 {
1119 TPM_STRUCTURE_TAG tag;
1120 TPM_DIGEST inputParms;
1121 TPM_COUNTER_VALUE auditCount;
1122 } TPM_AUDIT_EVENT_IN;
1123
1124 typedef struct tdTPM_AUDIT_EVENT_OUT
1125 {
1126 TPM_STRUCTURE_TAG tag;
1127 TPM_COMMAND_CODE ordinal;
1128 TPM_DIGEST outputParms;
1129 TPM_COUNTER_VALUE auditCount;
1130 TPM_RESULT returnCode;
1131 } TPM_AUDIT_EVENT_OUT;
1132
1133 //
1134 // Part 2, section 16: Return Codes
1135 //
1136 #ifndef TPM_BASE
1137 #error "TPM Error Codes require definition of TPM_BASE"
1138 #endif
1139
1140 #define TPM_VENDOR_ERROR TPM_Vendor_Specific32
1141 #define TPM_NON_FATAL 0x00000800
1142
1143 #define TPM_SUCCESS ((TPM_RESULT) TPM_BASE)
1144 #define TPM_AUTHFAIL ((TPM_RESULT) (TPM_BASE + 1))
1145 #define TPM_BADINDEX ((TPM_RESULT) (TPM_BASE + 2))
1146 #define TPM_BAD_PARAMETER ((TPM_RESULT) (TPM_BASE + 3))
1147 #define TPM_AUDITFAILURE ((TPM_RESULT) (TPM_BASE + 4))
1148 #define TPM_CLEAR_DISABLED ((TPM_RESULT) (TPM_BASE + 5))
1149 #define TPM_DEACTIVATED ((TPM_RESULT) (TPM_BASE + 6))
1150 #define TPM_DISABLED ((TPM_RESULT) (TPM_BASE + 7))
1151 #define TPM_DISABLED_CMD ((TPM_RESULT) (TPM_BASE + 8))
1152 #define TPM_FAIL ((TPM_RESULT) (TPM_BASE + 9))
1153 #define TPM_BAD_ORDINAL ((TPM_RESULT) (TPM_BASE + 10))
1154 #define TPM_INSTALL_DISABLED ((TPM_RESULT) (TPM_BASE + 11))
1155 #define TPM_INVALID_KEYHANDLE ((TPM_RESULT) (TPM_BASE + 12))
1156 #define TPM_KEYNOTFOUND ((TPM_RESULT) (TPM_BASE + 13))
1157 #define TPM_INAPPROPRIATE_ENC ((TPM_RESULT) (TPM_BASE + 14))
1158 #define TPM_MIGRATEFAIL ((TPM_RESULT) (TPM_BASE + 15))
1159 #define TPM_INVALID_PCR_INFO ((TPM_RESULT) (TPM_BASE + 16))
1160 #define TPM_NOSPACE ((TPM_RESULT) (TPM_BASE + 17))
1161 #define TPM_NOSRK ((TPM_RESULT) (TPM_BASE + 18))
1162 #define TPM_NOTSEALED_BLOB ((TPM_RESULT) (TPM_BASE + 19))
1163 #define TPM_OWNER_SET ((TPM_RESULT) (TPM_BASE + 20))
1164 #define TPM_RESOURCES ((TPM_RESULT) (TPM_BASE + 21))
1165 #define TPM_SHORTRANDOM ((TPM_RESULT) (TPM_BASE + 22))
1166 #define TPM_SIZE ((TPM_RESULT) (TPM_BASE + 23))
1167 #define TPM_WRONGPCRVAL ((TPM_RESULT) (TPM_BASE + 24))
1168 #define TPM_BAD_PARAM_SIZE ((TPM_RESULT) (TPM_BASE + 25))
1169 #define TPM_SHA_THREAD ((TPM_RESULT) (TPM_BASE + 26))
1170 #define TPM_SHA_ERROR ((TPM_RESULT) (TPM_BASE + 27))
1171 #define TPM_FAILEDSELFTEST ((TPM_RESULT) (TPM_BASE + 28))
1172 #define TPM_AUTH2FAIL ((TPM_RESULT) (TPM_BASE + 29))
1173 #define TPM_BADTAG ((TPM_RESULT) (TPM_BASE + 30))
1174 #define TPM_IOERROR ((TPM_RESULT) (TPM_BASE + 31))
1175 #define TPM_ENCRYPT_ERROR ((TPM_RESULT) (TPM_BASE + 32))
1176 #define TPM_DECRYPT_ERROR ((TPM_RESULT) (TPM_BASE + 33))
1177 #define TPM_INVALID_AUTHHANDLE ((TPM_RESULT) (TPM_BASE + 34))
1178 #define TPM_NO_ENDORSEMENT ((TPM_RESULT) (TPM_BASE + 35))
1179 #define TPM_INVALID_KEYUSAGE ((TPM_RESULT) (TPM_BASE + 36))
1180 #define TPM_WRONG_ENTITYTYPE ((TPM_RESULT) (TPM_BASE + 37))
1181 #define TPM_INVALID_POSTINIT ((TPM_RESULT) (TPM_BASE + 38))
1182 #define TPM_INAPPROPRIATE_SIG ((TPM_RESULT) (TPM_BASE + 39))
1183 #define TPM_BAD_KEY_PROPERTY ((TPM_RESULT) (TPM_BASE + 40))
1184 #define TPM_BAD_MIGRATION ((TPM_RESULT) (TPM_BASE + 41))
1185 #define TPM_BAD_SCHEME ((TPM_RESULT) (TPM_BASE + 42))
1186 #define TPM_BAD_DATASIZE ((TPM_RESULT) (TPM_BASE + 43))
1187 #define TPM_BAD_MODE ((TPM_RESULT) (TPM_BASE + 44))
1188 #define TPM_BAD_PRESENCE ((TPM_RESULT) (TPM_BASE + 45))
1189 #define TPM_BAD_VERSION ((TPM_RESULT) (TPM_BASE + 46))
1190 #define TPM_NO_WRAP_TRANSPORT ((TPM_RESULT) (TPM_BASE + 47))
1191 #define TPM_AUDITFAIL_UNSUCCESSFUL ((TPM_RESULT) (TPM_BASE + 48))
1192 #define TPM_AUDITFAIL_SUCCESSFUL ((TPM_RESULT) (TPM_BASE + 49))
1193 #define TPM_NOTRESETABLE ((TPM_RESULT) (TPM_BASE + 50))
1194 #define TPM_NOTLOCAL ((TPM_RESULT) (TPM_BASE + 51))
1195 #define TPM_BAD_TYPE ((TPM_RESULT) (TPM_BASE + 52))
1196 #define TPM_INVALID_RESOURCE ((TPM_RESULT) (TPM_BASE + 53))
1197 #define TPM_NOTFIPS ((TPM_RESULT) (TPM_BASE + 54))
1198 #define TPM_INVALID_FAMILY ((TPM_RESULT) (TPM_BASE + 55))
1199 #define TPM_NO_NV_PERMISSION ((TPM_RESULT) (TPM_BASE + 56))
1200 #define TPM_REQUIRES_SIGN ((TPM_RESULT) (TPM_BASE + 57))
1201 #define TPM_KEY_NOTSUPPORTED ((TPM_RESULT) (TPM_BASE + 58))
1202 #define TPM_AUTH_CONFLICT ((TPM_RESULT) (TPM_BASE + 59))
1203 #define TPM_AREA_LOCKED ((TPM_RESULT) (TPM_BASE + 60))
1204 #define TPM_BAD_LOCALITY ((TPM_RESULT) (TPM_BASE + 61))
1205 #define TPM_READ_ONLY ((TPM_RESULT) (TPM_BASE + 62))
1206 #define TPM_PER_NOWRITE ((TPM_RESULT) (TPM_BASE + 63))
1207 #define TPM_FAMILYCOUNT ((TPM_RESULT) (TPM_BASE + 64))
1208 #define TPM_WRITE_LOCKED ((TPM_RESULT) (TPM_BASE + 65))
1209 #define TPM_BAD_ATTRIBUTES ((TPM_RESULT) (TPM_BASE + 66))
1210 #define TPM_INVALID_STRUCTURE ((TPM_RESULT) (TPM_BASE + 67))
1211 #define TPM_KEY_OWNER_CONTROL ((TPM_RESULT) (TPM_BASE + 68))
1212 #define TPM_BAD_COUNTER ((TPM_RESULT) (TPM_BASE + 69))
1213 #define TPM_NOT_FULLWRITE ((TPM_RESULT) (TPM_BASE + 70))
1214 #define TPM_CONTEXT_GAP ((TPM_RESULT) (TPM_BASE + 71))
1215 #define TPM_MAXNVWRITES ((TPM_RESULT) (TPM_BASE + 72))
1216 #define TPM_NOOPERATOR ((TPM_RESULT) (TPM_BASE + 73))
1217 #define TPM_RESOURCEMISSING ((TPM_RESULT) (TPM_BASE + 74))
1218 #define TPM_DELEGATE_LOCK ((TPM_RESULT) (TPM_BASE + 75))
1219 #define TPM_DELEGATE_FAMILY ((TPM_RESULT) (TPM_BASE + 76))
1220 #define TPM_DELEGATE_ADMIN ((TPM_RESULT) (TPM_BASE + 77))
1221 #define TPM_TRANSPORT_NOTEXCLUSIVE ((TPM_RESULT) (TPM_BASE + 78))
1222 #define TPM_OWNER_CONTROL ((TPM_RESULT) (TPM_BASE + 79))
1223 #define TPM_DAA_RESOURCES ((TPM_RESULT) (TPM_BASE + 80))
1224 #define TPM_DAA_INPUT_DATA0 ((TPM_RESULT) (TPM_BASE + 81))
1225 #define TPM_DAA_INPUT_DATA1 ((TPM_RESULT) (TPM_BASE + 82))
1226 #define TPM_DAA_ISSUER_SETTINGS ((TPM_RESULT) (TPM_BASE + 83))
1227 #define TPM_DAA_TPM_SETTINGS ((TPM_RESULT) (TPM_BASE + 84))
1228 #define TPM_DAA_STAGE ((TPM_RESULT) (TPM_BASE + 85))
1229 #define TPM_DAA_ISSUER_VALIDITY ((TPM_RESULT) (TPM_BASE + 86))
1230 #define TPM_DAA_WRONG_W ((TPM_RESULT) (TPM_BASE + 87))
1231 #define TPM_BAD_HANDLE ((TPM_RESULT) (TPM_BASE + 88))
1232 #define TPM_BAD_DELEGATE ((TPM_RESULT) (TPM_BASE + 89))
1233 #define TPM_BADCONTEXT ((TPM_RESULT) (TPM_BASE + 90))
1234 #define TPM_TOOMANYCONTEXTS ((TPM_RESULT) (TPM_BASE + 91))
1235 #define TPM_MA_TICKET_SIGNATURE ((TPM_RESULT) (TPM_BASE + 92))
1236 #define TPM_MA_DESTINATION ((TPM_RESULT) (TPM_BASE + 93))
1237 #define TPM_MA_SOURCE ((TPM_RESULT) (TPM_BASE + 94))
1238 #define TPM_MA_AUTHORITY ((TPM_RESULT) (TPM_BASE + 95))
1239 #define TPM_PERMANENTEK ((TPM_RESULT) (TPM_BASE + 97))
1240 #define TPM_BAD_SIGNATURE ((TPM_RESULT) (TPM_BASE + 98))
1241 #define TPM_NOCONTEXTSPACE ((TPM_RESULT) (TPM_BASE + 99))
1242
1243 #define TPM_RETRY ((TPM_RESULT) (TPM_BASE + TPM_NON_FATAL))
1244 #define TPM_NEEDS_SELFTEST ((TPM_RESULT) (TPM_BASE + TPM_NON_FATAL + 1))
1245 #define TPM_DOING_SELFTEST ((TPM_RESULT) (TPM_BASE + TPM_NON_FATAL + 2))
1246 #define TPM_DEFEND_LOCK_RUNNING ((TPM_RESULT) (TPM_BASE + TPM_NON_FATAL + 3))
1247
1248 //
1249 // Part 2, section 17: Ordinals
1250 //
1251 // Ordinals are 32 bit values. The upper byte contains values that serve as
1252 // flag indicators, the next byte contains values indicating what committee
1253 // designated the ordinal, and the final two bytes contain the Command
1254 // Ordinal Index.
1255 // 3 2 1
1256 // 1 0 9 8 7 6 5 4 3 2 1 0 9 8 7 6 5 4 3 2 1 0 9 8 7 6 5 4 3 2 1 0
1257 // +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
1258 // |P|C|V| Reserved| Purview | Command Ordinal Index |
1259 // +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
1260 //
1261 // Where:
1262 //
1263 // * P is Protected/Unprotected command. When 0 the command is a Protected
1264 // command, when 1 the command is an Unprotected command.
1265 //
1266 // * C is Non-Connection/Connection related command. When 0 this command
1267 // passes through to either the protected (TPM) or unprotected (TSS)
1268 // components.
1269 //
1270 // * V is TPM/Vendor command. When 0 the command is TPM defined, when 1 the
1271 // command is vendor defined.
1272 //
1273 // * All reserved area bits are set to 0.
1274 //
1275
1276 #define TPM_ORD_ActivateIdentity ((TPM_COMMAND_CODE) 0x0000007A)
1277 #define TPM_ORD_AuthorizeMigrationKey ((TPM_COMMAND_CODE) 0x0000002B)
1278 #define TPM_ORD_CertifyKey ((TPM_COMMAND_CODE) 0x00000032)
1279 #define TPM_ORD_CertifyKey2 ((TPM_COMMAND_CODE) 0x00000033)
1280 #define TPM_ORD_CertifySelfTest ((TPM_COMMAND_CODE) 0x00000052)
1281 #define TPM_ORD_ChangeAuth ((TPM_COMMAND_CODE) 0x0000000C)
1282 #define TPM_ORD_ChangeAuthAsymFinish ((TPM_COMMAND_CODE) 0x0000000F)
1283 #define TPM_ORD_ChangeAuthAsymStart ((TPM_COMMAND_CODE) 0x0000000E)
1284 #define TPM_ORD_ChangeAuthOwner ((TPM_COMMAND_CODE) 0x00000010)
1285 #define TPM_ORD_CMK_ApproveMA ((TPM_COMMAND_CODE) 0x0000001D)
1286 #define TPM_ORD_CMK_ConvertMigration ((TPM_COMMAND_CODE) 0x00000024)
1287 #define TPM_ORD_CMK_CreateBlob ((TPM_COMMAND_CODE) 0x0000001B)
1288 #define TPM_ORD_CMK_CreateKey ((TPM_COMMAND_CODE) 0x00000013)
1289 #define TPM_ORD_CMK_CreateTicket ((TPM_COMMAND_CODE) 0x00000012)
1290 #define TPM_ORD_CMK_SetRestrictions ((TPM_COMMAND_CODE) 0x0000001C)
1291 #define TPM_ORD_ContinueSelfTest ((TPM_COMMAND_CODE) 0x00000053)
1292 #define TPM_ORD_ConvertMigrationBlob ((TPM_COMMAND_CODE) 0x0000002A)
1293 #define TPM_ORD_CreateCounter ((TPM_COMMAND_CODE) 0x000000DC)
1294 #define TPM_ORD_CreateEndorsementKeyPair ((TPM_COMMAND_CODE) 0x00000078)
1295 #define TPM_ORD_CreateMaintenanceArchive ((TPM_COMMAND_CODE) 0x0000002C)
1296 #define TPM_ORD_CreateMigrationBlob ((TPM_COMMAND_CODE) 0x00000028)
1297 #define TPM_ORD_CreateRevocableEK ((TPM_COMMAND_CODE) 0x0000007F)
1298 #define TPM_ORD_CreateWrapKey ((TPM_COMMAND_CODE) 0x0000001F)
1299 #define TPM_ORD_DAA_JOIN ((TPM_COMMAND_CODE) 0x00000029)
1300 #define TPM_ORD_DAA_SIGN ((TPM_COMMAND_CODE) 0x00000031)
1301 #define TPM_ORD_Delegate_CreateKeyDelegation ((TPM_COMMAND_CODE) 0x000000D4)
1302 #define TPM_ORD_Delegate_CreateOwnerDelegation ((TPM_COMMAND_CODE) 0x000000D5)
1303 #define TPM_ORD_Delegate_LoadOwnerDelegation ((TPM_COMMAND_CODE) 0x000000D8)
1304 #define TPM_ORD_Delegate_Manage ((TPM_COMMAND_CODE) 0x000000D2)
1305 #define TPM_ORD_Delegate_ReadTable ((TPM_COMMAND_CODE) 0x000000DB)
1306 #define TPM_ORD_Delegate_UpdateVerification ((TPM_COMMAND_CODE) 0x000000D1)
1307 #define TPM_ORD_Delegate_VerifyDelegation ((TPM_COMMAND_CODE) 0x000000D6)
1308 #define TPM_ORD_DirRead ((TPM_COMMAND_CODE) 0x0000001A)
1309 #define TPM_ORD_DirWriteAuth ((TPM_COMMAND_CODE) 0x00000019)
1310 #define TPM_ORD_DisableForceClear ((TPM_COMMAND_CODE) 0x0000005E)
1311 #define TPM_ORD_DisableOwnerClear ((TPM_COMMAND_CODE) 0x0000005C)
1312 #define TPM_ORD_DisablePubekRead ((TPM_COMMAND_CODE) 0x0000007E)
1313 #define TPM_ORD_DSAP ((TPM_COMMAND_CODE) 0x00000011)
1314 #define TPM_ORD_EstablishTransport ((TPM_COMMAND_CODE) 0x000000E6)
1315 #define TPM_ORD_EvictKey ((TPM_COMMAND_CODE) 0x00000022)
1316 #define TPM_ORD_ExecuteTransport ((TPM_COMMAND_CODE) 0x000000E7)
1317 #define TPM_ORD_Extend ((TPM_COMMAND_CODE) 0x00000014)
1318 #define TPM_ORD_FieldUpgrade ((TPM_COMMAND_CODE) 0x000000AA)
1319 #define TPM_ORD_FlushSpecific ((TPM_COMMAND_CODE) 0x000000BA)
1320 #define TPM_ORD_ForceClear ((TPM_COMMAND_CODE) 0x0000005D)
1321 #define TPM_ORD_GetAuditDigest ((TPM_COMMAND_CODE) 0x00000085)
1322 #define TPM_ORD_GetAuditDigestSigned ((TPM_COMMAND_CODE) 0x00000086)
1323 #define TPM_ORD_GetAuditEvent ((TPM_COMMAND_CODE) 0x00000082)
1324 #define TPM_ORD_GetAuditEventSigned ((TPM_COMMAND_CODE) 0x00000083)
1325 #define TPM_ORD_GetCapability ((TPM_COMMAND_CODE) 0x00000065)
1326 #define TPM_ORD_GetCapabilityOwner ((TPM_COMMAND_CODE) 0x00000066)
1327 #define TPM_ORD_GetCapabilitySigned ((TPM_COMMAND_CODE) 0x00000064)
1328 #define TPM_ORD_GetOrdinalAuditStatus ((TPM_COMMAND_CODE) 0x0000008C)
1329 #define TPM_ORD_GetPubKey ((TPM_COMMAND_CODE) 0x00000021)
1330 #define TPM_ORD_GetRandom ((TPM_COMMAND_CODE) 0x00000046)
1331 #define TPM_ORD_GetTestResult ((TPM_COMMAND_CODE) 0x00000054)
1332 #define TPM_ORD_GetTicks ((TPM_COMMAND_CODE) 0x000000F1)
1333 #define TPM_ORD_IncrementCounter ((TPM_COMMAND_CODE) 0x000000DD)
1334 #define TPM_ORD_Init ((TPM_COMMAND_CODE) 0x00000097)
1335 #define TPM_ORD_KeyControlOwner ((TPM_COMMAND_CODE) 0x00000023)
1336 #define TPM_ORD_KillMaintenanceFeature ((TPM_COMMAND_CODE) 0x0000002E)
1337 #define TPM_ORD_LoadAuthContext ((TPM_COMMAND_CODE) 0x000000B7)
1338 #define TPM_ORD_LoadContext ((TPM_COMMAND_CODE) 0x000000B9)
1339 #define TPM_ORD_LoadKey ((TPM_COMMAND_CODE) 0x00000020)
1340 #define TPM_ORD_LoadKey2 ((TPM_COMMAND_CODE) 0x00000041)
1341 #define TPM_ORD_LoadKeyContext ((TPM_COMMAND_CODE) 0x000000B5)
1342 #define TPM_ORD_LoadMaintenanceArchive ((TPM_COMMAND_CODE) 0x0000002D)
1343 #define TPM_ORD_LoadManuMaintPub ((TPM_COMMAND_CODE) 0x0000002F)
1344 #define TPM_ORD_MakeIdentity ((TPM_COMMAND_CODE) 0x00000079)
1345 #define TPM_ORD_MigrateKey ((TPM_COMMAND_CODE) 0x00000025)
1346 #define TPM_ORD_NV_DefineSpace ((TPM_COMMAND_CODE) 0x000000CC)
1347 #define TPM_ORD_NV_ReadValue ((TPM_COMMAND_CODE) 0x000000CF)
1348 #define TPM_ORD_NV_ReadValueAuth ((TPM_COMMAND_CODE) 0x000000D0)
1349 #define TPM_ORD_NV_WriteValue ((TPM_COMMAND_CODE) 0x000000CD)
1350 #define TPM_ORD_NV_WriteValueAuth ((TPM_COMMAND_CODE) 0x000000CE)
1351 #define TPM_ORD_OIAP ((TPM_COMMAND_CODE) 0x0000000A)
1352 #define TPM_ORD_OSAP ((TPM_COMMAND_CODE) 0x0000000B)
1353 #define TPM_ORD_OwnerClear ((TPM_COMMAND_CODE) 0x0000005B)
1354 #define TPM_ORD_OwnerReadInternalPub ((TPM_COMMAND_CODE) 0x00000081)
1355 #define TPM_ORD_OwnerReadPubek ((TPM_COMMAND_CODE) 0x0000007D)
1356 #define TPM_ORD_OwnerSetDisable ((TPM_COMMAND_CODE) 0x0000006E)
1357 #define TPM_ORD_PCR_Reset ((TPM_COMMAND_CODE) 0x000000C8)
1358 #define TPM_ORD_PcrRead ((TPM_COMMAND_CODE) 0x00000015)
1359 #define TPM_ORD_PhysicalDisable ((TPM_COMMAND_CODE) 0x00000070)
1360 #define TPM_ORD_PhysicalEnable ((TPM_COMMAND_CODE) 0x0000006F)
1361 #define TPM_ORD_PhysicalSetDeactivated ((TPM_COMMAND_CODE) 0x00000072)
1362 #define TPM_ORD_Quote ((TPM_COMMAND_CODE) 0x00000016)
1363 #define TPM_ORD_Quote2 ((TPM_COMMAND_CODE) 0x0000003E)
1364 #define TPM_ORD_ReadCounter ((TPM_COMMAND_CODE) 0x000000DE)
1365 #define TPM_ORD_ReadManuMaintPub ((TPM_COMMAND_CODE) 0x00000030)
1366 #define TPM_ORD_ReadPubek ((TPM_COMMAND_CODE) 0x0000007C)
1367 #define TPM_ORD_ReleaseCounter ((TPM_COMMAND_CODE) 0x000000DF)
1368 #define TPM_ORD_ReleaseCounterOwner ((TPM_COMMAND_CODE) 0x000000E0)
1369 #define TPM_ORD_ReleaseTransportSigned ((TPM_COMMAND_CODE) 0x000000E8)
1370 #define TPM_ORD_Reset ((TPM_COMMAND_CODE) 0x0000005A)
1371 #define TPM_ORD_ResetLockValue ((TPM_COMMAND_CODE) 0x00000040)
1372 #define TPM_ORD_RevokeTrust ((TPM_COMMAND_CODE) 0x00000080)
1373 #define TPM_ORD_SaveAuthContext ((TPM_COMMAND_CODE) 0x000000B6)
1374 #define TPM_ORD_SaveContext ((TPM_COMMAND_CODE) 0x000000B8)
1375 #define TPM_ORD_SaveKeyContext ((TPM_COMMAND_CODE) 0x000000B4)
1376 #define TPM_ORD_SaveState ((TPM_COMMAND_CODE) 0x00000098)
1377 #define TPM_ORD_Seal ((TPM_COMMAND_CODE) 0x00000017)
1378 #define TPM_ORD_Sealx ((TPM_COMMAND_CODE) 0x0000003D)
1379 #define TPM_ORD_SelfTestFull ((TPM_COMMAND_CODE) 0x00000050)
1380 #define TPM_ORD_SetCapability ((TPM_COMMAND_CODE) 0x0000003F)
1381 #define TPM_ORD_SetOperatorAuth ((TPM_COMMAND_CODE) 0x00000074)
1382 #define TPM_ORD_SetOrdinalAuditStatus ((TPM_COMMAND_CODE) 0x0000008D)
1383 #define TPM_ORD_SetOwnerInstall ((TPM_COMMAND_CODE) 0x00000071)
1384 #define TPM_ORD_SetOwnerPointer ((TPM_COMMAND_CODE) 0x00000075)
1385 #define TPM_ORD_SetRedirection ((TPM_COMMAND_CODE) 0x0000009A)
1386 #define TPM_ORD_SetTempDeactivated ((TPM_COMMAND_CODE) 0x00000073)
1387 #define TPM_ORD_SHA1Complete ((TPM_COMMAND_CODE) 0x000000A2)
1388 #define TPM_ORD_SHA1CompleteExtend ((TPM_COMMAND_CODE) 0x000000A3)
1389 #define TPM_ORD_SHA1Start ((TPM_COMMAND_CODE) 0x000000A0)
1390 #define TPM_ORD_SHA1Update ((TPM_COMMAND_CODE) 0x000000A1)
1391 #define TPM_ORD_Sign ((TPM_COMMAND_CODE) 0x0000003C)
1392 #define TPM_ORD_Startup ((TPM_COMMAND_CODE) 0x00000099)
1393 #define TPM_ORD_StirRandom ((TPM_COMMAND_CODE) 0x00000047)
1394 #define TPM_ORD_TakeOwnership ((TPM_COMMAND_CODE) 0x0000000D)
1395 #define TPM_ORD_Terminate_Handle ((TPM_COMMAND_CODE) 0x00000096)
1396 #define TPM_ORD_TickStampBlob ((TPM_COMMAND_CODE) 0x000000F2)
1397 #define TPM_ORD_UnBind ((TPM_COMMAND_CODE) 0x0000001E)
1398 #define TPM_ORD_Unseal ((TPM_COMMAND_CODE) 0x00000018)
1399 #define TSC_ORD_PhysicalPresence ((TPM_COMMAND_CODE) 0x4000000A)
1400 #define TSC_ORD_ResetEstablishmentBit ((TPM_COMMAND_CODE) 0x4000000B)
1401
1402 //
1403 // Part 2, section 18: Context structures
1404 //
1405
1406 typedef struct tdTPM_CONTEXT_BLOB
1407 {
1408 TPM_STRUCTURE_TAG tag;
1409 TPM_RESOURCE_TYPE resourceType;
1410 TPM_HANDLE handle;
1411 UINT8 label[16];
1412 UINT32 contextCount;
1413 TPM_DIGEST integrityDigest;
1414 UINT32 additionalSize;
1415 UINT8 *additionalData;
1416 UINT32 sensitiveSize;
1417 UINT8 *sensitiveData;
1418 } TPM_CONTEXT_BLOB;
1419
1420 typedef struct tdTPM_CONTEXT_SENSITIVE
1421 {
1422 TPM_STRUCTURE_TAG tag;
1423 TPM_NONCE contextNonce;
1424 UINT32 internalSize;
1425 UINT8 *internalData;
1426 } TPM_CONTEXT_SENSITIVE;
1427
1428 //
1429 // Part 2, section 19: NV Structures
1430 //
1431
1432 #define TPM_NV_INDEX_LOCK ((UINT32)0xffffffff)
1433 #define TPM_NV_INDEX0 ((UINT32)0x00000000)
1434 #define TPM_NV_INDEX_DIR ((UINT32)0x10000001)
1435 #define TPM_NV_INDEX_EKCert ((UINT32)0x0000f000)
1436 #define TPM_NV_INDEX_TPM_CC ((UINT32)0x0000f001)
1437 #define TPM_NV_INDEX_PlatformCert ((UINT32)0x0000f002)
1438 #define TPM_NV_INDEX_Platform_CC ((UINT32)0x0000f003)
1439 // The following define ranges of reserved indices.
1440 #define TPM_NV_INDEX_TSS_BASE ((UINT32)0x00011100)
1441 #define TPM_NV_INDEX_PC_BASE ((UINT32)0x00011200)
1442 #define TPM_NV_INDEX_SERVER_BASE ((UINT32)0x00011300)
1443 #define TPM_NV_INDEX_MOBILE_BASE ((UINT32)0x00011400)
1444 #define TPM_NV_INDEX_PERIPHERAL_BASE ((UINT32)0x00011500)
1445 #define TPM_NV_INDEX_GROUP_RESV_BASE ((UINT32)0x00010000)
1446
1447 typedef UINT32 TPM_NV_PER_ATTRIBUTES;
1448 // The typedefs TPM_NV_PER_ATTRIBUTES (not present in TPM 1.2 Spec. have been added
1449 // and structure fields that were to hold the following values
1450 #define TPM_NV_PER_READ_STCLEAR (((UINT32)1)<<31)
1451 #define TPM_NV_PER_AUTHREAD (((UINT32)1)<<18)
1452 #define TPM_NV_PER_OWNERREAD (((UINT32)1)<<17)
1453 #define TPM_NV_PER_PPREAD (((UINT32)1)<<16)
1454 #define TPM_NV_PER_GLOBALLOCK (((UINT32)1)<<15)
1455 #define TPM_NV_PER_WRITE_STCLEAR (((UINT32)1)<<14)
1456 #define TPM_NV_PER_WRITEDEFINE (((UINT32)1)<<13)
1457 #define TPM_NV_PER_WRITEALL (((UINT32)1)<<12)
1458 #define TPM_NV_PER_AUTHWRITE (((UINT32)1)<<2)
1459 #define TPM_NV_PER_OWNERWRITE (((UINT32)1)<<1)
1460 #define TPM_NV_PER_PPWRITE (((UINT32)1)<<0)
1461
1462 typedef struct tdTPM_NV_ATTRIBUTES
1463 {
1464 TPM_STRUCTURE_TAG tag;
1465 TPM_NV_PER_ATTRIBUTES attributes;
1466 } TPM_NV_ATTRIBUTES;
1467
1468
1469 typedef struct tdTPM_NV_DATA_PUBLIC
1470 {
1471 TPM_STRUCTURE_TAG tag;
1472 TPM_NV_INDEX nvIndex;
1473 TPM_PCR_INFO_SHORT pcrInfoRead;
1474 TPM_PCR_INFO_SHORT pcrInfoWrite;
1475 TPM_NV_ATTRIBUTES permission;
1476 BOOLEAN bReadSTClear;
1477 BOOLEAN bWriteSTClear;
1478 BOOLEAN bWriteDefine;
1479 UINT32 dataSize;
1480 } TPM_NV_DATA_PUBLIC;
1481
1482
1483
1484 // Internal to TPM:
1485 //typedef struct tdTPM_NV_DATA_SENSITIVE
1486 //{
1487 // TPM_STRUCTURE_TAG tag;
1488 // TPM_NV_DATA_PUBLIC pubInfo;
1489 // TPM_AUTHDATA authValue;
1490 // UINT8 *data;
1491 //} TPM_NV_DATA_SENSITIVE;
1492
1493
1494 //
1495 // Part 2, section 20: Delegation
1496 //
1497
1498 //
1499 // Part 2, section 20.3: Owner Permissions Settings for per1 bits
1500 //
1501 #define TPM_DELEGATE_SetOrdinalAuditStatus (((UINT32)1)<<30)
1502 #define TPM_DELEGATE_DirWriteAuth (((UINT32)1)<<29)
1503 #define TPM_DELEGATE_CMK_ApproveMA (((UINT32)1)<<28)
1504 #define TPM_DELEGATE_CMK_CreateTicket (((UINT32)1)<<26)
1505 #define TPM_DELEGATE_Delegate_LoadOwnerDelegation (((UINT32)1)<<24)
1506 #define TPM_DELEGATE_DAA_Join (((UINT32)1)<<23)
1507 #define TPM_DELEGATE_AuthorizeMigrationKey (((UINT32)1)<<22)
1508 #define TPM_DELEGATE_CreateMaintenanceArchive (((UINT32)1)<<21)
1509 #define TPM_DELEGATE_LoadMaintenanceArchive (((UINT32)1)<<20)
1510 #define TPM_DELEGATE_KillMaintenanceFeature (((UINT32)1)<<19)
1511 #define TPM_DELEGATE_OwnerReadInteralPub (((UINT32)1)<<18)
1512 #define TPM_DELEGATE_ResetLockValue (((UINT32)1)<<17)
1513 #define TPM_DELEGATE_OwnerClear (((UINT32)1)<<16)
1514 #define TPM_DELEGATE_DisableOwnerClear (((UINT32)1)<<15)
1515 #define TPM_DELEGATE_OwnerSetDisable (((UINT32)1)<<13)
1516 #define TPM_DELEGATE_SetCapability (((UINT32)1)<<12)
1517 #define TPM_DELEGATE_MakeIdentity (((UINT32)1)<<11)
1518 #define TPM_DELEGATE_ActivateIdentity (((UINT32)1)<<10)
1519 #define TPM_DELEGATE_OwnerReadPubek (((UINT32)1)<<9)
1520 #define TPM_DELEGATE_DisablePubekRead (((UINT32)1)<<8)
1521 #define TPM_DELEGATE_SetRedirection (((UINT32)1)<<7)
1522 #define TPM_DELEGATE_FieldUpgrade (((UINT32)1)<<6)
1523 #define TPM_DELEGATE_Delegate_UpdateVerification (((UINT32)1)<<5)
1524 #define TPM_DELEGATE_CreateCounter (((UINT32)1)<<4)
1525 #define TPM_DELEGATE_ReleaseCounterOwner (((UINT32)1)<<3)
1526 #define TPM_DELEGATE_DelegateManage (((UINT32)1)<<2)
1527 #define TPM_DELEGATE_Delegate_CreateOwnerDelegation (((UINT32)1)<<1)
1528 #define TPM_DELEGATE_DAA_Sign (((UINT32)1)<<0)
1529
1530 //
1531 // Part 2, section 20.3: Key Permissions Settings for per1 bits
1532 //
1533 #define TPM_KEY_DELEGATE_CMK_ConvertMigration (((UINT32)1)<<28)
1534 #define TPM_KEY_DELEGATE_TickStampBlob (((UINT32)1)<<27)
1535 #define TPM_KEY_DELEGATE_ChangeAuthAsymStart (((UINT32)1)<<26)
1536 #define TPM_KEY_DELEGATE_ChangeAuthAsymFinish (((UINT32)1)<<25)
1537 #define TPM_KEY_DELEGATE_CMK_CreateKey (((UINT32)1)<<24)
1538 #define TPM_KEY_DELEGATE_MigrateKey (((UINT32)1)<<23)
1539 #define TPM_KEY_DELEGATE_LoadKey2 (((UINT32)1)<<22)
1540 #define TPM_KEY_DELEGATE_EstablishTransport (((UINT32)1)<<21)
1541 #define TPM_KEY_DELEGATE_ReleaseTransportSigned (((UINT32)1)<<20)
1542 #define TPM_KEY_DELEGATE_Quote2 (((UINT32)1)<<19)
1543 #define TPM_KEY_DELEGATE_Sealx (((UINT32)1)<<18)
1544 #define TPM_KEY_DELEGATE_MakeIdentity (((UINT32)1)<<17)
1545 #define TPM_KEY_DELEGATE_ActivateIdentity (((UINT32)1)<<16)
1546 #define TPM_KEY_DELEGATE_GetAuditDigestSigned (((UINT32)1)<<15)
1547 #define TPM_KEY_DELEGATE_Sign (((UINT32)1)<<14)
1548 #define TPM_KEY_DELEGATE_CertifyKey2 (((UINT32)1)<<13)
1549 #define TPM_KEY_DELEGATE_CertifyKey (((UINT32)1)<<12)
1550 #define TPM_KEY_DELEGATE_CreateWrapKey (((UINT32)1)<<11)
1551 #define TPM_KEY_DELEGATE_CMK_CreateBlob (((UINT32)1)<<10)
1552 #define TPM_KEY_DELEGATE_CreateMigrationBlob (((UINT32)1)<<9)
1553 #define TPM_KEY_DELEGATE_ConvertMigrationBlob (((UINT32)1)<<8)
1554 #define TPM_KEY_DELEGATE_CreateKeyDelegation (((UINT32)1)<<7)
1555 #define TPM_KEY_DELEGATE_ChangeAuth (((UINT32)1)<<6)
1556 #define TPM_KEY_DELEGATE_GetPubKey (((UINT32)1)<<5)
1557 #define TPM_KEY_DELEGATE_UnBind (((UINT32)1)<<4)
1558 #define TPM_KEY_DELEGATE_Quote (((UINT32)1)<<3)
1559 #define TPM_KEY_DELEGATE_Unseal (((UINT32)1)<<2)
1560 #define TPM_KEY_DELEGATE_Seal (((UINT32)1)<<1)
1561 #define TPM_KEY_DELEGATE_LoadKey (((UINT32)1)<<0)
1562
1563 #define TPM_FAMILY_CREATE ((UINT32)0x00000001)
1564 #define TPM_FAMILY_ENABLE ((UINT32)0x00000002)
1565 #define TPM_FAMILY_ADMIN ((UINT32)0x00000003)
1566 #define TPM_FAMILY_INVALIDATE ((UINT32)0x00000004)
1567
1568 #define TPM_FAMFLAG_DELEGATE_ADMIN_LOCK (((UINT32)1)<<1)
1569 #define TPM_FAMFLAG_ENABLE (((UINT32)1)<<0)
1570
1571 typedef struct tdTPM_FAMILY_LABEL
1572 {
1573 UINT8 label;
1574 } TPM_FAMILY_LABEL;
1575
1576 typedef struct tdTPM_FAMILY_TABLE_ENTRY
1577 {
1578 TPM_STRUCTURE_TAG tag;
1579 TPM_FAMILY_LABEL label;
1580 TPM_FAMILY_ID familyID;
1581 TPM_FAMILY_VERIFICATION verificationCount;
1582 TPM_FAMILY_FLAGS flags;
1583 } TPM_FAMILY_TABLE_ENTRY;
1584
1585 #define TPM_FAMILY_TABLE_ENTRY_MIN 8
1586 //typedef struct tdTPM_FAMILY_TABLE
1587 //{
1588 // TPM_FAMILY_TABLE_ENTRY FamTableRow[TPM_NUM_FAMILY_TABLE_ENTRY_MIN];
1589 //} TPM_FAMILY_TABLE;
1590
1591
1592 typedef struct tdTPM_DELEGATE_LABEL
1593 {
1594 UINT8 label;
1595 } TPM_DELEGATE_LABEL;
1596
1597
1598 typedef UINT32 TPM_DELEGATE_TYPE;
1599 #define TPM_DEL_OWNER_BITS ((UINT32)0x00000001)
1600 #define TPM_DEL_KEY_BITS ((UINT32)0x00000002)
1601
1602 typedef struct tdTPM_DELEGATIONS
1603 {
1604 TPM_STRUCTURE_TAG tag;
1605 TPM_DELEGATE_TYPE delegateType;
1606 UINT32 per1;
1607 UINT32 per2;
1608 } TPM_DELEGATIONS;
1609
1610 typedef struct tdTPM_DELEGATE_PUBLIC
1611 {
1612 TPM_STRUCTURE_TAG tag;
1613 TPM_DELEGATE_LABEL label;
1614 TPM_PCR_INFO_SHORT pcrInfo;
1615 TPM_DELEGATIONS permissions;
1616 TPM_FAMILY_ID familyID;
1617 TPM_FAMILY_VERIFICATION verificationCount;
1618 } TPM_DELEGATE_PUBLIC;
1619
1620 typedef struct tdTPM_DELEGATE_TABLE_ROW
1621 {
1622 TPM_STRUCTURE_TAG tag;
1623 TPM_DELEGATE_PUBLIC pub;
1624 TPM_SECRET authValue;
1625 } TPM_DELEGATE_TABLE_ROW;
1626
1627
1628 #define TPM_NUM_DELEGATE_TABLE_ENTRY_MIN 2
1629 //typedef struct tdTPM_DELEGATE_TABLE
1630 //{
1631 // TPM_DELEGATE_TABLE_ROW delRow[TPM_NUM_DELEGATE_TABLE_ENTRY_MIN];
1632 //} TPM_DELEGATE_TABLE;
1633
1634 typedef struct tdTPM_DELEGATE_SENSITIVE
1635 {
1636 TPM_STRUCTURE_TAG tag;
1637 TPM_SECRET authValue;
1638 } TPM_DELEGATE_SENSITIVE;
1639
1640 typedef struct tdTPM_DELEGATE_OWNER_BLOB
1641 {
1642 TPM_STRUCTURE_TAG tag;
1643 TPM_DELEGATE_PUBLIC pub;
1644 TPM_DIGEST integrityDigest;
1645 UINT32 additionalSize;
1646 UINT8 *additionalArea;
1647 UINT32 sensitiveSize;
1648 UINT8 *sensitiveArea;
1649 } TPM_DELEGATE_OWNER_BLOB;
1650
1651 typedef struct tdTPM_DELEGATE_KEY_BLOB
1652 {
1653 TPM_STRUCTURE_TAG tag;
1654 TPM_DELEGATE_PUBLIC pub;
1655 TPM_DIGEST integrityDigest;
1656 TPM_DIGEST pubKeyDigest;
1657 UINT32 additionalSize;
1658 UINT8 *additionalArea;
1659 UINT32 sensitiveSize;
1660 UINT8 *sensitiveArea;
1661 } TPM_DELEGATE_KEY_BLOB;
1662
1663 //
1664 // Part 2, section 21.1: TPM_CAPABILITY_AREA for GetCapability
1665 //
1666 #define TPM_CAP_ORD ((TPM_CAPABILITY_AREA) 0x00000001)
1667 #define TPM_CAP_ALG ((TPM_CAPABILITY_AREA) 0x00000002)
1668 #define TPM_CAP_PID ((TPM_CAPABILITY_AREA) 0x00000003)
1669 #define TPM_CAP_FLAG ((TPM_CAPABILITY_AREA) 0x00000004)
1670 #define TPM_CAP_PROPERTY ((TPM_CAPABILITY_AREA) 0x00000005)
1671 #define TPM_CAP_VERSION ((TPM_CAPABILITY_AREA) 0x00000006)
1672 #define TPM_CAP_KEY_HANDLE ((TPM_CAPABILITY_AREA) 0x00000007)
1673 #define TPM_CAP_CHECK_LOADED ((TPM_CAPABILITY_AREA) 0x00000008)
1674 #define TPM_CAP_SYM_MODE ((TPM_CAPABILITY_AREA) 0x00000009)
1675 #define TPM_CAP_KEY_STATUS ((TPM_CAPABILITY_AREA) 0x0000000C)
1676 #define TPM_CAP_NV_LIST ((TPM_CAPABILITY_AREA) 0x0000000D)
1677 #define TPM_CAP_MFR ((TPM_CAPABILITY_AREA) 0x00000010)
1678 #define TPM_CAP_NV_INDEX ((TPM_CAPABILITY_AREA) 0x00000011)
1679 #define TPM_CAP_TRANS_ALG ((TPM_CAPABILITY_AREA) 0x00000012)
1680 #define TPM_CAP_HANDLE ((TPM_CAPABILITY_AREA) 0x00000014)
1681 #define TPM_CAP_TRANS_ES ((TPM_CAPABILITY_AREA) 0x00000015)
1682 #define TPM_CAP_AUTH_ENCRYPT ((TPM_CAPABILITY_AREA) 0x00000017)
1683 #define TPM_CAP_SELECT_SIZE ((TPM_CAPABILITY_AREA) 0x00000018)
1684 #define TPM_CAP_VERSION_VAL ((TPM_CAPABILITY_AREA) 0x0000001A)
1685
1686 #define TPM_CAP_FLAG_PERMANENT ((TPM_CAPABILITY_AREA) 0x00000108)
1687 #define TPM_CAP_FLAG_VOLATILE ((TPM_CAPABILITY_AREA) 0x00000109)
1688
1689 //
1690 // Part 2, section 21.2: CAP_PROPERTY Subcap values for GetCapability
1691 //
1692 #define TPM_CAP_PROP_PCR ((TPM_CAPABILITY_AREA) 0x00000101)
1693 #define TPM_CAP_PROP_DIR ((TPM_CAPABILITY_AREA) 0x00000102)
1694 #define TPM_CAP_PROP_MANUFACTURER ((TPM_CAPABILITY_AREA) 0x00000103)
1695 #define TPM_CAP_PROP_KEYS ((TPM_CAPABILITY_AREA) 0x00000104)
1696 #define TPM_CAP_PROP_MIN_COUNTER ((TPM_CAPABILITY_AREA) 0x00000107)
1697 #define TPM_CAP_PROP_AUTHSESS ((TPM_CAPABILITY_AREA) 0x0000010A)
1698 #define TPM_CAP_PROP_TRANSESS ((TPM_CAPABILITY_AREA) 0x0000010B)
1699 #define TPM_CAP_PROP_COUNTERS ((TPM_CAPABILITY_AREA) 0x0000010C)
1700 #define TPM_CAP_PROP_MAX_AUTHSESS ((TPM_CAPABILITY_AREA) 0x0000010D)
1701 #define TPM_CAP_PROP_MAX_TRANSESS ((TPM_CAPABILITY_AREA) 0x0000010E)
1702 #define TPM_CAP_PROP_MAX_COUNTERS ((TPM_CAPABILITY_AREA) 0x0000010F)
1703 #define TPM_CAP_PROP_MAX_KEYS ((TPM_CAPABILITY_AREA) 0x00000110)
1704 #define TPM_CAP_PROP_OWNER ((TPM_CAPABILITY_AREA) 0x00000111)
1705 #define TPM_CAP_PROP_CONTEXT ((TPM_CAPABILITY_AREA) 0x00000112)
1706 #define TPM_CAP_PROP_MAX_CONTEXT ((TPM_CAPABILITY_AREA) 0x00000113)
1707 #define TPM_CAP_PROP_FAMILYROWS ((TPM_CAPABILITY_AREA) 0x00000114)
1708 #define TPM_CAP_PROP_TIS_TIMEOUT ((TPM_CAPABILITY_AREA) 0x00000115)
1709 #define TPM_CAP_PROP_STARTUP_EFFECT ((TPM_CAPABILITY_AREA) 0x00000116)
1710 #define TPM_CAP_PROP_DELEGATE_ROW ((TPM_CAPABILITY_AREA) 0x00000117)
1711 #define TPM_CAP_PROP_DAA_MAX ((TPM_CAPABILITY_AREA) 0x00000119)
1712 #define CAP_PROP_SESSION_DAA ((TPM_CAPABILITY_AREA) 0x0000011A)
1713 #define TPM_CAP_PROP_CONTEXT_DIST ((TPM_CAPABILITY_AREA) 0x0000011B)
1714 #define TPM_CAP_PROP_DAA_INTERRUPT ((TPM_CAPABILITY_AREA) 0x0000011C)
1715 #define TPM_CAP_PROP_SESSIONS ((TPM_CAPABILITY_AREA) 0x0000011D)
1716 #define TPM_CAP_PROP_MAX_SESSIONS ((TPM_CAPABILITY_AREA) 0x0000011E)
1717 #define TPM_CAP_PROP_CMK_RESTRICTION ((TPM_CAPABILITY_AREA) 0x0000011F)
1718 #define TPM_CAP_PROP_DURATION ((TPM_CAPABILITY_AREA) 0x00000120)
1719 #define TPM_CAP_PROP_ACTIVE_COUNTER ((TPM_CAPABILITY_AREA) 0x00000122)
1720 #define TPM_CAP_PROP_MAX_NV_AVAILABLE ((TPM_CAPABILITY_AREA) 0x00000123)
1721 #define TPM_CAP_PROP_INPUT_BUFFER ((TPM_CAPABILITY_AREA) 0x00000124)
1722
1723 //
1724 // Part 2, section 21.6: TPM_CAP_VERSION_INFO
1725 // [size_is(vendorSpecificSize)] BYTE* vendorSpecific;
1726 //
1727 typedef struct tdTPM_CAP_VERSION_INFO {
1728 TPM_STRUCTURE_TAG tag;
1729 TPM_VERSION version;
1730 UINT16 specLevel;
1731 UINT8 errataRev;
1732 UINT8 tpmVendorID[4];
1733 UINT16 vendorSpecificSize;
1734 UINT8 *vendorSpecific;
1735 } TPM_CAP_VERSION_INFO;
1736
1737 //
1738 // Part 2, section 22: DAA Structures
1739 //
1740
1741 #define TPM_DAA_SIZE_r0 (43)
1742 #define TPM_DAA_SIZE_r1 (43)
1743 #define TPM_DAA_SIZE_r2 (128)
1744 #define TPM_DAA_SIZE_r3 (168)
1745 #define TPM_DAA_SIZE_r4 (219)
1746 #define TPM_DAA_SIZE_NT (20)
1747 #define TPM_DAA_SIZE_v0 (128)
1748 #define TPM_DAA_SIZE_v1 (192)
1749 #define TPM_DAA_SIZE_NE (256)
1750 #define TPM_DAA_SIZE_w (256)
1751 #define TPM_DAA_SIZE_issuerModulus (256)
1752 #define TPM_DAA_power0 (104)
1753 #define TPM_DAA_power1 (1024)
1754
1755 typedef struct tdTPM_DAA_ISSUER
1756 {
1757 TPM_STRUCTURE_TAG tag;
1758 TPM_DIGEST DAA_digest_R0;
1759 TPM_DIGEST DAA_digest_R1;
1760 TPM_DIGEST DAA_digest_S0;
1761 TPM_DIGEST DAA_digest_S1;
1762 TPM_DIGEST DAA_digest_n;
1763 TPM_DIGEST DAA_digest_gamma;
1764 UINT8 DAA_generic_q[26];
1765 } TPM_DAA_ISSUER;
1766
1767
1768 typedef struct tdTPM_DAA_TPM
1769 {
1770 TPM_STRUCTURE_TAG tag;
1771 TPM_DIGEST DAA_digestIssuer;
1772 TPM_DIGEST DAA_digest_v0;
1773 TPM_DIGEST DAA_digest_v1;
1774 TPM_DIGEST DAA_rekey;
1775 UINT32 DAA_count;
1776 } TPM_DAA_TPM;
1777
1778 typedef struct tdTPM_DAA_CONTEXT
1779 {
1780 TPM_STRUCTURE_TAG tag;
1781 TPM_DIGEST DAA_digestContext;
1782 TPM_DIGEST DAA_digest;
1783 TPM_DAA_CONTEXT_SEED DAA_contextSeed;
1784 UINT8 DAA_scratch[256];
1785 UINT8 DAA_stage;
1786 } TPM_DAA_CONTEXT;
1787
1788 typedef struct tdTPM_DAA_JOINDATA
1789 {
1790 UINT8 DAA_join_u0[128];
1791 UINT8 DAA_join_u1[138];
1792 TPM_DIGEST DAA_digest_n0;
1793 } TPM_DAA_JOINDATA;
1794
1795 typedef struct tdTPM_DAA_BLOB
1796 {
1797 TPM_STRUCTURE_TAG tag;
1798 TPM_RESOURCE_TYPE resourceType;
1799 UINT8 label[16];
1800 TPM_DIGEST blobIntegrity;
1801 UINT32 additionalSize;
1802 UINT8 *additionalData;
1803 UINT32 sensitiveSize;
1804 UINT8 *sensitiveData;
1805 } TPM_DAA_BLOB;
1806
1807 typedef struct tdTPM_DAA_SENSITIVE
1808 {
1809 TPM_STRUCTURE_TAG tag;
1810 UINT32 internalSize;
1811 UINT8 *internalData;
1812 } TPM_DAA_SENSITIVE;
1813
1814
1815 //
1816 // Part 2, section 23: Redirection
1817 //
1818
1819 // This section of the TPM spec defines exactly one value but does not
1820 // give it a name. The definition of TPM_SetRedirection in Part3
1821 // refers to exactly one name but does not give its value. We join
1822 // them here.
1823 #define TPM_REDIR_GPIO (0x00000001)
1824
1825 //
1826 // TPM Command & Response Headers
1827 //
1828 typedef struct tdTPM_RQU_COMMAND_HDR {
1829 TPM_STRUCTURE_TAG tag;
1830 UINT32 paramSize;
1831 TPM_COMMAND_CODE ordinal;
1832 } TPM_RQU_COMMAND_HDR;
1833
1834 typedef struct tdTPM_RSP_COMMAND_HDR {
1835 TPM_STRUCTURE_TAG tag;
1836 UINT32 paramSize;
1837 TPM_RESULT returnCode;
1838 } TPM_RSP_COMMAND_HDR;
1839
1840 #pragma pack (pop)
1841
1842 #endif // _TPM12_H_
EFI Development Kit II mirror for PVE