2 DXE Core Main Entry Point
4 Copyright (c) 2006 - 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.
18 // DXE Core Global Variables for Protocols from PEI
20 EFI_HANDLE mDecompressHandle
= NULL
;
23 // DXE Core globals for Architecture Protocols
25 EFI_SECURITY_ARCH_PROTOCOL
*gSecurity
= NULL
;
26 EFI_SECURITY2_ARCH_PROTOCOL
*gSecurity2
= NULL
;
27 EFI_CPU_ARCH_PROTOCOL
*gCpu
= NULL
;
28 EFI_METRONOME_ARCH_PROTOCOL
*gMetronome
= NULL
;
29 EFI_TIMER_ARCH_PROTOCOL
*gTimer
= NULL
;
30 EFI_BDS_ARCH_PROTOCOL
*gBds
= NULL
;
31 EFI_WATCHDOG_TIMER_ARCH_PROTOCOL
*gWatchdogTimer
= NULL
;
34 // DXE Core globals for optional protocol dependencies
36 EFI_SMM_BASE2_PROTOCOL
*gSmmBase2
= NULL
;
39 // DXE Core Global used to update core loaded image protocol handle
41 EFI_GUID
*gDxeCoreFileName
;
42 EFI_LOADED_IMAGE_PROTOCOL
*gDxeCoreLoadedImage
;
45 // DXE Core Module Variables
47 EFI_BOOT_SERVICES mBootServices
= {
49 EFI_BOOT_SERVICES_SIGNATURE
, // Signature
50 EFI_BOOT_SERVICES_REVISION
, // Revision
51 sizeof (EFI_BOOT_SERVICES
), // HeaderSize
55 (EFI_RAISE_TPL
) CoreRaiseTpl
, // RaiseTPL
56 (EFI_RESTORE_TPL
) CoreRestoreTpl
, // RestoreTPL
57 (EFI_ALLOCATE_PAGES
) CoreAllocatePages
, // AllocatePages
58 (EFI_FREE_PAGES
) CoreFreePages
, // FreePages
59 (EFI_GET_MEMORY_MAP
) CoreGetMemoryMap
, // GetMemoryMap
60 (EFI_ALLOCATE_POOL
) CoreAllocatePool
, // AllocatePool
61 (EFI_FREE_POOL
) CoreFreePool
, // FreePool
62 (EFI_CREATE_EVENT
) CoreCreateEvent
, // CreateEvent
63 (EFI_SET_TIMER
) CoreSetTimer
, // SetTimer
64 (EFI_WAIT_FOR_EVENT
) CoreWaitForEvent
, // WaitForEvent
65 (EFI_SIGNAL_EVENT
) CoreSignalEvent
, // SignalEvent
66 (EFI_CLOSE_EVENT
) CoreCloseEvent
, // CloseEvent
67 (EFI_CHECK_EVENT
) CoreCheckEvent
, // CheckEvent
68 (EFI_INSTALL_PROTOCOL_INTERFACE
) CoreInstallProtocolInterface
, // InstallProtocolInterface
69 (EFI_REINSTALL_PROTOCOL_INTERFACE
) CoreReinstallProtocolInterface
, // ReinstallProtocolInterface
70 (EFI_UNINSTALL_PROTOCOL_INTERFACE
) CoreUninstallProtocolInterface
, // UninstallProtocolInterface
71 (EFI_HANDLE_PROTOCOL
) CoreHandleProtocol
, // HandleProtocol
72 (VOID
*) NULL
, // Reserved
73 (EFI_REGISTER_PROTOCOL_NOTIFY
) CoreRegisterProtocolNotify
, // RegisterProtocolNotify
74 (EFI_LOCATE_HANDLE
) CoreLocateHandle
, // LocateHandle
75 (EFI_LOCATE_DEVICE_PATH
) CoreLocateDevicePath
, // LocateDevicePath
76 (EFI_INSTALL_CONFIGURATION_TABLE
) CoreInstallConfigurationTable
, // InstallConfigurationTable
77 (EFI_IMAGE_LOAD
) CoreLoadImage
, // LoadImage
78 (EFI_IMAGE_START
) CoreStartImage
, // StartImage
79 (EFI_EXIT
) CoreExit
, // Exit
80 (EFI_IMAGE_UNLOAD
) CoreUnloadImage
, // UnloadImage
81 (EFI_EXIT_BOOT_SERVICES
) CoreExitBootServices
, // ExitBootServices
82 (EFI_GET_NEXT_MONOTONIC_COUNT
) CoreEfiNotAvailableYetArg1
, // GetNextMonotonicCount
83 (EFI_STALL
) CoreStall
, // Stall
84 (EFI_SET_WATCHDOG_TIMER
) CoreSetWatchdogTimer
, // SetWatchdogTimer
85 (EFI_CONNECT_CONTROLLER
) CoreConnectController
, // ConnectController
86 (EFI_DISCONNECT_CONTROLLER
) CoreDisconnectController
, // DisconnectController
87 (EFI_OPEN_PROTOCOL
) CoreOpenProtocol
, // OpenProtocol
88 (EFI_CLOSE_PROTOCOL
) CoreCloseProtocol
, // CloseProtocol
89 (EFI_OPEN_PROTOCOL_INFORMATION
) CoreOpenProtocolInformation
, // OpenProtocolInformation
90 (EFI_PROTOCOLS_PER_HANDLE
) CoreProtocolsPerHandle
, // ProtocolsPerHandle
91 (EFI_LOCATE_HANDLE_BUFFER
) CoreLocateHandleBuffer
, // LocateHandleBuffer
92 (EFI_LOCATE_PROTOCOL
) CoreLocateProtocol
, // LocateProtocol
93 (EFI_INSTALL_MULTIPLE_PROTOCOL_INTERFACES
) CoreInstallMultipleProtocolInterfaces
, // InstallMultipleProtocolInterfaces
94 (EFI_UNINSTALL_MULTIPLE_PROTOCOL_INTERFACES
) CoreUninstallMultipleProtocolInterfaces
, // UninstallMultipleProtocolInterfaces
95 (EFI_CALCULATE_CRC32
) CoreEfiNotAvailableYetArg3
, // CalculateCrc32
96 (EFI_COPY_MEM
) CopyMem
, // CopyMem
97 (EFI_SET_MEM
) SetMem
, // SetMem
98 (EFI_CREATE_EVENT_EX
) CoreCreateEventEx
// CreateEventEx
101 EFI_DXE_SERVICES mDxeServices
= {
103 DXE_SERVICES_SIGNATURE
, // Signature
104 DXE_SERVICES_REVISION
, // Revision
105 sizeof (DXE_SERVICES
), // HeaderSize
109 (EFI_ADD_MEMORY_SPACE
) CoreAddMemorySpace
, // AddMemorySpace
110 (EFI_ALLOCATE_MEMORY_SPACE
) CoreAllocateMemorySpace
, // AllocateMemorySpace
111 (EFI_FREE_MEMORY_SPACE
) CoreFreeMemorySpace
, // FreeMemorySpace
112 (EFI_REMOVE_MEMORY_SPACE
) CoreRemoveMemorySpace
, // RemoveMemorySpace
113 (EFI_GET_MEMORY_SPACE_DESCRIPTOR
) CoreGetMemorySpaceDescriptor
, // GetMemorySpaceDescriptor
114 (EFI_SET_MEMORY_SPACE_ATTRIBUTES
) CoreSetMemorySpaceAttributes
, // SetMemorySpaceAttributes
115 (EFI_GET_MEMORY_SPACE_MAP
) CoreGetMemorySpaceMap
, // GetMemorySpaceMap
116 (EFI_ADD_IO_SPACE
) CoreAddIoSpace
, // AddIoSpace
117 (EFI_ALLOCATE_IO_SPACE
) CoreAllocateIoSpace
, // AllocateIoSpace
118 (EFI_FREE_IO_SPACE
) CoreFreeIoSpace
, // FreeIoSpace
119 (EFI_REMOVE_IO_SPACE
) CoreRemoveIoSpace
, // RemoveIoSpace
120 (EFI_GET_IO_SPACE_DESCRIPTOR
) CoreGetIoSpaceDescriptor
, // GetIoSpaceDescriptor
121 (EFI_GET_IO_SPACE_MAP
) CoreGetIoSpaceMap
, // GetIoSpaceMap
122 (EFI_DISPATCH
) CoreDispatcher
, // Dispatch
123 (EFI_SCHEDULE
) CoreSchedule
, // Schedule
124 (EFI_TRUST
) CoreTrust
, // Trust
125 (EFI_PROCESS_FIRMWARE_VOLUME
) CoreProcessFirmwareVolume
, // ProcessFirmwareVolume
126 (EFI_SET_MEMORY_SPACE_CAPABILITIES
)CoreSetMemorySpaceCapabilities
, // SetMemorySpaceCapabilities
129 EFI_SYSTEM_TABLE mEfiSystemTableTemplate
= {
131 EFI_SYSTEM_TABLE_SIGNATURE
, // Signature
132 EFI_SYSTEM_TABLE_REVISION
, // Revision
133 sizeof (EFI_SYSTEM_TABLE
), // HeaderSize
137 NULL
, // FirmwareVendor
138 0, // FirmwareRevision
139 NULL
, // ConsoleInHandle
141 NULL
, // ConsoleOutHandle
143 NULL
, // StandardErrorHandle
145 NULL
, // RuntimeServices
146 &mBootServices
, // BootServices
147 0, // NumberOfConfigurationTableEntries
148 NULL
// ConfigurationTable
151 EFI_RUNTIME_SERVICES mEfiRuntimeServicesTableTemplate
= {
153 EFI_RUNTIME_SERVICES_SIGNATURE
, // Signature
154 EFI_RUNTIME_SERVICES_REVISION
, // Revision
155 sizeof (EFI_RUNTIME_SERVICES
), // HeaderSize
159 (EFI_GET_TIME
) CoreEfiNotAvailableYetArg2
, // GetTime
160 (EFI_SET_TIME
) CoreEfiNotAvailableYetArg1
, // SetTime
161 (EFI_GET_WAKEUP_TIME
) CoreEfiNotAvailableYetArg3
, // GetWakeupTime
162 (EFI_SET_WAKEUP_TIME
) CoreEfiNotAvailableYetArg2
, // SetWakeupTime
163 (EFI_SET_VIRTUAL_ADDRESS_MAP
) CoreEfiNotAvailableYetArg4
, // SetVirtualAddressMap
164 (EFI_CONVERT_POINTER
) CoreEfiNotAvailableYetArg2
, // ConvertPointer
165 (EFI_GET_VARIABLE
) CoreEfiNotAvailableYetArg5
, // GetVariable
166 (EFI_GET_NEXT_VARIABLE_NAME
) CoreEfiNotAvailableYetArg3
, // GetNextVariableName
167 (EFI_SET_VARIABLE
) CoreEfiNotAvailableYetArg5
, // SetVariable
168 (EFI_GET_NEXT_HIGH_MONO_COUNT
) CoreEfiNotAvailableYetArg1
, // GetNextHighMonotonicCount
169 (EFI_RESET_SYSTEM
) CoreEfiNotAvailableYetArg4
, // ResetSystem
170 (EFI_UPDATE_CAPSULE
) CoreEfiNotAvailableYetArg3
, // UpdateCapsule
171 (EFI_QUERY_CAPSULE_CAPABILITIES
) CoreEfiNotAvailableYetArg4
, // QueryCapsuleCapabilities
172 (EFI_QUERY_VARIABLE_INFO
) CoreEfiNotAvailableYetArg4
// QueryVariableInfo
175 EFI_RUNTIME_ARCH_PROTOCOL gRuntimeTemplate
= {
176 INITIALIZE_LIST_HEAD_VARIABLE (gRuntimeTemplate
.ImageHead
),
177 INITIALIZE_LIST_HEAD_VARIABLE (gRuntimeTemplate
.EventHead
),
180 // Make sure Size != sizeof (EFI_MEMORY_DESCRIPTOR). This will
181 // prevent people from having pointer math bugs in their code.
182 // now you have to use *DescriptorSize to make things work.
184 sizeof (EFI_MEMORY_DESCRIPTOR
) + sizeof (UINT64
) - (sizeof (EFI_MEMORY_DESCRIPTOR
) % sizeof (UINT64
)),
185 EFI_MEMORY_DESCRIPTOR_VERSION
,
193 EFI_RUNTIME_ARCH_PROTOCOL
*gRuntime
= &gRuntimeTemplate
;
196 // DXE Core Global Variables for the EFI System Table, Boot Services Table,
197 // DXE Services Table, and Runtime Services Table
199 EFI_DXE_SERVICES
*gDxeCoreDS
= &mDxeServices
;
200 EFI_SYSTEM_TABLE
*gDxeCoreST
= NULL
;
203 // For debug initialize gDxeCoreRT to template. gDxeCoreRT must be allocated from RT memory
204 // but gDxeCoreRT is used for ASSERT () and DEBUG () type macros so lets give it
205 // a value that will not cause debug infrastructure to crash early on.
207 EFI_RUNTIME_SERVICES
*gDxeCoreRT
= &mEfiRuntimeServicesTableTemplate
;
208 EFI_HANDLE gDxeCoreImageHandle
= NULL
;
210 BOOLEAN gMemoryMapTerminated
= FALSE
;
213 // EFI Decompress Protocol
215 EFI_DECOMPRESS_PROTOCOL gEfiDecompress
= {
216 DxeMainUefiDecompressGetInfo
,
217 DxeMainUefiDecompress
221 // For Loading modules at fixed address feature, the configuration table is to cache the top address below which to load
222 // Runtime code&boot time code
224 GLOBAL_REMOVE_IF_UNREFERENCED EFI_LOAD_FIXED_ADDRESS_CONFIGURATION_TABLE gLoadModuleAtFixAddressConfigurationTable
= {0, 0};
226 // Main entry point to the DXE Core
230 Main entry point to DXE Core.
232 @param HobStart Pointer to the beginning of the HOB List from PEI.
234 @return This function should never return.
244 EFI_PHYSICAL_ADDRESS MemoryBaseAddress
;
246 PE_COFF_LOADER_IMAGE_CONTEXT ImageContext
;
248 EFI_HOB_GUID_TYPE
*GuidHob
;
249 EFI_VECTOR_HANDOFF_INFO
*VectorInfoList
;
250 EFI_VECTOR_HANDOFF_INFO
*VectorInfo
;
254 // Setup the default exception handlers
256 VectorInfoList
= NULL
;
257 GuidHob
= GetNextGuidHob (&gEfiVectorHandoffInfoPpiGuid
, HobStart
);
258 if (GuidHob
!= NULL
) {
259 VectorInfoList
= (EFI_VECTOR_HANDOFF_INFO
*) (GET_GUID_HOB_DATA(GuidHob
));
261 Status
= InitializeCpuExceptionHandlers (VectorInfoList
);
262 ASSERT_EFI_ERROR (Status
);
265 // Initialize Debug Agent to support source level debug in DXE phase
267 InitializeDebugAgent (DEBUG_AGENT_INIT_DXE_CORE
, HobStart
, NULL
);
270 // Initialize Memory Services
272 CoreInitializeMemoryServices (&HobStart
, &MemoryBaseAddress
, &MemoryLength
);
274 MemoryProfileInit (HobStart
);
277 // Allocate the EFI System Table and EFI Runtime Service Table from EfiRuntimeServicesData
278 // Use the templates to initialize the contents of the EFI System Table and EFI Runtime Services Table
280 gDxeCoreST
= AllocateRuntimeCopyPool (sizeof (EFI_SYSTEM_TABLE
), &mEfiSystemTableTemplate
);
281 ASSERT (gDxeCoreST
!= NULL
);
283 gDxeCoreRT
= AllocateRuntimeCopyPool (sizeof (EFI_RUNTIME_SERVICES
), &mEfiRuntimeServicesTableTemplate
);
284 ASSERT (gDxeCoreRT
!= NULL
);
286 gDxeCoreST
->RuntimeServices
= gDxeCoreRT
;
289 // Start the Image Services.
291 Status
= CoreInitializeImageServices (HobStart
);
292 ASSERT_EFI_ERROR (Status
);
295 // Initialize the Global Coherency Domain Services
297 Status
= CoreInitializeGcdServices (&HobStart
, MemoryBaseAddress
, MemoryLength
);
298 ASSERT_EFI_ERROR (Status
);
301 // Call constructor for all libraries
303 ProcessLibraryConstructorList (gDxeCoreImageHandle
, gDxeCoreST
);
304 PERF_END (NULL
,"PEI", NULL
, 0) ;
305 PERF_START (NULL
,"DXE", NULL
, 0) ;
308 // Report DXE Core image information to the PE/COFF Extra Action Library
310 ZeroMem (&ImageContext
, sizeof (ImageContext
));
311 ImageContext
.ImageAddress
= (EFI_PHYSICAL_ADDRESS
)(UINTN
)gDxeCoreLoadedImage
->ImageBase
;
312 ImageContext
.PdbPointer
= PeCoffLoaderGetPdbPointer ((VOID
*)(UINTN
)ImageContext
.ImageAddress
);
313 ImageContext
.SizeOfHeaders
= PeCoffGetSizeOfHeaders ((VOID
*)(UINTN
)ImageContext
.ImageAddress
);
314 Status
= PeCoffLoaderGetEntryPoint ((VOID
*)(UINTN
)ImageContext
.ImageAddress
, &EntryPoint
);
315 if (Status
== EFI_SUCCESS
) {
316 ImageContext
.EntryPoint
= (EFI_PHYSICAL_ADDRESS
)(UINTN
)EntryPoint
;
318 ImageContext
.Handle
= (VOID
*)(UINTN
)gDxeCoreLoadedImage
->ImageBase
;
319 ImageContext
.ImageRead
= PeCoffLoaderImageReadFromMemory
;
320 PeCoffLoaderRelocateImageExtraAction (&ImageContext
);
323 // Install the DXE Services Table into the EFI System Tables's Configuration Table
325 Status
= CoreInstallConfigurationTable (&gEfiDxeServicesTableGuid
, gDxeCoreDS
);
326 ASSERT_EFI_ERROR (Status
);
329 // Install the HOB List into the EFI System Tables's Configuration Table
331 Status
= CoreInstallConfigurationTable (&gEfiHobListGuid
, HobStart
);
332 ASSERT_EFI_ERROR (Status
);
335 // Install Memory Type Information Table into the EFI System Tables's Configuration Table
337 Status
= CoreInstallConfigurationTable (&gEfiMemoryTypeInformationGuid
, &gMemoryTypeInformation
);
338 ASSERT_EFI_ERROR (Status
);
341 // If Loading modules At fixed address feature is enabled, install Load moduels at fixed address
342 // Configuration Table so that user could easily to retrieve the top address to load Dxe and PEI
343 // Code and Tseg base to load SMM driver.
345 if (PcdGet64(PcdLoadModuleAtFixAddressEnable
) != 0) {
346 Status
= CoreInstallConfigurationTable (&gLoadFixedAddressConfigurationTableGuid
, &gLoadModuleAtFixAddressConfigurationTable
);
347 ASSERT_EFI_ERROR (Status
);
350 // Report Status Code here for DXE_ENTRY_POINT once it is available
354 (EFI_SOFTWARE_DXE_CORE
| EFI_SW_DXE_CORE_PC_ENTRY_POINT
)
358 // Create the aligned system table pointer structure that is used by external
359 // debuggers to locate the system table... Also, install debug image info
360 // configuration table.
362 CoreInitializeDebugImageInfoTable ();
363 CoreNewDebugImageInfoEntry (
364 EFI_DEBUG_IMAGE_INFO_TYPE_NORMAL
,
369 DEBUG ((DEBUG_INFO
| DEBUG_LOAD
, "HOBLIST address in DXE = 0x%p\n", HobStart
));
372 EFI_PEI_HOB_POINTERS Hob
;
374 for (Hob
.Raw
= HobStart
; !END_OF_HOB_LIST(Hob
); Hob
.Raw
= GET_NEXT_HOB(Hob
)) {
375 if (GET_HOB_TYPE (Hob
) == EFI_HOB_TYPE_MEMORY_ALLOCATION
) {
376 DEBUG ((DEBUG_INFO
| DEBUG_LOAD
, "Memory Allocation 0x%08x 0x%0lx - 0x%0lx\n", \
377 Hob
.MemoryAllocation
->AllocDescriptor
.MemoryType
, \
378 Hob
.MemoryAllocation
->AllocDescriptor
.MemoryBaseAddress
, \
379 Hob
.MemoryAllocation
->AllocDescriptor
.MemoryBaseAddress
+ Hob
.MemoryAllocation
->AllocDescriptor
.MemoryLength
- 1));
382 for (Hob
.Raw
= HobStart
; !END_OF_HOB_LIST(Hob
); Hob
.Raw
= GET_NEXT_HOB(Hob
)) {
383 if (GET_HOB_TYPE (Hob
) == EFI_HOB_TYPE_FV2
) {
384 DEBUG ((DEBUG_INFO
| DEBUG_LOAD
, "FV2 Hob 0x%0lx - 0x%0lx\n", Hob
.FirmwareVolume2
->BaseAddress
, Hob
.FirmwareVolume2
->BaseAddress
+ Hob
.FirmwareVolume2
->Length
- 1));
385 } else if (GET_HOB_TYPE (Hob
) == EFI_HOB_TYPE_FV
) {
386 DEBUG ((DEBUG_INFO
| DEBUG_LOAD
, "FV Hob 0x%0lx - 0x%0lx\n", Hob
.FirmwareVolume
->BaseAddress
, Hob
.FirmwareVolume
->BaseAddress
+ Hob
.FirmwareVolume
->Length
- 1));
392 // Initialize the Event Services
394 Status
= CoreInitializeEventServices ();
395 ASSERT_EFI_ERROR (Status
);
397 MemoryProfileInstallProtocol ();
399 CoreInitializePropertiesTable ();
400 CoreInitializeMemoryAttributesTable ();
403 // Get persisted vector hand-off info from GUIDeed HOB again due to HobStart may be updated,
404 // and install configuration table
406 GuidHob
= GetNextGuidHob (&gEfiVectorHandoffInfoPpiGuid
, HobStart
);
407 if (GuidHob
!= NULL
) {
408 VectorInfoList
= (EFI_VECTOR_HANDOFF_INFO
*) (GET_GUID_HOB_DATA(GuidHob
));
409 VectorInfo
= VectorInfoList
;
411 while (VectorInfo
->Attribute
!= EFI_VECTOR_HANDOFF_LAST_ENTRY
) {
415 VectorInfo
= AllocateCopyPool (sizeof (EFI_VECTOR_HANDOFF_INFO
) * Index
, (VOID
*) VectorInfoList
);
416 ASSERT (VectorInfo
!= NULL
);
417 Status
= CoreInstallConfigurationTable (&gEfiVectorHandoffTableGuid
, (VOID
*) VectorInfo
);
418 ASSERT_EFI_ERROR (Status
);
422 // Get the Protocols that were passed in from PEI to DXE through GUIDed HOBs
424 // These Protocols are not architectural. This implementation is sharing code between
425 // PEI and DXE in order to save FLASH space. These Protocols could also be implemented
426 // as part of the DXE Core. However, that would also require the DXE Core to be ported
427 // each time a different CPU is used, a different Decompression algorithm is used, or a
428 // different Image type is used. By placing these Protocols in PEI, the DXE Core remains
429 // generic, and only PEI and the Arch Protocols need to be ported from Platform to Platform,
430 // and from CPU to CPU.
434 // Publish the EFI, Tiano, and Custom Decompress protocols for use by other DXE components
436 Status
= CoreInstallMultipleProtocolInterfaces (
438 &gEfiDecompressProtocolGuid
, &gEfiDecompress
,
441 ASSERT_EFI_ERROR (Status
);
444 // Register for the GUIDs of the Architectural Protocols, so the rest of the
445 // EFI Boot Services and EFI Runtime Services tables can be filled in.
446 // Also register for the GUIDs of optional protocols.
448 CoreNotifyOnProtocolInstallation ();
451 // Produce Firmware Volume Protocols, one for each FV in the HOB list.
453 Status
= FwVolBlockDriverInit (gDxeCoreImageHandle
, gDxeCoreST
);
454 ASSERT_EFI_ERROR (Status
);
456 Status
= FwVolDriverInit (gDxeCoreImageHandle
, gDxeCoreST
);
457 ASSERT_EFI_ERROR (Status
);
460 // Produce the Section Extraction Protocol
462 Status
= InitializeSectionExtraction (gDxeCoreImageHandle
, gDxeCoreST
);
463 ASSERT_EFI_ERROR (Status
);
466 // Initialize the DXE Dispatcher
468 PERF_START (NULL
,"CoreInitializeDispatcher", "DxeMain", 0) ;
469 CoreInitializeDispatcher ();
470 PERF_END (NULL
,"CoreInitializeDispatcher", "DxeMain", 0) ;
473 // Invoke the DXE Dispatcher
475 PERF_START (NULL
, "CoreDispatcher", "DxeMain", 0);
477 PERF_END (NULL
, "CoreDispatcher", "DxeMain", 0);
480 // Display Architectural protocols that were not loaded if this is DEBUG build
483 CoreDisplayMissingArchProtocols ();
487 // Display any drivers that were not dispatched because dependency expression
488 // evaluated to false if this is a debug build
491 CoreDisplayDiscoveredNotDispatched ();
495 // Assert if the Architectural Protocols are not present.
497 Status
= CoreAllEfiServicesAvailable ();
498 if (EFI_ERROR(Status
)) {
500 // Report Status code that some Architectural Protocols are not present.
503 EFI_ERROR_CODE
| EFI_ERROR_MAJOR
,
504 (EFI_SOFTWARE_DXE_CORE
| EFI_SW_DXE_CORE_EC_NO_ARCH
)
507 ASSERT_EFI_ERROR (Status
);
510 // Report Status code before transfer control to BDS
514 (EFI_SOFTWARE_DXE_CORE
| EFI_SW_DXE_CORE_PC_HANDOFF_TO_NEXT
)
518 // Transfer control to the BDS Architectural Protocol
523 // BDS should never return
532 Place holder function until all the Boot Services and Runtime Services are
535 @return EFI_NOT_AVAILABLE_YET
540 CoreEfiNotAvailableYetArg0 (
545 // This function should never be executed. If it does, then the architectural protocols
546 // have not been designed correctly. The CpuBreakpoint () is commented out for now until the
547 // DXE Core and all the Architectural Protocols are complete.
550 return EFI_NOT_AVAILABLE_YET
;
555 Place holder function until all the Boot Services and Runtime Services are
558 @param Arg1 Undefined
560 @return EFI_NOT_AVAILABLE_YET
565 CoreEfiNotAvailableYetArg1 (
570 // This function should never be executed. If it does, then the architectural protocols
571 // have not been designed correctly. The CpuBreakpoint () is commented out for now until the
572 // DXE Core and all the Architectural Protocols are complete.
575 return EFI_NOT_AVAILABLE_YET
;
580 Place holder function until all the Boot Services and Runtime Services are available.
582 @param Arg1 Undefined
583 @param Arg2 Undefined
585 @return EFI_NOT_AVAILABLE_YET
590 CoreEfiNotAvailableYetArg2 (
596 // This function should never be executed. If it does, then the architectural protocols
597 // have not been designed correctly. The CpuBreakpoint () is commented out for now until the
598 // DXE Core and all the Architectural Protocols are complete.
601 return EFI_NOT_AVAILABLE_YET
;
606 Place holder function until all the Boot Services and Runtime Services are available.
608 @param Arg1 Undefined
609 @param Arg2 Undefined
610 @param Arg3 Undefined
612 @return EFI_NOT_AVAILABLE_YET
617 CoreEfiNotAvailableYetArg3 (
624 // This function should never be executed. If it does, then the architectural protocols
625 // have not been designed correctly. The CpuBreakpoint () is commented out for now until the
626 // DXE Core and all the Architectural Protocols are complete.
629 return EFI_NOT_AVAILABLE_YET
;
634 Place holder function until all the Boot Services and Runtime Services are available.
636 @param Arg1 Undefined
637 @param Arg2 Undefined
638 @param Arg3 Undefined
639 @param Arg4 Undefined
641 @return EFI_NOT_AVAILABLE_YET
646 CoreEfiNotAvailableYetArg4 (
654 // This function should never be executed. If it does, then the architectural protocols
655 // have not been designed correctly. The CpuBreakpoint () is commented out for now until the
656 // DXE Core and all the Architectural Protocols are complete.
659 return EFI_NOT_AVAILABLE_YET
;
664 Place holder function until all the Boot Services and Runtime Services are available.
666 @param Arg1 Undefined
667 @param Arg2 Undefined
668 @param Arg3 Undefined
669 @param Arg4 Undefined
670 @param Arg5 Undefined
672 @return EFI_NOT_AVAILABLE_YET
677 CoreEfiNotAvailableYetArg5 (
686 // This function should never be executed. If it does, then the architectural protocols
687 // have not been designed correctly. The CpuBreakpoint () is commented out for now until the
688 // DXE Core and all the Architectural Protocols are complete.
691 return EFI_NOT_AVAILABLE_YET
;
696 Calcualte the 32-bit CRC in a EFI table using the service provided by the
699 @param Hdr Pointer to an EFI standard header
704 IN OUT EFI_TABLE_HEADER
*Hdr
712 // If gBS->CalculateCrce32 () == CoreEfiNotAvailableYet () then
713 // Crc will come back as zero if we set it to zero here
716 gBS
->CalculateCrc32 ((UINT8
*)Hdr
, Hdr
->HeaderSize
, &Crc
);
722 Terminates all boot services.
724 @param ImageHandle Handle that identifies the exiting image.
725 @param MapKey Key to the latest memory map.
727 @retval EFI_SUCCESS Boot Services terminated
728 @retval EFI_INVALID_PARAMETER MapKey is incorrect.
733 CoreExitBootServices (
734 IN EFI_HANDLE ImageHandle
,
743 gTimer
->SetTimerPeriod (gTimer
, 0);
746 // Terminate memory services if the MapKey matches
748 Status
= CoreTerminateMemoryMap (MapKey
);
749 if (EFI_ERROR (Status
)) {
751 // Notify other drivers that ExitBootServices fail
753 CoreNotifySignalList (&gEventExitBootServicesFailedGuid
);
757 gMemoryMapTerminated
= TRUE
;
760 // Notify other drivers that we are exiting boot services.
762 CoreNotifySignalList (&gEfiEventExitBootServicesGuid
);
765 // Report that ExitBootServices() has been called
769 (EFI_SOFTWARE_EFI_BOOT_SERVICE
| EFI_SW_BS_PC_EXIT_BOOT_SERVICES
)
773 // Disable interrupt of Debug timer.
775 SaveAndSetDebugTimerInterrupt (FALSE
);
778 // Disable CPU Interrupts
780 gCpu
->DisableInterrupt (gCpu
);
783 // Clear the non-runtime values of the EFI System Table
785 gDxeCoreST
->BootServices
= NULL
;
786 gDxeCoreST
->ConIn
= NULL
;
787 gDxeCoreST
->ConsoleInHandle
= NULL
;
788 gDxeCoreST
->ConOut
= NULL
;
789 gDxeCoreST
->ConsoleOutHandle
= NULL
;
790 gDxeCoreST
->StdErr
= NULL
;
791 gDxeCoreST
->StandardErrorHandle
= NULL
;
794 // Recompute the 32-bit CRC of the EFI System Table
796 CalculateEfiHdrCrc (&gDxeCoreST
->Hdr
);
799 // Zero out the Boot Service Table
801 ZeroMem (gBS
, sizeof (EFI_BOOT_SERVICES
));
805 // Update the AtRuntime field in Runtiem AP.
807 gRuntime
->AtRuntime
= TRUE
;
814 Given a compressed source buffer, this function retrieves the size of the
815 uncompressed buffer and the size of the scratch buffer required to decompress
816 the compressed source buffer.
818 The GetInfo() function retrieves the size of the uncompressed buffer and the
819 temporary scratch buffer required to decompress the buffer specified by Source
820 and SourceSize. If the size of the uncompressed buffer or the size of the
821 scratch buffer cannot be determined from the compressed data specified by
822 Source and SourceData, then EFI_INVALID_PARAMETER is returned. Otherwise, the
823 size of the uncompressed buffer is returned in DestinationSize, the size of
824 the scratch buffer is returned in ScratchSize, and EFI_SUCCESS is returned.
825 The GetInfo() function does not have scratch buffer available to perform a
826 thorough checking of the validity of the source data. It just retrieves the
827 "Original Size" field from the beginning bytes of the source data and output
828 it as DestinationSize. And ScratchSize is specific to the decompression
831 @param This A pointer to the EFI_DECOMPRESS_PROTOCOL instance.
832 @param Source The source buffer containing the compressed data.
833 @param SourceSize The size, in bytes, of the source buffer.
834 @param DestinationSize A pointer to the size, in bytes, of the
835 uncompressed buffer that will be generated when the
836 compressed buffer specified by Source and
837 SourceSize is decompressed.
838 @param ScratchSize A pointer to the size, in bytes, of the scratch
839 buffer that is required to decompress the
840 compressed buffer specified by Source and
843 @retval EFI_SUCCESS The size of the uncompressed data was returned in
844 DestinationSize and the size of the scratch buffer
845 was returned in ScratchSize.
846 @retval EFI_INVALID_PARAMETER The size of the uncompressed data or the size of
847 the scratch buffer cannot be determined from the
848 compressed data specified by Source and
854 DxeMainUefiDecompressGetInfo (
855 IN EFI_DECOMPRESS_PROTOCOL
*This
,
857 IN UINT32 SourceSize
,
858 OUT UINT32
*DestinationSize
,
859 OUT UINT32
*ScratchSize
862 if (Source
== NULL
|| DestinationSize
== NULL
|| ScratchSize
== NULL
) {
863 return EFI_INVALID_PARAMETER
;
865 return UefiDecompressGetInfo (Source
, SourceSize
, DestinationSize
, ScratchSize
);
870 Decompresses a compressed source buffer.
872 The Decompress() function extracts decompressed data to its original form.
873 This protocol is designed so that the decompression algorithm can be
874 implemented without using any memory services. As a result, the Decompress()
875 Function is not allowed to call AllocatePool() or AllocatePages() in its
876 implementation. It is the caller's responsibility to allocate and free the
877 Destination and Scratch buffers.
878 If the compressed source data specified by Source and SourceSize is
879 successfully decompressed into Destination, then EFI_SUCCESS is returned. If
880 the compressed source data specified by Source and SourceSize is not in a
881 valid compressed data format, then EFI_INVALID_PARAMETER is returned.
883 @param This A pointer to the EFI_DECOMPRESS_PROTOCOL instance.
884 @param Source The source buffer containing the compressed data.
885 @param SourceSize SourceSizeThe size of source data.
886 @param Destination On output, the destination buffer that contains
887 the uncompressed data.
888 @param DestinationSize The size of the destination buffer. The size of
889 the destination buffer needed is obtained from
890 EFI_DECOMPRESS_PROTOCOL.GetInfo().
891 @param Scratch A temporary scratch buffer that is used to perform
893 @param ScratchSize The size of scratch buffer. The size of the
894 scratch buffer needed is obtained from GetInfo().
896 @retval EFI_SUCCESS Decompression completed successfully, and the
897 uncompressed buffer is returned in Destination.
898 @retval EFI_INVALID_PARAMETER The source buffer specified by Source and
899 SourceSize is corrupted (not in a valid
905 DxeMainUefiDecompress (
906 IN EFI_DECOMPRESS_PROTOCOL
*This
,
908 IN UINT32 SourceSize
,
909 IN OUT VOID
*Destination
,
910 IN UINT32 DestinationSize
,
911 IN OUT VOID
*Scratch
,
912 IN UINT32 ScratchSize
916 UINT32 TestDestinationSize
;
917 UINT32 TestScratchSize
;
919 if (Source
== NULL
|| Destination
== NULL
|| Scratch
== NULL
) {
920 return EFI_INVALID_PARAMETER
;
923 Status
= UefiDecompressGetInfo (Source
, SourceSize
, &TestDestinationSize
, &TestScratchSize
);
924 if (EFI_ERROR (Status
)) {
928 if (ScratchSize
< TestScratchSize
|| DestinationSize
< TestDestinationSize
) {
929 return RETURN_INVALID_PARAMETER
;
932 return UefiDecompress (Source
, Destination
, Scratch
);