2 DXE Core Main Entry Point
4 Copyright (c) 2006 - 2012, 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
128 EFI_SYSTEM_TABLE mEfiSystemTableTemplate
= {
130 EFI_SYSTEM_TABLE_SIGNATURE
, // Signature
131 EFI_SYSTEM_TABLE_REVISION
, // Revision
132 sizeof (EFI_SYSTEM_TABLE
), // HeaderSize
136 NULL
, // FirmwareVendor
137 0, // FirmwareRevision
138 NULL
, // ConsoleInHandle
140 NULL
, // ConsoleOutHandle
142 NULL
, // StandardErrorHandle
144 NULL
, // RuntimeServices
145 &mBootServices
, // BootServices
146 0, // NumberOfConfigurationTableEntries
147 NULL
// ConfigurationTable
150 EFI_RUNTIME_SERVICES mEfiRuntimeServicesTableTemplate
= {
152 EFI_RUNTIME_SERVICES_SIGNATURE
, // Signature
153 EFI_RUNTIME_SERVICES_REVISION
, // Revision
154 sizeof (EFI_RUNTIME_SERVICES
), // HeaderSize
158 (EFI_GET_TIME
) CoreEfiNotAvailableYetArg2
, // GetTime
159 (EFI_SET_TIME
) CoreEfiNotAvailableYetArg1
, // SetTime
160 (EFI_GET_WAKEUP_TIME
) CoreEfiNotAvailableYetArg3
, // GetWakeupTime
161 (EFI_SET_WAKEUP_TIME
) CoreEfiNotAvailableYetArg2
, // SetWakeupTime
162 (EFI_SET_VIRTUAL_ADDRESS_MAP
) CoreEfiNotAvailableYetArg4
, // SetVirtualAddressMap
163 (EFI_CONVERT_POINTER
) CoreEfiNotAvailableYetArg2
, // ConvertPointer
164 (EFI_GET_VARIABLE
) CoreEfiNotAvailableYetArg5
, // GetVariable
165 (EFI_GET_NEXT_VARIABLE_NAME
) CoreEfiNotAvailableYetArg3
, // GetNextVariableName
166 (EFI_SET_VARIABLE
) CoreEfiNotAvailableYetArg5
, // SetVariable
167 (EFI_GET_NEXT_HIGH_MONO_COUNT
) CoreEfiNotAvailableYetArg1
, // GetNextHighMonotonicCount
168 (EFI_RESET_SYSTEM
) CoreEfiNotAvailableYetArg4
, // ResetSystem
169 (EFI_UPDATE_CAPSULE
) CoreEfiNotAvailableYetArg3
, // UpdateCapsule
170 (EFI_QUERY_CAPSULE_CAPABILITIES
) CoreEfiNotAvailableYetArg4
, // QueryCapsuleCapabilities
171 (EFI_QUERY_VARIABLE_INFO
) CoreEfiNotAvailableYetArg4
// QueryVariableInfo
174 EFI_RUNTIME_ARCH_PROTOCOL gRuntimeTemplate
= {
175 INITIALIZE_LIST_HEAD_VARIABLE (gRuntimeTemplate
.ImageHead
),
176 INITIALIZE_LIST_HEAD_VARIABLE (gRuntimeTemplate
.EventHead
),
179 // Make sure Size != sizeof (EFI_MEMORY_DESCRIPTOR). This will
180 // prevent people from having pointer math bugs in their code.
181 // now you have to use *DescriptorSize to make things work.
183 sizeof (EFI_MEMORY_DESCRIPTOR
) + sizeof (UINT64
) - (sizeof (EFI_MEMORY_DESCRIPTOR
) % sizeof (UINT64
)),
184 EFI_MEMORY_DESCRIPTOR_VERSION
,
192 EFI_RUNTIME_ARCH_PROTOCOL
*gRuntime
= &gRuntimeTemplate
;
195 // DXE Core Global Variables for the EFI System Table, Boot Services Table,
196 // DXE Services Table, and Runtime Services Table
198 EFI_DXE_SERVICES
*gDxeCoreDS
= &mDxeServices
;
199 EFI_SYSTEM_TABLE
*gDxeCoreST
= NULL
;
202 // For debug initialize gDxeCoreRT to template. gDxeCoreRT must be allocated from RT memory
203 // but gDxeCoreRT is used for ASSERT () and DEBUG () type macros so lets give it
204 // a value that will not cause debug infrastructure to crash early on.
206 EFI_RUNTIME_SERVICES
*gDxeCoreRT
= &mEfiRuntimeServicesTableTemplate
;
207 EFI_HANDLE gDxeCoreImageHandle
= NULL
;
211 // EFI Decompress Protocol
213 EFI_DECOMPRESS_PROTOCOL gEfiDecompress
= {
214 DxeMainUefiDecompressGetInfo
,
215 DxeMainUefiDecompress
219 // For Loading modules at fixed address feature, the configuration table is to cache the top address below which to load
220 // Runtime code&boot time code
222 GLOBAL_REMOVE_IF_UNREFERENCED EFI_LOAD_FIXED_ADDRESS_CONFIGURATION_TABLE gLoadModuleAtFixAddressConfigurationTable
= {0, 0};
224 // Main entry point to the DXE Core
228 Main entry point to DXE Core.
230 @param HobStart Pointer to the beginning of the HOB List from PEI.
232 @return This function should never return.
242 EFI_PHYSICAL_ADDRESS MemoryBaseAddress
;
244 PE_COFF_LOADER_IMAGE_CONTEXT ImageContext
;
247 // Setup the default exception handlers
249 SetupCpuExceptionHandlers ();
252 // Initialize Debug Agent to support source level debug in DXE phase
254 InitializeDebugAgent (DEBUG_AGENT_INIT_DXE_CORE
, HobStart
, NULL
);
257 // Initialize Memory Services
259 CoreInitializeMemoryServices (&HobStart
, &MemoryBaseAddress
, &MemoryLength
);
262 // Allocate the EFI System Table and EFI Runtime Service Table from EfiRuntimeServicesData
263 // Use the templates to initialize the contents of the EFI System Table and EFI Runtime Services Table
265 gDxeCoreST
= AllocateRuntimeCopyPool (sizeof (EFI_SYSTEM_TABLE
), &mEfiSystemTableTemplate
);
266 ASSERT (gDxeCoreST
!= NULL
);
268 gDxeCoreRT
= AllocateRuntimeCopyPool (sizeof (EFI_RUNTIME_SERVICES
), &mEfiRuntimeServicesTableTemplate
);
269 ASSERT (gDxeCoreRT
!= NULL
);
271 gDxeCoreST
->RuntimeServices
= gDxeCoreRT
;
274 // Start the Image Services.
276 Status
= CoreInitializeImageServices (HobStart
);
277 ASSERT_EFI_ERROR (Status
);
280 // Call constructor for all libraries
282 ProcessLibraryConstructorList (gDxeCoreImageHandle
, gDxeCoreST
);
283 PERF_END (NULL
,"PEI", NULL
, 0) ;
284 PERF_START (NULL
,"DXE", NULL
, 0) ;
287 // Report DXE Core image information to the PE/COFF Extra Action Library
289 ImageContext
.ImageAddress
= (EFI_PHYSICAL_ADDRESS
)(UINTN
)gDxeCoreLoadedImage
->ImageBase
;
290 ImageContext
.PdbPointer
= PeCoffLoaderGetPdbPointer ((VOID
*) (UINTN
) ImageContext
.ImageAddress
);
291 PeCoffLoaderRelocateImageExtraAction (&ImageContext
);
294 // Initialize the Global Coherency Domain Services
296 Status
= CoreInitializeGcdServices (&HobStart
, MemoryBaseAddress
, MemoryLength
);
297 ASSERT_EFI_ERROR (Status
);
300 // Install the DXE Services Table into the EFI System Tables's Configuration Table
302 Status
= CoreInstallConfigurationTable (&gEfiDxeServicesTableGuid
, gDxeCoreDS
);
303 ASSERT_EFI_ERROR (Status
);
306 // Install the HOB List into the EFI System Tables's Configuration Table
308 Status
= CoreInstallConfigurationTable (&gEfiHobListGuid
, HobStart
);
309 ASSERT_EFI_ERROR (Status
);
312 // Install Memory Type Information Table into the EFI System Tables's Configuration Table
314 Status
= CoreInstallConfigurationTable (&gEfiMemoryTypeInformationGuid
, &gMemoryTypeInformation
);
315 ASSERT_EFI_ERROR (Status
);
318 // If Loading modules At fixed address feature is enabled, install Load moduels at fixed address
319 // Configuration Table so that user could easily to retrieve the top address to load Dxe and PEI
320 // Code and Tseg base to load SMM driver.
322 if (PcdGet64(PcdLoadModuleAtFixAddressEnable
) != 0) {
323 Status
= CoreInstallConfigurationTable (&gLoadFixedAddressConfigurationTableGuid
, &gLoadModuleAtFixAddressConfigurationTable
);
324 ASSERT_EFI_ERROR (Status
);
327 // Report Status Code here for DXE_ENTRY_POINT once it is available
331 (EFI_SOFTWARE_DXE_CORE
| EFI_SW_DXE_CORE_PC_ENTRY_POINT
)
335 // Create the aligned system table pointer structure that is used by external
336 // debuggers to locate the system table... Also, install debug image info
337 // configuration table.
339 CoreInitializeDebugImageInfoTable ();
340 CoreNewDebugImageInfoEntry (
341 EFI_DEBUG_IMAGE_INFO_TYPE_NORMAL
,
346 DEBUG ((DEBUG_INFO
| DEBUG_LOAD
, "HOBLIST address in DXE = 0x%p\n", HobStart
));
349 EFI_PEI_HOB_POINTERS Hob
;
351 for (Hob
.Raw
= HobStart
; !END_OF_HOB_LIST(Hob
); Hob
.Raw
= GET_NEXT_HOB(Hob
)) {
352 if (GET_HOB_TYPE (Hob
) == EFI_HOB_TYPE_MEMORY_ALLOCATION
) {
353 DEBUG ((DEBUG_INFO
| DEBUG_LOAD
, "Memory Allocation 0x%08x 0x%0lx - 0x%0lx\n", \
354 Hob
.MemoryAllocation
->AllocDescriptor
.MemoryType
, \
355 Hob
.MemoryAllocation
->AllocDescriptor
.MemoryBaseAddress
, \
356 Hob
.MemoryAllocation
->AllocDescriptor
.MemoryBaseAddress
+ Hob
.MemoryAllocation
->AllocDescriptor
.MemoryLength
- 1));
359 for (Hob
.Raw
= HobStart
; !END_OF_HOB_LIST(Hob
); Hob
.Raw
= GET_NEXT_HOB(Hob
)) {
360 if (GET_HOB_TYPE (Hob
) == EFI_HOB_TYPE_FV2
) {
361 DEBUG ((DEBUG_INFO
| DEBUG_LOAD
, "FV2 Hob 0x%0lx - 0x%0lx\n", Hob
.FirmwareVolume2
->BaseAddress
, Hob
.FirmwareVolume2
->BaseAddress
+ Hob
.FirmwareVolume2
->Length
- 1));
362 } else if (GET_HOB_TYPE (Hob
) == EFI_HOB_TYPE_FV
) {
363 DEBUG ((DEBUG_INFO
| DEBUG_LOAD
, "FV Hob 0x%0lx - 0x%0lx\n", Hob
.FirmwareVolume
->BaseAddress
, Hob
.FirmwareVolume
->BaseAddress
+ Hob
.FirmwareVolume2
->Length
- 1));
369 // Initialize the Event Services
371 Status
= CoreInitializeEventServices ();
372 ASSERT_EFI_ERROR (Status
);
376 // Get the Protocols that were passed in from PEI to DXE through GUIDed HOBs
378 // These Protocols are not architectural. This implementation is sharing code between
379 // PEI and DXE in order to save FLASH space. These Protocols could also be implemented
380 // as part of the DXE Core. However, that would also require the DXE Core to be ported
381 // each time a different CPU is used, a different Decompression algorithm is used, or a
382 // different Image type is used. By placing these Protocols in PEI, the DXE Core remains
383 // generic, and only PEI and the Arch Protocols need to be ported from Platform to Platform,
384 // and from CPU to CPU.
388 // Publish the EFI, Tiano, and Custom Decompress protocols for use by other DXE components
390 Status
= CoreInstallMultipleProtocolInterfaces (
392 &gEfiDecompressProtocolGuid
, &gEfiDecompress
,
395 ASSERT_EFI_ERROR (Status
);
398 // Register for the GUIDs of the Architectural Protocols, so the rest of the
399 // EFI Boot Services and EFI Runtime Services tables can be filled in.
400 // Also register for the GUIDs of optional protocols.
402 CoreNotifyOnProtocolInstallation ();
405 // Produce Firmware Volume Protocols, one for each FV in the HOB list.
407 Status
= FwVolBlockDriverInit (gDxeCoreImageHandle
, gDxeCoreST
);
408 ASSERT_EFI_ERROR (Status
);
410 Status
= FwVolDriverInit (gDxeCoreImageHandle
, gDxeCoreST
);
411 ASSERT_EFI_ERROR (Status
);
414 // Produce the Section Extraction Protocol
416 Status
= InitializeSectionExtraction (gDxeCoreImageHandle
, gDxeCoreST
);
417 ASSERT_EFI_ERROR (Status
);
420 // Initialize the DXE Dispatcher
422 PERF_START (NULL
,"CoreInitializeDispatcher", "DxeMain", 0) ;
423 CoreInitializeDispatcher ();
424 PERF_END (NULL
,"CoreInitializeDispatcher", "DxeMain", 0) ;
427 // Invoke the DXE Dispatcher
429 PERF_START (NULL
, "CoreDispatcher", "DxeMain", 0);
431 PERF_END (NULL
, "CoreDispatcher", "DxeMain", 0);
434 // Display Architectural protocols that were not loaded if this is DEBUG build
437 CoreDisplayMissingArchProtocols ();
441 // Display any drivers that were not dispatched because dependency expression
442 // evaluated to false if this is a debug build
445 CoreDisplayDiscoveredNotDispatched ();
449 // Assert if the Architectural Protocols are not present.
451 ASSERT_EFI_ERROR (CoreAllEfiServicesAvailable ());
454 // Report Status code before transfer control to BDS
458 (EFI_SOFTWARE_DXE_CORE
| EFI_SW_DXE_CORE_PC_HANDOFF_TO_NEXT
)
462 // Transfer control to the BDS Architectural Protocol
467 // BDS should never return
476 Place holder function until all the Boot Services and Runtime Services are
479 @return EFI_NOT_AVAILABLE_YET
484 CoreEfiNotAvailableYetArg0 (
489 // This function should never be executed. If it does, then the architectural protocols
490 // have not been designed correctly. The CpuBreakpoint () is commented out for now until the
491 // DXE Core and all the Architectural Protocols are complete.
494 return EFI_NOT_AVAILABLE_YET
;
499 Place holder function until all the Boot Services and Runtime Services are
502 @param Arg1 Undefined
504 @return EFI_NOT_AVAILABLE_YET
509 CoreEfiNotAvailableYetArg1 (
514 // This function should never be executed. If it does, then the architectural protocols
515 // have not been designed correctly. The CpuBreakpoint () is commented out for now until the
516 // DXE Core and all the Architectural Protocols are complete.
519 return EFI_NOT_AVAILABLE_YET
;
524 Place holder function until all the Boot Services and Runtime Services are available.
526 @param Arg1 Undefined
527 @param Arg2 Undefined
529 @return EFI_NOT_AVAILABLE_YET
534 CoreEfiNotAvailableYetArg2 (
540 // This function should never be executed. If it does, then the architectural protocols
541 // have not been designed correctly. The CpuBreakpoint () is commented out for now until the
542 // DXE Core and all the Architectural Protocols are complete.
545 return EFI_NOT_AVAILABLE_YET
;
550 Place holder function until all the Boot Services and Runtime Services are available.
552 @param Arg1 Undefined
553 @param Arg2 Undefined
554 @param Arg3 Undefined
556 @return EFI_NOT_AVAILABLE_YET
561 CoreEfiNotAvailableYetArg3 (
568 // This function should never be executed. If it does, then the architectural protocols
569 // have not been designed correctly. The CpuBreakpoint () is commented out for now until the
570 // DXE Core and all the Architectural Protocols are complete.
573 return EFI_NOT_AVAILABLE_YET
;
578 Place holder function until all the Boot Services and Runtime Services are available.
580 @param Arg1 Undefined
581 @param Arg2 Undefined
582 @param Arg3 Undefined
583 @param Arg4 Undefined
585 @return EFI_NOT_AVAILABLE_YET
590 CoreEfiNotAvailableYetArg4 (
598 // This function should never be executed. If it does, then the architectural protocols
599 // have not been designed correctly. The CpuBreakpoint () is commented out for now until the
600 // DXE Core and all the Architectural Protocols are complete.
603 return EFI_NOT_AVAILABLE_YET
;
608 Place holder function until all the Boot Services and Runtime Services are available.
610 @param Arg1 Undefined
611 @param Arg2 Undefined
612 @param Arg3 Undefined
613 @param Arg4 Undefined
614 @param Arg5 Undefined
616 @return EFI_NOT_AVAILABLE_YET
621 CoreEfiNotAvailableYetArg5 (
630 // This function should never be executed. If it does, then the architectural protocols
631 // have not been designed correctly. The CpuBreakpoint () is commented out for now until the
632 // DXE Core and all the Architectural Protocols are complete.
635 return EFI_NOT_AVAILABLE_YET
;
640 Calcualte the 32-bit CRC in a EFI table using the service provided by the
643 @param Hdr Pointer to an EFI standard header
648 IN OUT EFI_TABLE_HEADER
*Hdr
656 // If gBS->CalculateCrce32 () == CoreEfiNotAvailableYet () then
657 // Crc will come back as zero if we set it to zero here
660 gBS
->CalculateCrc32 ((UINT8
*)Hdr
, Hdr
->HeaderSize
, &Crc
);
666 Terminates all boot services.
668 @param ImageHandle Handle that identifies the exiting image.
669 @param MapKey Key to the latest memory map.
671 @retval EFI_SUCCESS Boot Services terminated
672 @retval EFI_INVALID_PARAMETER MapKey is incorrect.
677 CoreExitBootServices (
678 IN EFI_HANDLE ImageHandle
,
687 gTimer
->SetTimerPeriod (gTimer
, 0);
690 // Terminate memory services if the MapKey matches
692 Status
= CoreTerminateMemoryMap (MapKey
);
693 if (EFI_ERROR (Status
)) {
695 // Notify other drivers that ExitBootServices fail
697 CoreNotifySignalList (&gEventExitBootServicesFailedGuid
);
702 // Notify other drivers that we are exiting boot services.
704 CoreNotifySignalList (&gEfiEventExitBootServicesGuid
);
707 // Disable interrupt of Debug timer.
709 SaveAndSetDebugTimerInterrupt (FALSE
);
712 // Disable CPU Interrupts
714 gCpu
->DisableInterrupt (gCpu
);
717 // Report that ExitBootServices() has been called
721 (EFI_SOFTWARE_EFI_BOOT_SERVICE
| EFI_SW_BS_PC_EXIT_BOOT_SERVICES
)
725 // Clear the non-runtime values of the EFI System Table
727 gDxeCoreST
->BootServices
= NULL
;
728 gDxeCoreST
->ConIn
= NULL
;
729 gDxeCoreST
->ConsoleInHandle
= NULL
;
730 gDxeCoreST
->ConOut
= NULL
;
731 gDxeCoreST
->ConsoleOutHandle
= NULL
;
732 gDxeCoreST
->StdErr
= NULL
;
733 gDxeCoreST
->StandardErrorHandle
= NULL
;
736 // Recompute the 32-bit CRC of the EFI System Table
738 CalculateEfiHdrCrc (&gDxeCoreST
->Hdr
);
741 // Zero out the Boot Service Table
743 ZeroMem (gBS
, sizeof (EFI_BOOT_SERVICES
));
747 // Update the AtRuntime field in Runtiem AP.
749 gRuntime
->AtRuntime
= TRUE
;
756 Given a compressed source buffer, this function retrieves the size of the
757 uncompressed buffer and the size of the scratch buffer required to decompress
758 the compressed source buffer.
760 The GetInfo() function retrieves the size of the uncompressed buffer and the
761 temporary scratch buffer required to decompress the buffer specified by Source
762 and SourceSize. If the size of the uncompressed buffer or the size of the
763 scratch buffer cannot be determined from the compressed data specified by
764 Source and SourceData, then EFI_INVALID_PARAMETER is returned. Otherwise, the
765 size of the uncompressed buffer is returned in DestinationSize, the size of
766 the scratch buffer is returned in ScratchSize, and EFI_SUCCESS is returned.
767 The GetInfo() function does not have scratch buffer available to perform a
768 thorough checking of the validity of the source data. It just retrieves the
769 "Original Size" field from the beginning bytes of the source data and output
770 it as DestinationSize. And ScratchSize is specific to the decompression
773 @param This A pointer to the EFI_DECOMPRESS_PROTOCOL instance.
774 @param Source The source buffer containing the compressed data.
775 @param SourceSize The size, in bytes, of the source buffer.
776 @param DestinationSize A pointer to the size, in bytes, of the
777 uncompressed buffer that will be generated when the
778 compressed buffer specified by Source and
779 SourceSize is decompressed.
780 @param ScratchSize A pointer to the size, in bytes, of the scratch
781 buffer that is required to decompress the
782 compressed buffer specified by Source and
785 @retval EFI_SUCCESS The size of the uncompressed data was returned in
786 DestinationSize and the size of the scratch buffer
787 was returned in ScratchSize.
788 @retval EFI_INVALID_PARAMETER The size of the uncompressed data or the size of
789 the scratch buffer cannot be determined from the
790 compressed data specified by Source and
796 DxeMainUefiDecompressGetInfo (
797 IN EFI_DECOMPRESS_PROTOCOL
*This
,
799 IN UINT32 SourceSize
,
800 OUT UINT32
*DestinationSize
,
801 OUT UINT32
*ScratchSize
804 if (Source
== NULL
|| DestinationSize
== NULL
|| ScratchSize
== NULL
) {
805 return EFI_INVALID_PARAMETER
;
807 return UefiDecompressGetInfo (Source
, SourceSize
, DestinationSize
, ScratchSize
);
812 Decompresses a compressed source buffer.
814 The Decompress() function extracts decompressed data to its original form.
815 This protocol is designed so that the decompression algorithm can be
816 implemented without using any memory services. As a result, the Decompress()
817 Function is not allowed to call AllocatePool() or AllocatePages() in its
818 implementation. It is the caller's responsibility to allocate and free the
819 Destination and Scratch buffers.
820 If the compressed source data specified by Source and SourceSize is
821 sucessfully decompressed into Destination, then EFI_SUCCESS is returned. If
822 the compressed source data specified by Source and SourceSize is not in a
823 valid compressed data format, then EFI_INVALID_PARAMETER is returned.
825 @param This A pointer to the EFI_DECOMPRESS_PROTOCOL instance.
826 @param Source The source buffer containing the compressed data.
827 @param SourceSize SourceSizeThe size of source data.
828 @param Destination On output, the destination buffer that contains
829 the uncompressed data.
830 @param DestinationSize The size of the destination buffer. The size of
831 the destination buffer needed is obtained from
832 EFI_DECOMPRESS_PROTOCOL.GetInfo().
833 @param Scratch A temporary scratch buffer that is used to perform
835 @param ScratchSize The size of scratch buffer. The size of the
836 scratch buffer needed is obtained from GetInfo().
838 @retval EFI_SUCCESS Decompression completed successfully, and the
839 uncompressed buffer is returned in Destination.
840 @retval EFI_INVALID_PARAMETER The source buffer specified by Source and
841 SourceSize is corrupted (not in a valid
847 DxeMainUefiDecompress (
848 IN EFI_DECOMPRESS_PROTOCOL
*This
,
850 IN UINT32 SourceSize
,
851 IN OUT VOID
*Destination
,
852 IN UINT32 DestinationSize
,
853 IN OUT VOID
*Scratch
,
854 IN UINT32 ScratchSize
858 UINT32 TestDestinationSize
;
859 UINT32 TestScratchSize
;
861 if (Source
== NULL
|| Destination
== NULL
|| Scratch
== NULL
) {
862 return EFI_INVALID_PARAMETER
;
865 Status
= UefiDecompressGetInfo (Source
, SourceSize
, &TestDestinationSize
, &TestScratchSize
);
866 if (EFI_ERROR (Status
)) {
870 if (ScratchSize
< TestScratchSize
|| DestinationSize
< TestDestinationSize
) {
871 return RETURN_INVALID_PARAMETER
;
874 return UefiDecompress (Source
, Destination
, Scratch
);