3 Copyright (c) 2006, Intel Corporation
4 All rights reserved. This program and the accompanying materials
5 are licensed and made available under the terms and conditions of the BSD License
6 which accompanies this distribution. The full text of the license may be found at
7 http://opensource.org/licenses/bsd-license.php
9 THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
10 WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
18 Pei Core Load Image Support
26 IN EFI_PEI_SERVICES
**PeiServices
,
27 IN EFI_FFS_FILE_HEADER
*PeimFileHeader
,
34 Routine for loading file image.
38 PeiServices - The PEI core services table.
39 PeimFileHeader - Pointer to the FFS file header of the image.
40 EntryPoint - Pointer to entry point of specified image file for output.
44 Status - EFI_SUCCESS - Image is successfully loaded.
45 EFI_NOT_FOUND - Fail to locate necessary PPI
46 Others - Fail to load file.
52 EFI_PEI_FV_FILE_LOADER_PPI
*FvLoadFilePpi
;
53 EFI_PHYSICAL_ADDRESS ImageAddress
;
55 EFI_PHYSICAL_ADDRESS ImageEntryPoint
;
56 EFI_TE_IMAGE_HEADER
*TEImageHeader
;
62 // Try to find a PE32 section.
64 Status
= PeiCoreFfsFindSectionData (
70 // If we didn't find a PE32 section, try to find a TE section.
72 if (EFI_ERROR (Status
)) {
73 Status
= PeiCoreFfsFindSectionData (
76 (VOID
**) &TEImageHeader
78 if (EFI_ERROR (Status
) || TEImageHeader
== NULL
) {
80 // There was not a PE32 or a TE section, so assume that it's a Compressed section
81 // and use the LoadFile
83 Status
= PeiCoreLocatePpi (
84 &gEfiPeiFvFileLoaderPpiGuid
,
87 (VOID
**)&FvLoadFilePpi
89 if (EFI_ERROR (Status
)) {
93 Status
= FvLoadFilePpi
->FvLoadFile (
101 if (EFI_ERROR (Status
)) {
102 return EFI_NOT_FOUND
;
106 // Retrieve the entry point from the PE/COFF image header
108 Status
= PeCoffLoaderGetEntryPoint ((VOID
*)(UINTN
)ImageAddress
, EntryPoint
);
109 if (EFI_ERROR (Status
)) {
110 return EFI_NOT_FOUND
;
114 // Retrieve the entry point from the TE image header
116 ImageAddress
= (EFI_PHYSICAL_ADDRESS
) (UINTN
) TEImageHeader
;
117 *EntryPoint
= (VOID
*)((UINTN
) TEImageHeader
+ sizeof (EFI_TE_IMAGE_HEADER
) +
118 TEImageHeader
->AddressOfEntryPoint
- TEImageHeader
->StrippedSize
);
122 // Retrieve the entry point from the PE/COFF image header
124 ImageAddress
= (EFI_PHYSICAL_ADDRESS
) (UINTN
) Pe32Data
;
125 Status
= PeCoffLoaderGetEntryPoint (Pe32Data
, EntryPoint
);
126 if (EFI_ERROR (Status
)) {
127 return EFI_NOT_FOUND
;
132 // Print debug message: Loading PEIM at 0x12345678 EntryPoint=0x12345688 Driver.efi
134 DEBUG ((EFI_D_INFO
| EFI_D_LOAD
, "Loading PEIM at 0x%08x EntryPoint=0x%08x ", Pe32Data
, *EntryPoint
));
136 EFI_IMAGE_DATA_DIRECTORY
* DirectoryEntry
;
137 EFI_IMAGE_DEBUG_DIRECTORY_ENTRY
* DebugEntry
;
141 BOOLEAN FileNameFound
;
143 CHAR8 AsciiBuffer
[512];
144 VOID
*CodeViewEntryPointer
;
146 EFI_IMAGE_DOS_HEADER
*DosHeader
;
147 EFI_IMAGE_NT_HEADERS
*PeHeader
;
150 // Pe32Data is NULL when load TE image
153 if (TEImageHeader
== NULL
) {
154 DosHeader
= (EFI_IMAGE_DOS_HEADER
*)Pe32Data
;
155 if (DosHeader
->e_magic
== EFI_IMAGE_DOS_SIGNATURE
) {
157 // DOS image header is present, so read the PE header after the DOS image header
159 PeHeader
= (EFI_IMAGE_NT_HEADERS
*) ((UINTN
) Pe32Data
+ (UINTN
) ((DosHeader
->e_lfanew
) & 0x0ffff));
162 // DOS image header is not present, so PE header is at the image base
164 PeHeader
= (EFI_IMAGE_NT_HEADERS
*) Pe32Data
;
169 // Find the codeview info in the image and display the file name
172 // Per the PE/COFF spec, you can't assume that a given data directory
173 // is present in the image. You have to check the NumberOfRvaAndSizes in
174 // the optional header to verify a desired directory entry is there.
177 DirectoryEntry
= NULL
;
179 if (TEImageHeader
== NULL
) {
180 if (PeHeader
->OptionalHeader
.NumberOfRvaAndSizes
> EFI_IMAGE_DIRECTORY_ENTRY_DEBUG
) {
181 DirectoryEntry
= (EFI_IMAGE_DATA_DIRECTORY
*) &(PeHeader
->OptionalHeader
.DataDirectory
[EFI_IMAGE_DIRECTORY_ENTRY_DEBUG
]);
182 DebugEntry
= (EFI_IMAGE_DEBUG_DIRECTORY_ENTRY
*) ((UINTN
) ImageAddress
+ DirectoryEntry
->VirtualAddress
);
185 if (TEImageHeader
->DataDirectory
[EFI_TE_IMAGE_DIRECTORY_ENTRY_DEBUG
].VirtualAddress
!= 0) {
186 DirectoryEntry
= &TEImageHeader
->DataDirectory
[EFI_TE_IMAGE_DIRECTORY_ENTRY_DEBUG
];
187 TEImageAdjust
= sizeof (EFI_TE_IMAGE_HEADER
) - TEImageHeader
->StrippedSize
;
188 DebugEntry
= (EFI_IMAGE_DEBUG_DIRECTORY_ENTRY
*)((UINTN
) TEImageHeader
+
189 TEImageHeader
->DataDirectory
[EFI_TE_IMAGE_DIRECTORY_ENTRY_DEBUG
].VirtualAddress
+
194 if (DebugEntry
!= NULL
&& DirectoryEntry
!= NULL
) {
195 for (DirCount
= 0; DirCount
< DirectoryEntry
->Size
; DirCount
++, DebugEntry
++) {
196 if (DebugEntry
->Type
== EFI_IMAGE_DEBUG_TYPE_CODEVIEW
) {
197 if (DebugEntry
->SizeOfData
> 0) {
198 CodeViewEntryPointer
= (VOID
*) ((UINTN
) DebugEntry
->RVA
+ (UINTN
) ImageAddress
+ (UINTN
)TEImageAdjust
);
199 switch (* (UINT32
*) CodeViewEntryPointer
) {
200 case CODEVIEW_SIGNATURE_NB10
:
201 AsciiString
= (CHAR8
*) CodeViewEntryPointer
+ sizeof (EFI_IMAGE_DEBUG_CODEVIEW_NB10_ENTRY
);
204 case CODEVIEW_SIGNATURE_RSDS
:
205 AsciiString
= (CHAR8
*) CodeViewEntryPointer
+ sizeof (EFI_IMAGE_DEBUG_CODEVIEW_RSDS_ENTRY
);
212 if (AsciiString
!= NULL
) {
213 FileNameFound
= FALSE
;
214 for (Index
= 0, Index1
= 0; AsciiString
[Index
] != 0; Index
++) {
215 if (AsciiString
[Index
] == '\\') {
217 FileNameFound
= TRUE
;
222 for (Index
= Index1
+ 1; AsciiString
[Index
] != '.'; Index
++) {
223 AsciiBuffer
[Index
- (Index1
+ 1)] = AsciiString
[Index
];
225 AsciiBuffer
[Index
- (Index1
+ 1)] = 0;
226 DEBUG ((EFI_D_INFO
| EFI_D_LOAD
, "%a.efi", AsciiBuffer
));
236 DEBUG ((EFI_D_INFO
| EFI_D_LOAD
, "\n"));