2 CPU Exception Handler Library common functions.
4 Copyright (c) 2012 - 2016, Intel Corporation. All rights reserved.<BR>
5 This program and the accompanying materials
6 are licensed and made available under the terms and conditions of the BSD License
7 which accompanies this distribution. The full text of the license may be found at
8 http://opensource.org/licenses/bsd-license.php
10 THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
11 WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
15 #include "CpuExceptionCommon.h"
18 // Error code flag indicating whether or not an error code will be
19 // pushed on the stack if an exception occurs.
21 // 1 means an error code will be pushed, otherwise 0
23 CONST UINT32 mErrorCodeFlag
= 0x00027d00;
26 // Define the maximum message length
28 #define MAX_DEBUG_MESSAGE_LENGTH 0x100
30 CONST CHAR8 mExceptionReservedStr
[] = "Reserved";
31 CONST CHAR8
*mExceptionNameStr
[] = {
37 "#BR - BOUND Range Exceeded",
38 "#UD - Invalid Opcode",
39 "#NM - Device Not Available",
41 "Coprocessor Segment Overrun",
43 "#NP - Segment Not Present",
44 "#SS - Stack Fault Fault",
45 "#GP - General Protection",
48 "#MF - x87 FPU Floating-Point Error",
49 "#AC - Alignment Check",
50 "#MC - Machine-Check",
51 "#XM - SIMD floating-point",
52 "#VE - Virtualization"
55 #define EXCEPTION_KNOWN_NAME_NUM (sizeof (mExceptionNameStr) / sizeof (CHAR8 *))
58 Get ASCII format string exception name by exception type.
60 @param ExceptionType Exception type.
62 @return ASCII format string exception name.
66 IN EFI_EXCEPTION_TYPE ExceptionType
69 if ((UINTN
) ExceptionType
< EXCEPTION_KNOWN_NAME_NUM
) {
70 return mExceptionNameStr
[ExceptionType
];
72 return mExceptionReservedStr
;
77 Prints a message to the serial port.
79 @param Format Format string for the message to print.
80 @param ... Variable argument list whose contents are accessed
81 based on the format string specified by Format.
86 InternalPrintMessage (
87 IN CONST CHAR8
*Format
,
91 CHAR8 Buffer
[MAX_DEBUG_MESSAGE_LENGTH
];
95 // Convert the message to an ASCII String
97 VA_START (Marker
, Format
);
98 AsciiVSPrint (Buffer
, sizeof (Buffer
), Format
, Marker
);
102 // Send the print string to a Serial Port
104 SerialPortWrite ((UINT8
*)Buffer
, AsciiStrLen (Buffer
));
108 Find and display image base address and return image base and its entry point.
110 @param CurrentEip Current instruction pointer.
111 @param EntryPoint Return module entry point if module header is found.
113 @return !0 Image base address.
114 @return 0 Image header cannot be found.
117 FindModuleImageBase (
119 OUT UINTN
*EntryPoint
123 EFI_IMAGE_DOS_HEADER
*DosHdr
;
124 EFI_IMAGE_OPTIONAL_HEADER_PTR_UNION Hdr
;
130 Pe32Data
= CurrentEip
& ~(mImageAlignSize
- 1);
131 while (Pe32Data
!= 0) {
132 DosHdr
= (EFI_IMAGE_DOS_HEADER
*) Pe32Data
;
133 if (DosHdr
->e_magic
== EFI_IMAGE_DOS_SIGNATURE
) {
135 // DOS image header is present, so read the PE header after the DOS image header.
137 Hdr
.Pe32
= (EFI_IMAGE_NT_HEADERS32
*)(Pe32Data
+ (UINTN
) ((DosHdr
->e_lfanew
) & 0x0ffff));
139 // Make sure PE header address does not overflow and is less than the initial address.
141 if (((UINTN
)Hdr
.Pe32
> Pe32Data
) && ((UINTN
)Hdr
.Pe32
< CurrentEip
)) {
142 if (Hdr
.Pe32
->Signature
== EFI_IMAGE_NT_SIGNATURE
) {
146 InternalPrintMessage ("!!!! Find PE image ");
147 *EntryPoint
= (UINTN
)Pe32Data
+ (UINTN
)(Hdr
.Pe32
->OptionalHeader
.AddressOfEntryPoint
& 0x0ffffffff);
153 // DOS image header is not present, TE header is at the image base.
155 Hdr
.Pe32
= (EFI_IMAGE_NT_HEADERS32
*)Pe32Data
;
156 if ((Hdr
.Te
->Signature
== EFI_TE_IMAGE_HEADER_SIGNATURE
) &&
157 ((Hdr
.Te
->Machine
== IMAGE_FILE_MACHINE_I386
) || Hdr
.Te
->Machine
== IMAGE_FILE_MACHINE_X64
)) {
159 // It's TE image, it TE header and Machine type match
161 InternalPrintMessage ("!!!! Find TE image ");
162 *EntryPoint
= (UINTN
)Pe32Data
+ (UINTN
)(Hdr
.Te
->AddressOfEntryPoint
& 0x0ffffffff) + sizeof(EFI_TE_IMAGE_HEADER
) - Hdr
.Te
->StrippedSize
;
168 // Not found the image base, check the previous aligned address
170 Pe32Data
-= mImageAlignSize
;
174 PdbPointer
= PeCoffLoaderGetPdbPointer ((VOID
*) Pe32Data
);
175 if (PdbPointer
!= NULL
) {
176 InternalPrintMessage ("%a", PdbPointer
);
178 InternalPrintMessage ("(No PDB) " );
181 InternalPrintMessage ("!!!! Can't find image information. !!!!\n");
188 Read and save reserved vector information
190 @param[in] VectorInfo Pointer to reserved vector list.
191 @param[out] ReservedVector Pointer to reserved vector data buffer.
192 @param[in] VectorCount Vector number to be updated.
194 @return EFI_SUCCESS Read and save vector info successfully.
195 @retval EFI_INVALID_PARAMETER VectorInfo includes the invalid content if VectorInfo is not NULL.
199 ReadAndVerifyVectorInfo (
200 IN EFI_VECTOR_HANDOFF_INFO
*VectorInfo
,
201 OUT RESERVED_VECTORS_DATA
*ReservedVector
,
205 while (VectorInfo
->Attribute
!= EFI_VECTOR_HANDOFF_LAST_ENTRY
) {
206 if (VectorInfo
->Attribute
> EFI_VECTOR_HANDOFF_HOOK_AFTER
) {
208 // If vector attrubute is invalid
210 return EFI_INVALID_PARAMETER
;
212 if (VectorInfo
->VectorNumber
< VectorCount
) {
213 ReservedVector
[VectorInfo
->VectorNumber
].Attribute
= VectorInfo
->Attribute
;