1\documentclass{report} 2\usepackage{hyperref} 3\usepackage{adjustbox} 4\usepackage{placeins} 5 6% Metadata. 7\title{CPER-JSON Specification} 8\author{\parbox{\linewidth}{\centering% 9Lawrence Tang\endgraf 10Lawrence.Tang@arm.com\endgraf\medskip}} 11\date{\parbox{\linewidth}{\centering% 12Revision v0.0.1 (\today)\endgraf 13First revision released [DATE].}} 14 15% Commands. 16\newcommand*{\thead}[1]{\multicolumn{1}{|c|}{\bfseries #1}} 17\newcommand*{\jsontable}[1]{ 18 \begin{table}[!ht] 19 \label{#1} 20 \centering 21 \begin{adjustbox}{center} 22 \begin{tabular}{|l|c|p{8cm}|} 23 \hline 24 \thead{Field Name} & \thead{Type} & \thead{Description} \\ 25 \hline 26} 27\newcommand*{\jsontableend}[1]{ 28 \hline 29 \end{tabular} 30 \end{adjustbox} 31 \caption{#1} 32 \label{table:#1} 33 \end{table} 34 \FloatBarrier 35} 36 37\begin{document} 38\maketitle 39\tableofcontents 40\listoftables 41 42% Introductory section. 43\chapter{Preface} 44\section{Introduction \& Summary} 45This document lays out a structure for representing UEFI CPER records, as described in UEFI Appendix N 46\footnote{Version referenced is \href{https://uefi.org/sites/default/files/resources/UEFI_Spec_2_9_2021_03_18.pdf}{UEFI Specification 2021/03/18}.}, 47 in a human-readable JSON format, intended to be interoperable with standard CPER binary. 48\\\\ 49The C library released with this specification allows for the conversion between UEFI CPER records, an intermediate format, and the JSON structures 50defined in this document. There is also a comprehensive JSON schema\footnote{As defined by \href{https://json-schema.org/draft/2020-12/json-schema-core.html}{JSON schema Draft (2020/12)}} included within the same repository, at \texttt{specification/json}. 51 52% Specification section. 53\chapter{Main Structure Specification} 54\section{Parent Structure} 55\label{section:parentstructure} 56This structure contains descriptions of the CPER log header, as well as the section descriptors and 57section structures themselves within arrays. This is the structure returned by \texttt{cper\_to\_ir(FILE* cper\_file)} as JSON IR. 58 59% Parent structure table. 60\jsontable{table:parentstructure} 61header & object & A CPER header structure as defined in Section \ref{section:headerstructure}. \\ 62\hline 63sectionDescriptors & array & An array of section descriptor objects as defined in Section \ref{section:sectiondescriptorstructure}. \\ 64\hline 65sections & array & An array of section objects as defined in Chapter \ref{chapter:sectionchapter}. These sections are at the same index as their corresponding section descriptor within the \texttt{sectionDescriptors} array.\\ 66\jsontableend{Parent structure field table.} 67 68% Header structure. 69\section{Header Structure} 70\label{section:headerstructure} 71This structure describes the JSON format of the standard CPER header as defined in section N.2.1 of the 72UEFI specification. 73 74% Header structure table. 75\jsontable{table:headerstructure} 76revision & object & A CPER revision object structure as defined in Subsection \ref{subsection:revisionstructure}. \\ 77\hline 78sectionCount & int & The number of sections that are described by the CPER record.\\ 79\hline 80severity & object & An error severity structure as described in \ref{subsection:headererrorseveritystructure}.\\ 81\hline 82validationBits & object & A CPER header validation bitfield as described in Subsection \ref{subsection:headervalidbitfieldstructure}.\\ 83\hline 84recordLength & uint64 & The total length of the binary CPER record, including the header, in bytes.\\ 85\hline 86timestamp & string (\textbf{optional}) & The attached record timestamp, if the validity field is set. Formatted identically to \texttt{Date.toJson()} (ISO 8601), minus the trailing timezone letter. Timezone is local to the machine creating the record.\\ 87\hline 88timestampIsPrecise & boolean (\textbf{optional}) & If a timestamp is attached, indicates whether the provided timestamp is precise.\\ 89\hline 90platformID & string (\textbf{optional}) & If validation bit is set, uniquely identifying GUID of the platform. Platform SMBIOS UUID should be used to populate this field.\\ 91\hline 92partitionID & string (\textbf{optional}) & If validation bit is set, GUID identifying the partition on which the error occurred.\\ 93\hline 94creatorID & string & A GUID identifying the creator of the error record. May be overwritten by subsequent owners of the record.\\ 95\hline 96notificationType & object & A CPER notification type structure as described in Subsection \ref{subsection:notificationtypestructure}.\\ 97\hline 98recordID & uint64 & A unique value which, when combined with the \texttt{creatorID} field, uniquely identifies this error record on a given system.\\ 99\hline 100flags & object & A CPER header flags structure, as defined in Subsection \ref{subsection:headerflagsstructure}.\\ 101\hline 102persistenceInfo & uint64 & Produced and consumed by the creator of the error record identified by \texttt{creatorID}. Format undefined.\\ 103\jsontableend{Header structure field table.} 104 105% Header error severity. 106\subsection{Header Error Severity Structure} 107\label{subsection:headererrorseveritystructure} 108This structure describes the error severity of a single CPER record. 109\jsontable{table:headererrorseveritystructure} 110name & string & The human readable name of this error severity, if known. \\ 111\hline 112code & uint64 & The integer value of this error severity. \\ 113\jsontableend{Header error severity structure field table.} 114 115% Header validation bitfield. 116\subsection{Header Validation Bitfield Structure} 117\label{subsection:headervalidbitfieldstructure} 118This structure describes a bitfield for validating the fields of the header of a single CPER record. 119\jsontable{table:headervalidbitfieldstructure} 120platformIDValid & boolean & Whether the "platformID" field in the header structure (\ref{section:headerstructure}) is valid. \\ 121\hline 122timestampValid & boolean & Whether the "timestamp" field in the header structure (\ref{section:headerstructure}) is valid. \\ 123\hline 124partitionIDValid & boolean & Whether the "partitionID" field in the header structure (\ref{section:headerstructure}) is valid.\\ 125\jsontableend{Header validation bitfield structure field table.} 126 127% Header notification type. 128\subsection{Notification Type Structure} 129\label{subsection:notificationtypestructure} 130This structure describes the notification type of a single CPER record. 131\jsontable{table:notificationtypestructure} 132guid & string & The GUID of this notification type. Assigned GUIDs for types of CPER records are defined in UEFI Specification section N.2.1.1.\\ 133\hline 134type & string & A human readable name, if available, of the notification type for the given GUID.\\ 135\jsontableend{Notification type structure field table.} 136 137% Header flags. 138\subsection{Header Flags Structure} 139\label{subsection:headerflagsstructure} 140This structure describes the enabled flag on a given CPER record header. 141\jsontable{table:headerflagsstructure} 142name & string & A human readable name, if available, of this flag.\\ 143\hline 144value & uint64 & The integer value of this flag.\\ 145\jsontableend{Header flags structure field table.} 146 147%Section descriptor structure. 148\section{Section Descriptor Structure} 149\label{section:sectiondescriptorstructure} 150This section describes the JSON format of a single CPER record section descriptor as defined by section N.2.2 of the UEFI specification. An array of these structures is contained within the parent structure as defined in Section \ref{section:parentstructure}. 151 152%Section descriptor structure table. 153\jsontable{table:sectiondescriptorstructure} 154sectionOffset & uint64 & The offset (in bytes) of the section body this section descriptor describes from the base of the record header.\\ 155\hline 156sectionLength & uint64 & The length (in bytes) of the section body.\\ 157\hline 158revision & object & A CPER revision structure as defined in Subsection \ref{subsection:revisionstructure}.\\ 159\hline 160validationBits.fruIDValid & boolean & Whether the "fruID" field on this section descriptor contains valid data.\\ 161validationBits.fruStringValid & boolean & Whether the "fruString" field on this section descriptor contains valid data.\\ 162\hline 163flags & object & A CPER section descriptor flags structure as described in Subsection \ref{subsection:sectiondescriptorflagsstructure}.\\ 164\hline 165sectionType.data & string & GUID data for the type of section body.\\ 166sectionType.type & string & The human readable name, if possible, for the type of section body. GUIDs for types of sectoin body are defined in UEFI specification section N.2.2 Table N-5 and section N.2.4.\\ 167\hline 168fruID & string (\textbf{optional}) & If validation field set, the FRU ID of the section reporting the error.\\ 169\hline 170severity.code & uint64 & The integer value of the severity of the described section.\\ 171severity.name & string & If available, the human readable name for the severity of the described section.\\ 172\hline 173fruText & string (\textbf{optional}) & If validation field set, ASCII string identifying the FRU hardware.\\ 174\jsontableend{Section descriptor structure field table.} 175 176% Section descriptor flags. 177\subsection{Section Descriptor Flags Structure} 178\label{subsection:sectiondescriptorflagsstructure} 179This structure describes the enabled flags on a given CPER section descriptor. 180\jsontable{table:sectiondescriptorflagsstructure} 181primary & boolean & If true, indicates the section body should be associated with the error condition.\\ 182\hline 183containmentWarning & boolean & If true, the error was not contained within the processor or memory heirarchy, and may have propagated elsewhere.\\ 184\hline 185reset & boolean & If true, indicates the component has been reset and must be re-initialised or re-enabled by the operating system.\\ 186\hline 187errorThresholdExceeded & boolean & If true, indicates the operating system may choose to discontinue use of this resource.\\ 188\hline 189resourceNotAccessible & boolean & If true, the resource could not be queried for error information due to conflicts with other system software or resources. Some fields of the section will be invalid.\\ 190\hline 191latentError & boolean & If true, indicates that action has been taken to ensure error containment, but the error has not been fully corrected. System software may choose to take further action before the data is consumed.\\ 192\hline 193propagated & boolean & If true, indicates that the error has been propagated due to hardware poisoning.\\ 194\hline 195overflow & boolean & If true, overflow of data structures used to manage errors has been detected. Some error records may be lost.\\ 196\jsontableend{Section descriptor flags structure field table.} 197 198% Generic CPER structures. 199\section{Generic CPER Structures} 200This section describes generic CPER structures that are re-used throughout the specification. 201 202% Revision. 203\subsection{Revision Structure} 204\label{subsection:revisionstructure} 205This structure describes the revision of a single CPER record or sub-structure. 206\jsontable{table:revisionstructure} 207major & int & The major version number. An increase in this revision indicates the changes are not backward compatible. \\ 208\hline 209minor & int & The minor version number. Incremented on additions of new GUID types, errata fixes, or clarifications. Backwards compatible with the same major version number. \\ 210\jsontableend{CPER revision structure field table.} 211 212% Generic Error Status 213\subsection{Generic Error Status Structure} 214\label{subsection:genericerrorstatusstructure} 215This structure describes the a generic CPER error status, that can be used by any CPER section. 216\jsontable{table:genericerrorstatusstructure} 217errorType.value & uint64 & The raw value of the error type.\\ 218errorType.name & string & The human readable name, if available, of the error type.\\ 219errorType.description & string & A human readable description, if available, of the error type.\\ 220\hline 221addressSignal & boolean & Whether the error was detected on the address signals/address portion of the transaction.\\ 222\hline 223controlSignal & boolean & Whether the error was detected on the control signals/control portion of the transaction.\\ 224\hline 225dataSignal & boolean & Whether the error was detected on the data signals/data portion of the transaction.\\ 226\hline 227detectedByResponder & boolean & Whether the error was detected by the responder of the transaction.\\ 228\hline 229detectedByRequester & boolean & Whether the error was detected by the requester of the transaction.\\ 230\hline 231firstError & boolean & If multiple errors are logged for a single type of section, this indicates this is the first error in a chronological sequence. This field is optional to set.\\ 232\hline 233overflowDroppedLogs & boolean & Additional errors occurred and were not logged due to lack of resources.\\ 234\jsontableend{Generic Error Status structure field table.} 235 236%Sections. 237\chapter{Section Specification} 238\label{chapter:sectionchapter} 239This chapter defines section body formats for all of the sections defined within UEFI Specification section N.2.4. 240 241% Generic processor error section. 242\section{Generic Processor Error Section} 243\label{section:genericprocessorerrorsection} 244This section describes the JSON format for a single Generic Processor Error Section from a CPER record. The GUID used for Generic Processor Error Sections is \texttt{\{0x9876CCAD, 0x47B4, 0x4bdb, \{0xB6, 0x5E, 0x16, 0xF1, 0x93, 0xC4, 0xF3, 0xDB\}\}}. 245\jsontable{table:genericprocessorerrorsection} 246validationBits & object & A Generic Processor Error Validation Structure, as described in Subsection \ref{subsection:genericprocessorvalidationstructure}.\\ 247\hline 248processorType.name & string & If available, the human readable name of the processor type.\\ 249processorType.value & uint64 & The integer value of the processor type.\\ 250\hline 251processorISA.name & string & If available, the human readable name of the processor ISA.\\ 252processorISA.value & uint64 & The integer value corresponding to the processor ISA.\\ 253\hline 254errorType.name & string & If available, the human readable name of the type of processor error this section describes.\\ 255errorType.value & uint64 & The integer value corresponding to the processor error type.\\ 256\hline 257operation.name & string & If available, the human readable name of the operation.\\ 258operation.value & uint64 & The integer value corresponding to the operation.\\ 259\hline 260flags & object & Flag information for the Generic Processor Error as described in Subsection \ref{subsection:genericprocessorflagsstructure}.\\ 261\hline 262level & int & The level of the structure at which the error occurred.\\ 263\hline 264cpuVersionInfo & uint64 & The CPU version information as reported by CPUID with EAX=1. On ARM, this is MIDR\_EL1.\\ 265\hline 266cpuBrandString & string & The ASCII brand string of the CPU. This field is optional on ARM.\\ 267\hline 268processorID & uint64 & The unique identifier of the logical processor. On ARM, this is MPIDR\_EL1.\\ 269\hline 270targetAddress & uint64 & The target address associated with the error.\\ 271\hline 272requestorID & uint64 & ID of the requestor associated with the error.\\ 273\hline 274responderID & uint64 & ID of the responder associated with the error.\\ 275\hline 276instructionIP & uint64 & Identifies the instruction pointer at the point of error.\\ 277\jsontableend{Generic Processor Error structure field table.} 278 279% Generic processor error validation structure. 280\subsection{Generic Processor Error Validation Structure} 281\label{subsection:genericprocessorvalidationstructure} 282This structure describes the valdation bits structure of a General Processor Error CPER section. 283\jsontable{table:genericprocessorvalidationstructure} 284processorTypeValid & boolean & Whether the "processorType" field of the Generic Processor Error section (\ref{section:genericprocessorerrorsection}) is valid.\\ 285\hline 286processorISAValid & boolean & Whether the "processorISA" field of the Generic Processor Error section (\ref{section:genericprocessorerrorsection}) is valid.\\ 287\hline 288processorErrorTypeValid & boolean & Whether the "errorType" field of the Generic Processor Error section (\ref{section:genericprocessorerrorsection}) is valid.\\ 289\hline 290operationValid & boolean & Whether the "operation" field of the Generic Processor Error section (\ref{section:genericprocessorerrorsection}) is valid.\\ 291\hline 292flagsValid & boolean & Whether the "flags" field of the Generic Processor Error section (\ref{section:genericprocessorerrorsection}) is valid.\\ 293\hline 294levelValid & boolean & Whether the "levelValid" field of the Generic Processor Error section (\ref{section:genericprocessorerrorsection}) is valid.\\ 295\hline 296cpuVersionValid & boolean & Whether the "cpuVersion" field of the Generic Processor Error section (\ref{section:genericprocessorerrorsection}) is valid.\\ 297\hline 298cpuBrandInfoValid & boolean & Whether the "cpuBrandInfo" field of the Generic Processor Error section (\ref{section:genericprocessorerrorsection}) is valid.\\ 299\hline 300cpuIDValid & boolean & Whether the "cpuID" field of the Generic Processor Error section (\ref{section:genericprocessorerrorsection}) is valid.\\ 301\hline 302targetAddressValid & boolean & Whether the "targetAddress" field of the Generic Processor Error section (\ref{section:genericprocessorerrorsection}) is valid.\\ 303\hline 304requestorIDValid & boolean & Whether the "requestorID" field of the Generic Processor Error section (\ref{section:genericprocessorerrorsection}) is valid.\\ 305\hline 306responderIDValid & boolean & Whether the "responderID" field of the Generic Processor Error section (\ref{section:genericprocessorerrorsection}) is valid.\\ 307\hline 308instructionIPValid & boolean & Whether the "instructionIP" field of the Generic Processor Error section (\ref{section:genericprocessorerrorsection}) is valid.\\ 309\jsontableend{Generic Processor Error validation structure field table.} 310 311% Generic processor error flags structure. 312\subsection{Generic Processor Error Flags Structure} 313\label{subsection:genericprocessorflagsstructure} 314This structure describes the flags structure of a General Processor Error CPER section. 315\jsontable{table:genericprocessorflagsstructure} 316restartable & boolean & Whether program execution can be restarted reliably after the error.\\ 317\hline 318preciseIP & boolean & Whether the instruction IP captured is directly associated with the error.\\ 319\hline 320overflow & boolean & Whether a machine check overflow occurred (multiple errors occurred at once).\\ 321\hline 322corrected & boolean & Whether the error was corrected by hardware/firmware.\\ 323\jsontableend{Generic Processor Error flags structure field table.} 324 325% IA32/x64 error section. 326\section{IA32/x64 Processor Error Section} 327\label{section:ia32x64errorsection} 328This section describes the JSON format for a single IA32/x64 Error Section from a CPER record. The GUID used for IA32/x64 Processor Error Sections is \texttt{\{0xDC3EA0B0, 0xA144, 0x4797, \{0xB9, 0x5B, 0x53, 0xFA, 0x24, 0x2B, 0x6E, 0x1D\}\}}. 329\jsontable{table:genericprocessorerrorsection} 330validationBits & object & IA32/x64 Processor Error Validation Structure as described in Subsection \ref{subsection:ia32x64processorflagsstructure}.\\ 331\hline 332localAPICID & uint64 & The APIC ID of the processor.\\ 333\hline 334cpuidInfo & object & IA32/x64 CPUINFO Structure as defined in Subsection \ref{subsection:ia32x64cpuinfostructure}.\\ 335\hline 336processorErrorInfo & array & Array of IA32/x64 Processor Error Info Structures as described in Subsection \ref{subsection:ia32x64processorerrorinfostructure}.\\ 337\hline 338processorContextInfo & array & Array of IA32/x64 Processor Context Info Structures as described in Subsection \ref{subsection:ia32x64processorcontextinfostructure}.\\ 339\jsontableend{IA32/x64 Processor Error structure field table.} 340 341% IA32/x64 validation bitfield structure. 342\subsection{IA32/x64 Processor Error Validation Structure} 343\label{subsection:ia32x64processorflagsstructure} 344This structure describes the validation bitfield structure of an IA32/x64 Error CPER section. 345\jsontable{table:ia32x64processorflagsstructure} 346localAPICIDValid & boolean & Whether the "localAPICID" field of the IA32/x64 Error section (\ref{section:ia32x64errorsection}) is valid.\\ 347\hline 348cpuIDInfoValid & boolean & Whether the "cpuidInfo" field of the IA32/x64 Error section (\ref{section:ia32x64errorsection}) is valid.\\ 349\hline 350processorErrorInfoNum & int & The number of IA32/x64 Processor Error Info Structures (\ref{subsection:ia32x64processorerrorinfostructure}) that are included with this error section.\\ 351\hline 352processorContextInfoNum & int & The number of IA32/x64 Processor Context Info Structures (\ref{subsection:ia32x64processorcontextinfostructure}) that are included with this error section.\\ 353\jsontableend{IA32/x64 Processor Error validation structure field table.} 354 355% IA32/x64 CPUINFO structure. 356\subsection{IA32/x64 CPUINFO Structure} 357\label{subsection:ia32x64cpuinfostructure} 358This structure describes the CPUINFO structure of an IA32/x64 Error CPER section. 359\jsontable{table:ia32x64cpuinfostructure} 360eax & uint64 & Value of the EAX register resulting from a call to CPUID with EAX=1.\\ 361\hline 362ebx & uint64 & Value of the EBX register resulting from a call to CPUID with EAX=1.\\ 363\hline 364ecx & uint64 & Value of the ECX register resulting from a call to CPUID with EAX=1.\\ 365\hline 366edx & uint64 & Value of the EDX register resulting from a call to CPUID with EAX=1.\\ 367\jsontableend{IA32/x64 CPUINFO structure field table.} 368 369% IA32/x64 Processor Error Info structure. 370\subsection{IA32/x64 Processor Error Info Structure} 371\label{subsection:ia32x64processorerrorinfostructure} 372This structure describes a single IA32/x64 Processor Error Info sub-section, which is part of the larger IA32/x64 record (\ref{section:ia32x64errorsection}). 373\jsontable{table:ia32x64processorerrorinfostructure} 374type.guid & string & A GUID indicating the type of processor error defined in this structure. See \texttt{edk/Cper.h} in the library repository for the defined GUID values.\\ 375type.name & string & The human readable name, if available, of the type of processor error defined in this structure.\\ 376\hline 377validationBits & object & An IA32/x64 Processor Error Info Validation structure, as defined in Subsection \ref{subsection:ia32x64processorerrorinfovalidationstructure}.\\ 378\hline 379checkInfo & object & Check information structure for this error. One of the structures defined in Subsections \ref{subsection:ia32x64processorerrorcheckinfocachetlbstructure}, \ref{subsection:ia32x64processorerrorcheckinfobusstructure}, or \ref{subsection:ia32x64processorerrorcheckinfomscheckstructure}. Which section is placed here is dependent on the \texttt{type} field.\\ 380\hline 381targetAddressID & uint64 & Identifies the target address associated with the error.\\ 382\hline 383requestorID & uint64 & Identifies the requestor associated with the error.\\ 384\hline 385responderID & uint64 & Identifies the responder associated with the error.\\ 386\hline 387instructionPointer & uint64 & Identifies the instruction executing when the error occurred.\\ 388\jsontableend{IA32/x64 Processor Error Info structure field table.} 389 390% IA32/x64 Processor Error Info Validation structure. 391\subsection{IA32/x64 Processor Error Info Validation Structure} 392\label{subsection:ia32x64processorerrorinfovalidationstructure} 393This structure describes a single IA32/x64 Processor Error Info structure's valid fields, as a set of boolean values. 394\jsontable{table:ia32x64processorerrorinfovalidationstructure} 395checkInfoValid & boolean & Whether the "checkInfo" field in the Processor Error Info structure (\ref{subsection:ia32x64processorerrorinfostructure}) is valid.\\ 396\hline 397targetAddressIDValid & boolean & Whether the "targetAddressID" field in the Processor Error Info structure (\ref{subsection:ia32x64processorerrorinfostructure}) is valid.\\ 398\hline 399requestorIDValid & boolean & Whether the "requestorID" field in the Processor Error Info structure (\ref{subsection:ia32x64processorerrorinfostructure}) is valid.\\ 400\hline 401responderIDValid & boolean & Whether the "responderID" field in the Processor Error Info structure (\ref{subsection:ia32x64processorerrorinfostructure}) is valid.\\ 402\hline 403instructionPointerValid & boolean & Whether the "instructionPointer" field in the Processor Error Info structure (\ref{subsection:ia32x64processorerrorinfostructure}) is valid.\\ 404\hline 405\jsontableend{IA32/x64 Processor Error Info validation structure field table.} 406 407% IA32/x64 Processor Error Check Info (Cache/TLB Error) 408\subsection{IA32/x64 Processor Error Check Info (Cache/TLB Error) Structure} 409\label{subsection:ia32x64processorerrorcheckinfocachetlbstructure} 410This structure describes check info for an IA32/x64 Processor Error Info structure (\ref{subsection:ia32x64processorerrorinfostructure}) stemming from a cache or TLB error. 411The GUIDs for cache and TLB error check info structures can be found in the library repository's \texttt{edk/Cper.h}. 412\jsontable{table:ia32x64processorerrorcheckinfocachetlbstructure} 413validationBits & object & An IA32/x64 Processor Error Check Info (Cache/TLB/Bus) Validation structure, as defined in Subsection \ref{subsection:ia32x64processorerrorcheckinfovalidationstructure}.\\ 414\hline 415transactionType.value & uint64 & The raw value of the type of cache/TLB error that occurred.\\ 416transactionType.name & string & The human readable name, if available, of the type of cache/TLB error that occurred.\\ 417\hline 418operation.value & uint64 & The raw value of the type of cache/TLB operation that caused the error.\\ 419operation.name & string & The human readable name, if available, of the type of cache/TLB operation that caused the error.\\ 420\hline 421level & uint64 & The cache/TLB level at which the error occurred.\\ 422\hline 423processorContextCorrupt & boolean & Whether the processor context might have been corrupted.\\ 424\hline 425uncorrected & boolean & Whether the error remained uncorrected.\\ 426\hline 427preciseIP & boolean & Whether the instruction pointed pushed onto the stack is directly associated with the error.\\ 428\hline 429restartableIP & boolean & Whether program execution can be restarted reliably at the instruction pointer pushed onto the stack.\\ 430\hline 431overflow & boolean & Whether an error overflow occurred (multiple errors within a short timeframe may cause this, can indicate loss of data).\\ 432\jsontableend{IA32/x64 Processor Error Check Info (Cache/TLB Error) structure field table.} 433 434% IA32/x64 Processor Error Check Info (Bus Error) 435\subsection{IA32/x64 Processor Error Check Info (Bus Error) Structure} 436\label{subsection:ia32x64processorerrorcheckinfobusstructure} 437This structure describes check info for an IA32/x64 Processor Error Info structure (\ref{subsection:ia32x64processorerrorinfostructure}) stemming from a bus error. 438The GUID for bus error check info structures can be found in the library repository's \texttt{edk/Cper.h}. 439\jsontable{table:ia32x64processorerrorcheckinfobusstructure} 440validationBits & object & An IA32/x64 Processor Error Check Info (Cache/TLB/Bus) Validation structure, as defined in Subsection \ref{subsection:ia32x64processorerrorcheckinfovalidationstructure}.\\ 441\hline 442transactionType.value & uint64 & The raw value of the type of bus error that occurred.\\ 443transactionType.name & string & The human readable name, if available, of the type of bus error that occurred.\\ 444\hline 445operation.value & uint64 & The raw value of the type of bus operation that caused the error.\\ 446operation.name & string & The human readable name, if available, of the type of bus operation that caused the error.\\ 447\hline 448level & uint64 & The bus heirarchy level at which the error occurred.\\ 449\hline 450processorContextCorrupt & boolean & Whether the processor context might have been corrupted.\\ 451\hline 452uncorrected & boolean & Whether the error remained uncorrected.\\ 453\hline 454preciseIP & boolean & Whether the instruction pointed pushed onto the stack is directly associated with the error.\\ 455\hline 456restartableIP & boolean & Whether program execution can be restarted reliably at the instruction pointer pushed onto the stack.\\ 457\hline 458overflow & boolean & Whether an error overflow occurred (multiple errors within a short timeframe may cause this, can indicate loss of data).\\ 459\hline 460participationType.value & uint64 & The raw value of the type of participation.\\ 461participationType.name & string & The human readable name, if available, of the type of participation.\\ 462\hline 463timedOut & boolean & Whether the request timed out.\\ 464\hline 465addressSpace.value & uint64 & The raw value of the address space the error was in.\\ 466addressSpace.name & string & The human readable name, if available, of the address space the error was in.\\ 467\jsontableend{IA32/x64 Processor Error Check Info (Bus Error) structure field table.} 468 469% IA32/x64 Processor Error Check Info (MS Check Error) 470\subsection{IA32/x64 Processor Error Check Info (MS Check Error) Structure} 471\label{subsection:ia32x64processorerrorcheckinfomscheckstructure} 472This structure describes check info for an IA32/x64 Processor Error Info structure (\ref{subsection:ia32x64processorerrorinfostructure}) stemming from an MS check error. 473The GUID for MS check check info structures can be found in the library repository's \texttt{edk/Cper.h}. 474\jsontable{table:ia32x64processorerrorcheckinfomscheckstructure} 475validationBits & object & An IA32/x64 Processor Error Check Info (MS Check) Validation structure, as defined in Subsection \ref{subsection:ia32x64processorerrorcheckinfomscheckvalidationstructure}.\\ 476\hline 477errorType.value & uint64 & The raw value of the type of operation that caused the error.\\ 478errorType.name & string & The human readable name, if available, of the type of operation that caused the error.\\ 479\hline 480processorContextCorrupt & boolean & Whether the processor context might have been corrupted.\\ 481\hline 482uncorrected & boolean & Whether the error remained uncorrected.\\ 483\hline 484preciseIP & boolean & Whether the instruction pointed pushed onto the stack is directly associated with the error.\\ 485\hline 486restartableIP & boolean & Whether program execution can be restarted reliably at the instruction pointer pushed onto the stack.\\ 487\hline 488overflow & boolean & Whether an error overflow occurred (multiple errors within a short timeframe may cause this, can indicate loss of data).\\ 489\jsontableend{IA32/x64 Processor Error Check Info (MS Check Error) structure field table.} 490 491% IA32/x64 Processor Error Check Info Validation structure. 492\subsection{IA32/x64 Processor Error Check Info (Cache/TLB/Bus) Validation Structure} 493\label{subsection:ia32x64processorerrorcheckinfovalidationstructure} 494This structure describes a single IA32/x64 Processor Error Check Info structure's valid fields for cache, TLB and bus errors, as a set of boolean values. 495\jsontable{table:ia32x64processorerrorcheckinfovalidationstructure} 496transactionTypeValid & boolean & Whether the "transactionType" field in a Processor Error Check Info structure is valid.\\ 497\hline 498operationValid & boolean & Whether the "operation" field in a Processor Error Check Info structure is valid.\\ 499\hline 500levelValid & boolean & Whether the "level" field in a Processor Error Check Info structure is valid.\\ 501\hline 502processorContextCorruptValid & boolean & Whether the "processorContextCorrupt" field in a Processor Error Check Info structure is valid.\\ 503\hline 504uncorrectedValid & boolean & Whether the "uncorrected" field in a Processor Error Check Info structure is valid.\\ 505\hline 506preciseIPValid & boolean & Whether the "preciseIP" field in a Processor Error Check Info structure is valid.\\ 507\hline 508restartableIPValid & boolean & Whether the "restartableIP" field in a Processor Error Check Info structure is valid.\\ 509\hline 510overflowValid & boolean & Whether the "overflow" field in a Processor Error Check Info structure is valid.\\ 511\hline 512participationTypeValid & boolean (\textbf{optional}) & Whether the "participationType" field in the Processor Error Check Info (Bus Error) structure (\ref{subsection:ia32x64processorerrorcheckinfobusstructure}) is valid. \textbf{This field is only present on bus related check info structures.}\\ 513\hline 514timedOutValid & boolean (\textbf{optional}) & Whether the "timeOut" field in the Processor Error Check Info (Bus Error) structure (\ref{subsection:ia32x64processorerrorcheckinfobusstructure}) is valid. \textbf{This field is only present on bus related check info structures.}\\ 515\hline 516addressSpaceValid & boolean (\textbf{optional}) & Whether the "addressSpace" field in the Processor Error Check Info (Bus Error) structure (\ref{subsection:ia32x64processorerrorcheckinfobusstructure}) is valid. \textbf{This field is only present on bus related check info structures.}\\ 517\jsontableend{IA32/x64 Processor Error Check Info (Cache/TLB/Bus) validation structure field table.} 518 519% IA32/x64 Processor Error Check Info (MS Check) Validation structure. 520\subsection{IA32/x64 Processor Error Check Info (MS Check) Validation Structure} 521\label{subsection:ia32x64processorerrorcheckinfomscheckvalidationstructure} 522This structure describes a single IA32/x64 Processor Error Check Info structure's valid fields for MS check errors, as a set of boolean values. 523\jsontable{table:ia32x64processorerrorcheckinfomscheckvalidationstructure} 524errorTypeValid & boolean & Whether the "transactionType" field in a Processor Error Check Info (MS Check) (\ref{subsection:ia32x64processorerrorcheckinfomscheckstructure}) structure is valid.\\ 525\hline 526processorContextCorruptValid & boolean & Whether the "processorContextCorrupt" field in a Processor Error Check Info (MS Check) (\ref{subsection:ia32x64processorerrorcheckinfomscheckstructure}) structure is valid.\\ 527\hline 528uncorrectedValid & boolean & Whether the "uncorrected" field in a Processor Error Check Info (MS Check) (\ref{subsection:ia32x64processorerrorcheckinfomscheckstructure}) structure is valid.\\ 529\hline 530preciseIPValid & boolean & Whether the "preciseIP" field in a Processor Error Check Info (MS Check) (\ref{subsection:ia32x64processorerrorcheckinfomscheckstructure}) structure is valid.\\ 531\hline 532restartableIPValid & boolean & Whether the "restartableIP" field in a Processor Error Check Info (MS Check) (\ref{subsection:ia32x64processorerrorcheckinfomscheckstructure}) structure is valid.\\ 533\hline 534overflowValid & boolean & Whether the "overflow" field in a Processor Error Check Info (MS Check) (\ref{subsection:ia32x64processorerrorcheckinfomscheckstructure}) structure is valid.\\ 535\jsontableend{IA32/x64 Processor Error Check Info (MS Check) validation structure field table.} 536 537% IA32/x64 Processor Context Info structure. 538\subsection{IA32/x64 Processor Context Info Structure} 539\label{subsection:ia32x64processorcontextinfostructure} 540This structure describes a single IA32/x64 Processor Context Info sub-section, which is part of the larger IA32/x64 record (\ref{section:ia32x64errorsection}). 541\jsontable{table:ia32x64processorcontextinfostructure} 542registerContextType.value & uint64 & The raw value of the type of processor context state being reported.\\ 543registerContextType.name & string & The human readable name, if available, of the type of processor context state being reported.\\ 544\hline 545registerArraySize & uint64 & The total size of the array for the data type being reported, in bytes.\\ 546\hline 547msrAddress & uint64 & The starting MSR address. Valid when the \texttt{registerContextType.value} field is "1" (MSR Registers).\\ 548\hline 549mmRegisterAddress & uint64 & The starting memory address for when the \texttt{registerContextType.value} field is "7" (Memory Mapped Registers).\\ 550\hline 551registerArray & object & Register data, formatted as object fields. If the \texttt{registerContextType.value} field has the value "2" or "3", this takes the structure of Subsections \ref{subsection:ia32x64ia32registerstatestructure} and \ref{subsection:ia32x64x64registerstatestructure} respectively. If the value is any other, it takes the form of the structure defined in Subsection \ref{subsection:ia32x64unformattedregisterstatestructure}.\\ 552\jsontableend{IA32/x64 Processor Context Info structure field table.} 553 554% IA32/x64 IA32 Register State structure 555\subsection{IA32/x64 IA32 Register State Structure} 556\label{subsection:ia32x64ia32registerstatestructure} 557This structure describes a single IA32/x64 IA32 register state, which is contained in IA32/x64 Processor Context Info structures (\ref{subsection:ia32x64processorcontextinfostructure}) when \texttt{registerContextType.value} has the value "2". 558\jsontable{table:ia32x64ia32registerstatestructure} 559eax & uint64 & The EAX register. Real maximum is \texttt{UINT32}, null extended to \texttt{UINT64}.\\ 560\hline 561ebx & uint64 & The EBX register. Real maximum is \texttt{UINT32}, null extended to \texttt{UINT64}.\\ 562\hline 563ecx & uint64 & The ECX register. Real maximum is \texttt{UINT32}, null extended to \texttt{UINT64}.\\ 564\hline 565edx & uint64 & The EDX register. Real maximum is \texttt{UINT32}, null extended to \texttt{UINT64}.\\ 566\hline 567esi & uint64 & The ESI register. Real maximum is \texttt{UINT32}, null extended to \texttt{UINT64}.\\ 568\hline 569edi & uint64 & The EDI register. Real maximum is \texttt{UINT32}, null extended to \texttt{UINT64}.\\ 570\hline 571ebp & uint64 & The EBP register. Real maximum is \texttt{UINT32}, null extended to \texttt{UINT64}.\\ 572\hline 573esp & uint64 & The ESP register. Real maximum is \texttt{UINT32}, null extended to \texttt{UINT64}.\\ 574\hline 575cs & uint64 & The CS register. Real maximum is \texttt{UINT32}, null extended to \texttt{UINT64}.\\ 576\hline 577ds & uint64 & The DS register. Real maximum is \texttt{UINT32}, null extended to \texttt{UINT64}.\\ 578\hline 579ss & uint64 & The SS register. Real maximum is \texttt{UINT32}, null extended to \texttt{UINT64}.\\ 580\hline 581es & uint64 & The ES register. Real maximum is \texttt{UINT32}, null extended to \texttt{UINT64}.\\ 582\hline 583fs & uint64 & The FS register. Real maximum is \texttt{UINT32}, null extended to \texttt{UINT64}.\\ 584\hline 585gs & uint64 & The GS register. Real maximum is \texttt{UINT32}, null extended to \texttt{UINT64}.\\ 586\hline 587eflags & uint64 & The EFLAGS register. Real maximum is \texttt{UINT32}, null extended to \texttt{UINT64}.\\ 588\hline 589eip & uint64 & The EIP register. Real maximum is \texttt{UINT32}, null extended to \texttt{UINT64}.\\ 590\hline 591cr0 & uint64 & The CR0 register. Real maximum is \texttt{UINT32}, null extended to \texttt{UINT64}.\\ 592\hline 593cr1 & uint64 & The CR1 register. Real maximum is \texttt{UINT32}, null extended to \texttt{UINT64}.\\ 594\hline 595cr2 & uint64 & The CR2 register. Real maximum is \texttt{UINT32}, null extended to \texttt{UINT64}.\\ 596\hline 597cr3 & uint64 & The CR3 register. Real maximum is \texttt{UINT32}, null extended to \texttt{UINT64}.\\ 598\hline 599cr4 & uint64 & The CR4 register. Real maximum is \texttt{UINT32}, null extended to \texttt{UINT64}.\\ 600\hline 601gdtr & uint64 & The GDTR register.\\ 602\hline 603idtr & uint64 & The IDTR register.\\ 604\hline 605ldtr & uint64 & The LDTR register.\\ 606\hline 607tr & uint64 & The TR register. Real maximum is \texttt{UINT32}, null extended to \texttt{UINT64}.\\ 608\jsontableend{IA32/x64 IA32 Register State structure field table.} 609 610% IA32/x64 x64 Register State structure 611\subsection{IA32/x64 x64 Register State Structure} 612\label{subsection:ia32x64x64registerstatestructure} 613This structure describes a single IA32/x64 x64 register state, which is contained in IA32/x64 Processor Context Info structures (\ref{subsection:ia32x64processorcontextinfostructure}) when \texttt{registerContextType.value} has the value "3". 614\jsontable{table:ia32x64x64registerstatestructure} 615rax & uint64 & The RAX register.\\ 616\hline 617rbx & uint64 & The RBX register.\\ 618\hline 619rcx & uint64 & The RCX register.\\ 620\hline 621rdx & uint64 & The RDX register.\\ 622\hline 623rsi & uint64 & The RSI register.\\ 624\hline 625rdi & uint64 & The RDI register.\\ 626\hline 627rbp & uint64 & The RBP register.\\ 628\hline 629rsp & uint64 & The RSP register.\\ 630\hline 631r8 & uint64 & The R8 register.\\ 632\hline 633r9 & uint64 & The R9 register.\\ 634\hline 635r10 & uint64 & The R10 register.\\ 636\hline 637r11 & uint64 & The R11 register.\\ 638\hline 639r12 & uint64 & The R12 register.\\ 640\hline 641r13 & uint64 & The R13 register.\\ 642\hline 643r14 & uint64 & The R14 register.\\ 644\hline 645r15 & uint64 & The R15 register.\\ 646\hline 647cs & uint64 & The CS register.\\ 648\hline 649ds & uint64 & The DS register.\\ 650\hline 651ss & uint64 & The SS register.\\ 652\hline 653es & uint64 & The ES register.\\ 654\hline 655fs & uint64 & The FS register.\\ 656\hline 657gs & uint64 & The GS register.\\ 658\hline 659rflags & uint64 & The RFLAGS register.\\ 660\hline 661eip & uint64 & The EIP register.\\ 662\hline 663cr0 & uint64 & The CR0 register.\\ 664\hline 665cr1 & uint64 & The CR1 register.\\ 666\hline 667cr2 & uint64 & The CR2 register.\\ 668\hline 669cr3 & uint64 & The CR3 register.\\ 670\hline 671cr4 & uint64 & The CR4 register.\\ 672\hline 673cr8 & uint64 & The CR8 register.\\ 674\hline 675gdtr\_0 & uint64 & The first \texttt{UINT64} of the GDTR register.\\ 676\hline 677gdtr\_1 & uint64 & The second \texttt{UINT64} of the GDTR register.\\ 678\hline 679idtr\_0 & uint64 & The first \texttt{UINT64} of the IDTR register.\\ 680\hline 681idtr\_1 & uint64 & The second \texttt{UINT64} of the IDTR register.\\ 682\hline 683ldtr & uint64 & The LDTR register.\\ 684\hline 685tr & uint64 & The TR register.\\ 686\jsontableend{IA32/x64 x64 Register State structure field table.} 687 688% IA32/x64 IA32 Register State structure 689\subsection{IA32/x64 Unformatted Register State Structure} 690\label{subsection:ia32x64unformattedregisterstatestructure} 691This structure describes a single IA32/x64 unformatted register state, which is contained in IA32/x64 Processor Context Info structures (\ref{subsection:ia32x64processorcontextinfostructure}) when\\\texttt{registerContextType.value} has a value other than "2" or "3". 692\jsontable{table:ia32x64unformattedregisterstatestructure} 693data & string & A base64-formatted binary representation of the register array.\\ 694\jsontableend{IA32/x64 Unformatted Register State structure field table.} 695 696% ARM processor error section. 697\section{ARM Processor Error Section} 698\label{section:armprocessorerrorsection} 699This section describes the JSON format for a single ARM Processor Error Section from a CPER record. The GUID used for ARM Processor Error Sections is \texttt{\{ 0xe19e3d16, 0xbc11, 0x11e4, \{ 0x9c, 0xaa, 0xc2, 0x05, 0x1d, 0x5d, 0x46, 0xb0 \}\}}. 700\jsontable{table:armprocessorerrorsection} 701validationBits & object & An ARM Processor Error Validation structure, as defined in Subsection \ref{subsection:armprocessorerrorvalidationstructure}.\\ 702\hline 703errorInfoNum & int & The number of error info structures attached to this error.\\ 704\hline 705contextInfoNum & int & The number of context info structures attached to this error.\\ 706\hline 707sectionLength & uint64 & The total size (in bytes) of this error section.\\ 708\hline 709errorAffinity.value & int & The raw value of the error affinity for this error.\\ 710errorAffinity.type & string & The human readable type of the error affinity for this error. All values are vendor defined, so specific names cannot be provided.\\ 711\hline 712mpidrEl1 & uint64 & The processor ID (\texttt{MPIDR\_EL1}) for this error.\\ 713\hline 714midrEl1 & uint64 & The chip ID (\texttt{MIDR\_EL1}) for this error.\\ 715\hline 716running & boolean & Whether the processor is running or not. If true, the \texttt{psciState} field is not included.\\ 717\hline 718psciState & uint64 (\textbf{optional}) & The PSCI state of the processor. Only \textbf{optionally} included when the "running" field is false. Cannot be made human readable, as this could either be in the pre-PSCI 1.0 format, or the newer "Extended StateID" format. For more information, see the ARM PSCI specification.\\ 719\hline 720errorInfo & array & Array of ARM Processor Error Info structures, as defined in Subsection \ref{subsection:armprocessorerrorinfostructure}.\\ 721\hline 722contextInfo & array & Array of ARM Processor Context Info structures, as defined in Subsection \ref{subsection:armprocessorcontextinfostructure}.\\ 723\hline 724vendorSpecificInfo.data & string (\textbf{optional}) & If it exists, a base64-encoded binary representation of any attached vendor specific information.\\ 725\jsontableend{ARM Processor Error structure field table.} 726 727% ARM Processor Error Validation structure 728\subsection{ARM Processor Error Validation Structure} 729\label{subsection:armprocessorerrorvalidationstructure} 730This structure describes which fields are valid in a single ARM Processor Error structure (\ref{section:armprocessorerrorsection}) with boolean fields. 731\jsontable{table:armprocessorerrorvalidationstructure} 732mpidrValid & boolean & Whether the "mpidrEl1" field in the ARM Processor Error structure (\ref{section:armprocessorerrorsection}) is valid.\\ 733\hline 734errorAffinityLevelValid & boolean & Whether the "errorAffinity" field in the ARM Processor Error structure (\ref{section:armprocessorerrorsection}) is valid.\\ 735\hline 736runningStateValid & boolean & Whether the "running" field in the ARM Processor Error structure (\ref{section:armprocessorerrorsection}) is valid.\\ 737\hline 738vendorSpecificInfoValid & boolean & Whether the trailing vendor specific info (if present) in the ARM Processor Error Structure (\ref{section:armprocessorerrorsection}) is valid.\\ 739\jsontableend{ARM Processor Error validation structure field table.} 740 741% ARM Processor Error Info structure 742\subsection{ARM Processor Error Info Structure} 743\label{subsection:armprocessorerrorinfostructure} 744This structure describes a single ARM Processor Error Info structure, as part of a whole ARM Processor Error structure (\ref{section:armprocessorerrorsection}). 745\jsontable{table:armprocessorerrorinfostructure} 746version & int & The version of the structure that is implemented.\\ 747\hline 748length & int & The length of the structure, in bytes. For version 0, this is 32.\\ 749\hline 750validationBits & object & An ARM Processor Error Info Validation structure as defined in Subsection \ref{subsection:armprocessorerrorinfovalidationstructure}.\\ 751\hline 752errorType.value & uint64 & The raw value of the error type this error info describes.\\ 753errorType.name & string & The human readable name, if available, of the error type this error info describes.\\ 754\hline 755multipleError.value & int & If the value of this field is 2 or greater, the raw value of the number of errors that occurred. Otherwise, the raw value of the multiple error status.\\ 756multipleError.type & string & The human readable value, if available, of what type of multiple error this is (single error, multiple error).\\ 757\hline 758flags & object & An ARM Processor Error Info Flags structure as defined in Subsection \ref{subsection:armprocessorerrorinfoflagsstructure}.\\ 759\hline 760errorInformation & object & An error information structure, as defined in one of Subsections \ref{subsection:armprocessorerrorinfoerrorinformationcachetlbstructure} or \ref{subsection:armprocessorerrorinfoerrorinformationbusstructure}, or . Which structure this is depends on the \texttt{errorType.value} field.\\ 761\hline 762virtualFaultAddress & uint64 & Indicates a virtual fault address associated with the error, such as when an error occurs in virtually indexed cache.\\ 763\hline 764physicalFaultAddress & uint64 & Indicates a physical fault address associated with the error.\\ 765\jsontableend{ARM Processor Error Info structure field table.} 766 767% ARM Processor Error Info Validation structure 768\subsection{ARM Processor Error Info Validation Structure} 769\label{subsection:armprocessorerrorinfovalidationstructure} 770This structure describes the valid fields in a single ARM Processor Error Info structure (\ref{subsection:armprocessorerrorinfostructure}), using boolean fields. 771\jsontable{table:armprocessorerrorinfovalidationstructure} 772multipleErrorValid & boolean & Whether the "multipleError" field in the ARM Processor Error Info structure (\ref{subsection:armprocessorerrorinfostructure}) is valid.\\ 773\hline 774flagsValid & boolean & Whether the "flags" field in the ARM Processor Error Info structure (\ref{subsection:armprocessorerrorinfostructure}) is valid.\\ 775\hline 776errorInformationValid & boolean & Whether the "errorInformation" field in the ARM Processor Error Info structure (\ref{subsection:armprocessorerrorinfostructure}) is valid.\\ 777\hline 778virtualFaultAddressValid & boolean & Whether the "virtualFaultAddress" field in the ARM Processor Error Info structure (\ref{subsection:armprocessorerrorinfostructure}) is valid.\\ 779\hline 780physicalFaultAddressValid & boolean & Whether the "physicalFaultAddress" field in the ARM Processor Error Info structure (\ref{subsection:armprocessorerrorinfostructure}) is valid.\\ 781\jsontableend{ARM Processor Error Info validation structure field table.} 782 783% ARM Processor Error Info Validation structure 784\subsection{ARM Processor Error Info Flags Structure} 785\label{subsection:armprocessorerrorinfoflagsstructure} 786This structure describes the flags in a single ARM Processor Error Info structure (\ref{subsection:armprocessorerrorinfostructure}), using boolean fields. 787\jsontable{table:armprocessorerrorinfoflagsstructure} 788firstErrorCaptured & boolean & Whether this is the first error captured.\\ 789\hline 790lastErrorCaptured & boolean & Whether this is the last error captured.\\ 791\hline 792propagated & boolean & Whether the error has propagated.\\ 793\hline 794overflow & boolean & Whether error buffer overflow was detected. This is usually from multiple errors occurring in a short timespan, and indicates loss of error data.\\ 795\jsontableend{ARM Processor Error Info Flags structure field table.} 796 797% ARM Processor Error Info Error Information (Cache/TLB) structure 798\subsection{ARM Processor Error Info Cache/TLB Information Structure} 799\label{subsection:armprocessorerrorinfoerrorinformationcachetlbstructure} 800This structure describes cache/TLB error information for a single ARM Processor Error Info structure (\ref{subsection:armprocessorerrorinfostructure}). This structure is used when the \texttt{type} field of that structure has the value 0 or 1. 801\jsontable{table:armprocessorerrorinfoerrorinformationcachetlbstructure} 802validationBits & object & An ARM Processor Info Cache/TLB Validation structure as defined in Subsection \ref{subsection:armprocessorerrorinfocachetlbvalidationstructure}.\\ 803\hline 804transactionType.value & uint64 & The raw value of the type of cache/TLB error.\\ 805transactionType.name & string & The human readable name, if available, of the type of cache/TLB error.\\ 806\hline 807operation.value & uint64 & The raw value of the cache/TLB operation that caused the error.\\ 808operation.name & string & The human readable name, if available, of the cache/TLB operation that caused the error.\\ 809\hline 810level & int & The cache/TLB level that the error occurred at.\\ 811\hline 812processorContextCorrupt & boolean & Whether the processor context may have been corrupted.\\ 813\hline 814corrected & boolean & Whether the error was corrected.\\ 815\hline 816precisePC & boolean & Whether the program counter is directly associated with the error.\\ 817\hline 818restartablePC & boolean & Whether program execution can be restarted reliably at the program counter associated with the error.\\ 819\jsontableend{ARM Processor Error Info Cache/TLB Information structure field table.} 820 821% ARM Processor Error Info Error Information (Cache/TLB) validation structure 822\subsection{ARM Processor Error Info Cache/TLB Validation Structure} 823\label{subsection:armprocessorerrorinfocachetlbvalidationstructure} 824This structure describes valid fields in a single ARM Processor Error Info Cache/TLB Information structure (\ref{subsection:armprocessorerrorinfoerrorinformationcachetlbstructure}), as a set of boolean fields. 825\jsontable{table:armprocessorerrorinfocachetlbvalidationstructure} 826transactionTypeValid & boolean & Whether the "transactionType" field in the ARM Processor Info Cache/TLB Information structure (\ref{subsection:armprocessorerrorinfoerrorinformationcachetlbstructure}) is valid.\\ 827\hline 828operationValid & boolean & Whether the "operation" field in the ARM Processor Info Cache/TLB Information structure (\ref{subsection:armprocessorerrorinfoerrorinformationcachetlbstructure}) is valid.\\ 829\hline 830levelValid & boolean & Whether the "level" field in the ARM Processor Info Cache/TLB Information structure (\ref{subsection:armprocessorerrorinfoerrorinformationcachetlbstructure}) is valid.\\ 831\hline 832processorContextCorruptValid & boolean & Whether the "processorContextCorrupt" field in the ARM Processor Info Cache/TLB Information structure (\ref{subsection:armprocessorerrorinfoerrorinformationcachetlbstructure}) is valid.\\ 833\hline 834correctedValid & boolean & Whether the "corrected" field in the ARM Processor Info Cache/TLB Information structure (\ref{subsection:armprocessorerrorinfoerrorinformationcachetlbstructure}) is valid.\\ 835\hline 836precisePCValid & boolean & Whether the "precisePC" field in the ARM Processor Info Cache/TLB Information structure (\ref{subsection:armprocessorerrorinfoerrorinformationcachetlbstructure}) is valid.\\ 837\hline 838restartablePCValid & boolean & Whether the "restartablePC" field in the ARM Processor Info Cache/TLB Information structure (\ref{subsection:armprocessorerrorinfoerrorinformationcachetlbstructure}) is valid.\\ 839\jsontableend{ARM Processor Error Info Cache/TLB validation structure field table.} 840 841% ARM Processor Error Info Error Information (Bus) structure 842\subsection{ARM Processor Error Info Bus Information Structure} 843\label{subsection:armprocessorerrorinfoerrorinformationbusstructure} 844This structure describes bus error information for a single ARM Processor Error Info structure (\ref{subsection:armprocessorerrorinfostructure}). This structure is used when the \texttt{type} field of that structure has the value 2. 845\jsontable{table:armprocessorerrorinfoerrorinformationbusstructure} 846validationBits & object & An ARM Processor Info Bus Validation structure as defined in Subsection \ref{subsection:armprocessorerrorinfobusvalidationstructure}.\\ 847\hline 848transactionType.value & uint64 & The raw value of the type of bus error.\\ 849transactionType.name & string & The human readable name, if available, of the type of bus error.\\ 850\hline 851operation.value & uint64 & The raw value of the bus operation that caused the error.\\ 852operation.name & string & The human readable name, if available, of the bus operation that caused the error.\\ 853\hline 854level & int & The affinity level that the bus error occurred at.\\ 855\hline 856processorContextCorrupt & boolean & Whether the processor context may have been corrupted.\\ 857\hline 858corrected & boolean & Whether the error was corrected.\\ 859\hline 860precisePC & boolean & Whether the program counter is directly associated with the error.\\ 861\hline 862restartablePC & boolean & Whether program execution can be restarted reliably at the program counter associated with the error.\\ 863\hline 864timedOut & boolean & Whether the request timed out.\\ 865\hline 866participationType.value & uint64 & The raw value of the type of participation that occurred in the bus error.\\ 867participationType.name & string & The human readable name, if available, of the type of participation that occurred in the bus error.\\ 868\hline 869addressSpace.value & uint64 & The raw value of the address space in which the bus error occurred.\\ 870addressSpace.name & string & The human readable name, if available, of the address space in which the bus error occurred.\\ 871\hline 872memoryAttributes & int & Memory access attributes for this bus error as described in the ARM ARM.\\ 873\hline 874accessMode.value & int & The raw value of the access mode of the bus request (secure/normal).\\ 875accessMode.name & string & The human readable name, if available, of the access mode of the bus request (secure/normal).\\ 876\jsontableend{ARM Processor Error Info Bus Information structure field table.} 877 878% ARM Processor Error Info Error Information (Bus) validation structure 879\subsection{ARM Processor Error Info Bus Validation Structure} 880\label{subsection:armprocessorerrorinfobusvalidationstructure} 881This structure describes valid fields in a single ARM Processor Error Info Cache/TLB Information structure (\ref{subsection:armprocessorerrorinfoerrorinformationbusstructure}), as a set of boolean fields. 882\jsontable{table:armprocessorerrorinfobusvalidationstructure} 883transactionTypeValid & boolean & Whether the "transactionType" field in the ARM Processor Info Bus Information structure (\ref{subsection:armprocessorerrorinfoerrorinformationbusstructure}) is valid.\\ 884\hline 885operationValid & boolean & Whether the "operation" field in the ARM Processor Info Bus Information structure (\ref{subsection:armprocessorerrorinfoerrorinformationbusstructure}) is valid.\\ 886\hline 887levelValid & boolean & Whether the "level" field in the ARM Processor Info Bus Information structure (\ref{subsection:armprocessorerrorinfoerrorinformationbusstructure}) is valid.\\ 888\hline 889processorContextCorruptValid & boolean & Whether the "processorContextCorrupt" field in the ARM Processor Info Bus Information structure (\ref{subsection:armprocessorerrorinfoerrorinformationbusstructure}) is valid.\\ 890\hline 891correctedValid & boolean & Whether the "corrected" field in the ARM Processor Info Bus Information structure (\ref{subsection:armprocessorerrorinfoerrorinformationbusstructure}) is valid.\\ 892\hline 893precisePCValid & boolean & Whether the "precisePC" field in the ARM Processor Info Bus Information structure (\ref{subsection:armprocessorerrorinfoerrorinformationbusstructure}) is valid.\\ 894\hline 895restartablePCValid & boolean & Whether the "restartablePC" field in the ARM Processor Info Bus Information structure (\ref{subsection:armprocessorerrorinfoerrorinformationbusstructure}) is valid.\\ 896\hline 897participationTypeValid & boolean & Whether the "participationType" field in the ARM Processor Info Bus Information structure (\ref{subsection:armprocessorerrorinfoerrorinformationbusstructure}) is valid.\\ 898\hline 899timedOutValid & boolean & Whether the "timedOut" field in the ARM Processor Info Bus Information structure (\ref{subsection:armprocessorerrorinfoerrorinformationbusstructure}) is valid.\\ 900\hline 901addressSpaceValid & boolean & Whether the "addressSpace" field in the ARM Processor Info Bus Information structure (\ref{subsection:armprocessorerrorinfoerrorinformationbusstructure}) is valid.\\ 902\hline 903memoryAttributesValid & boolean & Whether the "memoryAttributes" field in the ARM Processor Info Bus Information structure (\ref{subsection:armprocessorerrorinfoerrorinformationbusstructure}) is valid.\\ 904\hline 905accessModeValid & boolean & Whether the "accessMode" field in the ARM Processor Info Bus Information structure (\ref{subsection:armprocessorerrorinfoerrorinformationbusstructure}) is valid.\\ 906\jsontableend{ARM Processor Error Info Bus validation structure field table.} 907 908% ARM Processor Error Info Error Information (Microarchitecture/Undefined) structure 909\subsection{ARM Processor Error Info Microarchitecture/Undefined Information Structure} 910\label{subsection:armprocessorerrorinfoerrorinformationmicroarchundefinedstructure} 911This structure describes microarchitecture/other undefined error information for a single ARM Processor Error Info structure (\ref{subsection:armprocessorerrorinfostructure}). This structure is used when the \texttt{type} field of that structure has a value other than 0-2 (inclusive). 912\jsontable{table:armprocessorerrorinfoerrorinformationmicroarchundefinedstructure} 913data & uint64 & The unformatted data represented in the error information structure.\\ 914\jsontableend{ARM Processor Error Info Microarchitecture/Undefined Information structure field table.} 915 916% ARM Processor Context Info structure 917\subsection{ARM Processor Context Info Structure} 918\label{subsection:armprocessorcontextinfostructure} 919This structure describes a single ARM Processor Context Info structure, as part of a whole ARM Processor Error structure (\ref{section:armprocessorerrorsection}). 920\jsontable{table:armprocessorcontextinfostructure} 921version & int & The version of the structure. In the referenced UEFI specification, this is 0.\\ 922\hline 923registerContextType.value & uint64 & The raw value of the type of processor context state being reported.\\ 924registerContextType.name & string & The human readable name, if available, of the type of processor context state being reported.\\ 925\hline 926registerArraySize & uint64 & The size of the attached register array, in bytes.\\ 927\hline 928registerArray & object & The attached register array, with registers encoded as object fields. Structured as shown in one of subsections \ref{subsection:armaarch32gprstructure}, \ref{subsection:armaarch32el1contextregistersstructure}, \ref{subsection:armaarch32el2contextregistersstructure}, \ref{subsection:armaarch32secureregistersstructure}, \ref{subsection:armaarch64gprstructure}, \ref{subsection:armaarch64el1contextregistersstructure}, \ref{subsection:armaarch64el2contextregistersstructure}, \ref{subsection:armaarch64el3contextregistersstructure}, \ref{subsection:armmiscregistersstructure} or \ref{subsection:armunknownregistersstructure}. Type of structure depends on the \texttt{registerContextType.value} field.\\ 929\jsontableend{ARM Processor Context Info structure field table.} 930 931% ARM AARCH32 General Purpose Registers structure 932\subsection{ARM AARCH32 General Purpose Registers Structure} 933\label{subsection:armaarch32gprstructure} 934This structure describes the register array for AARCH32 GPRs as part of an ARM Processor Context Info Structure (\ref{subsection:armprocessorcontextinfostructure}). This structure is included when the field \texttt{registerContextType.value} has the value 0. 935\jsontable{table:armaarch32gprstructure} 936r0 & uint64 & Register R0. \texttt{UINT32} value null extended to \texttt{UINT64}.\\ 937\hline 938r1 & uint64 & Register R1. \texttt{UINT32} value null extended to \texttt{UINT64}.\\ 939\hline 940r2 & uint64 & Register R2. \texttt{UINT32} value null extended to \texttt{UINT64}.\\ 941\hline 942r3 & uint64 & Register R3. \texttt{UINT32} value null extended to \texttt{UINT64}.\\ 943\hline 944r4 & uint64 & Register R4. \texttt{UINT32} value null extended to \texttt{UINT64}.\\ 945\hline 946r5 & uint64 & Register R5. \texttt{UINT32} value null extended to \texttt{UINT64}.\\ 947\hline 948r6 & uint64 & Register R6. \texttt{UINT32} value null extended to \texttt{UINT64}.\\ 949\hline 950r7 & uint64 & Register R7. \texttt{UINT32} value null extended to \texttt{UINT64}.\\ 951\hline 952r8 & uint64 & Register R8. \texttt{UINT32} value null extended to \texttt{UINT64}.\\ 953\hline 954r9 & uint64 & Register R9. \texttt{UINT32} value null extended to \texttt{UINT64}.\\ 955\hline 956r10 & uint64 & Register R10. \texttt{UINT32} value null extended to \texttt{UINT64}.\\ 957\hline 958r11 & uint64 & Register R11. \texttt{UINT32} value null extended to \texttt{UINT64}.\\ 959\hline 960r12 & uint64 & Register R12. \texttt{UINT32} value null extended to \texttt{UINT64}.\\ 961\hline 962r13\_sp & uint64 & Register R13 (SP). \texttt{UINT32} value null extended to \texttt{UINT64}.\\ 963\hline 964r14\_lr & uint64 & Register R14 (LR). \texttt{UINT32} value null extended to \texttt{UINT64}.\\ 965\hline 966r15\_pc & uint64 & Register R15 (PC). \texttt{UINT32} value null extended to \texttt{UINT64}.\\ 967\jsontableend{ARM AARCH32 General Purpose Registers structure field table.} 968 969% ARM AARCH32 EL1 Context Registers structure 970\subsection{ARM AARCH32 EL1 Context Registers Structure} 971\label{subsection:armaarch32el1contextregistersstructure} 972This structure describes the register array for AARCH32 EL1 context registers as part of an ARM Processor Context Info Structure (\ref{subsection:armprocessorcontextinfostructure}). This structure is included when the field \texttt{registerContextType.value} has the value 1. 973\jsontable{table:armaarch32el1contextregistersstructure} 974dfar & uint64 & Register DFAR. \texttt{UINT32} value null extended to \texttt{UINT64}.\\ 975\hline 976dfsr & uint64 & Register DFSR. \texttt{UINT32} value null extended to \texttt{UINT64}.\\ 977\hline 978ifar & uint64 & Register IFAR. \texttt{UINT32} value null extended to \texttt{UINT64}.\\ 979\hline 980isr & uint64 & Register ISR. \texttt{UINT32} value null extended to \texttt{UINT64}.\\ 981\hline 982mair0 & uint64 & Register MAIR0. \texttt{UINT32} value null extended to \texttt{UINT64}.\\ 983\hline 984mair1 & uint64 & Register MAIR1. \texttt{UINT32} value null extended to \texttt{UINT64}.\\ 985\hline 986midr & uint64 & Register MIDR. \texttt{UINT32} value null extended to \texttt{UINT64}.\\ 987\hline 988mpidr & uint64 & Register MPIDR. \texttt{UINT32} value null extended to \texttt{UINT64}.\\ 989\hline 990nmrr & uint64 & Register NMRR. \texttt{UINT32} value null extended to \texttt{UINT64}.\\ 991\hline 992prrr & uint64 & Register PRRR. \texttt{UINT32} value null extended to \texttt{UINT64}.\\ 993\hline 994sctlr\_ns & uint64 & Register SCTLR (NS). \texttt{UINT32} value null extended to \texttt{UINT64}.\\ 995\hline 996spsr & uint64 & Register SPSR. \texttt{UINT32} value null extended to \texttt{UINT64}.\\ 997\hline 998spsr\_abt & uint64 & Register SPSR (ABT). \texttt{UINT32} value null extended to \texttt{UINT64}.\\ 999\hline 1000spsr\_fiq & uint64 & Register SPSR (FIQ). \texttt{UINT32} value null extended to \texttt{UINT64}.\\ 1001\hline 1002spsr\_irq & uint64 & Register SPSR (IRQ). \texttt{UINT32} value null extended to \texttt{UINT64}.\\ 1003\hline 1004spsr\_svc & uint64 & Register SPSR (SVC). \texttt{UINT32} value null extended to \texttt{UINT64}.\\ 1005\hline 1006spsr\_und & uint64 & Register SPSR (UND). \texttt{UINT32} value null extended to \texttt{UINT64}.\\ 1007\hline 1008tpidrprw & uint64 & Register TPIDR (PRW). \texttt{UINT32} value null extended to \texttt{UINT64}.\\ 1009\hline 1010tpidruro & uint64 & Register TPIDR (URO). \texttt{UINT32} value null extended to \texttt{UINT64}.\\ 1011\hline 1012tpidrurw & uint64 & Register TPIDR (URW). \texttt{UINT32} value null extended to \texttt{UINT64}.\\ 1013\hline 1014ttbcr & uint64 & Register TTBCR. \texttt{UINT32} value null extended to \texttt{UINT64}.\\ 1015\hline 1016ttbr0 & uint64 & Register TTBR0. \texttt{UINT32} value null extended to \texttt{UINT64}.\\ 1017\hline 1018ttbr1 & uint64 & Register TTBR1. \texttt{UINT32} value null extended to \texttt{UINT64}.\\ 1019\hline 1020dacr & uint64 & Register DACR. \texttt{UINT32} value null extended to \texttt{UINT64}.\\ 1021\jsontableend{ARM AARCH32 EL1 Context Registers structure field table.} 1022 1023% ARM AARCH32 EL2 Context Registers structure 1024\subsection{ARM AARCH32 EL2 Context Registers Structure} 1025\label{subsection:armaarch32el2contextregistersstructure} 1026This structure describes the register array for AARCH32 EL2 context registers as part of an ARM Processor Context Info Structure (\ref{subsection:armprocessorcontextinfostructure}). This structure is included when the field \texttt{registerContextType.value} has the value 2. 1027\jsontable{table:armaarch32el2contextregistersstructure} 1028elr\_hyp & uint64 & Register ELR\_HYP. \texttt{UINT32} value null extended to \texttt{UINT64}.\\ 1029\hline 1030hamair0 & uint64 & Register HAMAIR0. \texttt{UINT32} value null extended to \texttt{UINT64}.\\ 1031\hline 1032hamair1 & uint64 & Register HAMAIR1. \texttt{UINT32} value null extended to \texttt{UINT64}.\\ 1033\hline 1034hcr & uint64 & Register HCR. \texttt{UINT32} value null extended to \texttt{UINT64}.\\ 1035\hline 1036hcr2 & uint64 & Register HCR2. \texttt{UINT32} value null extended to \texttt{UINT64}.\\ 1037\hline 1038hdfar & uint64 & Register HDFAR. \texttt{UINT32} value null extended to \texttt{UINT64}.\\ 1039\hline 1040hifar & uint64 & Register HIFAR. \texttt{UINT32} value null extended to \texttt{UINT64}.\\ 1041\hline 1042hpfar & uint64 & Register HPFAR. \texttt{UINT32} value null extended to \texttt{UINT64}.\\ 1043\hline 1044hsr & uint64 & Register HSR. \texttt{UINT32} value null extended to \texttt{UINT64}.\\ 1045\hline 1046htcr & uint64 & Register HTCR. \texttt{UINT32} value null extended to \texttt{UINT64}.\\ 1047\hline 1048htpidr & uint64 & Register HTPIDR. \texttt{UINT32} value null extended to \texttt{UINT64}.\\ 1049\hline 1050httbr & uint64 & Register HTTBR. \texttt{UINT32} value null extended to \texttt{UINT64}.\\ 1051\hline 1052spsr\_hyp & uint64 & Register SPSR (HYP). \texttt{UINT32} value null extended to \texttt{UINT64}.\\ 1053\hline 1054vtcr & uint64 & Register VTCR. \texttt{UINT32} value null extended to \texttt{UINT64}.\\ 1055\hline 1056vttbr & uint64 & Register VTTBR. \texttt{UINT32} value null extended to \texttt{UINT64}.\\ 1057\hline 1058dacr32\_el2 & uint64 & Register DACR32 (EL2). \texttt{UINT32} value null extended to \texttt{UINT64}.\\ 1059\hline 1060\jsontableend{ARM AARCH32 EL2 Context Registers structure field table.} 1061 1062% ARM AARCH32 Secure Registers structure 1063\subsection{ARM AARCH32 Secure Registers Structure} 1064\label{subsection:armaarch32secureregistersstructure} 1065This structure describes the register array for AARCH32 secure registers as part of an ARM Processor Context Info Structure (\ref{subsection:armprocessorcontextinfostructure}). This structure is included when the field \texttt{registerContextType.value} has the value 3. 1066\jsontable{table:armaarch32secureregistersstructure} 1067sctlr\_s & uint64 & Register SCTLR\_S. \texttt{UINT32} value null extended to \texttt{UINT64}.\\ 1068\hline 1069spsr\_mon & uint64 & Register SPSR (MON). \texttt{UINT32} value null extended to \texttt{UINT64}.\\ 1070\jsontableend{ARM AARCH32 Secure Registers structure field table.} 1071 1072% ARM AARCH64 General Purpose Registers structure 1073\subsection{ARM AARCH64 General Purpose Registers Structure} 1074\label{subsection:armaarch64gprstructure} 1075This structure describes the register array for AARCH64 GPRs as part of an ARM Processor Context Info Structure (\ref{subsection:armprocessorcontextinfostructure}). This structure is included when the field \texttt{registerContextType.value} has the value 4. 1076\jsontable{table:armaarch64gprstructure} 1077x0 & uint64 & Register X0.\\ 1078\hline 1079x1 & uint64 & Register X1.\\ 1080\hline 1081x2 & uint64 & Register X2.\\ 1082\hline 1083x3 & uint64 & Register X3.\\ 1084\hline 1085x4 & uint64 & Register X4.\\ 1086\hline 1087x5 & uint64 & Register X5.\\ 1088\hline 1089x6 & uint64 & Register X6.\\ 1090\hline 1091x7 & uint64 & Register X7.\\ 1092\hline 1093x8 & uint64 & Register X8.\\ 1094\hline 1095x9 & uint64 & Register X9.\\ 1096\hline 1097x10 & uint64 & Register X10.\\ 1098\hline 1099x11 & uint64 & Register X11.\\ 1100\hline 1101x12 & uint64 & Register X12.\\ 1102\hline 1103x13 & uint64 & Register X13.\\ 1104\hline 1105x14 & uint64 & Register X14.\\ 1106\hline 1107x15 & uint64 & Register X15.\\ 1108\hline 1109x16 & uint64 & Register X16.\\ 1110\hline 1111x17 & uint64 & Register X17.\\ 1112\hline 1113x18 & uint64 & Register X18.\\ 1114\hline 1115x19 & uint64 & Register X19.\\ 1116\hline 1117x20 & uint64 & Register X20.\\ 1118\hline 1119x21 & uint64 & Register X21.\\ 1120\hline 1121x22 & uint64 & Register X22.\\ 1122\hline 1123x23 & uint64 & Register X23.\\ 1124\hline 1125x24 & uint64 & Register X24.\\ 1126\hline 1127x25 & uint64 & Register X25.\\ 1128\hline 1129x26 & uint64 & Register X26.\\ 1130\hline 1131x27 & uint64 & Register X27.\\ 1132\hline 1133x28 & uint64 & Register X28.\\ 1134\hline 1135x29 & uint64 & Register X29.\\ 1136\hline 1137x30 & uint64 & Register X30.\\ 1138\hline 1139sp & uint64 & Register SP.\\ 1140\jsontableend{ARM AARCH64 General Purpose Registers structure field table.} 1141 1142% ARM AARCH64 EL1 Context Registers structure 1143\subsection{ARM AARCH64 EL1 Context Registers Structure} 1144\label{subsection:armaarch64el1contextregistersstructure} 1145This structure describes the register array for AARCH64 EL1 context registers as part of an ARM Processor Context Info Structure (\ref{subsection:armprocessorcontextinfostructure}). This structure is included when the field \texttt{registerContextType.value} has the value 5. 1146\jsontable{table:armaarch64el1contextregistersstructure} 1147elr\_el1 & uint64 & Register ELR (EL1).\\ 1148\hline 1149esr\_el1 & uint64 & Register ESR (EL1).\\ 1150\hline 1151far\_el1 & uint64 & Register FAR (EL1).\\ 1152\hline 1153isr\_el1 & uint64 & Register ISR (EL1).\\ 1154\hline 1155mair\_el1 & uint64 & Register MAIR (EL1).\\ 1156\hline 1157midr\_el1 & uint64 & Register MIDR (EL1).\\ 1158\hline 1159mpidr\_el1 & uint64 & Register MPIDR (EL1).\\ 1160\hline 1161sctlr\_el1 & uint64 & Register SCTLR (EL1).\\ 1162\hline 1163sp\_el0 & uint64 & Register SP (EL0).\\ 1164\hline 1165sp\_el1 & uint64 & Register SP (EL1).\\ 1166\hline 1167spsr\_el1 & uint64 & Register SPSR (EL1).\\ 1168\hline 1169tcr\_el1 & uint64 & Register TCR (EL1).\\ 1170\hline 1171tpidr\_el0 & uint64 & Register TPIDR (EL0).\\ 1172\hline 1173tpidr\_el1 & uint64 & Register TPIDR (EL1).\\ 1174\hline 1175tpidrro\_el0 & uint64 & Register TPIDRRO (EL0).\\ 1176\hline 1177ttbr0\_el1 & uint64 & Register TTBR0 (EL1).\\ 1178\hline 1179ttbr1\_el1 & uint64 & Register TTBR1 (EL1).\\ 1180\jsontableend{ARM AARCH64 EL1 Context Registers structure field table.} 1181 1182% ARM AARCH64 EL2 Context Registers structure 1183\subsection{ARM AARCH64 EL2 Context Registers Structure} 1184\label{subsection:armaarch64el2contextregistersstructure} 1185This structure describes the register array for AARCH64 EL2 context registers as part of an ARM Processor Context Info Structure (\ref{subsection:armprocessorcontextinfostructure}). This structure is included when the field \texttt{registerContextType.value} has the value 6. 1186\jsontable{table:armaarch64el2contextregistersstructure} 1187elr\_el2 & uint64 & Register ELR (EL2).\\ 1188\hline 1189esr\_el2 & uint64 & Register ESR (EL2).\\ 1190\hline 1191far\_el2 & uint64 & Register FAR (EL2).\\ 1192\hline 1193hacr\_el2 & uint64 & Register HACR (EL2).\\ 1194\hline 1195hcr\_el2 & uint64 & Register HCR (EL2).\\ 1196\hline 1197hpfar\_el2 & uint64 & Register HPFAR (EL2).\\ 1198\hline 1199mair\_el2 & uint64 & Register MAIR (EL2).\\ 1200\hline 1201sctlr\_el2 & uint64 & Register SCTLR (EL2).\\ 1202\hline 1203sp\_el2 & uint64 & Register SP (EL2).\\ 1204\hline 1205spsr\_el2 & uint64 & Register SPSR (EL2).\\ 1206\hline 1207tcr\_el2 & uint64 & Register TCR (EL2).\\ 1208\hline 1209tpidr\_el2 & uint64 & Register TPIDR (EL2).\\ 1210\hline 1211ttbr0\_el2 & uint64 & Register TTBR0 (EL2).\\ 1212\hline 1213vtcr\_el2 & uint64 & Register VTCR (EL2).\\ 1214\hline 1215vttbr\_el2 & uint64 & Register VTTBR (EL2).\\ 1216\jsontableend{ARM AARCH64 EL2 Context Registers structure field table.} 1217 1218% ARM AARCH64 EL3 Context Registers structure 1219\subsection{ARM AARCH64 EL3 Context Registers Structure} 1220\label{subsection:armaarch64el3contextregistersstructure} 1221This structure describes the register array for AARCH64 EL3 context registers as part of an ARM Processor Context Info Structure (\ref{subsection:armprocessorcontextinfostructure}). This structure is included when the field \texttt{registerContextType.value} has the value 7. 1222\jsontable{table:armaarch64el3contextregistersstructure} 1223elr\_el3 & uint64 & Register ELR (EL3).\\ 1224\hline 1225esr\_el3 & uint64 & Register ESR (EL3).\\ 1226\hline 1227far\_el3 & uint64 & Register FAR (EL3).\\ 1228\hline 1229mair\_el3 & uint64 & Register MAIR (EL3).\\ 1230\hline 1231sctlr\_el3 & uint64 & Register SCTLR (EL3).\\ 1232\hline 1233sp\_el3 & uint64 & Register SP (EL3).\\ 1234\hline 1235spsr\_el3 & uint64 & Register SPSR (EL3).\\ 1236\hline 1237tcr\_el3 & uint64 & Register TCR (EL3).\\ 1238\hline 1239tpidr\_el3 & uint64 & Register TPIDR (EL3).\\ 1240\hline 1241ttbr0\_el3 & uint64 & Register TTBR0 (EL3).\\ 1242\jsontableend{ARM AARCH64 EL3 Context Registers structure field table.} 1243 1244% ARM AARCH64 Miscellaneous Registers structure 1245\subsection{ARM AARCH64 Miscellaneous Registers Structure} 1246\label{subsection:armmiscregistersstructure} 1247This structure describes the register array for miscellaneous ARM registers as part of an ARM Processor Context Info Structure (\ref{subsection:armprocessorcontextinfostructure}). This structure is included when the field \texttt{registerContextType.value} has the value 8. 1248\jsontable{table:armmiscregistersstructure} 1249mrsEncoding.op2 & uint64 & MRS Encoding OP2.\\ 1250\hline 1251mrsEncoding.crm & uint64 & MRS Encoding CRm.\\ 1252\hline 1253mrsEncoding.crn & uint64 & MRS Encoding CRn.\\ 1254\hline 1255mrsEncoding.op1 & uint64 & MRS Encoding Op1.\\ 1256\hline 1257mrsEncoding.o0 & uint64 & MRS Encoding O0.\\ 1258\hline 1259value & uint64 & Value of the single register.\\ 1260\jsontableend{ARM AARCH64 Miscellaneous Registers structure field table.} 1261 1262% ARM AARCH64 Unknown Registers structure 1263\subsection{ARM AARCH64 Unknown Registers Structure} 1264\label{subsection:armunknownregistersstructure} 1265This structure describes the register array for unknown ARM registers as part of an ARM Processor Context Info Structure (\ref{subsection:armprocessorcontextinfostructure}). This structure is included when the field \texttt{registerContextType.value} has any value other than 0-8 (inclusive). 1266\jsontable{table:armunknownregistersstructure} 1267data & string & A base64 representation of the unknown binary register array data.\\ 1268\jsontableend{ARM AARCH64 Unknown Registers structure field table.} 1269 1270% Memory error section. 1271\section{Memory Error Section} 1272\label{section:memoryerrorsection} 1273This section describes the JSON format for a single Memory Error Section from a CPER record. The GUID used for Memory Error Sections is \texttt{\{ 0xa5bc1114, 0x6f64, 0x4ede, \{ 0xb8, 0x63, 0x3e, 0x83, 0xed, 0x7c, 0x83, 0xb1 \}\}}. 1274\jsontable{table:memoryerrorsection} 1275validationBits & object & A Memory Error Validation structure, as described in Subsection \ref{subsection:memoryerrorvalidationstructure}.\\ 1276\hline 1277errorStatus & object & A CPER Generic Error Status structure, as described in Subsection \ref{subsection:genericerrorstatusstructure}.\\ 1278\hline 1279bank & object & Structure as described in one of Subsection \ref{subsection:memoryerrorstandardbankaddressstructure} or Subsection \ref{subsection:memoryerroraddressgroupbankaddressstructure}. Selected structure depends on the \texttt{validationBits.bankValid} field.\\ 1280\hline 1281memoryErrorType.value & uint64 & The raw value of the memory error type.\\ 1282memoryErrorType.name & string & The human readable name, if available, of the memory error type.\\ 1283\hline 1284extended.rowBit16 & boolean & Bit 16 of the row number of the memory error location.\\ 1285extended.rowBit17 & boolean & Bit 17 of the row number of the memory error location.\\ 1286extended.chipIdentification & int & The ID of the related chip.\\ 1287\hline 1288physicalAddress & uint64 & The physical address at which the error occurred.\\ 1289\hline 1290physicalAddressMask & uint64 & Defines the valid address bits in the \texttt{physicalAddress} field.\\ 1291\hline 1292node & uint64 & Identifies the node containing the memory error, if in a multi-node system.\\ 1293\hline 1294card & uint64 & The card number of the memory error location.\\ 1295\hline 1296moduleRank & uint64 & The module or rank number of the offending memory error location.\\ 1297\hline 1298device & uint64 & The device number of the memory associated with the error.\\ 1299\hline 1300row & uint64 & The first 16 bits of the row number of the memory location.\\ 1301\hline 1302column & uint64 & The column number of the memory error location.\\ 1303\hline 1304bitPosition & uint64 & The bit position at which the error occurred.\\ 1305\hline 1306requestorID & uint64 & Hardware address of the device that initiated the errored transaction.\\ 1307\hline 1308responderID & uint64 & Hardware address of the device that responded to the transaction.\\ 1309\hline 1310targetID & uint64 & Hardware address of the intended target of the transaction.\\ 1311\hline 1312rankNumber & uint64 & The rank number of the memory error location.\\ 1313\hline 1314cardSmbiosHandle & uint64 & The SMBIOS handle for the memory card's Type 16 Memory Array Structure.\\ 1315\hline 1316moduleSmbiosHandle & uint64 & The SMBIOS handle for the memory module's Type 17 Memory Device Structure.\\ 1317\jsontableend{Memory Error structure field table.} 1318 1319% Memory error validation structure. 1320\subsection{Memory Error Validation Structure} 1321\label{subsection:memoryerrorvalidationstructure} 1322This structure describes whether fields in a single Memory Error (\ref{section:memoryerrorsection}) are valid, using boolean fields. 1323\jsontable{table:memoryerrorvalidationstructure} 1324errorStatusValid & boolean & Whether the "errorStatus" field of a Memory Error (\ref{section:memoryerrorsection}) is valid.\\ 1325\hline 1326physicalAddressValid & boolean & Whether the "physicalAddress" field of a Memory Error (\ref{section:memoryerrorsection}) is valid.\\ 1327\hline 1328physicalAddressMaskValid & boolean & Whether the "physicalAddressMask" field of a Memory Error (\ref{section:memoryerrorsection}) is valid.\\ 1329\hline 1330nodeValid & boolean & Whether the "node" field of a Memory Error (\ref{section:memoryerrorsection}) is valid.\\ 1331\hline 1332cardValid & boolean & Whether the "card" field of a Memory Error (\ref{section:memoryerrorsection}) is valid.\\ 1333\hline 1334moduleValid & boolean & Whether the "module" field of a Memory Error (\ref{section:memoryerrorsection}) is valid.\\ 1335\hline 1336bankValid & boolean & Whether the "bank.value" field of a Memory Error (\ref{section:memoryerrorsection}) is valid. When the bank is addressed by group/address, refer to \texttt{bankGroupValid} and \texttt{bankAddressValid} instead.\\ 1337\hline 1338deviceValid & boolean & Whether the "device" field of a Memory Error (\ref{section:memoryerrorsection}) is valid.\\ 1339\hline 1340rowValid & boolean & Whether the "row" field of a Memory Error (\ref{section:memoryerrorsection}) is valid.\\ 1341\hline 1342memoryPlatformTargetValid & boolean & Whether the memory platform target of a Memory Error (\ref{section:memoryerrorsection}) is valid.\\ 1343\hline 1344memoryErrorTypeValid & boolean & Whether the "memoryErrorType" field of a Memory Error (\ref{section:memoryerrorsection}) is valid.\\ 1345\hline 1346rankNumberValid & boolean & Whether the "rankNumber" field of a Memory Error (\ref{section:memoryerrorsection}) is valid.\\ 1347\hline 1348cardHandleValid & boolean & Whether the "cardSmbiosHandle" field of a Memory Error (\ref{section:memoryerrorsection}) is valid.\\ 1349\hline 1350moduleHandleValid & boolean & Whether the "moduleSmbiosHandle" field of a Memory Error (\ref{section:memoryerrorsection}) is valid.\\ 1351\hline 1352extendedRowBitsValid & boolean & Whether the "extended.rowBit16" and "extended.rowBit17" field of a Memory Error (\ref{section:memoryerrorsection}) is valid.\\ 1353\hline 1354bankGroupValid & boolean & Whether the "bank.group" field of a Memory Error (\ref{section:memoryerrorsection}) is valid.\\ 1355\hline 1356bankAddressValid & boolean & Whether the "bank.address" field of a Memory Error (\ref{section:memoryerrorsection}) is valid.\\ 1357\hline 1358chipIdentificationValid & boolean & Whether the "extended.chipIdentification" field of a Memory Error (\ref{section:memoryerrorsection}) is valid.\\ 1359\jsontableend{Memory Error validation structure field table.} 1360 1361% Memory error normal bank addressing structure. 1362\subsection{Memory Error Standard Bank Address Structure} 1363\label{subsection:memoryerrorstandardbankaddressstructure} 1364This structure describes a simple bank address for a Memory Error section (\ref{section:memoryerrorsection}). This structure is selected when the \texttt{bankValid} field in the corresponding Memory Error Validation Structure (\ref{subsection:memoryerrorvalidationstructure}) is set to "true". 1365\jsontable{table:memoryerrorstandardbankaddressstructure} 1366value & uint64 & The value of the bank address.\\ 1367\jsontableend{Memory Error Standard Bank Address structure field table.} 1368 1369% Memory error address/group bank addressing structure. 1370\subsection{Memory Error Address/Group Bank Address Structure} 1371\label{subsection:memoryerroraddressgroupbankaddressstructure} 1372This structure describes an address/group bank address for a Memory Error section (\ref{section:memoryerrorsection}). This structure is selected when the \texttt{bankValid} field in the corresponding Memory Error Validation Structure (\ref{subsection:memoryerrorvalidationstructure}) is set to "false". 1373\jsontable{table:memoryerroraddressgroupbankaddressstructure} 1374address & uint64 & The address of the bank.\\ 1375\hline 1376group & uint64 & The group of the bank.\\ 1377\jsontableend{Memory Error Address/Group Bank Address structure field table.} 1378 1379% Memory error 2 section. 1380\section{Memory Error 2 Section} 1381\label{section:memoryerror2section} 1382This section describes the JSON format for a single Memory Error 2 Section from a CPER record. The GUID used for Memory Error 2 Sections is \texttt{\{ 0x61EC04FC, 0x48E6, 0xD813, \{ 0x25, 0xC9, 0x8D, 0xAA, 0x44, 0x75, 0x0B, 0x12 \}\}}. 1383\jsontable{table:memoryerror2section} 1384validationBits & object & A Memory Error 2 Validation structure, as described in Subsection \ref{subsection:memoryerror2validationstructure}.\\ 1385\hline 1386errorStatus & object & A CPER Generic Error Status structure, as described in Subsection \ref{subsection:genericerrorstatusstructure}.\\ 1387\hline 1388bank & object & Structure as described in one of Subsection \ref{subsection:memoryerror2standardbankaddressstructure} or Subsection \ref{subsection:memoryerror2addressgroupbankaddressstructure}. Selected structure depends on the \texttt{validationBits.bankValid} field.\\ 1389\hline 1390memoryErrorType.value & uint64 & The raw value of the memory error type.\\ 1391memoryErrorType.name & string & The human readable name, if available, of the memory error type.\\ 1392\hline 1393status.value & int & The raw value of the memory error status.\\ 1394status.state & string & The human readable value, if available, of the memory error status (corrected/uncorrected).\\ 1395\hline 1396physicalAddress & uint64 & The physical address at which the error occurred.\\ 1397\hline 1398physicalAddressMask & uint64 & Defines the valid address bits in the \texttt{physicalAddress} field.\\ 1399\hline 1400node & uint64 & Identifies the node containing the memory error, if in a multi-node system.\\ 1401\hline 1402card & uint64 & The card number of the memory error location.\\ 1403\hline 1404module & uint64 & The module of the offending memory error location.\\ 1405\hline 1406device & uint64 & The device number of the memory associated with the error.\\ 1407\hline 1408row & uint64 & The first 16 bits of the row number of the memory location.\\ 1409\hline 1410column & uint64 & The column number of the memory error location.\\ 1411\hline 1412bitPosition & uint64 & The bit position at which the error occurred.\\ 1413\hline 1414rank & uint64 & The rank number of the error location.\\ 1415\hline 1416chipID & uint64 & Chip identifier. Encoded field used to address the die in 3DS packages.\\ 1417\hline 1418requestorID & uint64 & Hardware address of the device that initiated the errored transaction.\\ 1419\hline 1420responderID & uint64 & Hardware address of the device that responded to the transaction.\\ 1421\hline 1422targetID & uint64 & Hardware address of the intended target of the transaction.\\ 1423\hline 1424cardSmbiosHandle & uint64 & The SMBIOS handle for the memory card's Type 16 Memory Array Structure.\\ 1425\hline 1426moduleSmbiosHandle & uint64 & The SMBIOS handle for the memory module's Type 17 Memory Device Structure.\\ 1427\jsontableend{Memory Error 2 structure field table.} 1428 1429% Memory error 2 validation structure. 1430\subsection{Memory Error 2 Validation Structure} 1431\label{subsection:memoryerror2validationstructure} 1432This structure describes whether fields in a single Memory Error 2 (\ref{section:memoryerror2section}) are valid, using boolean fields. 1433\jsontable{table:memoryerror2validationstructure} 1434errorStatusValid & boolean & Whether the "errorStatus" field of a Memory Error 2 (\ref{section:memoryerror2section}) is valid.\\ 1435\hline 1436physicalAddressValid & boolean & Whether the "physicalAddress" field of a Memory Error 2 (\ref{section:memoryerror2section}) is valid.\\ 1437\hline 1438physicalAddressMaskValid & boolean & Whether the "physicalAddressMask" field of a Memory Error 2 (\ref{section:memoryerror2section}) is valid.\\ 1439\hline 1440nodeValid & boolean & Whether the "node" field of a Memory Error 2 (\ref{section:memoryerror2section}) is valid.\\ 1441\hline 1442cardValid & boolean & Whether the "card" field of a Memory Error 2 (\ref{section:memoryerror2section}) is valid.\\ 1443\hline 1444moduleValid & boolean & Whether the "module" field of a Memory Error 2 (\ref{section:memoryerror2section}) is valid.\\ 1445\hline 1446bankValid & boolean & Whether the "bank.value" field of a Memory Error 2 (\ref{section:memoryerror2section}) is valid. When the bank is addressed by group/address, refer to \texttt{bankGroupValid} and \texttt{bankAddressValid} instead.\\ 1447\hline 1448deviceValid & boolean & Whether the "device" field of a Memory Error 2 (\ref{section:memoryerror2section}) is valid.\\ 1449\hline 1450rowValid & boolean & Whether the "row" field of a Memory Error 2 (\ref{section:memoryerror2section}) is valid.\\ 1451\hline 1452columnValid & boolean & Whether the "column" field of a Memory Error 2 (\ref{section:memoryerror2section}) is valid.\\ 1453\hline 1454rankValid & boolean & Whether the "rank" field of a Memory Error 2 (\ref{section:memoryerror2section}) is valid.\\ 1455\hline 1456bitPositionValid & boolean & Whether the "bitPosition" field of a Memory Error 2 (\ref{section:memoryerror2section}) is valid.\\ 1457\hline 1458chipIDValid & boolean & Whether the "chipID" field of a Memory Error 2 (\ref{section:memoryerror2section}) is valid.\\ 1459\hline 1460memoryErrorTypeValid & boolean & Whether the "memoryErrorType" field of a Memory Error 2 (\ref{section:memoryerror2section}) is valid.\\ 1461\hline 1462statusValid & boolean & Whether the "status" field of a Memory Error 2 (\ref{section:memoryerror2section}) is valid.\\ 1463\hline 1464requestorIDValid & boolean & Whether the "requestorID" field of a Memory Error 2 (\ref{section:memoryerror2section}) is valid.\\ 1465\hline 1466responderIDValid & boolean & Whether the "responderID" field of a Memory Error 2 (\ref{section:memoryerror2section}) is valid.\\ 1467\hline 1468targetIDValid & boolean & Whether the "targetID" field of a Memory Error 2 (\ref{section:memoryerror2section}) is valid.\\ 1469\hline 1470cardHandleValid & boolean & Whether the "cardSmbiosHandle" field of a Memory Error 2 (\ref{section:memoryerror2section}) is valid.\\ 1471\hline 1472moduleHandleValid & boolean & Whether the "moduleSmbiosHandle" field of a Memory Error 2 (\ref{section:memoryerror2section}) is valid.\\ 1473\hline 1474bankGroupValid & boolean & Whether the "bankGroup" field of a Memory Error 2 (\ref{section:memoryerror2section}) is valid.\\ 1475\hline 1476bankAddressValid & boolean & Whether the "bankAddress" field of a Memory Error 2 (\ref{section:memoryerror2section}) is valid.\\ 1477\jsontableend{Memory Error 2 validation structure field table.} 1478 1479% Memory error 2 normal bank addressing structure. 1480\subsection{Memory Error 2 Standard Bank Address Structure} 1481\label{subsection:memoryerror2standardbankaddressstructure} 1482This structure describes a simple bank address for a Memory Error 2 section (\ref{section:memoryerror2section}). This structure is selected when the \texttt{bankValid} field in the corresponding Memory Error 2 Validation Structure (\ref{subsection:memoryerror2validationstructure}) is set to "true". 1483\jsontable{table:memoryerror2standardbankaddressstructure} 1484value & uint64 & The value of the bank address.\\ 1485\jsontableend{Memory Error 2 Standard Bank Address structure field table.} 1486 1487% Memory error 2 address/group bank addressing structure. 1488\subsection{Memory Error 2 Address/Group Bank Address Structure} 1489\label{subsection:memoryerror2addressgroupbankaddressstructure} 1490This structure describes an address/group bank address for a Memory Error 2 section (\ref{section:memoryerror2section}). This structure is selected when the \texttt{bankValid} field in the corresponding Memory Error 2 Validation Structure (\ref{subsection:memoryerror2validationstructure}) is set to "false". 1491\jsontable{table:memoryerror2addressgroupbankaddressstructure} 1492address & uint64 & The address of the bank.\\ 1493\hline 1494group & uint64 & The group of the bank.\\ 1495\jsontableend{Memory Error 2 Address/Group Bank Address structure field table.} 1496 1497% PCIe error section. 1498\section{PCIe Error Section} 1499\label{section:pcieerrorsection} 1500This section describes the JSON format for a single PCIe Error Section from a CPER record. The GUID used for PCIe Error Sections is \texttt{\{ 0xd995e954, 0xbbc1, 0x430f, \{ 0xad, 0x91, 0xb4, 0x4d, 0xcb, 0x3c, 0x6f, 0x35 \}\}}. 1501\jsontable{table:pcieerrorsection} 1502validationBits & object & A PCIe Error Validation structure as defined in Subsection \ref{subsection:pcieerrorvalidationstructure}.\\ 1503\hline 1504portType.value & uint64 & The raw value of the port type for this error.\\ 1505portType.name & string & The human readable name, if available, of the port type for this error.\\ 1506\hline 1507version.major & int & The major version number for the PCIe specification supported.\\ 1508version.minor & int & The minor version number for the PCIe specification supported.\\ 1509\hline 1510commandStatus.commandRegister & uint64 & The PCI command register value.\\ 1511commandStatus.statusRegister & uint64 & The PCI status register value.\\ 1512\hline 1513deviceID & object & A PCIe Device ID structure as defined in Subsection \ref{subsection:pciedeviceidstructure}.\\ 1514\hline 1515deviceSerialNumber & uint64 & The serial number of the device.\\ 1516\hline 1517bridgeControlStatus.secondaryStatusRegister & uint64 & The bridge secondary status register. \emph{This field is valid for bridges only.}\\ 1518\hline 1519bridgeControlStatus.controlRegister & uint64 & The bridge control register. \emph{This field is valid for bridges only.}\\ 1520\hline 1521capabilityStructure.data & string & A base-64 formatted binary dump of the PCIe capability structure for this device. The structure could either be a PCIe 1.1 Capability Structure (36-byte, padded to 60 bytes) or a PCIe 2.0 Capability Structure (60-byte).\\ 1522\hline 1523% aerInfo & object & A PCIe AER Extended Capability structure, as defined in Subsection \ref{subsection:pcieaerecstructure}.\\ 1524aerInfo.data & string & A base64-formatted representation of a PCIe AER Extended Capability structure.\\ 1525\jsontableend{PCIe Error structure field table.} 1526 1527% PCIe error validation structure. 1528\subsection{PCIe Error Validation Structure} 1529\label{subsection:pcieerrorvalidationstructure} 1530This structure describes which fields within a PCIe Error section (\ref{section:pcieerrorsection}) are valid, using boolean fields. 1531\jsontable{table:pcieerrorvalidationstructure} 1532portTypeValid & boolean & Whether the "portType" field within a PCIe Error section (\ref{section:pcieerrorsection}) is valid.\\ 1533\hline 1534versionValid & boolean & Whether the "version" field within a PCIe Error section (\ref{section:pcieerrorsection}) is valid.\\ 1535\hline 1536commandStatusValid & boolean & Whether the "commandStatus" field within a PCIe Error section (\ref{section:pcieerrorsection}) is valid.\\ 1537\hline 1538deviceIDValid & boolean & Whether the "deviceID" field within a PCIe Error section (\ref{section:pcieerrorsection}) is valid.\\ 1539\hline 1540deviceSerialNumberValid & boolean & Whether the "deviceSerialNumber" field within a PCIe Error section (\ref{section:pcieerrorsection}) is valid.\\ 1541\hline 1542bridgeControlStatusValid & boolean & Whether the "bridgeControlStatus" field within a PCIe Error section (\ref{section:pcieerrorsection}) is valid.\\ 1543\hline 1544capabilityStructureStatusValid & boolean & Whether the "capabilityStructure" field within a PCIe Error section (\ref{section:pcieerrorsection}) is valid.\\ 1545\hline 1546aerInfoValid & boolean & Whether the "aerInfo" field within a PCIe Error section (\ref{section:pcieerrorsection}) is valid.\\ 1547\hline 1548\jsontableend{PCIe Error validation structure field table.} 1549 1550% PCIe Device ID structure. 1551\subsection{PCIe Device ID Structure} 1552\label{subsection:pciedeviceidstructure} 1553This structure describes a PCIe device ID, for use in a PCI Error section (\ref{table:pcieerrorsection}). 1554\jsontable{table:pciedeviceidstructure} 1555vendorID & uint64 & The vendor ID of the PCIe device.\\ 1556\hline 1557deviceID & uint64 & The device ID of the PCIe device.\\ 1558\hline 1559classCode & uint64 & The class code of the PCIe device.\\ 1560\hline 1561functionNumber & uint64 & The function number of the PCIe device.\\ 1562\hline 1563deviceNumber & uint64 & The device number of the PCIe device.\\ 1564\hline 1565segmentNumber & uint64 & The segment number of the PCIe device.\\ 1566\hline 1567primaryOrDeviceBusNumber & uint64 & The root port/bridge primary bus number or device bus number of the PCIe device.\\ 1568\hline 1569secondaryBusNumber & uint64 & The root port/bridge secondary bus number of the PCIe device.\\ 1570\hline 1571slotNumber & uint64 & The slot number of the PCIe device.\\ 1572\jsontableend{PCIe Device ID structure field table.} 1573 1574% % PCIe Advanced Error Reporting Extended Capability structure. 1575% \subsection{PCIe AER Extended Capability Structure} 1576% \label{subsection:pcieaerecstructure} 1577% This structure describes a PCIe Advanced Error Reporting Extended Capability structure, for use in a PCI Error section (\ref{table:pcieerrorsection}). 1578% \jsontable{table:pcieaerecstructure} 1579% capabilityID & uint64 & The capability ID for this AER structure.\\ 1580% \hline 1581% capabilityVersion & uint64 & The capability structure version for this AER structure.\\ 1582% \hline 1583% uncorrectableErrorStatusRegister & uint64 & The uncorrectable error status register value.\\ 1584% \hline 1585% uncorrectableErrorMaskRegister & uint64 & The uncorrectable error mask register value.\\ 1586% \hline 1587% uncorrectableErrorSeverityRegister & uint64 & The uncorrectable error severity register value.\\ 1588% \hline 1589% correctableErrorStatusRegister & uint64 & The correctable error status register value.\\ 1590% \hline 1591% correctableErrorMaskRegister & uint64 & The correctable error mask register value.\\ 1592% \hline 1593% aeccReg & uint64 & The AECC register value.\\ 1594% \hline 1595% headerLogRegister & string & A base64-encoded binary dump of the header log register.\\ 1596% \hline 1597% rootErrorCommand & uint64 & The root error command.\\ 1598% \hline 1599% rootErrorStatus & uint64 & The root error status.\\ 1600% \hline 1601% errorSourceIDRegister & uint64 & The error source ID register.\\ 1602% \hline 1603% correctableErrorSourceIDRegister & uint64 & The correctable error source ID register.\\ 1604% \jsontableend{PCIe AER Extended Capability structure field table.} 1605 1606% PCI/PCI-X Bus error section. 1607\section{PCI/PCI-X Bus Error Section} 1608\label{section:pcibuserrorsection} 1609This section describes the JSON format for a single PCI/PCI-X Bus Error Section from a CPER record. The GUID used for PCI/PCI-X Bus Error Sections is \texttt{\{ 0xc5753963, 0x3b84, 0x4095, \{ 0xbf, 0x78, 0xed, 0xda, 0xd3, 0xf9, 0xc9, 0xdd \}\}}. 1610\jsontable{table:pcibuserrorsection} 1611validationBits & object & A PCI/PCI-X Bus Error Validation structure, as described in Subsection \ref{subsection:pcibuserrorvalidationstructure}.\\ 1612\hline 1613errorStatus & object & A CPER Generic Error Status structure, as described in Subsection \ref{subsection:genericerrorstatusstructure}.\\ 1614\hline 1615errorType.value & uint64 & The raw value of the error type for this bus error.\\ 1616errorType.name & string & The human readable name, if available, of the error type for this bus error.\\ 1617\hline 1618busID.busNumber & int & The bus number of this bus ID.\\ 1619busID.segmentNumber & int & The segment number of this bus ID.\\ 1620\hline 1621busAddress & uint64 & The memory or I/O address on the bus at the time of the error.\\ 1622\hline 1623busData & uint64 & Data on the bus at the time of the error.\\ 1624\hline 1625busCommandType & string & The type of command at the time of the error. Either "PCI" or "PCI-X".\\ 1626\hline 1627busRequestorID & uint64 & The PCI bus requestor ID for the error.\\ 1628\hline 1629busCompleterID & uint64 & The PCI bus completer ID for the error.\\ 1630\hline 1631targetID & uint64 & The PCI bus intended target ID for the error.\\ 1632\jsontableend{PCI/PCI-X Bus Error structure field table.} 1633 1634% PCI/PCI-X Bus error validation structure. 1635\subsection{PCI/PCI-X Bus Error Validation Structure} 1636\label{subsection:pcibuserrorvalidationstructure} 1637This structure describes which fields within a PCI/PCI-X Bus Error section (\ref{section:pcibuserrorsection}) are valid, using boolean fields. 1638\jsontable{table:pcibuserrorvalidationstructure} 1639errorStatusValid & boolean & Whether the "errorStatus" field of the PCI/PCI-X Bus Error section (\ref{section:pcibuserrorsection}) is valid.\\ 1640\hline 1641errorTypeValid & boolean & Whether the "errorType" field of the PCI/PCI-X Bus Error section (\ref{section:pcibuserrorsection}) is valid.\\ 1642\hline 1643busIDValid & boolean & Whether the "busID" field of the PCI/PCI-X Bus Error section (\ref{section:pcibuserrorsection}) is valid.\\ 1644\hline 1645busAddressValid & boolean & Whether the "busAddress" field of the PCI/PCI-X Bus Error section (\ref{section:pcibuserrorsection}) is valid.\\ 1646\hline 1647busDataValid & boolean & Whether the "busData" field of the PCI/PCI-X Bus Error section (\ref{section:pcibuserrorsection}) is valid.\\ 1648\hline 1649commandValid & boolean & Whether the "busCommandType" field of the PCI/PCI-X Bus Error section (\ref{section:pcibuserrorsection}) is valid.\\ 1650\hline 1651requestorIDValid & boolean & Whether the "busRequestorID" field of the PCI/PCI-X Bus Error section (\ref{section:pcibuserrorsection}) is valid.\\ 1652\hline 1653completerIDValid & boolean & Whether the "busCompleterID" field of the PCI/PCI-X Bus Error section (\ref{section:pcibuserrorsection}) is valid.\\ 1654\hline 1655targetIDValid & boolean & Whether the "targetID" field of the PCI/PCI-X Bus Error section (\ref{section:pcibuserrorsection}) is valid.\\ 1656\jsontableend{PCI/PCI-X Bus Error validation structure field table.} 1657 1658% PCI/PCI-X Component error section. 1659\section{PCI/PCI-X Component Error Section} 1660\label{section:pcicomponenterrorsection} 1661This section describes the JSON format for a single PCI/PCI-X Component Error Section from a CPER record. The GUID used for PCI/PCI-X Component Error Sections is \texttt{\{ 0xeb5e4685, 0xca66, 0x4769, \{ 0xb6, 0xa2, 0x26, 0x06, 0x8b, 0x00, 0x13, 0x26 \}\}}. 1662\jsontable{table:pcicomponenterrorsection} 1663validationBits & object & A PCI/PCI-X Component Error Validation structure, as defined in Subsection \ref{subsection:pcicomponenterrorvalidationstructure}.\\ 1664\hline 1665errorStatus & object & A CPER Generic Error Status structure, as described in Subsection \ref{subsection:genericerrorstatusstructure}.\\ 1666\hline 1667idInfo & object & A PCI/PCI-X Component ID structure, as defined in Subsection \ref{subsection:pcicomponentidstructure}.\\ 1668\hline 1669memoryNumber & uint64 & The number of PCI/PCI-X component memory mapped register address/data pair values are present in this structure.\\ 1670\hline 1671ioNumber & uint64 & The number of PCI/PCI-X component programmed I/O register address/data pair values are present in this structure.\\ 1672\hline 1673registerDataPairs & array & An array of PCI/PCI-X Component Register Pair structures, as defined in Subsection \ref{subsection:pcicomponentregisterpairstructure}. The length corresponds to the amounts listed in fields \texttt{memoryNumber} and \texttt{ioNumber}.\\ 1674\jsontableend{PCI/PCI-X Component Error structure field table.} 1675 1676% PCI/PCI-X Component error validation structure. 1677\subsection{PCI/PCI-X Component Error Validation Structure} 1678\label{subsection:pcicomponenterrorvalidationstructure} 1679This structure describes which fields within a PCI/PCI-X Component Error section (\ref{section:pcicomponenterrorsection}) are valid, using boolean fields. 1680\jsontable{table:pcicomponenterrorvalidationstructure} 1681errorStatusValid & boolean & Whether the "errorStatus" field of the PCI/PCI-X Component Error section (\ref{section:pcicomponenterrorsection}) is valid.\\ 1682\hline 1683idInfoValid & boolean & Whether the "idInfo" field of the PCI/PCI-X Component Error section (\ref{section:pcicomponenterrorsection}) is valid.\\ 1684\hline 1685memoryNumberValid & boolean & Whether the "memoryNumber" field of the PCI/PCI-X Component Error section (\ref{section:pcicomponenterrorsection}) is valid.\\ 1686\hline 1687ioNumberValid & boolean & Whether the "ioNumber" field of the PCI/PCI-X Component Error section (\ref{section:pcicomponenterrorsection}) is valid.\\ 1688\hline 1689registerDataPairsValid & boolean & Whether the "registerDataPairs" field of the PCI/PCI-X Component Error section (\ref{section:pcicomponenterrorsection}) is valid.\\ 1690\jsontableend{PCI/PCI-X Component Error validation structure field table.} 1691 1692% PCI/PCI-X Component ID structure. 1693\subsection{PCI/PCI-X Component ID Structure} 1694\label{subsection:pcicomponentidstructure} 1695This structure describes the ID of a single PCI/PCI-X component for use in a PCI/PCI-X Component Error section (\ref{section:pcicomponenterrorsection}). 1696\jsontable{table:pcicomponentidstructure} 1697vendorID & uint64 & The vendor ID of this PCI/PCI-X component.\\ 1698\hline 1699deviceID & uint64 & The device ID of this PCI/PCI-X component.\\ 1700\hline 1701classCode & uint64 & The class code of this PCI/PCI-X component.\\ 1702\hline 1703functionNumber & uint64 & The function number of this PCI/PCI-X component.\\ 1704\hline 1705deviceNumber & uint64 & The device number of this PCI/PCI-X component.\\ 1706\hline 1707busNumber & uint64 & The bus number of this PCI/PCI-X component.\\ 1708\hline 1709segmentNumber & uint64 & The segment number of this PCI/PCI-X component.\\ 1710\jsontableend{PCI/PCI-X Component ID structure field table.} 1711 1712% PCI/PCI-X Component Register Pair structure. 1713\subsection{PCI/PCI-X Component Register Pair Structure} 1714\label{subsection:pcicomponentregisterpairstructure} 1715This structure describes a single pair of registers from a PCI/PCI-X component for use in a PCI/PCI-X Component Error section (\ref{section:pcicomponenterrorsection}). The actual "pairs" of address and data aren't necessarily all 16 bytes allocated long, and there is no field to indicate their length, so do not assume that the address is in the first field and the data in the second. 1716\jsontable{table:pcicomponentregisterpairstructure} 1717firstHalf & uint64 & The first 8 bytes of the 16 byte register pair structure.\\ 1718\hline 1719secondHalf & uint64 & The second 8 bytes of the 16 byte register pair structure.\\ 1720\jsontableend{PCI/PCI-X Component Register Pair structure field table.} 1721 1722% Firmware error section. 1723\section{Firmware Error Section} 1724\label{section:firmwareerrorsection} 1725This section describes the JSON format for a single Firmware Error Section from a CPER record. The GUID used for Firmware Error Sections is \texttt{\{ 0x81212a96, 0x09ed, 0x4996, \{ 0x94, 0x71, 0x8d, 0x72, 0x9c, 0x8e, 0x69, 0xed \}\}}. 1726\jsontable{table:firmwareerrorsection} 1727errorRecordType.value & uint64 & The raw value of the type of firmware error record this is.\\ 1728errorRecordType.name & string & The human readable name, if available, of the type of firmware error record this is.\\ 1729\hline 1730revision & int & The header revision of this record. For the referenced UEFI specification, this value is 2.\\ 1731\hline 1732recordID & uint64 & Identifier for the referenced firmware error record. When the \texttt{revision} field is greater than 1 (which is expected here), this value will be null.\\ 1733\hline 1734recordIDGUID & string & GUID of the firmware error record referenced by this section. \textbf{This field is only valid when the \texttt{errorRecordType} field has a value of 2.} Otherwise, this field is ignored.\\ 1735\jsontableend{Firmware Error structure field table.} 1736 1737% Generic DMAr error section. 1738\section{Generic DMAr Error Section} 1739\label{section:dmargenericerrorsection} 1740This section describes the JSON format for a single Generic DMAr Error Section from a CPER record. The GUID used for Generic DMAr Error Sections is \texttt{\{ 0x5b51fef7, 0xc79d, 0x4434, \{ 0x8f, 0x1b, 0xaa, 0x62, 0xde, 0x3e, 0x2c, 0x64 \}\}}. 1741\jsontable{table:dmargenericerrorsection} 1742requesterID & int & The device ID associated with the fault condition.\\ 1743\hline 1744segmentNumber & int & The segment number associated with the device.\\ 1745\hline 1746faultReason.value & uint64 & The raw value of the reason for the fault.\\ 1747faultReason.name & string & The human readable name, if available, of the reason for the fault.\\ 1748faultReason.description & string (\textbf{optional}) & A human readable description, if available, of the reason for the fault.\\ 1749\hline 1750accessType.value & uint64 & The raw value of the access type that caused the fault.\\ 1751accessType.name & string & The human readable name, if available, of the access type that caused the fault.\\ 1752\hline 1753addressType.value & uint64 & The raw value of the addressing type that caused the fault.\\ 1754addressType.name & string & The human readable name, if available, of the addressing type that caused the fault.\\ 1755\hline 1756architectureType.value & uint64 & The raw value of the DMAr architecture type.\\ 1757architectureType.name & string & The human readable name, if available, of the DMAr architecture type.\\ 1758\hline 1759deviceAddress & uint64 & The 64-bit device virtual address contained in the faulted DMA request.\\ 1760\jsontableend{Generic DMAr Error structure field table.} 1761 1762% VT-d DMAr error section. 1763\section{VT-d DMAr Error Section} 1764\label{section:vtddmarerrorsection} 1765This section describes the JSON format for a single VT-d DMAr Error Section from a CPER record. The GUID used for VT-d DMAr Error Sections is \texttt{\{ 0x71761d37, 0x32b2, 0x45cd, \{ 0xa7, 0xd0, 0xb0, 0xfe, 0xdd, 0x93, 0xe8, 0xcf \}\}}. 1766\jsontable{table:vtddmarerrorsection} 1767version & int & Version register value as defined in the VT-d specification.\\ 1768\hline 1769revision & int & Revision field in VT-d specific DMA remapping reporting structure.\\ 1770\hline 1771oemID & uint64 & OEM ID field in VT-d specific DMA remapping reporting structure.\\ 1772\hline 1773capabilityRegister & uint64 & Value of VT-d capability register.\\ 1774\hline 1775extendedCapabilityRegister & uint64 & Value of VT-d extended capability register.\\ 1776\hline 1777globalCommandRegister & uint64 & Value of VT-d global command register.\\ 1778\hline 1779globalStatusRegister & uint64 & Value of VT-d global status register.\\ 1780\hline 1781faultStatusRegister & uint64 & Value of VT-d fault status register.\\ 1782\hline 1783faultRecord & object & A VT-d DMAR Fault Record structure, as defined in Subsection \ref{subsection:vtddmarfaultrecordstructure}.\\ 1784\hline 1785rootEntry & string & A base64-represented binary dump of the root entry table for the associated requester ID.\\ 1786\hline 1787contextEntry & string & A base64-represented binary dump of the context entry table for the associated requester ID.\\ 1788\hline 1789pageTableEntry\_Level6 & uint64 & The page table entry for the device virtual address in page level 6.\\ 1790\hline 1791pageTableEntry\_Level5 & uint64 & The page table entry for the device virtual address in page level 5.\\ 1792\hline 1793pageTableEntry\_Level4 & uint64 & The page table entry for the device virtual address in page level 4.\\ 1794\hline 1795pageTableEntry\_Level3 & uint64 & The page table entry for the device virtual address in page level 3.\\ 1796\hline 1797pageTableEntry\_Level2 & uint64 & The page table entry for the device virtual address in page level 2.\\ 1798\hline 1799pageTableEntry\_Level1 & uint64 & The page table entry for the device virtual address in page level 1.\\ 1800\jsontableend{VT-d DMAr Error structure field table.} 1801 1802% VT-d DMAR Fault Record structure. 1803\subsection{VT-d DMAR Fault Record Structure} 1804\label{subsection:vtddmarfaultrecordstructure} 1805This structure describes a fault record, which forms part of a single VT-d DMAr Error section (\ref{section:vtddmarerrorsection}). 1806\jsontable{table:vtddmarfaultrecordstructure} 1807faultInformation & uint64 & Fault information field as defined in the VT-d specification.\\ 1808\hline 1809sourceIdentifier & uint64 & Identifier of the source of the VT-d fault.\\ 1810\hline 1811privelegeModeRequested & boolean & Whether privelege mode was requested.\\ 1812\hline 1813executePermissionRequested & boolean & Whether execute permission was requested.\\ 1814\hline 1815pasidPresent & boolean & Whether the "pasidValue" field contains valid data.\\ 1816\hline 1817faultReason & uint64 & The reason for the VT-d fault, as defined in the VT-d specification.\\ 1818\hline 1819pasidValue & uint64 & The PASID associated with the fault.\\ 1820\hline 1821addressType & uint64 & The addressing type of the fault, as defined by the VT-d specification.\\ 1822\hline 1823type.value & uint64 & The raw value of the type of VT-d fault record.\\ 1824type.name & string & The human readable name, if available, of the type of VT-d fault record.\\ 1825\jsontableend{VT-d DMAR Fault Record structure field table.} 1826 1827% IOMMU DMAr error section. 1828\section{IOMMU DMAr Error Section} 1829\label{section:iommudmarerrorsection} 1830This section describes the JSON format for a single IOMMU DMAr Error Section from a CPER record. The GUID used for IOMMU DMAr Error Sections is \texttt{\{ 0x036f84e1, 0x7f37, 0x428c, \{ 0xa7, 0x9e, 0x57, 0x5f, 0xdf, 0xaa, 0x84, 0xec \}\}}. 1831\jsontable{table:iommudmarerrorsection} 1832revision & int & The IOMMU specification revision.\\ 1833\hline 1834controlRegister & uint64 & The IOMMU control register value.\\ 1835\hline 1836statusRegister & uint64 & The IOMMU status register value.\\ 1837\hline 1838eventLogEntry & string & A base-64 binary dump of the IOMMU fault-related event log entry, as defined in the IOMMU specification.\\ 1839\hline 1840deviceTableEntry & string & A base-64 representation of the value from the device table for a given requester ID.\\ 1841\hline 1842pageTableEntry\_Level6 & uint64 & Page table entry for device virtual address in page level 6.\\ 1843\hline 1844pageTableEntry\_Level5 & uint64 & Page table entry for device virtual address in page level 5.\\ 1845\hline 1846pageTableEntry\_Level4 & uint64 & Page table entry for device virtual address in page level 4.\\ 1847\hline 1848pageTableEntry\_Level3 & uint64 & Page table entry for device virtual address in page level 3.\\ 1849\hline 1850pageTableEntry\_Level2 & uint64 & Page table entry for device virtual address in page level 2.\\ 1851\hline 1852pageTableEntry\_Level1 & uint64 & Page table entry for device virtual address in page level 1.\\ 1853\jsontableend{IOMMU DMAr Error structure field table.} 1854 1855% CCIX PER error section. 1856\section{CCIX PER Error Section} 1857\label{section:ccixpererrorsection} 1858This section describes the JSON format for a single CCIX PER Error Section from a CPER record. The GUID used for CCIX PER Error Sections is \texttt{\{ 0x91335EF6, 0xEBFB, 0x4478, \{0xA6, 0xA6, 0x88, 0xB7, 0x28, 0xCF, 0x75, 0xD7 \}\}}. 1859\jsontable{table:ccixpererrorsection} 1860length & uint64 & The length (in bytes) of the entire structure.\\ 1861\hline 1862validationBits & object & A CCIX PER Validation structure as described in Subsection \ref{subsection:ccixpervalidationstructure}.\\ 1863\hline 1864ccixSourceID & int & If the agent is an HA, SA, or RA, this indicates the CCIX Agent ID of the reporting component. Otherwise, this is the CCIX Device ID.\\ 1865\hline 1866ccixPortID & int & The CCIX Port ID that reported this error.\\ 1867\hline 1868ccixPERLog & string & A base64-represented binary dump of the CCIX PER Log structure, as defined in Section 7.3.2 of the CCIX Base Specification (Rev. 1.0).\\ 1869\jsontableend{CCIX PER Error structure field table.} 1870 1871% CCIX PER Validation structure. 1872\subsection{CCIX PER Validation Structure} 1873\label{subsection:ccixpervalidationstructure} 1874This structure describes which fields are valid in a CCIX PER Error section (\ref{section:ccixpererrorsection}) using boolean fields. 1875\jsontable{table:ccixpervalidationstructure} 1876ccixSourceIDValid & boolean & Whether the "ccixSourceID" field in the CCIX PER Error Section (\ref{section:ccixpererrorsection}) is valid.\\ 1877\hline 1878ccixPortIDValid & boolean & Whether the "ccixPortID" field in the CCIX PER Error Section (\ref{section:ccixpererrorsection}) is valid.\\ 1879\hline 1880ccixPERLogValid & boolean & Whether the "ccixPERLog" field in the CCIX PER Error Section (\ref{section:ccixpererrorsection}) is valid.\\ 1881\jsontableend{CCIX PER validation structure field table.} 1882 1883% CXL Protocol error section. 1884\section{CXL Protocol Error Section} 1885\label{section:cxlprotocolerrorsection} 1886This section describes the JSON format for a single CXL Protocol Error Section from a CPER record. The GUID used for CXL Protocol Error Sections is \texttt{\{ 0x80B9EFB4, 0x52B5, 0x4DE3, \{ 0xA7, 0x77, 0x68, 0x78, 0x4B, 0x77, 0x10, 0x48 \}\}}. 1887\jsontable{table:cxlprotocolerrorsection} 1888validationBits & object & A CXL Protocol Validation structure as defined in Subsection \ref{subsection:cxlprotocolvalidationstructure}.\\ 1889\hline 1890agentType.value & uint64 & The raw value of the detecting CXL agent type.\\ 1891agentType.name & string & The human readable name, if available, of the CXL agent type.\\ 1892\hline 1893cxlAgentAddress & object & One of the structures described in Subsection \ref{subsection:cxlprotocoldeviceagentaddressstructure} or Subsection \ref{subsection:cxlprotocolrcrbaddressstructure}. Included structure is dependent on the \texttt{agentType.value} field.\\ 1894\hline 1895deviceID & object & A CXL Device ID structure, as defined in Subsection \ref{subsection:cxlprotocoldeviceidstructure}.\\ 1896\hline 1897deviceSerial & uint64 (\textbf{optional}) & The CXL device serial number. Only included if the detecting device is a CXL device (field \texttt{agentType.value} has value 0).\\ 1898\hline 1899capabilityStructure & string (\textbf{optional}) & A base64-encoded binary dump of the CXL device's PCIe capability structure. This could either be a PCIe 1.1 Capability Structure (36-byte, padded to 60 bytes), or a PCIe 2.0 Capability Structure (60-byte). Only included if the detecting device is a CXL device (field \texttt{agentType.value} has value 0).\\ 1900\hline 1901dvsecLength & int & Length (in bytes) of the CXL DVSEC structure.\\ 1902\hline 1903errorLogLength & int & Length (in bytes) of the CXL Error Log structure.\\ 1904\hline 1905cxlDVSEC & string & A base64-encoded dump of the CXL DVSEC structure. For CXL 1.1 devices, this is a "CXL DVSEC For Flex Bus Devices" structure as defined in the CXL 1.1 specification. For CXL 1.1 host downstream ports, this is the "CXL DVSEC For Flex Bus Port" structure as defined in the CXL 1.1 specification.\\ 1906\hline 1907cxlErrorLog & string & A base64-encoded dump of the CXL error log. This field contains a copy of "CXL RAS Capability Structure", as defined in the CXL 1.1 specification.\\ 1908\jsontableend{CXL Protocol Error structure field table.} 1909 1910% CXL Protocol Validation structure. 1911\subsection{CXL Protocol Validation Structure} 1912\label{subsection:cxlprotocolvalidationstructure} 1913This structure describes which fields are valid in a CXL Protocol Error section (\ref{section:cxlprotocolerrorsection}) using boolean fields. 1914\jsontable{table:cxlprotocolvalidationstructure} 1915cxlAgentTypeValid & boolean & Whether the "cxlAgentType" field in the CXL Protocol Error section (\ref{section:cxlprotocolerrorsection}) is valid.\\ 1916\hline 1917cxlAgentAddressValid & boolean & Whether the "cxlAgentAddress" field in the CXL Protocol Error section (\ref{section:cxlprotocolerrorsection}) is valid.\\ 1918\hline 1919deviceIDValid & boolean & Whether the "deviceID" field in the CXL Protocol Error section (\ref{section:cxlprotocolerrorsection}) is valid.\\ 1920\hline 1921deviceSerialValid & boolean & Whether the "deviceSerial" field in the CXL Protocol Error section (\ref{section:cxlprotocolerrorsection}) is valid.\\ 1922\hline 1923capabiltyStructureValid & boolean & Whether the "capabilityStructure" field in the CXL Protocol Error section (\ref{section:cxlprotocolerrorsection}) is valid.\\ 1924\hline 1925cxlDVSECValid & boolean & Whether the "cxlDVSEC" field in the CXL Protocol Error section (\ref{section:cxlprotocolerrorsection}) is valid.\\ 1926\hline 1927cxlErrorLogValid & boolean & Whether the "cxlErrorLog" field in the CXL Protocol Error section (\ref{section:cxlprotocolerrorsection}) is valid.\\ 1928\jsontableend{CXL Protocol validation structure field table.} 1929 1930% CXL Protocol Device Agent Address structure. 1931\subsection{CXL Protocol Device Agent Address Structure} 1932\label{subsection:cxlprotocoldeviceagentaddressstructure} 1933This structure describes the address of a single CXL device agent, for use in a CXL Protocol Error section (\ref{section:cxlprotocolerrorsection}). Included when the \texttt{agentType.value} field has the value "0". 1934\jsontable{table:cxlprotocoldeviceagentaddressstructure} 1935functionNumber & uint64 & The function number of the CXL device.\\ 1936\hline 1937deviceNumber & uint64 & The device number of the CXL device.\\ 1938\hline 1939busNumber & uint64 & The bus number of the CXL device.\\ 1940\hline 1941segmentNumber & uint64 & The segment number of the CXL device.\\ 1942\jsontableend{CXL Protocol Device Agent Address structure field table.} 1943 1944% CXL Protocol RCRB Base Address structure. 1945\subsection{CXL Protocol RCRB Base Address Structure} 1946\label{subsection:cxlprotocolrcrbaddressstructure} 1947This structure describes an RCRB base address, for use in a CXL Protocol Error section (\ref{section:cxlprotocolerrorsection}). Included when the \texttt{agentType.value} field has the value "1". 1948\jsontable{table:cxlprotocolrcrbaddressstructure} 1949value & uint64 & The CXL port RCRB base address.\\ 1950\jsontableend{CXL Protocol RCRB Base Address structure field table.} 1951 1952% CXL Protocol Device ID structure. 1953\subsection{CXL Protocol Device ID Structure} 1954\label{subsection:cxlprotocoldeviceidstructure} 1955This structure describes the ID of a CXL device, for use in a CXL Protocol Error section (\ref{section:cxlprotocolerrorsection}). 1956\jsontable{table:cxlprotocoldeviceidstructure} 1957vendorID & uint64 & The vendor ID of the CXL device.\\ 1958\hline 1959deviceID & uint64 & The device ID of the CXL device.\\ 1960\hline 1961subsystemVendorID & uint64 & The subsystem vendor ID of the CXL device.\\ 1962\hline 1963subsystemDeviceID & uint64 & The subsystem device ID of the CXL device.\\ 1964\hline 1965classCode & uint64 & The class code of the CXL device.\\ 1966\hline 1967slotNumber & uint64 & The slot number of the CXL device.\\ 1968\jsontableend{CXL Protocol Device ID structure field table.} 1969 1970% CXL Component error section. 1971\section{CXL Component Error Section} 1972\label{section:cxlcomponenterrorsection} 1973This section describes the JSON format for a single CXL Component Error Section from a CPER record. There are several GUIDs used for CXL Component Error Sections, of which defined are:\\ 1974\begin{itemize} 1975 \item CXL General Media Error (\texttt{\{ 0xfbcd0a77, 0xc260, 0x417f, \{ 0x85, 0xa9, 0x08, 0x8b, 0x16, 0x21, 0xeb, 0xa6 \}\}})\\ 1976 \item CXL DRAM Event Error (\texttt{\{ 0x601dcbb3, 0x9c06, 0x4eab, \{ 0xb8, 0xaf, 0x4e, 0x9b, 0xfb, 0x5c, 0x96, 0x24 \}\}})\\ 1977 \item CXL Memory Module Error (\texttt{\{ 0xfe927475, 0xdd59, 0x4339, \{ 0xa5, 0x86, 0x79, 0xba, 0xb1, 0x13, 0xb7, 0x74 \}\}})\\ 1978 \item CXL Physical Switch Error (\texttt{\{ 0x77cf9271, 0x9c02, 0x470b, \{ 0x9f, 0xe4, 0xbc, 0x7b, 0x75, 0xf2, 0xda, 0x97 \}\}})\\ 1979 \item CXL Virtual Switch Error (\texttt{\{ 0x40d26425, 0x3396, 0x4c4d, \{ 0xa5, 0xda, 0x3d, 0x47, 0x26, 0x3a, 0xf4, 0x25 \}\}})\\ 1980 \item CXL MLD Port Error (\texttt{\{ 0x8dc44363, 0x0c96, 0x4710, \{ 0xb7, 0xbf, 0x04, 0xbb, 0x99, 0x53, 0x4c, 0x3f \}\}})\\ 1981\end{itemize} 1982\jsontable{table:cxlcomponenterrorsection} 1983length & uint64 & The length in bytes for the entire structure.\\ 1984\hline 1985validationBits & object & A CXL Component Validation structure as described in Subsection \ref{subsection:cxlcomponentvalidationstructure}.\\ 1986\hline 1987deviceID & object & A CXL Component Device ID structure as described in Subsection \ref{subsection:cxlcomponentdeviceidstructure}.\\ 1988\hline 1989deviceSerial & uint64 & The serial of the CXL component.\\ 1990\hline 1991cxlComponentEventLog.data & string (\textbf{optional}) & If a CXL component event log is attached (\texttt{validationBits.cxlComponentEventLogValid} is true), this is a base64-represented binary dump of the CXL Component Event Log as described within CXL Specification Section 8.2.9.1.\\ 1992\jsontableend{CXL Component Error structure field table.} 1993 1994% CXL Component Validation structure. 1995\subsection{CXL Component Validation Structure} 1996\label{subsection:cxlcomponentvalidationstructure} 1997This structure describes which fields are valid in a CXL Component Error section (\ref{section:cxlcomponenterrorsection}) using boolean fields. 1998\jsontable{table:cxlcomponentvalidationstructure} 1999deviceIDValid & boolean & Whether the "deviceID" field of the CXL Component Error section (\ref{section:cxlcomponenterrorsection}) is valid.\\ 2000\hline 2001deviceSerialValid & boolean & Whether the "deviceSerial" field of the CXL Component Error section (\ref{section:cxlcomponenterrorsection}) is valid.\\ 2002\hline 2003cxlComponentEventLogValid & boolean & Whether the "cxlComponentEventLog" field of the CXL Component Error section (\ref{section:cxlcomponenterrorsection}) is valid.\\ 2004\jsontableend{CXL Component validation structure field table.} 2005 2006% CXL Component Device ID structure. 2007\subsection{CXL Component Device ID Structure} 2008\label{subsection:cxlcomponentdeviceidstructure} 2009This structure describes the ID of a CXL component, for use in a CXL Component Error section (\ref{section:cxlcomponenterrorsection}). 2010\jsontable{table:cxlcomponentdeviceidstructure} 2011vendorID & uint64 & The vendor ID of the CXL component.\\ 2012\hline 2013deviceID & uint64 & The device ID of the CXL component.\\ 2014\hline 2015functionNumber & uint64 & The function number of the CXL component.\\ 2016\hline 2017deviceNumber & uint64 & The device number of the CXL component.\\ 2018\hline 2019busNumber & uint64 & The bus of the CXL component.\\ 2020\hline 2021segmentNumber & uint64 & The segment of the CXL component.\\ 2022\hline 2023slotNumber & uint64 & The slot number of the CXL component.\\ 2024\jsontableend{CXL Component Device ID structure field table.} 2025 2026% Undefined error section. 2027\section{Undefined Error Section} 2028\label{section:undefinederrorsection} 2029This section describes the JSON format for a single undefined CPER section. This structure is used for all CPER sections that have \texttt{errorType} GUIDs which are not defined in UEFI Appendix N. 2030\jsontable{table:ccixpererrorsection} 2031data & string & A base64-encoded binary dump of the undefined CPER section.\\ 2032\jsontableend{Undefined Error structure field table.} 2033 2034\end{document}