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