ISO_IEC_11889-4_2015.pdf

Information technology Trusted Platform Module Library Part 4:Supporting RoutinesTechnologies de linformation Bibliothque de module de plate-forme de confiance Partie 4:Routines de supportINTERNATIONAL STANDARDISO/IEC11889-4Reference numberISO/IEC 11889-4:2015(E)Second edition 2015-12-15 ISO/IEC 2015 ii ISO/IEC 2015 All rights reservedCOPYRIGHT PROTECTED DOCUMENT ISO/IEC 2015,Published in SwitzerlandAll rights reserved.Unless otherwise specified,no part of this publication may be reproduced or utilized otherwise in any form or by any means,electronic or mechanical,including photocopying,or posting on the internet or an intranet,without prior written permission.Permission can be requested from either ISO at the address below or ISOs member body in the country of the requester.ISO copyright officeCh.de Blandonnet 8 CP 401CH-1214 Vernier,Geneva,SwitzerlandTel.+41 22 749 01 11Fax+41 22 749 09 47copyrightiso.orgwww.iso.orgISO/IEC 11889-4:2015(E)ISO/IEC 11889-4:2015(E)CONTENTS Foreword.xvii Introduction.xviii 1 Scope.1 2 Normative references.2 3 Terms and definitions.2 4 Symbols and abbreviated terms.2 5 Automation.2 5.1 Introduction.2 5.2 Configuration Parser.2 5.3 Structure Parser.3 5.3.1 Introduction.3 5.3.2 Unmarshaling Code Prototype.3 5.3.3 Marshaling Code Function Prototypes.5 5.4 Command Parser.6 5.5 Portability.6 6 Header Files.7 6.1 Introduction.7 6.2 BaseTypes.h.7 6.3 bits.h.8 6.4 bool.h.9 6.5 Capabilities.h.9 6.6 TPMB.h.9 6.7 TpmError.h.10 6.8 Global.h.10 6.8.1 Description.10 6.8.2 Includes.11 6.8.3 Defines and Types.11 6.8.4 Loaded Object Structures.12 6.8.5 AUTH_DUP Types.14 6.8.6 Active Session Context.14 6.8.7 PCR.16 6.8.8 Startup.17 6.8.9 NV.18 6.8.10 COMMIT_INDEX_MASK.19 6.8.11 RAM Global Values.19 6.8.12 Persistent Global Values.21 6.8.13 Global Macro Definitions.26 6.9 Private data.26 6.10 Tpm.h.31 6.11 swap.h.31 6.12 InternalRoutines.h.32 6.13 TpmBuildSwitches.h.33 6.14 VendorString.h.34 7 Main.36 7.1 CommandDispatcher().36 7.2 ExecCommand.c.36 7.2.1 Introduction.36 7.2.2 Includes.36 7.2.3 ExecuteCommand().36 ISO/IEC 2015 All rights reserved iii ISO/IEC 11889-4:2015(E)7.3 ParseHandleBuffer().42 7.4 SessionProcess.c.43 7.4.1 Introduction.43 7.4.2 Includes and Data Definitions.43 7.4.3 Authorization Support Functions.43 7.4.4 Session Parsing Functions.50 7.4.5 Response Session Processing.68 8 Command Support Functions.78 8.1 Introduction.78 8.2 Attestation Command Support(Attest_spt.c).78 8.2.1 Includes.78 8.2.2 Functions.78 8.3 Context Management Command Support(Context_spt.c).81 8.3.1 Includes.81 8.3.2 Functions.81 8.4 Policy Command Support(Policy_spt.c).83 8.4.1 Includes.83 8.4.2 Functions.83 8.5 NV Command Support(NV_spt.c).85 8.5.1 Includes.85 8.5.2 Functions.86 8.6 Object Command Support(Object_spt.c).88 8.6.1 Includes.88 8.6.2 Local Functions.88 8.6.3 Public Functions.93 9 Subsystem.113 9.1 CommandAudit.c.113 9.1.1 Introduction.113 9.1.2 Includes.113 9.1.3 Functions.113 9.2 DA.c.117 9.2.1 Introduction.117 9.2.2 Includes and Data Definitions.117 9.2.3 Functions.117 9.3 Hierarchy.c.120 9.3.1 Introduction.120 9.3.2 Includes.120 9.3.3 Functions.120 9.4 NV.c.124 9.4.1 Introduction.124 9.4.2 Includes,Defines and Data Definitions.124 9.4.3 NV Utility Functions.124 9.4.4 NV Index and Persistent Object Access Functions.126 9.4.5 RAM-based NV Index Data Access Functions.130 9.4.6 Utility Functions.132 9.4.7 NV Access Functions.140 9.5 Object.c.158 iv ISO/IEC 2015 All rights reserved ISO/IEC 11889-4:2015(E)9.5.1 Introduction.158 9.5.2 Includes and Data Definitions.158 9.5.3 Functions.158 9.6 PCR.c.174 9.6.1 Introduction.174 9.6.2 Includes,Defines,and Data Definitions.174 9.6.3 Functions.174 9.7 PP.c.196 9.7.1 Introduction.196 9.7.2 Includes.196 9.7.3 Functions.196 9.8 Session.c.199 9.8.1 Introduction.199 9.8.2 Includes,Defines,and Local Variables.200 9.8.3 File Scope Function-ContextIdSetOldest().200 9.8.4 Startup Function-SessionStartup().201 9.8.5 Access Functions.202 9.8.6 Utility Functions.204 9.9 Time.c.216 9.9.1 Introduction.216 9.9.2 Includes.216 9.9.3 Functions.216 10 Support.221 10.1 AlgorithmCap.c.221 10.1.1 Description.221 10.1.2 Includes and Defines.221 10.1.3 AlgorithmCapGetImplemented().222 10.2 Bits.c.224 10.2.1 Introduction.224 10.2.2 Includes.224 10.2.3 Functions.224 10.3 CommandAttributeData.c.225 10.4 CommandCodeAttributes.c.231 10.4.1 Introduction.231 10.4.2 Includes and Defines.231 10.4.3 Command Attribute Functions.231 10.5 DRTM.c.236 10.5.1 Description.236 10.5.2 Includes.236 10.5.3 Functions.236 10.6 Entity.c.237 10.6.1 Description.237 10.6.2 Includes.237 10.6.3 Functions.237 10.7 Global.c.243 10.7.1 Description.243 10.7.2 Includes and Defines.244 10.7.3 Global Data Values.244 ISO/IEC 2015 All rights reserved v ISO/IEC 11889-4:2015(E)10.7.4 Private Values.244 10.8 Handle.c.246 10.8.1 Description.246 10.8.2 Includes.246 10.8.3 Functions.246 10.9 Locality.c.248 10.9.1 Includes.248 10.9.2 LocalityGetAttributes().248 10.10 Manufacture.c.248 10.10.1 Description.248 10.10.2 Inclu