]> git.proxmox.com Git - mirror_edk2.git/blame - MdeModulePkg/Core/Dxe/DxeMain/DxeMain.c
projects / mirror_edk2.git / blame
? search:
summary | shortlog | log | commit | commitdiff | tree
blob | blame (incremental) | history | HEAD
TempRam Done PPI definition in PI1.2.1
[mirror_edk2.git] / MdeModulePkg / Core / Dxe / DxeMain / DxeMain.c
CommitLineData
31f228cf 1/** @file\r
2 DXE Core Main Entry Point\r
3\r
1e172d6b 4Copyright (c) 2006 - 2012, Intel Corporation. All rights reserved.<BR>\r
cd5ebaa0 5This program and the accompanying materials\r
31f228cf 6are licensed and made available under the terms and conditions of the BSD License\r
7which accompanies this distribution. The full text of the license may be found at\r
8http://opensource.org/licenses/bsd-license.php\r
9\r
10THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,\r
11WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.\r
12\r
13**/\r
14\r
15#include "DxeMain.h"\r
16\r
17//\r
18// DXE Core Global Variables for Protocols from PEI\r
19//\r
20EFI_HANDLE mDecompressHandle = NULL;\r
21\r
22//\r
23// DXE Core globals for Architecture Protocols\r
24//\r
25EFI_SECURITY_ARCH_PROTOCOL *gSecurity = NULL;\r
bc2dfdbc 26EFI_SECURITY2_ARCH_PROTOCOL *gSecurity2 = NULL;\r
31f228cf 27EFI_CPU_ARCH_PROTOCOL *gCpu = NULL;\r
28EFI_METRONOME_ARCH_PROTOCOL *gMetronome = NULL;\r
29EFI_TIMER_ARCH_PROTOCOL *gTimer = NULL;\r
30EFI_BDS_ARCH_PROTOCOL *gBds = NULL;\r
31EFI_WATCHDOG_TIMER_ARCH_PROTOCOL *gWatchdogTimer = NULL;\r
32\r
0803854b 33//\r
34// DXE Core globals for optional protocol dependencies\r
35//\r
36EFI_SMM_BASE2_PROTOCOL *gSmmBase2 = NULL;\r
37\r
31f228cf 38//\r
39// DXE Core Global used to update core loaded image protocol handle\r
40//\r
41EFI_GUID *gDxeCoreFileName;\r
42EFI_LOADED_IMAGE_PROTOCOL *gDxeCoreLoadedImage;\r
43\r
44//\r
45// DXE Core Module Variables\r
46//\r
47EFI_BOOT_SERVICES mBootServices = {\r
48 {\r
49 EFI_BOOT_SERVICES_SIGNATURE, // Signature\r
50 EFI_BOOT_SERVICES_REVISION, // Revision\r
51 sizeof (EFI_BOOT_SERVICES), // HeaderSize\r
52 0, // CRC32\r
53 0 // Reserved\r
54 },\r
55 (EFI_RAISE_TPL) CoreRaiseTpl, // RaiseTPL\r
56 (EFI_RESTORE_TPL) CoreRestoreTpl, // RestoreTPL\r
57 (EFI_ALLOCATE_PAGES) CoreAllocatePages, // AllocatePages\r
58 (EFI_FREE_PAGES) CoreFreePages, // FreePages\r
59 (EFI_GET_MEMORY_MAP) CoreGetMemoryMap, // GetMemoryMap\r
60 (EFI_ALLOCATE_POOL) CoreAllocatePool, // AllocatePool\r
61 (EFI_FREE_POOL) CoreFreePool, // FreePool\r
62 (EFI_CREATE_EVENT) CoreCreateEvent, // CreateEvent\r
63 (EFI_SET_TIMER) CoreSetTimer, // SetTimer\r
64 (EFI_WAIT_FOR_EVENT) CoreWaitForEvent, // WaitForEvent\r
65 (EFI_SIGNAL_EVENT) CoreSignalEvent, // SignalEvent\r
66 (EFI_CLOSE_EVENT) CoreCloseEvent, // CloseEvent\r
67 (EFI_CHECK_EVENT) CoreCheckEvent, // CheckEvent\r
68 (EFI_INSTALL_PROTOCOL_INTERFACE) CoreInstallProtocolInterface, // InstallProtocolInterface\r
69 (EFI_REINSTALL_PROTOCOL_INTERFACE) CoreReinstallProtocolInterface, // ReinstallProtocolInterface\r
70 (EFI_UNINSTALL_PROTOCOL_INTERFACE) CoreUninstallProtocolInterface, // UninstallProtocolInterface\r
71 (EFI_HANDLE_PROTOCOL) CoreHandleProtocol, // HandleProtocol\r
72 (VOID *) NULL, // Reserved\r
73 (EFI_REGISTER_PROTOCOL_NOTIFY) CoreRegisterProtocolNotify, // RegisterProtocolNotify\r
74 (EFI_LOCATE_HANDLE) CoreLocateHandle, // LocateHandle\r
75 (EFI_LOCATE_DEVICE_PATH) CoreLocateDevicePath, // LocateDevicePath\r
76 (EFI_INSTALL_CONFIGURATION_TABLE) CoreInstallConfigurationTable, // InstallConfigurationTable\r
77 (EFI_IMAGE_LOAD) CoreLoadImage, // LoadImage\r
78 (EFI_IMAGE_START) CoreStartImage, // StartImage\r
79 (EFI_EXIT) CoreExit, // Exit\r
80 (EFI_IMAGE_UNLOAD) CoreUnloadImage, // UnloadImage\r
81 (EFI_EXIT_BOOT_SERVICES) CoreExitBootServices, // ExitBootServices\r
82 (EFI_GET_NEXT_MONOTONIC_COUNT) CoreEfiNotAvailableYetArg1, // GetNextMonotonicCount\r
83 (EFI_STALL) CoreStall, // Stall\r
84 (EFI_SET_WATCHDOG_TIMER) CoreSetWatchdogTimer, // SetWatchdogTimer\r
85 (EFI_CONNECT_CONTROLLER) CoreConnectController, // ConnectController\r
86 (EFI_DISCONNECT_CONTROLLER) CoreDisconnectController, // DisconnectController\r
87 (EFI_OPEN_PROTOCOL) CoreOpenProtocol, // OpenProtocol\r
88 (EFI_CLOSE_PROTOCOL) CoreCloseProtocol, // CloseProtocol\r
89 (EFI_OPEN_PROTOCOL_INFORMATION) CoreOpenProtocolInformation, // OpenProtocolInformation\r
90 (EFI_PROTOCOLS_PER_HANDLE) CoreProtocolsPerHandle, // ProtocolsPerHandle\r
91 (EFI_LOCATE_HANDLE_BUFFER) CoreLocateHandleBuffer, // LocateHandleBuffer\r
92 (EFI_LOCATE_PROTOCOL) CoreLocateProtocol, // LocateProtocol\r
93 (EFI_INSTALL_MULTIPLE_PROTOCOL_INTERFACES) CoreInstallMultipleProtocolInterfaces, // InstallMultipleProtocolInterfaces\r
94 (EFI_UNINSTALL_MULTIPLE_PROTOCOL_INTERFACES) CoreUninstallMultipleProtocolInterfaces, // UninstallMultipleProtocolInterfaces\r
95 (EFI_CALCULATE_CRC32) CoreEfiNotAvailableYetArg3, // CalculateCrc32\r
96 (EFI_COPY_MEM) CopyMem, // CopyMem\r
97 (EFI_SET_MEM) SetMem, // SetMem\r
98 (EFI_CREATE_EVENT_EX) CoreCreateEventEx // CreateEventEx\r
99};\r
100\r
101EFI_DXE_SERVICES mDxeServices = {\r
102 {\r
103 DXE_SERVICES_SIGNATURE, // Signature\r
104 DXE_SERVICES_REVISION, // Revision\r
105 sizeof (DXE_SERVICES), // HeaderSize\r
106 0, // CRC32\r
107 0 // Reserved\r
108 },\r
109 (EFI_ADD_MEMORY_SPACE) CoreAddMemorySpace, // AddMemorySpace\r
110 (EFI_ALLOCATE_MEMORY_SPACE) CoreAllocateMemorySpace, // AllocateMemorySpace\r
111 (EFI_FREE_MEMORY_SPACE) CoreFreeMemorySpace, // FreeMemorySpace\r
112 (EFI_REMOVE_MEMORY_SPACE) CoreRemoveMemorySpace, // RemoveMemorySpace\r
113 (EFI_GET_MEMORY_SPACE_DESCRIPTOR) CoreGetMemorySpaceDescriptor, // GetMemorySpaceDescriptor\r
114 (EFI_SET_MEMORY_SPACE_ATTRIBUTES) CoreSetMemorySpaceAttributes, // SetMemorySpaceAttributes\r
115 (EFI_GET_MEMORY_SPACE_MAP) CoreGetMemorySpaceMap, // GetMemorySpaceMap\r
116 (EFI_ADD_IO_SPACE) CoreAddIoSpace, // AddIoSpace\r
117 (EFI_ALLOCATE_IO_SPACE) CoreAllocateIoSpace, // AllocateIoSpace\r
118 (EFI_FREE_IO_SPACE) CoreFreeIoSpace, // FreeIoSpace\r
119 (EFI_REMOVE_IO_SPACE) CoreRemoveIoSpace, // RemoveIoSpace\r
120 (EFI_GET_IO_SPACE_DESCRIPTOR) CoreGetIoSpaceDescriptor, // GetIoSpaceDescriptor\r
121 (EFI_GET_IO_SPACE_MAP) CoreGetIoSpaceMap, // GetIoSpaceMap\r
122 (EFI_DISPATCH) CoreDispatcher, // Dispatch\r
123 (EFI_SCHEDULE) CoreSchedule, // Schedule\r
124 (EFI_TRUST) CoreTrust, // Trust\r
125 (EFI_PROCESS_FIRMWARE_VOLUME) CoreProcessFirmwareVolume, // ProcessFirmwareVolume\r
126};\r
127\r
128EFI_SYSTEM_TABLE mEfiSystemTableTemplate = {\r
129 {\r
130 EFI_SYSTEM_TABLE_SIGNATURE, // Signature\r
131 EFI_SYSTEM_TABLE_REVISION, // Revision\r
132 sizeof (EFI_SYSTEM_TABLE), // HeaderSize\r
133 0, // CRC32\r
134 0 // Reserved\r
135 },\r
136 NULL, // FirmwareVendor\r
137 0, // FirmwareRevision\r
138 NULL, // ConsoleInHandle\r
139 NULL, // ConIn\r
140 NULL, // ConsoleOutHandle\r
141 NULL, // ConOut\r
142 NULL, // StandardErrorHandle\r
143 NULL, // StdErr\r
144 NULL, // RuntimeServices\r
145 &mBootServices, // BootServices\r
146 0, // NumberOfConfigurationTableEntries\r
147 NULL // ConfigurationTable\r
148};\r
149\r
150EFI_RUNTIME_SERVICES mEfiRuntimeServicesTableTemplate = {\r
151 {\r
152 EFI_RUNTIME_SERVICES_SIGNATURE, // Signature\r
153 EFI_RUNTIME_SERVICES_REVISION, // Revision\r
154 sizeof (EFI_RUNTIME_SERVICES), // HeaderSize\r
155 0, // CRC32\r
156 0 // Reserved\r
157 },\r
158 (EFI_GET_TIME) CoreEfiNotAvailableYetArg2, // GetTime\r
159 (EFI_SET_TIME) CoreEfiNotAvailableYetArg1, // SetTime\r
160 (EFI_GET_WAKEUP_TIME) CoreEfiNotAvailableYetArg3, // GetWakeupTime\r
161 (EFI_SET_WAKEUP_TIME) CoreEfiNotAvailableYetArg2, // SetWakeupTime\r
162 (EFI_SET_VIRTUAL_ADDRESS_MAP) CoreEfiNotAvailableYetArg4, // SetVirtualAddressMap\r
163 (EFI_CONVERT_POINTER) CoreEfiNotAvailableYetArg2, // ConvertPointer\r
164 (EFI_GET_VARIABLE) CoreEfiNotAvailableYetArg5, // GetVariable\r
165 (EFI_GET_NEXT_VARIABLE_NAME) CoreEfiNotAvailableYetArg3, // GetNextVariableName\r
166 (EFI_SET_VARIABLE) CoreEfiNotAvailableYetArg5, // SetVariable\r
167 (EFI_GET_NEXT_HIGH_MONO_COUNT) CoreEfiNotAvailableYetArg1, // GetNextHighMonotonicCount\r
168 (EFI_RESET_SYSTEM) CoreEfiNotAvailableYetArg4, // ResetSystem\r
169 (EFI_UPDATE_CAPSULE) CoreEfiNotAvailableYetArg3, // UpdateCapsule\r
170 (EFI_QUERY_CAPSULE_CAPABILITIES) CoreEfiNotAvailableYetArg4, // QueryCapsuleCapabilities\r
171 (EFI_QUERY_VARIABLE_INFO) CoreEfiNotAvailableYetArg4 // QueryVariableInfo\r
172};\r
173\r
174EFI_RUNTIME_ARCH_PROTOCOL gRuntimeTemplate = {\r
175 INITIALIZE_LIST_HEAD_VARIABLE (gRuntimeTemplate.ImageHead),\r
176 INITIALIZE_LIST_HEAD_VARIABLE (gRuntimeTemplate.EventHead),\r
177\r
178 //\r
179 // Make sure Size != sizeof (EFI_MEMORY_DESCRIPTOR). This will\r
180 // prevent people from having pointer math bugs in their code.\r
181 // now you have to use *DescriptorSize to make things work.\r
182 //\r
183 sizeof (EFI_MEMORY_DESCRIPTOR) + sizeof (UINT64) - (sizeof (EFI_MEMORY_DESCRIPTOR) % sizeof (UINT64)),\r
184 EFI_MEMORY_DESCRIPTOR_VERSION,\r
185 0,\r
186 NULL,\r
187 NULL,\r
188 FALSE,\r
189 FALSE\r
190};\r
191\r
192EFI_RUNTIME_ARCH_PROTOCOL *gRuntime = &gRuntimeTemplate;\r
193\r
194//\r
195// DXE Core Global Variables for the EFI System Table, Boot Services Table,\r
196// DXE Services Table, and Runtime Services Table\r
197//\r
198EFI_DXE_SERVICES *gDxeCoreDS = &mDxeServices;\r
199EFI_SYSTEM_TABLE *gDxeCoreST = NULL;\r
200\r
201//\r
202// For debug initialize gDxeCoreRT to template. gDxeCoreRT must be allocated from RT memory\r
203// but gDxeCoreRT is used for ASSERT () and DEBUG () type macros so lets give it\r
204// a value that will not cause debug infrastructure to crash early on.\r
205//\r
206EFI_RUNTIME_SERVICES *gDxeCoreRT = &mEfiRuntimeServicesTableTemplate;\r
207EFI_HANDLE gDxeCoreImageHandle = NULL;\r
208\r
209\r
210//\r
211// EFI Decompress Protocol\r
212//\r
213EFI_DECOMPRESS_PROTOCOL gEfiDecompress = {\r
214 DxeMainUefiDecompressGetInfo,\r
215 DxeMainUefiDecompress\r
216};\r
217\r
218//\r
e7af83ae 219// For Loading modules at fixed address feature, the configuration table is to cache the top address below which to load\r
220// Runtime code&boot time code\r
54ea99a7 221//\r
ebfb7bb5 222GLOBAL_REMOVE_IF_UNREFERENCED EFI_LOAD_FIXED_ADDRESS_CONFIGURATION_TABLE gLoadModuleAtFixAddressConfigurationTable = {0, 0};\r
54ea99a7 223\r
31f228cf 224// Main entry point to the DXE Core\r
225//\r
226\r
227/**\r
228 Main entry point to DXE Core.\r
229\r
230 @param HobStart Pointer to the beginning of the HOB List from PEI.\r
231\r
232 @return This function should never return.\r
233\r
234**/\r
235VOID\r
236EFIAPI\r
237DxeMain (\r
238 IN VOID *HobStart\r
239 )\r
240{\r
d0d41b52 241 EFI_STATUS Status;\r
242 EFI_PHYSICAL_ADDRESS MemoryBaseAddress;\r
243 UINT64 MemoryLength;\r
244 PE_COFF_LOADER_IMAGE_CONTEXT ImageContext;\r
31f228cf 245\r
1e172d6b 246 //\r
247 // Setup the default exception handlers\r
248 //\r
249 SetupCpuExceptionHandlers ();\r
250 \r
e7af83ae 251 //\r
252 // Initialize Debug Agent to support source level debug in DXE phase\r
253 //\r
4cf7e038 254 InitializeDebugAgent (DEBUG_AGENT_INIT_DXE_CORE, HobStart, NULL);\r
e7af83ae 255\r
31f228cf 256 //\r
257 // Initialize Memory Services\r
258 //\r
259 CoreInitializeMemoryServices (&HobStart, &MemoryBaseAddress, &MemoryLength);\r
260\r
261 //\r
262 // Allocate the EFI System Table and EFI Runtime Service Table from EfiRuntimeServicesData\r
263 // Use the templates to initialize the contents of the EFI System Table and EFI Runtime Services Table\r
264 //\r
265 gDxeCoreST = AllocateRuntimeCopyPool (sizeof (EFI_SYSTEM_TABLE), &mEfiSystemTableTemplate);\r
266 ASSERT (gDxeCoreST != NULL);\r
267\r
268 gDxeCoreRT = AllocateRuntimeCopyPool (sizeof (EFI_RUNTIME_SERVICES), &mEfiRuntimeServicesTableTemplate);\r
269 ASSERT (gDxeCoreRT != NULL);\r
270\r
271 gDxeCoreST->RuntimeServices = gDxeCoreRT;\r
272\r
273 //\r
274 // Start the Image Services.\r
275 //\r
276 Status = CoreInitializeImageServices (HobStart);\r
277 ASSERT_EFI_ERROR (Status);\r
278\r
279 //\r
280 // Call constructor for all libraries\r
281 //\r
282 ProcessLibraryConstructorList (gDxeCoreImageHandle, gDxeCoreST);\r
283 PERF_END (NULL,"PEI", NULL, 0) ;\r
284 PERF_START (NULL,"DXE", NULL, 0) ;\r
285\r
d0d41b52 286 //\r
287 // Report DXE Core image information to the PE/COFF Extra Action Library\r
288 //\r
289 ImageContext.ImageAddress = (EFI_PHYSICAL_ADDRESS)(UINTN)gDxeCoreLoadedImage->ImageBase;\r
290 ImageContext.PdbPointer = PeCoffLoaderGetPdbPointer ((VOID*) (UINTN) ImageContext.ImageAddress);\r
291 PeCoffLoaderRelocateImageExtraAction (&ImageContext);\r
292\r
31f228cf 293 //\r
294 // Initialize the Global Coherency Domain Services\r
295 //\r
296 Status = CoreInitializeGcdServices (&HobStart, MemoryBaseAddress, MemoryLength);\r
297 ASSERT_EFI_ERROR (Status);\r
298\r
299 //\r
300 // Install the DXE Services Table into the EFI System Tables's Configuration Table\r
301 //\r
302 Status = CoreInstallConfigurationTable (&gEfiDxeServicesTableGuid, gDxeCoreDS);\r
303 ASSERT_EFI_ERROR (Status);\r
304\r
305 //\r
306 // Install the HOB List into the EFI System Tables's Configuration Table\r
307 //\r
308 Status = CoreInstallConfigurationTable (&gEfiHobListGuid, HobStart);\r
309 ASSERT_EFI_ERROR (Status);\r
310\r
311 //\r
312 // Install Memory Type Information Table into the EFI System Tables's Configuration Table\r
313 //\r
314 Status = CoreInstallConfigurationTable (&gEfiMemoryTypeInformationGuid, &gMemoryTypeInformation);\r
315 ASSERT_EFI_ERROR (Status);\r
e7af83ae 316\r
54ea99a7 317 //\r
e7af83ae 318 // If Loading modules At fixed address feature is enabled, install Load moduels at fixed address\r
54ea99a7 319 // Configuration Table so that user could easily to retrieve the top address to load Dxe and PEI\r
e7af83ae 320 // Code and Tseg base to load SMM driver.\r
54ea99a7 321 //\r
852081fc 322 if (PcdGet64(PcdLoadModuleAtFixAddressEnable) != 0) {\r
54ea99a7 323 Status = CoreInstallConfigurationTable (&gLoadFixedAddressConfigurationTableGuid, &gLoadModuleAtFixAddressConfigurationTable);\r
324 ASSERT_EFI_ERROR (Status);\r
325 }\r
31f228cf 326 //\r
327 // Report Status Code here for DXE_ENTRY_POINT once it is available\r
328 //\r
329 REPORT_STATUS_CODE (\r
330 EFI_PROGRESS_CODE,\r
f9876ecf 331 (EFI_SOFTWARE_DXE_CORE | EFI_SW_DXE_CORE_PC_ENTRY_POINT)\r
31f228cf 332 );\r
333\r
334 //\r
335 // Create the aligned system table pointer structure that is used by external\r
336 // debuggers to locate the system table... Also, install debug image info\r
337 // configuration table.\r
338 //\r
339 CoreInitializeDebugImageInfoTable ();\r
340 CoreNewDebugImageInfoEntry (\r
341 EFI_DEBUG_IMAGE_INFO_TYPE_NORMAL,\r
342 gDxeCoreLoadedImage,\r
343 gDxeCoreImageHandle\r
344 );\r
345\r
346 DEBUG ((DEBUG_INFO | DEBUG_LOAD, "HOBLIST address in DXE = 0x%p\n", HobStart));\r
347\r
348 DEBUG_CODE_BEGIN ();\r
349 EFI_PEI_HOB_POINTERS Hob;\r
350\r
351 for (Hob.Raw = HobStart; !END_OF_HOB_LIST(Hob); Hob.Raw = GET_NEXT_HOB(Hob)) {\r
352 if (GET_HOB_TYPE (Hob) == EFI_HOB_TYPE_MEMORY_ALLOCATION) {\r
8e90dd6b 353 DEBUG ((DEBUG_INFO | DEBUG_LOAD, "Memory Allocation 0x%08x 0x%0lx - 0x%0lx\n", \\r
bfef82a1 354 Hob.MemoryAllocation->AllocDescriptor.MemoryType, \\r
31f228cf 355 Hob.MemoryAllocation->AllocDescriptor.MemoryBaseAddress, \\r
bfef82a1 356 Hob.MemoryAllocation->AllocDescriptor.MemoryBaseAddress + Hob.MemoryAllocation->AllocDescriptor.MemoryLength - 1));\r
31f228cf 357 }\r
358 }\r
359 for (Hob.Raw = HobStart; !END_OF_HOB_LIST(Hob); Hob.Raw = GET_NEXT_HOB(Hob)) {\r
360 if (GET_HOB_TYPE (Hob) == EFI_HOB_TYPE_FV2) {\r
3351d21f 361 DEBUG ((DEBUG_INFO | DEBUG_LOAD, "FV2 Hob 0x%0lx - 0x%0lx\n", Hob.FirmwareVolume2->BaseAddress, Hob.FirmwareVolume2->BaseAddress + Hob.FirmwareVolume2->Length - 1));\r
31f228cf 362 } else if (GET_HOB_TYPE (Hob) == EFI_HOB_TYPE_FV) {\r
3351d21f 363 DEBUG ((DEBUG_INFO | DEBUG_LOAD, "FV Hob 0x%0lx - 0x%0lx\n", Hob.FirmwareVolume->BaseAddress, Hob.FirmwareVolume->BaseAddress + Hob.FirmwareVolume2->Length - 1));\r
31f228cf 364 }\r
365 }\r
366 DEBUG_CODE_END ();\r
367\r
368 //\r
369 // Initialize the Event Services\r
370 //\r
371 Status = CoreInitializeEventServices ();\r
372 ASSERT_EFI_ERROR (Status);\r
373\r
374\r
375 //\r
376 // Get the Protocols that were passed in from PEI to DXE through GUIDed HOBs\r
377 //\r
378 // These Protocols are not architectural. This implementation is sharing code between\r
379 // PEI and DXE in order to save FLASH space. These Protocols could also be implemented\r
380 // as part of the DXE Core. However, that would also require the DXE Core to be ported\r
381 // each time a different CPU is used, a different Decompression algorithm is used, or a\r
382 // different Image type is used. By placing these Protocols in PEI, the DXE Core remains\r
383 // generic, and only PEI and the Arch Protocols need to be ported from Platform to Platform,\r
384 // and from CPU to CPU.\r
385 //\r
386\r
387 //\r
388 // Publish the EFI, Tiano, and Custom Decompress protocols for use by other DXE components\r
389 //\r
390 Status = CoreInstallMultipleProtocolInterfaces (\r
391 &mDecompressHandle,\r
392 &gEfiDecompressProtocolGuid, &gEfiDecompress,\r
393 NULL\r
394 );\r
395 ASSERT_EFI_ERROR (Status);\r
396\r
397 //\r
398 // Register for the GUIDs of the Architectural Protocols, so the rest of the\r
399 // EFI Boot Services and EFI Runtime Services tables can be filled in.\r
74e44290 400 // Also register for the GUIDs of optional protocols.\r
31f228cf 401 //\r
74e44290 402 CoreNotifyOnProtocolInstallation ();\r
31f228cf 403\r
404 //\r
405 // Produce Firmware Volume Protocols, one for each FV in the HOB list.\r
406 //\r
407 Status = FwVolBlockDriverInit (gDxeCoreImageHandle, gDxeCoreST);\r
408 ASSERT_EFI_ERROR (Status);\r
409\r
410 Status = FwVolDriverInit (gDxeCoreImageHandle, gDxeCoreST);\r
411 ASSERT_EFI_ERROR (Status);\r
412\r
413 //\r
414 // Produce the Section Extraction Protocol\r
415 //\r
416 Status = InitializeSectionExtraction (gDxeCoreImageHandle, gDxeCoreST);\r
417 ASSERT_EFI_ERROR (Status);\r
418\r
419 //\r
420 // Initialize the DXE Dispatcher\r
421 //\r
422 PERF_START (NULL,"CoreInitializeDispatcher", "DxeMain", 0) ;\r
423 CoreInitializeDispatcher ();\r
424 PERF_END (NULL,"CoreInitializeDispatcher", "DxeMain", 0) ;\r
425\r
426 //\r
427 // Invoke the DXE Dispatcher\r
428 //\r
429 PERF_START (NULL, "CoreDispatcher", "DxeMain", 0);\r
430 CoreDispatcher ();\r
431 PERF_END (NULL, "CoreDispatcher", "DxeMain", 0);\r
432\r
433 //\r
434 // Display Architectural protocols that were not loaded if this is DEBUG build\r
435 //\r
436 DEBUG_CODE_BEGIN ();\r
437 CoreDisplayMissingArchProtocols ();\r
438 DEBUG_CODE_END ();\r
439\r
440 //\r
441 // Display any drivers that were not dispatched because dependency expression\r
442 // evaluated to false if this is a debug build\r
443 //\r
444 DEBUG_CODE_BEGIN ();\r
445 CoreDisplayDiscoveredNotDispatched ();\r
446 DEBUG_CODE_END ();\r
447\r
448 //\r
449 // Assert if the Architectural Protocols are not present.\r
450 //\r
37623a5c 451 Status = CoreAllEfiServicesAvailable ();\r
452 if (EFI_ERROR(Status)) {\r
453 //\r
454 // Report Status code that some Architectural Protocols are not present.\r
455 //\r
456 REPORT_STATUS_CODE (\r
457 EFI_ERROR_CODE | EFI_ERROR_MAJOR,\r
458 (EFI_SOFTWARE_DXE_CORE | EFI_SW_DXE_CORE_EC_NO_ARCH)\r
459 ); \r
460 }\r
461 ASSERT_EFI_ERROR (Status);\r
31f228cf 462\r
463 //\r
464 // Report Status code before transfer control to BDS\r
465 //\r
466 REPORT_STATUS_CODE (\r
467 EFI_PROGRESS_CODE,\r
f9876ecf 468 (EFI_SOFTWARE_DXE_CORE | EFI_SW_DXE_CORE_PC_HANDOFF_TO_NEXT)\r
31f228cf 469 );\r
470\r
471 //\r
472 // Transfer control to the BDS Architectural Protocol\r
473 //\r
474 gBds->Entry (gBds);\r
475\r
476 //\r
477 // BDS should never return\r
478 //\r
479 ASSERT (FALSE);\r
480 CpuDeadLoop ();\r
481}\r
482\r
483\r
484\r
485/**\r
486 Place holder function until all the Boot Services and Runtime Services are\r
487 available.\r
488\r
489 @return EFI_NOT_AVAILABLE_YET\r
490\r
491**/\r
492EFI_STATUS\r
493EFIAPI\r
494CoreEfiNotAvailableYetArg0 (\r
495 VOID\r
496 )\r
497{\r
498 //\r
499 // This function should never be executed. If it does, then the architectural protocols\r
500 // have not been designed correctly. The CpuBreakpoint () is commented out for now until the\r
501 // DXE Core and all the Architectural Protocols are complete.\r
502 //\r
503\r
504 return EFI_NOT_AVAILABLE_YET;\r
505}\r
506\r
507\r
508/**\r
509 Place holder function until all the Boot Services and Runtime Services are\r
510 available.\r
511\r
512 @param Arg1 Undefined\r
513\r
514 @return EFI_NOT_AVAILABLE_YET\r
515\r
516**/\r
517EFI_STATUS\r
518EFIAPI\r
519CoreEfiNotAvailableYetArg1 (\r
520 UINTN Arg1\r
521 )\r
522{\r
523 //\r
524 // This function should never be executed. If it does, then the architectural protocols\r
525 // have not been designed correctly. The CpuBreakpoint () is commented out for now until the\r
526 // DXE Core and all the Architectural Protocols are complete.\r
527 //\r
528\r
529 return EFI_NOT_AVAILABLE_YET;\r
530}\r
531\r
532\r
533/**\r
534 Place holder function until all the Boot Services and Runtime Services are available.\r
535\r
536 @param Arg1 Undefined\r
537 @param Arg2 Undefined\r
538\r
539 @return EFI_NOT_AVAILABLE_YET\r
540\r
541**/\r
542EFI_STATUS\r
543EFIAPI\r
544CoreEfiNotAvailableYetArg2 (\r
545 UINTN Arg1,\r
546 UINTN Arg2\r
547 )\r
548{\r
549 //\r
550 // This function should never be executed. If it does, then the architectural protocols\r
551 // have not been designed correctly. The CpuBreakpoint () is commented out for now until the\r
552 // DXE Core and all the Architectural Protocols are complete.\r
553 //\r
554\r
555 return EFI_NOT_AVAILABLE_YET;\r
556}\r
557\r
558\r
559/**\r
560 Place holder function until all the Boot Services and Runtime Services are available.\r
561\r
562 @param Arg1 Undefined\r
563 @param Arg2 Undefined\r
564 @param Arg3 Undefined\r
565\r
566 @return EFI_NOT_AVAILABLE_YET\r
567\r
568**/\r
569EFI_STATUS\r
570EFIAPI\r
571CoreEfiNotAvailableYetArg3 (\r
572 UINTN Arg1,\r
573 UINTN Arg2,\r
574 UINTN Arg3\r
575 )\r
576{\r
577 //\r
578 // This function should never be executed. If it does, then the architectural protocols\r
579 // have not been designed correctly. The CpuBreakpoint () is commented out for now until the\r
580 // DXE Core and all the Architectural Protocols are complete.\r
581 //\r
582\r
583 return EFI_NOT_AVAILABLE_YET;\r
584}\r
585\r
586\r
587/**\r
588 Place holder function until all the Boot Services and Runtime Services are available.\r
589\r
590 @param Arg1 Undefined\r
591 @param Arg2 Undefined\r
592 @param Arg3 Undefined\r
593 @param Arg4 Undefined\r
594\r
595 @return EFI_NOT_AVAILABLE_YET\r
596\r
597**/\r
598EFI_STATUS\r
599EFIAPI\r
600CoreEfiNotAvailableYetArg4 (\r
601 UINTN Arg1,\r
602 UINTN Arg2,\r
603 UINTN Arg3,\r
604 UINTN Arg4\r
605 )\r
606{\r
607 //\r
608 // This function should never be executed. If it does, then the architectural protocols\r
609 // have not been designed correctly. The CpuBreakpoint () is commented out for now until the\r
610 // DXE Core and all the Architectural Protocols are complete.\r
611 //\r
612\r
613 return EFI_NOT_AVAILABLE_YET;\r
614}\r
615\r
616\r
617/**\r
618 Place holder function until all the Boot Services and Runtime Services are available.\r
619\r
620 @param Arg1 Undefined\r
621 @param Arg2 Undefined\r
622 @param Arg3 Undefined\r
623 @param Arg4 Undefined\r
624 @param Arg5 Undefined\r
625\r
626 @return EFI_NOT_AVAILABLE_YET\r
627\r
628**/\r
629EFI_STATUS\r
630EFIAPI\r
631CoreEfiNotAvailableYetArg5 (\r
632 UINTN Arg1,\r
633 UINTN Arg2,\r
634 UINTN Arg3,\r
635 UINTN Arg4,\r
636 UINTN Arg5\r
637 )\r
638{\r
639 //\r
640 // This function should never be executed. If it does, then the architectural protocols\r
641 // have not been designed correctly. The CpuBreakpoint () is commented out for now until the\r
642 // DXE Core and all the Architectural Protocols are complete.\r
643 //\r
644\r
645 return EFI_NOT_AVAILABLE_YET;\r
646}\r
647\r
648\r
649/**\r
650 Calcualte the 32-bit CRC in a EFI table using the service provided by the\r
651 gRuntime service.\r
652\r
653 @param Hdr Pointer to an EFI standard header\r
654\r
655**/\r
656VOID\r
657CalculateEfiHdrCrc (\r
658 IN OUT EFI_TABLE_HEADER *Hdr\r
659 )\r
660{\r
661 UINT32 Crc;\r
662\r
663 Hdr->CRC32 = 0;\r
664\r
665 //\r
666 // If gBS->CalculateCrce32 () == CoreEfiNotAvailableYet () then\r
667 // Crc will come back as zero if we set it to zero here\r
668 //\r
669 Crc = 0;\r
670 gBS->CalculateCrc32 ((UINT8 *)Hdr, Hdr->HeaderSize, &Crc);\r
671 Hdr->CRC32 = Crc;\r
672}\r
673\r
674\r
675/**\r
676 Terminates all boot services.\r
677\r
678 @param ImageHandle Handle that identifies the exiting image.\r
679 @param MapKey Key to the latest memory map.\r
680\r
681 @retval EFI_SUCCESS Boot Services terminated\r
682 @retval EFI_INVALID_PARAMETER MapKey is incorrect.\r
683\r
684**/\r
685EFI_STATUS\r
686EFIAPI\r
687CoreExitBootServices (\r
688 IN EFI_HANDLE ImageHandle,\r
689 IN UINTN MapKey\r
690 )\r
691{\r
692 EFI_STATUS Status;\r
693\r
785b5f5a 694 //\r
695 // Disable Timer\r
696 //\r
697 gTimer->SetTimerPeriod (gTimer, 0);\r
698\r
31f228cf 699 //\r
700 // Terminate memory services if the MapKey matches\r
701 //\r
702 Status = CoreTerminateMemoryMap (MapKey);\r
703 if (EFI_ERROR (Status)) {\r
044824d9 704 //\r
705 // Notify other drivers that ExitBootServices fail \r
706 //\r
707 CoreNotifySignalList (&gEventExitBootServicesFailedGuid);\r
31f228cf 708 return Status;\r
709 }\r
710\r
31f228cf 711 //\r
712 // Notify other drivers that we are exiting boot services.\r
713 //\r
714 CoreNotifySignalList (&gEfiEventExitBootServicesGuid);\r
715\r
213fecef 716 //\r
717 // Disable interrupt of Debug timer.\r
718 //\r
719 SaveAndSetDebugTimerInterrupt (FALSE);\r
720\r
31f228cf 721 //\r
722 // Disable CPU Interrupts\r
723 //\r
724 gCpu->DisableInterrupt (gCpu);\r
725\r
726 //\r
727 // Report that ExitBootServices() has been called\r
728 //\r
729 REPORT_STATUS_CODE (\r
730 EFI_PROGRESS_CODE,\r
f9876ecf 731 (EFI_SOFTWARE_EFI_BOOT_SERVICE | EFI_SW_BS_PC_EXIT_BOOT_SERVICES)\r
31f228cf 732 );\r
733\r
734 //\r
735 // Clear the non-runtime values of the EFI System Table\r
736 //\r
737 gDxeCoreST->BootServices = NULL;\r
738 gDxeCoreST->ConIn = NULL;\r
739 gDxeCoreST->ConsoleInHandle = NULL;\r
740 gDxeCoreST->ConOut = NULL;\r
741 gDxeCoreST->ConsoleOutHandle = NULL;\r
742 gDxeCoreST->StdErr = NULL;\r
743 gDxeCoreST->StandardErrorHandle = NULL;\r
744\r
745 //\r
746 // Recompute the 32-bit CRC of the EFI System Table\r
747 //\r
748 CalculateEfiHdrCrc (&gDxeCoreST->Hdr);\r
749\r
750 //\r
751 // Zero out the Boot Service Table\r
752 //\r
753 ZeroMem (gBS, sizeof (EFI_BOOT_SERVICES));\r
754 gBS = NULL;\r
755\r
756 //\r
757 // Update the AtRuntime field in Runtiem AP.\r
758 //\r
759 gRuntime->AtRuntime = TRUE;\r
760\r
761 return Status;\r
762}\r
763\r
764\r
765/**\r
766 Given a compressed source buffer, this function retrieves the size of the\r
767 uncompressed buffer and the size of the scratch buffer required to decompress\r
768 the compressed source buffer.\r
769\r
770 The GetInfo() function retrieves the size of the uncompressed buffer and the\r
771 temporary scratch buffer required to decompress the buffer specified by Source\r
772 and SourceSize. If the size of the uncompressed buffer or the size of the\r
773 scratch buffer cannot be determined from the compressed data specified by\r
774 Source and SourceData, then EFI_INVALID_PARAMETER is returned. Otherwise, the\r
775 size of the uncompressed buffer is returned in DestinationSize, the size of\r
776 the scratch buffer is returned in ScratchSize, and EFI_SUCCESS is returned.\r
777 The GetInfo() function does not have scratch buffer available to perform a\r
778 thorough checking of the validity of the source data. It just retrieves the\r
779 "Original Size" field from the beginning bytes of the source data and output\r
780 it as DestinationSize. And ScratchSize is specific to the decompression\r
781 implementation.\r
782\r
783 @param This A pointer to the EFI_DECOMPRESS_PROTOCOL instance.\r
784 @param Source The source buffer containing the compressed data.\r
785 @param SourceSize The size, in bytes, of the source buffer.\r
786 @param DestinationSize A pointer to the size, in bytes, of the\r
787 uncompressed buffer that will be generated when the\r
788 compressed buffer specified by Source and\r
789 SourceSize is decompressed.\r
790 @param ScratchSize A pointer to the size, in bytes, of the scratch\r
791 buffer that is required to decompress the\r
792 compressed buffer specified by Source and\r
793 SourceSize.\r
794\r
795 @retval EFI_SUCCESS The size of the uncompressed data was returned in\r
796 DestinationSize and the size of the scratch buffer\r
797 was returned in ScratchSize.\r
798 @retval EFI_INVALID_PARAMETER The size of the uncompressed data or the size of\r
799 the scratch buffer cannot be determined from the\r
800 compressed data specified by Source and\r
801 SourceSize.\r
802\r
803**/\r
804EFI_STATUS\r
805EFIAPI\r
806DxeMainUefiDecompressGetInfo (\r
807 IN EFI_DECOMPRESS_PROTOCOL *This,\r
808 IN VOID *Source,\r
809 IN UINT32 SourceSize,\r
810 OUT UINT32 *DestinationSize,\r
811 OUT UINT32 *ScratchSize\r
812 )\r
813{\r
814 if (Source == NULL || DestinationSize == NULL || ScratchSize == NULL) {\r
815 return EFI_INVALID_PARAMETER;\r
816 }\r
817 return UefiDecompressGetInfo (Source, SourceSize, DestinationSize, ScratchSize);\r
818}\r
819\r
820\r
821/**\r
822 Decompresses a compressed source buffer.\r
823\r
824 The Decompress() function extracts decompressed data to its original form.\r
825 This protocol is designed so that the decompression algorithm can be\r
826 implemented without using any memory services. As a result, the Decompress()\r
827 Function is not allowed to call AllocatePool() or AllocatePages() in its\r
828 implementation. It is the caller's responsibility to allocate and free the\r
829 Destination and Scratch buffers.\r
830 If the compressed source data specified by Source and SourceSize is\r
831 sucessfully decompressed into Destination, then EFI_SUCCESS is returned. If\r
832 the compressed source data specified by Source and SourceSize is not in a\r
833 valid compressed data format, then EFI_INVALID_PARAMETER is returned.\r
834\r
835 @param This A pointer to the EFI_DECOMPRESS_PROTOCOL instance.\r
836 @param Source The source buffer containing the compressed data.\r
837 @param SourceSize SourceSizeThe size of source data.\r
838 @param Destination On output, the destination buffer that contains\r
839 the uncompressed data.\r
840 @param DestinationSize The size of the destination buffer. The size of\r
841 the destination buffer needed is obtained from\r
842 EFI_DECOMPRESS_PROTOCOL.GetInfo().\r
843 @param Scratch A temporary scratch buffer that is used to perform\r
844 the decompression.\r
845 @param ScratchSize The size of scratch buffer. The size of the\r
846 scratch buffer needed is obtained from GetInfo().\r
847\r
848 @retval EFI_SUCCESS Decompression completed successfully, and the\r
849 uncompressed buffer is returned in Destination.\r
850 @retval EFI_INVALID_PARAMETER The source buffer specified by Source and\r
851 SourceSize is corrupted (not in a valid\r
852 compressed format).\r
853\r
854**/\r
855EFI_STATUS\r
856EFIAPI\r
857DxeMainUefiDecompress (\r
858 IN EFI_DECOMPRESS_PROTOCOL *This,\r
859 IN VOID *Source,\r
860 IN UINT32 SourceSize,\r
861 IN OUT VOID *Destination,\r
862 IN UINT32 DestinationSize,\r
863 IN OUT VOID *Scratch,\r
864 IN UINT32 ScratchSize\r
865 )\r
866{\r
867 EFI_STATUS Status;\r
868 UINT32 TestDestinationSize;\r
869 UINT32 TestScratchSize;\r
870\r
871 if (Source == NULL || Destination== NULL || Scratch == NULL) {\r
872 return EFI_INVALID_PARAMETER;\r
873 }\r
874\r
875 Status = UefiDecompressGetInfo (Source, SourceSize, &TestDestinationSize, &TestScratchSize);\r
876 if (EFI_ERROR (Status)) {\r
877 return Status;\r
878 }\r
879\r
880 if (ScratchSize < TestScratchSize || DestinationSize < TestDestinationSize) {\r
881 return RETURN_INVALID_PARAMETER;\r
882 }\r
883\r
884 return UefiDecompress (Source, Destination, Scratch);\r
885}\r
EFI Development Kit II mirror for PVE