2 DXE Core Main Entry Point
4 Copyright (c) 2006 - 2018, Intel Corporation. All rights reserved.<BR>
5 SPDX-License-Identifier: BSD-2-Clause-Patent
12 // DXE Core Global Variables for Protocols from PEI
14 EFI_HANDLE mDecompressHandle
= NULL
;
17 // DXE Core globals for Architecture Protocols
19 EFI_SECURITY_ARCH_PROTOCOL
*gSecurity
= NULL
;
20 EFI_SECURITY2_ARCH_PROTOCOL
*gSecurity2
= NULL
;
21 EFI_CPU_ARCH_PROTOCOL
*gCpu
= NULL
;
22 EFI_METRONOME_ARCH_PROTOCOL
*gMetronome
= NULL
;
23 EFI_TIMER_ARCH_PROTOCOL
*gTimer
= NULL
;
24 EFI_BDS_ARCH_PROTOCOL
*gBds
= NULL
;
25 EFI_WATCHDOG_TIMER_ARCH_PROTOCOL
*gWatchdogTimer
= NULL
;
28 // DXE Core globals for optional protocol dependencies
30 EFI_SMM_BASE2_PROTOCOL
*gSmmBase2
= NULL
;
33 // DXE Core Global used to update core loaded image protocol handle
35 EFI_GUID
*gDxeCoreFileName
;
36 EFI_LOADED_IMAGE_PROTOCOL
*gDxeCoreLoadedImage
;
39 // DXE Core Module Variables
41 EFI_BOOT_SERVICES mBootServices
= {
43 EFI_BOOT_SERVICES_SIGNATURE
, // Signature
44 EFI_BOOT_SERVICES_REVISION
, // Revision
45 sizeof (EFI_BOOT_SERVICES
), // HeaderSize
49 (EFI_RAISE_TPL
) CoreRaiseTpl
, // RaiseTPL
50 (EFI_RESTORE_TPL
) CoreRestoreTpl
, // RestoreTPL
51 (EFI_ALLOCATE_PAGES
) CoreAllocatePages
, // AllocatePages
52 (EFI_FREE_PAGES
) CoreFreePages
, // FreePages
53 (EFI_GET_MEMORY_MAP
) CoreGetMemoryMap
, // GetMemoryMap
54 (EFI_ALLOCATE_POOL
) CoreAllocatePool
, // AllocatePool
55 (EFI_FREE_POOL
) CoreFreePool
, // FreePool
56 (EFI_CREATE_EVENT
) CoreCreateEvent
, // CreateEvent
57 (EFI_SET_TIMER
) CoreSetTimer
, // SetTimer
58 (EFI_WAIT_FOR_EVENT
) CoreWaitForEvent
, // WaitForEvent
59 (EFI_SIGNAL_EVENT
) CoreSignalEvent
, // SignalEvent
60 (EFI_CLOSE_EVENT
) CoreCloseEvent
, // CloseEvent
61 (EFI_CHECK_EVENT
) CoreCheckEvent
, // CheckEvent
62 (EFI_INSTALL_PROTOCOL_INTERFACE
) CoreInstallProtocolInterface
, // InstallProtocolInterface
63 (EFI_REINSTALL_PROTOCOL_INTERFACE
) CoreReinstallProtocolInterface
, // ReinstallProtocolInterface
64 (EFI_UNINSTALL_PROTOCOL_INTERFACE
) CoreUninstallProtocolInterface
, // UninstallProtocolInterface
65 (EFI_HANDLE_PROTOCOL
) CoreHandleProtocol
, // HandleProtocol
66 (VOID
*) NULL
, // Reserved
67 (EFI_REGISTER_PROTOCOL_NOTIFY
) CoreRegisterProtocolNotify
, // RegisterProtocolNotify
68 (EFI_LOCATE_HANDLE
) CoreLocateHandle
, // LocateHandle
69 (EFI_LOCATE_DEVICE_PATH
) CoreLocateDevicePath
, // LocateDevicePath
70 (EFI_INSTALL_CONFIGURATION_TABLE
) CoreInstallConfigurationTable
, // InstallConfigurationTable
71 (EFI_IMAGE_LOAD
) CoreLoadImage
, // LoadImage
72 (EFI_IMAGE_START
) CoreStartImage
, // StartImage
73 (EFI_EXIT
) CoreExit
, // Exit
74 (EFI_IMAGE_UNLOAD
) CoreUnloadImage
, // UnloadImage
75 (EFI_EXIT_BOOT_SERVICES
) CoreExitBootServices
, // ExitBootServices
76 (EFI_GET_NEXT_MONOTONIC_COUNT
) CoreEfiNotAvailableYetArg1
, // GetNextMonotonicCount
77 (EFI_STALL
) CoreStall
, // Stall
78 (EFI_SET_WATCHDOG_TIMER
) CoreSetWatchdogTimer
, // SetWatchdogTimer
79 (EFI_CONNECT_CONTROLLER
) CoreConnectController
, // ConnectController
80 (EFI_DISCONNECT_CONTROLLER
) CoreDisconnectController
, // DisconnectController
81 (EFI_OPEN_PROTOCOL
) CoreOpenProtocol
, // OpenProtocol
82 (EFI_CLOSE_PROTOCOL
) CoreCloseProtocol
, // CloseProtocol
83 (EFI_OPEN_PROTOCOL_INFORMATION
) CoreOpenProtocolInformation
, // OpenProtocolInformation
84 (EFI_PROTOCOLS_PER_HANDLE
) CoreProtocolsPerHandle
, // ProtocolsPerHandle
85 (EFI_LOCATE_HANDLE_BUFFER
) CoreLocateHandleBuffer
, // LocateHandleBuffer
86 (EFI_LOCATE_PROTOCOL
) CoreLocateProtocol
, // LocateProtocol
87 (EFI_INSTALL_MULTIPLE_PROTOCOL_INTERFACES
) CoreInstallMultipleProtocolInterfaces
, // InstallMultipleProtocolInterfaces
88 (EFI_UNINSTALL_MULTIPLE_PROTOCOL_INTERFACES
) CoreUninstallMultipleProtocolInterfaces
, // UninstallMultipleProtocolInterfaces
89 (EFI_CALCULATE_CRC32
) CoreEfiNotAvailableYetArg3
, // CalculateCrc32
90 (EFI_COPY_MEM
) CopyMem
, // CopyMem
91 (EFI_SET_MEM
) SetMem
, // SetMem
92 (EFI_CREATE_EVENT_EX
) CoreCreateEventEx
// CreateEventEx
95 EFI_DXE_SERVICES mDxeServices
= {
97 DXE_SERVICES_SIGNATURE
, // Signature
98 DXE_SERVICES_REVISION
, // Revision
99 sizeof (DXE_SERVICES
), // HeaderSize
103 (EFI_ADD_MEMORY_SPACE
) CoreAddMemorySpace
, // AddMemorySpace
104 (EFI_ALLOCATE_MEMORY_SPACE
) CoreAllocateMemorySpace
, // AllocateMemorySpace
105 (EFI_FREE_MEMORY_SPACE
) CoreFreeMemorySpace
, // FreeMemorySpace
106 (EFI_REMOVE_MEMORY_SPACE
) CoreRemoveMemorySpace
, // RemoveMemorySpace
107 (EFI_GET_MEMORY_SPACE_DESCRIPTOR
) CoreGetMemorySpaceDescriptor
, // GetMemorySpaceDescriptor
108 (EFI_SET_MEMORY_SPACE_ATTRIBUTES
) CoreSetMemorySpaceAttributes
, // SetMemorySpaceAttributes
109 (EFI_GET_MEMORY_SPACE_MAP
) CoreGetMemorySpaceMap
, // GetMemorySpaceMap
110 (EFI_ADD_IO_SPACE
) CoreAddIoSpace
, // AddIoSpace
111 (EFI_ALLOCATE_IO_SPACE
) CoreAllocateIoSpace
, // AllocateIoSpace
112 (EFI_FREE_IO_SPACE
) CoreFreeIoSpace
, // FreeIoSpace
113 (EFI_REMOVE_IO_SPACE
) CoreRemoveIoSpace
, // RemoveIoSpace
114 (EFI_GET_IO_SPACE_DESCRIPTOR
) CoreGetIoSpaceDescriptor
, // GetIoSpaceDescriptor
115 (EFI_GET_IO_SPACE_MAP
) CoreGetIoSpaceMap
, // GetIoSpaceMap
116 (EFI_DISPATCH
) CoreDispatcher
, // Dispatch
117 (EFI_SCHEDULE
) CoreSchedule
, // Schedule
118 (EFI_TRUST
) CoreTrust
, // Trust
119 (EFI_PROCESS_FIRMWARE_VOLUME
) CoreProcessFirmwareVolume
, // ProcessFirmwareVolume
120 (EFI_SET_MEMORY_SPACE_CAPABILITIES
)CoreSetMemorySpaceCapabilities
, // SetMemorySpaceCapabilities
123 EFI_SYSTEM_TABLE mEfiSystemTableTemplate
= {
125 EFI_SYSTEM_TABLE_SIGNATURE
, // Signature
126 EFI_SYSTEM_TABLE_REVISION
, // Revision
127 sizeof (EFI_SYSTEM_TABLE
), // HeaderSize
131 NULL
, // FirmwareVendor
132 0, // FirmwareRevision
133 NULL
, // ConsoleInHandle
135 NULL
, // ConsoleOutHandle
137 NULL
, // StandardErrorHandle
139 NULL
, // RuntimeServices
140 &mBootServices
, // BootServices
141 0, // NumberOfConfigurationTableEntries
142 NULL
// ConfigurationTable
145 EFI_RUNTIME_SERVICES mEfiRuntimeServicesTableTemplate
= {
147 EFI_RUNTIME_SERVICES_SIGNATURE
, // Signature
148 EFI_RUNTIME_SERVICES_REVISION
, // Revision
149 sizeof (EFI_RUNTIME_SERVICES
), // HeaderSize
153 (EFI_GET_TIME
) CoreEfiNotAvailableYetArg2
, // GetTime
154 (EFI_SET_TIME
) CoreEfiNotAvailableYetArg1
, // SetTime
155 (EFI_GET_WAKEUP_TIME
) CoreEfiNotAvailableYetArg3
, // GetWakeupTime
156 (EFI_SET_WAKEUP_TIME
) CoreEfiNotAvailableYetArg2
, // SetWakeupTime
157 (EFI_SET_VIRTUAL_ADDRESS_MAP
) CoreEfiNotAvailableYetArg4
, // SetVirtualAddressMap
158 (EFI_CONVERT_POINTER
) CoreEfiNotAvailableYetArg2
, // ConvertPointer
159 (EFI_GET_VARIABLE
) CoreEfiNotAvailableYetArg5
, // GetVariable
160 (EFI_GET_NEXT_VARIABLE_NAME
) CoreEfiNotAvailableYetArg3
, // GetNextVariableName
161 (EFI_SET_VARIABLE
) CoreEfiNotAvailableYetArg5
, // SetVariable
162 (EFI_GET_NEXT_HIGH_MONO_COUNT
) CoreEfiNotAvailableYetArg1
, // GetNextHighMonotonicCount
163 (EFI_RESET_SYSTEM
) CoreEfiNotAvailableYetArg4
, // ResetSystem
164 (EFI_UPDATE_CAPSULE
) CoreEfiNotAvailableYetArg3
, // UpdateCapsule
165 (EFI_QUERY_CAPSULE_CAPABILITIES
) CoreEfiNotAvailableYetArg4
, // QueryCapsuleCapabilities
166 (EFI_QUERY_VARIABLE_INFO
) CoreEfiNotAvailableYetArg4
// QueryVariableInfo
169 EFI_RUNTIME_ARCH_PROTOCOL gRuntimeTemplate
= {
170 INITIALIZE_LIST_HEAD_VARIABLE (gRuntimeTemplate
.ImageHead
),
171 INITIALIZE_LIST_HEAD_VARIABLE (gRuntimeTemplate
.EventHead
),
174 // Make sure Size != sizeof (EFI_MEMORY_DESCRIPTOR). This will
175 // prevent people from having pointer math bugs in their code.
176 // now you have to use *DescriptorSize to make things work.
178 sizeof (EFI_MEMORY_DESCRIPTOR
) + sizeof (UINT64
) - (sizeof (EFI_MEMORY_DESCRIPTOR
) % sizeof (UINT64
)),
179 EFI_MEMORY_DESCRIPTOR_VERSION
,
187 EFI_RUNTIME_ARCH_PROTOCOL
*gRuntime
= &gRuntimeTemplate
;
190 // DXE Core Global Variables for the EFI System Table, Boot Services Table,
191 // DXE Services Table, and Runtime Services Table
193 EFI_DXE_SERVICES
*gDxeCoreDS
= &mDxeServices
;
194 EFI_SYSTEM_TABLE
*gDxeCoreST
= NULL
;
197 // For debug initialize gDxeCoreRT to template. gDxeCoreRT must be allocated from RT memory
198 // but gDxeCoreRT is used for ASSERT () and DEBUG () type macros so lets give it
199 // a value that will not cause debug infrastructure to crash early on.
201 EFI_RUNTIME_SERVICES
*gDxeCoreRT
= &mEfiRuntimeServicesTableTemplate
;
202 EFI_HANDLE gDxeCoreImageHandle
= NULL
;
204 BOOLEAN gMemoryMapTerminated
= FALSE
;
207 // EFI Decompress Protocol
209 EFI_DECOMPRESS_PROTOCOL gEfiDecompress
= {
210 DxeMainUefiDecompressGetInfo
,
211 DxeMainUefiDecompress
215 // For Loading modules at fixed address feature, the configuration table is to cache the top address below which to load
216 // Runtime code&boot time code
218 GLOBAL_REMOVE_IF_UNREFERENCED EFI_LOAD_FIXED_ADDRESS_CONFIGURATION_TABLE gLoadModuleAtFixAddressConfigurationTable
= {0, 0};
220 // Main entry point to the DXE Core
224 Main entry point to DXE Core.
226 @param HobStart Pointer to the beginning of the HOB List from PEI.
228 @return This function should never return.
238 EFI_PHYSICAL_ADDRESS MemoryBaseAddress
;
240 PE_COFF_LOADER_IMAGE_CONTEXT ImageContext
;
242 EFI_HOB_GUID_TYPE
*GuidHob
;
243 EFI_VECTOR_HANDOFF_INFO
*VectorInfoList
;
244 EFI_VECTOR_HANDOFF_INFO
*VectorInfo
;
248 // Setup the default exception handlers
250 VectorInfoList
= NULL
;
251 GuidHob
= GetNextGuidHob (&gEfiVectorHandoffInfoPpiGuid
, HobStart
);
252 if (GuidHob
!= NULL
) {
253 VectorInfoList
= (EFI_VECTOR_HANDOFF_INFO
*) (GET_GUID_HOB_DATA(GuidHob
));
255 Status
= InitializeCpuExceptionHandlersEx (VectorInfoList
, NULL
);
256 ASSERT_EFI_ERROR (Status
);
259 // Initialize Debug Agent to support source level debug in DXE phase
261 InitializeDebugAgent (DEBUG_AGENT_INIT_DXE_CORE
, HobStart
, NULL
);
264 // Initialize Memory Services
266 CoreInitializeMemoryServices (&HobStart
, &MemoryBaseAddress
, &MemoryLength
);
268 MemoryProfileInit (HobStart
);
271 // Allocate the EFI System Table and EFI Runtime Service Table from EfiRuntimeServicesData
272 // Use the templates to initialize the contents of the EFI System Table and EFI Runtime Services Table
274 gDxeCoreST
= AllocateRuntimeCopyPool (sizeof (EFI_SYSTEM_TABLE
), &mEfiSystemTableTemplate
);
275 ASSERT (gDxeCoreST
!= NULL
);
277 gDxeCoreRT
= AllocateRuntimeCopyPool (sizeof (EFI_RUNTIME_SERVICES
), &mEfiRuntimeServicesTableTemplate
);
278 ASSERT (gDxeCoreRT
!= NULL
);
280 gDxeCoreST
->RuntimeServices
= gDxeCoreRT
;
283 // Start the Image Services.
285 Status
= CoreInitializeImageServices (HobStart
);
286 ASSERT_EFI_ERROR (Status
);
289 // Initialize the Global Coherency Domain Services
291 Status
= CoreInitializeGcdServices (&HobStart
, MemoryBaseAddress
, MemoryLength
);
292 ASSERT_EFI_ERROR (Status
);
295 // Call constructor for all libraries
297 ProcessLibraryConstructorList (gDxeCoreImageHandle
, gDxeCoreST
);
298 PERF_CROSSMODULE_END ("PEI");
299 PERF_CROSSMODULE_BEGIN ("DXE");
302 // Report DXE Core image information to the PE/COFF Extra Action Library
304 ZeroMem (&ImageContext
, sizeof (ImageContext
));
305 ImageContext
.ImageAddress
= (EFI_PHYSICAL_ADDRESS
)(UINTN
)gDxeCoreLoadedImage
->ImageBase
;
306 ImageContext
.PdbPointer
= PeCoffLoaderGetPdbPointer ((VOID
*)(UINTN
)ImageContext
.ImageAddress
);
307 ImageContext
.SizeOfHeaders
= PeCoffGetSizeOfHeaders ((VOID
*)(UINTN
)ImageContext
.ImageAddress
);
308 Status
= PeCoffLoaderGetEntryPoint ((VOID
*)(UINTN
)ImageContext
.ImageAddress
, &EntryPoint
);
309 if (Status
== EFI_SUCCESS
) {
310 ImageContext
.EntryPoint
= (EFI_PHYSICAL_ADDRESS
)(UINTN
)EntryPoint
;
312 ImageContext
.Handle
= (VOID
*)(UINTN
)gDxeCoreLoadedImage
->ImageBase
;
313 ImageContext
.ImageRead
= PeCoffLoaderImageReadFromMemory
;
314 PeCoffLoaderRelocateImageExtraAction (&ImageContext
);
317 // Install the DXE Services Table into the EFI System Tables's Configuration Table
319 Status
= CoreInstallConfigurationTable (&gEfiDxeServicesTableGuid
, gDxeCoreDS
);
320 ASSERT_EFI_ERROR (Status
);
323 // Install the HOB List into the EFI System Tables's Configuration Table
325 Status
= CoreInstallConfigurationTable (&gEfiHobListGuid
, HobStart
);
326 ASSERT_EFI_ERROR (Status
);
329 // Install Memory Type Information Table into the EFI System Tables's Configuration Table
331 Status
= CoreInstallConfigurationTable (&gEfiMemoryTypeInformationGuid
, &gMemoryTypeInformation
);
332 ASSERT_EFI_ERROR (Status
);
335 // If Loading modules At fixed address feature is enabled, install Load moduels at fixed address
336 // Configuration Table so that user could easily to retrieve the top address to load Dxe and PEI
337 // Code and Tseg base to load SMM driver.
339 if (PcdGet64(PcdLoadModuleAtFixAddressEnable
) != 0) {
340 Status
= CoreInstallConfigurationTable (&gLoadFixedAddressConfigurationTableGuid
, &gLoadModuleAtFixAddressConfigurationTable
);
341 ASSERT_EFI_ERROR (Status
);
344 // Report Status Code here for DXE_ENTRY_POINT once it is available
348 (EFI_SOFTWARE_DXE_CORE
| EFI_SW_DXE_CORE_PC_ENTRY_POINT
)
352 // Create the aligned system table pointer structure that is used by external
353 // debuggers to locate the system table... Also, install debug image info
354 // configuration table.
356 CoreInitializeDebugImageInfoTable ();
357 CoreNewDebugImageInfoEntry (
358 EFI_DEBUG_IMAGE_INFO_TYPE_NORMAL
,
363 DEBUG ((DEBUG_INFO
| DEBUG_LOAD
, "HOBLIST address in DXE = 0x%p\n", HobStart
));
366 EFI_PEI_HOB_POINTERS Hob
;
368 for (Hob
.Raw
= HobStart
; !END_OF_HOB_LIST(Hob
); Hob
.Raw
= GET_NEXT_HOB(Hob
)) {
369 if (GET_HOB_TYPE (Hob
) == EFI_HOB_TYPE_MEMORY_ALLOCATION
) {
370 DEBUG ((DEBUG_INFO
| DEBUG_LOAD
, "Memory Allocation 0x%08x 0x%0lx - 0x%0lx\n", \
371 Hob
.MemoryAllocation
->AllocDescriptor
.MemoryType
, \
372 Hob
.MemoryAllocation
->AllocDescriptor
.MemoryBaseAddress
, \
373 Hob
.MemoryAllocation
->AllocDescriptor
.MemoryBaseAddress
+ Hob
.MemoryAllocation
->AllocDescriptor
.MemoryLength
- 1));
376 for (Hob
.Raw
= HobStart
; !END_OF_HOB_LIST(Hob
); Hob
.Raw
= GET_NEXT_HOB(Hob
)) {
377 if (GET_HOB_TYPE (Hob
) == EFI_HOB_TYPE_FV
) {
379 DEBUG_INFO
| DEBUG_LOAD
,
380 "FV Hob 0x%0lx - 0x%0lx\n",
381 Hob
.FirmwareVolume
->BaseAddress
,
382 Hob
.FirmwareVolume
->BaseAddress
+ Hob
.FirmwareVolume
->Length
- 1
384 } else if (GET_HOB_TYPE (Hob
) == EFI_HOB_TYPE_FV2
) {
386 DEBUG_INFO
| DEBUG_LOAD
,
387 "FV2 Hob 0x%0lx - 0x%0lx\n",
388 Hob
.FirmwareVolume2
->BaseAddress
,
389 Hob
.FirmwareVolume2
->BaseAddress
+ Hob
.FirmwareVolume2
->Length
- 1
392 DEBUG_INFO
| DEBUG_LOAD
,
394 &Hob
.FirmwareVolume2
->FvName
,
395 &Hob
.FirmwareVolume2
->FileName
397 } else if (GET_HOB_TYPE (Hob
) == EFI_HOB_TYPE_FV3
) {
399 DEBUG_INFO
| DEBUG_LOAD
,
400 "FV3 Hob 0x%0lx - 0x%0lx - 0x%x - 0x%x\n",
401 Hob
.FirmwareVolume3
->BaseAddress
,
402 Hob
.FirmwareVolume3
->BaseAddress
+ Hob
.FirmwareVolume3
->Length
- 1,
403 Hob
.FirmwareVolume3
->AuthenticationStatus
,
404 Hob
.FirmwareVolume3
->ExtractedFv
406 if (Hob
.FirmwareVolume3
->ExtractedFv
) {
408 DEBUG_INFO
| DEBUG_LOAD
,
410 &Hob
.FirmwareVolume3
->FvName
,
411 &Hob
.FirmwareVolume3
->FileName
419 // Initialize the Event Services
421 Status
= CoreInitializeEventServices ();
422 ASSERT_EFI_ERROR (Status
);
424 MemoryProfileInstallProtocol ();
426 CoreInitializeMemoryAttributesTable ();
427 CoreInitializeMemoryProtection ();
430 // Get persisted vector hand-off info from GUIDeed HOB again due to HobStart may be updated,
431 // and install configuration table
433 GuidHob
= GetNextGuidHob (&gEfiVectorHandoffInfoPpiGuid
, HobStart
);
434 if (GuidHob
!= NULL
) {
435 VectorInfoList
= (EFI_VECTOR_HANDOFF_INFO
*) (GET_GUID_HOB_DATA(GuidHob
));
436 VectorInfo
= VectorInfoList
;
438 while (VectorInfo
->Attribute
!= EFI_VECTOR_HANDOFF_LAST_ENTRY
) {
442 VectorInfo
= AllocateCopyPool (sizeof (EFI_VECTOR_HANDOFF_INFO
) * Index
, (VOID
*) VectorInfoList
);
443 ASSERT (VectorInfo
!= NULL
);
444 Status
= CoreInstallConfigurationTable (&gEfiVectorHandoffTableGuid
, (VOID
*) VectorInfo
);
445 ASSERT_EFI_ERROR (Status
);
449 // Get the Protocols that were passed in from PEI to DXE through GUIDed HOBs
451 // These Protocols are not architectural. This implementation is sharing code between
452 // PEI and DXE in order to save FLASH space. These Protocols could also be implemented
453 // as part of the DXE Core. However, that would also require the DXE Core to be ported
454 // each time a different CPU is used, a different Decompression algorithm is used, or a
455 // different Image type is used. By placing these Protocols in PEI, the DXE Core remains
456 // generic, and only PEI and the Arch Protocols need to be ported from Platform to Platform,
457 // and from CPU to CPU.
461 // Publish the EFI, Tiano, and Custom Decompress protocols for use by other DXE components
463 Status
= CoreInstallMultipleProtocolInterfaces (
465 &gEfiDecompressProtocolGuid
, &gEfiDecompress
,
468 ASSERT_EFI_ERROR (Status
);
471 // Register for the GUIDs of the Architectural Protocols, so the rest of the
472 // EFI Boot Services and EFI Runtime Services tables can be filled in.
473 // Also register for the GUIDs of optional protocols.
475 CoreNotifyOnProtocolInstallation ();
478 // Produce Firmware Volume Protocols, one for each FV in the HOB list.
480 Status
= FwVolBlockDriverInit (gDxeCoreImageHandle
, gDxeCoreST
);
481 ASSERT_EFI_ERROR (Status
);
483 Status
= FwVolDriverInit (gDxeCoreImageHandle
, gDxeCoreST
);
484 ASSERT_EFI_ERROR (Status
);
487 // Produce the Section Extraction Protocol
489 Status
= InitializeSectionExtraction (gDxeCoreImageHandle
, gDxeCoreST
);
490 ASSERT_EFI_ERROR (Status
);
493 // Initialize the DXE Dispatcher
495 CoreInitializeDispatcher ();
498 // Invoke the DXE Dispatcher
503 // Display Architectural protocols that were not loaded if this is DEBUG build
506 CoreDisplayMissingArchProtocols ();
510 // Display any drivers that were not dispatched because dependency expression
511 // evaluated to false if this is a debug build
514 CoreDisplayDiscoveredNotDispatched ();
518 // Assert if the Architectural Protocols are not present.
520 Status
= CoreAllEfiServicesAvailable ();
521 if (EFI_ERROR(Status
)) {
523 // Report Status code that some Architectural Protocols are not present.
526 EFI_ERROR_CODE
| EFI_ERROR_MAJOR
,
527 (EFI_SOFTWARE_DXE_CORE
| EFI_SW_DXE_CORE_EC_NO_ARCH
)
530 ASSERT_EFI_ERROR (Status
);
533 // Report Status code before transfer control to BDS
537 (EFI_SOFTWARE_DXE_CORE
| EFI_SW_DXE_CORE_PC_HANDOFF_TO_NEXT
)
541 // Transfer control to the BDS Architectural Protocol
546 // BDS should never return
558 Place holder function until all the Boot Services and Runtime Services are
561 @param Arg1 Undefined
563 @return EFI_NOT_AVAILABLE_YET
568 CoreEfiNotAvailableYetArg1 (
573 // This function should never be executed. If it does, then the architectural protocols
574 // have not been designed correctly. The CpuBreakpoint () is commented out for now until the
575 // DXE Core and all the Architectural Protocols are complete.
578 return EFI_NOT_AVAILABLE_YET
;
583 Place holder function until all the Boot Services and Runtime Services are available.
585 @param Arg1 Undefined
586 @param Arg2 Undefined
588 @return EFI_NOT_AVAILABLE_YET
593 CoreEfiNotAvailableYetArg2 (
599 // This function should never be executed. If it does, then the architectural protocols
600 // have not been designed correctly. The CpuBreakpoint () is commented out for now until the
601 // DXE Core and all the Architectural Protocols are complete.
604 return EFI_NOT_AVAILABLE_YET
;
609 Place holder function until all the Boot Services and Runtime Services are available.
611 @param Arg1 Undefined
612 @param Arg2 Undefined
613 @param Arg3 Undefined
615 @return EFI_NOT_AVAILABLE_YET
620 CoreEfiNotAvailableYetArg3 (
627 // This function should never be executed. If it does, then the architectural protocols
628 // have not been designed correctly. The CpuBreakpoint () is commented out for now until the
629 // DXE Core and all the Architectural Protocols are complete.
632 return EFI_NOT_AVAILABLE_YET
;
637 Place holder function until all the Boot Services and Runtime Services are available.
639 @param Arg1 Undefined
640 @param Arg2 Undefined
641 @param Arg3 Undefined
642 @param Arg4 Undefined
644 @return EFI_NOT_AVAILABLE_YET
649 CoreEfiNotAvailableYetArg4 (
657 // This function should never be executed. If it does, then the architectural protocols
658 // have not been designed correctly. The CpuBreakpoint () is commented out for now until the
659 // DXE Core and all the Architectural Protocols are complete.
662 return EFI_NOT_AVAILABLE_YET
;
667 Place holder function until all the Boot Services and Runtime Services are available.
669 @param Arg1 Undefined
670 @param Arg2 Undefined
671 @param Arg3 Undefined
672 @param Arg4 Undefined
673 @param Arg5 Undefined
675 @return EFI_NOT_AVAILABLE_YET
680 CoreEfiNotAvailableYetArg5 (
689 // This function should never be executed. If it does, then the architectural protocols
690 // have not been designed correctly. The CpuBreakpoint () is commented out for now until the
691 // DXE Core and all the Architectural Protocols are complete.
694 return EFI_NOT_AVAILABLE_YET
;
699 Calcualte the 32-bit CRC in a EFI table using the service provided by the
702 @param Hdr Pointer to an EFI standard header
707 IN OUT EFI_TABLE_HEADER
*Hdr
715 // If gBS->CalculateCrce32 () == CoreEfiNotAvailableYet () then
716 // Crc will come back as zero if we set it to zero here
719 gBS
->CalculateCrc32 ((UINT8
*)Hdr
, Hdr
->HeaderSize
, &Crc
);
725 Terminates all boot services.
727 @param ImageHandle Handle that identifies the exiting image.
728 @param MapKey Key to the latest memory map.
730 @retval EFI_SUCCESS Boot Services terminated
731 @retval EFI_INVALID_PARAMETER MapKey is incorrect.
736 CoreExitBootServices (
737 IN EFI_HANDLE ImageHandle
,
746 gTimer
->SetTimerPeriod (gTimer
, 0);
749 // Terminate memory services if the MapKey matches
751 Status
= CoreTerminateMemoryMap (MapKey
);
752 if (EFI_ERROR (Status
)) {
754 // Notify other drivers that ExitBootServices fail
756 CoreNotifySignalList (&gEventExitBootServicesFailedGuid
);
760 gMemoryMapTerminated
= TRUE
;
763 // Notify other drivers that we are exiting boot services.
765 CoreNotifySignalList (&gEfiEventExitBootServicesGuid
);
768 // Report that ExitBootServices() has been called
772 (EFI_SOFTWARE_EFI_BOOT_SERVICE
| EFI_SW_BS_PC_EXIT_BOOT_SERVICES
)
775 MemoryProtectionExitBootServicesCallback();
778 // Disable interrupt of Debug timer.
780 SaveAndSetDebugTimerInterrupt (FALSE
);
783 // Disable CPU Interrupts
785 gCpu
->DisableInterrupt (gCpu
);
788 // Clear the non-runtime values of the EFI System Table
790 gDxeCoreST
->BootServices
= NULL
;
791 gDxeCoreST
->ConIn
= NULL
;
792 gDxeCoreST
->ConsoleInHandle
= NULL
;
793 gDxeCoreST
->ConOut
= NULL
;
794 gDxeCoreST
->ConsoleOutHandle
= NULL
;
795 gDxeCoreST
->StdErr
= NULL
;
796 gDxeCoreST
->StandardErrorHandle
= NULL
;
799 // Recompute the 32-bit CRC of the EFI System Table
801 CalculateEfiHdrCrc (&gDxeCoreST
->Hdr
);
804 // Zero out the Boot Service Table
806 ZeroMem (gBS
, sizeof (EFI_BOOT_SERVICES
));
810 // Update the AtRuntime field in Runtiem AP.
812 gRuntime
->AtRuntime
= TRUE
;
819 Given a compressed source buffer, this function retrieves the size of the
820 uncompressed buffer and the size of the scratch buffer required to decompress
821 the compressed source buffer.
823 The GetInfo() function retrieves the size of the uncompressed buffer and the
824 temporary scratch buffer required to decompress the buffer specified by Source
825 and SourceSize. If the size of the uncompressed buffer or the size of the
826 scratch buffer cannot be determined from the compressed data specified by
827 Source and SourceData, then EFI_INVALID_PARAMETER is returned. Otherwise, the
828 size of the uncompressed buffer is returned in DestinationSize, the size of
829 the scratch buffer is returned in ScratchSize, and EFI_SUCCESS is returned.
830 The GetInfo() function does not have scratch buffer available to perform a
831 thorough checking of the validity of the source data. It just retrieves the
832 "Original Size" field from the beginning bytes of the source data and output
833 it as DestinationSize. And ScratchSize is specific to the decompression
836 @param This A pointer to the EFI_DECOMPRESS_PROTOCOL instance.
837 @param Source The source buffer containing the compressed data.
838 @param SourceSize The size, in bytes, of the source buffer.
839 @param DestinationSize A pointer to the size, in bytes, of the
840 uncompressed buffer that will be generated when the
841 compressed buffer specified by Source and
842 SourceSize is decompressed.
843 @param ScratchSize A pointer to the size, in bytes, of the scratch
844 buffer that is required to decompress the
845 compressed buffer specified by Source and
848 @retval EFI_SUCCESS The size of the uncompressed data was returned in
849 DestinationSize and the size of the scratch buffer
850 was returned in ScratchSize.
851 @retval EFI_INVALID_PARAMETER The size of the uncompressed data or the size of
852 the scratch buffer cannot be determined from the
853 compressed data specified by Source and
859 DxeMainUefiDecompressGetInfo (
860 IN EFI_DECOMPRESS_PROTOCOL
*This
,
862 IN UINT32 SourceSize
,
863 OUT UINT32
*DestinationSize
,
864 OUT UINT32
*ScratchSize
867 if (Source
== NULL
|| DestinationSize
== NULL
|| ScratchSize
== NULL
) {
868 return EFI_INVALID_PARAMETER
;
870 return UefiDecompressGetInfo (Source
, SourceSize
, DestinationSize
, ScratchSize
);
875 Decompresses a compressed source buffer.
877 The Decompress() function extracts decompressed data to its original form.
878 This protocol is designed so that the decompression algorithm can be
879 implemented without using any memory services. As a result, the Decompress()
880 Function is not allowed to call AllocatePool() or AllocatePages() in its
881 implementation. It is the caller's responsibility to allocate and free the
882 Destination and Scratch buffers.
883 If the compressed source data specified by Source and SourceSize is
884 successfully decompressed into Destination, then EFI_SUCCESS is returned. If
885 the compressed source data specified by Source and SourceSize is not in a
886 valid compressed data format, then EFI_INVALID_PARAMETER is returned.
888 @param This A pointer to the EFI_DECOMPRESS_PROTOCOL instance.
889 @param Source The source buffer containing the compressed data.
890 @param SourceSize SourceSizeThe size of source data.
891 @param Destination On output, the destination buffer that contains
892 the uncompressed data.
893 @param DestinationSize The size of the destination buffer. The size of
894 the destination buffer needed is obtained from
895 EFI_DECOMPRESS_PROTOCOL.GetInfo().
896 @param Scratch A temporary scratch buffer that is used to perform
898 @param ScratchSize The size of scratch buffer. The size of the
899 scratch buffer needed is obtained from GetInfo().
901 @retval EFI_SUCCESS Decompression completed successfully, and the
902 uncompressed buffer is returned in Destination.
903 @retval EFI_INVALID_PARAMETER The source buffer specified by Source and
904 SourceSize is corrupted (not in a valid
910 DxeMainUefiDecompress (
911 IN EFI_DECOMPRESS_PROTOCOL
*This
,
913 IN UINT32 SourceSize
,
914 IN OUT VOID
*Destination
,
915 IN UINT32 DestinationSize
,
916 IN OUT VOID
*Scratch
,
917 IN UINT32 ScratchSize
921 UINT32 TestDestinationSize
;
922 UINT32 TestScratchSize
;
924 if (Source
== NULL
|| Destination
== NULL
|| Scratch
== NULL
) {
925 return EFI_INVALID_PARAMETER
;
928 Status
= UefiDecompressGetInfo (Source
, SourceSize
, &TestDestinationSize
, &TestScratchSize
);
929 if (EFI_ERROR (Status
)) {
933 if (ScratchSize
< TestScratchSize
|| DestinationSize
< TestDestinationSize
) {
934 return RETURN_INVALID_PARAMETER
;
937 return UefiDecompress (Source
, Destination
, Scratch
);