[mirror_edk2.git] / MdeModulePkg / Core / Dxe / DxeMain / DxeMain.c

/** @file\r
  DXE Core Main Entry Point\r
\r
Copyright (c) 2006 - 2008, Intel Corporation. <BR>\r
All rights reserved. This program and the accompanying materials\r
are licensed and made available under the terms and conditions of the BSD License\r
which accompanies this distribution.  The full text of the license may be found at\r
http://opensource.org/licenses/bsd-license.php\r
\r
THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,\r
WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.\r
\r
**/\r
\r
#include "DxeMain.h"\r
\r
//\r
// DXE Core Global Variables for Protocols from PEI\r
//\r
EFI_HANDLE                                mDecompressHandle = NULL;\r
\r
//\r
// DXE Core globals for Architecture Protocols\r
//\r
EFI_SECURITY_ARCH_PROTOCOL        *gSecurity      = NULL;\r
EFI_CPU_ARCH_PROTOCOL             *gCpu           = NULL;\r
EFI_METRONOME_ARCH_PROTOCOL       *gMetronome     = NULL;\r
EFI_TIMER_ARCH_PROTOCOL           *gTimer         = NULL;\r
EFI_BDS_ARCH_PROTOCOL             *gBds           = NULL;\r
EFI_WATCHDOG_TIMER_ARCH_PROTOCOL  *gWatchdogTimer = NULL;\r
\r
//\r
// DXE Core Global used to update core loaded image protocol handle\r
//\r
EFI_GUID                           *gDxeCoreFileName;\r
EFI_LOADED_IMAGE_PROTOCOL          *gDxeCoreLoadedImage;\r
\r
//\r
// BugBug: I'n not runtime, but is the PPI?\r
//\r
EFI_STATUS_CODE_PROTOCOL     gStatusCodeInstance = {\r
  NULL\r
};\r
\r
EFI_STATUS_CODE_PROTOCOL     *gStatusCode    = &gStatusCodeInstance;\r
\r
//\r
// DXE Core Module Variables\r
//\r
\r
EFI_BOOT_SERVICES mBootServices = {\r
  {\r
    EFI_BOOT_SERVICES_SIGNATURE,                                                          // Signature\r
    EFI_BOOT_SERVICES_REVISION,                                                           // Revision\r
    sizeof (EFI_BOOT_SERVICES),                                                           // HeaderSize\r
    0,                                                                                    // CRC32\r
    0                                                                                     // Reserved\r
  },\r
  (EFI_RAISE_TPL)                               CoreRaiseTpl,                             // RaiseTPL\r
  (EFI_RESTORE_TPL)                             CoreRestoreTpl,                           // RestoreTPL\r
  (EFI_ALLOCATE_PAGES)                          CoreAllocatePages,                        // AllocatePages\r
  (EFI_FREE_PAGES)                              CoreFreePages,                            // FreePages\r
  (EFI_GET_MEMORY_MAP)                          CoreGetMemoryMap,                         // GetMemoryMap\r
  (EFI_ALLOCATE_POOL)                           CoreAllocatePool,                         // AllocatePool\r
  (EFI_FREE_POOL)                               CoreFreePool,                             // FreePool\r
  (EFI_CREATE_EVENT)                            CoreCreateEvent,                          // CreateEvent\r
  (EFI_SET_TIMER)                               CoreSetTimer,                             // SetTimer\r
  (EFI_WAIT_FOR_EVENT)                          CoreWaitForEvent,                         // WaitForEvent\r
  (EFI_SIGNAL_EVENT)                            CoreSignalEvent,                          // SignalEvent\r
  (EFI_CLOSE_EVENT)                             CoreCloseEvent,                           // CloseEvent\r
  (EFI_CHECK_EVENT)                             CoreCheckEvent,                           // CheckEvent\r
  (EFI_INSTALL_PROTOCOL_INTERFACE)              CoreInstallProtocolInterface,             // InstallProtocolInterface\r
  (EFI_REINSTALL_PROTOCOL_INTERFACE)            CoreReinstallProtocolInterface,           // ReinstallProtocolInterface\r
  (EFI_UNINSTALL_PROTOCOL_INTERFACE)            CoreUninstallProtocolInterface,           // UninstallProtocolInterface\r
  (EFI_HANDLE_PROTOCOL)                         CoreHandleProtocol,                       // HandleProtocol\r
  (VOID *)                                      NULL,                                     // Reserved\r
  (EFI_REGISTER_PROTOCOL_NOTIFY)                CoreRegisterProtocolNotify,               // RegisterProtocolNotify\r
  (EFI_LOCATE_HANDLE)                           CoreLocateHandle,                         // LocateHandle\r
  (EFI_LOCATE_DEVICE_PATH)                      CoreLocateDevicePath,                     // LocateDevicePath\r
  (EFI_INSTALL_CONFIGURATION_TABLE)             CoreInstallConfigurationTable,            // InstallConfigurationTable\r
  (EFI_IMAGE_LOAD)                              CoreLoadImage,                            // LoadImage\r
  (EFI_IMAGE_START)                             CoreStartImage,                           // StartImage\r
  (EFI_EXIT)                                    CoreExit,                                 // Exit\r
  (EFI_IMAGE_UNLOAD)                            CoreUnloadImage,                          // UnloadImage\r
  (EFI_EXIT_BOOT_SERVICES)                      CoreExitBootServices,                     // ExitBootServices\r
  (EFI_GET_NEXT_MONOTONIC_COUNT)                CoreEfiNotAvailableYetArg1,               // GetNextMonotonicCount\r
  (EFI_STALL)                                   CoreStall,                                // Stall\r
  (EFI_SET_WATCHDOG_TIMER)                      CoreSetWatchdogTimer,                     // SetWatchdogTimer\r
  (EFI_CONNECT_CONTROLLER)                      CoreConnectController,                    // ConnectController\r
  (EFI_DISCONNECT_CONTROLLER)                   CoreDisconnectController,                 // DisconnectController\r
  (EFI_OPEN_PROTOCOL)                           CoreOpenProtocol,                         // OpenProtocol\r
  (EFI_CLOSE_PROTOCOL)                          CoreCloseProtocol,                        // CloseProtocol\r
  (EFI_OPEN_PROTOCOL_INFORMATION)               CoreOpenProtocolInformation,              // OpenProtocolInformation\r
  (EFI_PROTOCOLS_PER_HANDLE)                    CoreProtocolsPerHandle,                   // ProtocolsPerHandle\r
  (EFI_LOCATE_HANDLE_BUFFER)                    CoreLocateHandleBuffer,                   // LocateHandleBuffer\r
  (EFI_LOCATE_PROTOCOL)                         CoreLocateProtocol,                       // LocateProtocol\r
  (EFI_INSTALL_MULTIPLE_PROTOCOL_INTERFACES)    CoreInstallMultipleProtocolInterfaces,    // InstallMultipleProtocolInterfaces\r
  (EFI_UNINSTALL_MULTIPLE_PROTOCOL_INTERFACES)  CoreUninstallMultipleProtocolInterfaces,  // UninstallMultipleProtocolInterfaces\r
  (EFI_CALCULATE_CRC32)                         CoreEfiNotAvailableYetArg3,               // CalculateCrc32\r
  (EFI_COPY_MEM)                                CopyMem,                                  // CopyMem\r
  (EFI_SET_MEM)                                 SetMem,                                   // SetMem\r
  (EFI_CREATE_EVENT_EX)                         CoreCreateEventEx                         // CreateEventEx\r
};\r
\r
EFI_DXE_SERVICES mDxeServices = {\r
  {\r
    DXE_SERVICES_SIGNATURE,                                           // Signature\r
    DXE_SERVICES_REVISION,                                            // Revision\r
    sizeof (DXE_SERVICES),                                            // HeaderSize\r
    0,                                                                    // CRC32\r
    0                                                                     // Reserved\r
  },\r
  (EFI_ADD_MEMORY_SPACE)             CoreAddMemorySpace,                  // AddMemorySpace\r
  (EFI_ALLOCATE_MEMORY_SPACE)        CoreAllocateMemorySpace,             // AllocateMemorySpace\r
  (EFI_FREE_MEMORY_SPACE)            CoreFreeMemorySpace,                 // FreeMemorySpace\r
  (EFI_REMOVE_MEMORY_SPACE)          CoreRemoveMemorySpace,               // RemoveMemorySpace\r
  (EFI_GET_MEMORY_SPACE_DESCRIPTOR)  CoreGetMemorySpaceDescriptor,        // GetMemorySpaceDescriptor\r
  (EFI_SET_MEMORY_SPACE_ATTRIBUTES)  CoreSetMemorySpaceAttributes,        // SetMemorySpaceAttributes\r
  (EFI_GET_MEMORY_SPACE_MAP)         CoreGetMemorySpaceMap,               // GetMemorySpaceMap\r
  (EFI_ADD_IO_SPACE)                 CoreAddIoSpace,                      // AddIoSpace\r
  (EFI_ALLOCATE_IO_SPACE)            CoreAllocateIoSpace,                 // AllocateIoSpace\r
  (EFI_FREE_IO_SPACE)                CoreFreeIoSpace,                     // FreeIoSpace\r
  (EFI_REMOVE_IO_SPACE)              CoreRemoveIoSpace,                   // RemoveIoSpace\r
  (EFI_GET_IO_SPACE_DESCRIPTOR)      CoreGetIoSpaceDescriptor,            // GetIoSpaceDescriptor\r
  (EFI_GET_IO_SPACE_MAP)             CoreGetIoSpaceMap,                   // GetIoSpaceMap\r
  (EFI_DISPATCH)                     CoreDispatcher,                      // Dispatch\r
  (EFI_SCHEDULE)                     CoreSchedule,                        // Schedule\r
  (EFI_TRUST)                        CoreTrust,                           // Trust\r
  (EFI_PROCESS_FIRMWARE_VOLUME)      CoreProcessFirmwareVolume,           // ProcessFirmwareVolume\r
};\r
\r
EFI_SYSTEM_TABLE mEfiSystemTableTemplate = {\r
  {\r
    EFI_SYSTEM_TABLE_SIGNATURE,                                           // Signature\r
    EFI_SYSTEM_TABLE_REVISION,                                            // Revision\r
    sizeof (EFI_SYSTEM_TABLE),                                            // HeaderSize\r
    0,                                                                    // CRC32\r
    0                                                                     // Reserved\r
  },\r
  NULL,                                                                   // FirmwareVendor\r
  0,                                                                      // FirmwareRevision\r
  NULL,                                                                   // ConsoleInHandle\r
  NULL,                                                                   // ConIn\r
  NULL,                                                                   // ConsoleOutHandle\r
  NULL,                                                                   // ConOut\r
  NULL,                                                                   // StandardErrorHandle\r
  NULL,                                                                   // StdErr\r
  NULL,                                                                   // RuntimeServices\r
  &mBootServices,                                                         // BootServices\r
  0,                                                                      // NumberOfConfigurationTableEntries\r
  NULL                                                                    // ConfigurationTable\r
};\r
\r
EFI_RUNTIME_SERVICES mEfiRuntimeServicesTableTemplate = {\r
  {\r
    EFI_RUNTIME_SERVICES_SIGNATURE,                               // Signature\r
    EFI_RUNTIME_SERVICES_REVISION,                                // Revision\r
    sizeof (EFI_RUNTIME_SERVICES),                                // HeaderSize\r
    0,                                                            // CRC32\r
    0                                                             // Reserved\r
  },\r
  (EFI_GET_TIME)                    CoreEfiNotAvailableYetArg2,   // GetTime\r
  (EFI_SET_TIME)                    CoreEfiNotAvailableYetArg1,   // SetTime\r
  (EFI_GET_WAKEUP_TIME)             CoreEfiNotAvailableYetArg3,   // GetWakeupTime\r
  (EFI_SET_WAKEUP_TIME)             CoreEfiNotAvailableYetArg2,   // SetWakeupTime\r
  (EFI_SET_VIRTUAL_ADDRESS_MAP)     CoreEfiNotAvailableYetArg4,   // SetVirtualAddressMap\r
  (EFI_CONVERT_POINTER)             CoreEfiNotAvailableYetArg2,   // ConvertPointer\r
  (EFI_GET_VARIABLE)                CoreEfiNotAvailableYetArg5,   // GetVariable\r
  (EFI_GET_NEXT_VARIABLE_NAME)      CoreEfiNotAvailableYetArg3,   // GetNextVariableName\r
  (EFI_SET_VARIABLE)                CoreEfiNotAvailableYetArg5,   // SetVariable\r
  (EFI_GET_NEXT_HIGH_MONO_COUNT)    CoreEfiNotAvailableYetArg1,   // GetNextHighMonotonicCount\r
  (EFI_RESET_SYSTEM)                CoreEfiNotAvailableYetArg4,   // ResetSystem\r
  (EFI_UPDATE_CAPSULE)              CoreEfiNotAvailableYetArg3,   // UpdateCapsule\r
  (EFI_QUERY_CAPSULE_CAPABILITIES)  CoreEfiNotAvailableYetArg4,   // QueryCapsuleCapabilities\r
  (EFI_QUERY_VARIABLE_INFO)         CoreEfiNotAvailableYetArg4    // QueryVariableInfo\r
};\r
\r
EFI_RUNTIME_ARCH_PROTOCOL gRuntimeTemplate = {\r
  INITIALIZE_LIST_HEAD_VARIABLE (gRuntimeTemplate.ImageHead),\r
  INITIALIZE_LIST_HEAD_VARIABLE (gRuntimeTemplate.EventHead),\r
\r
  //\r
  // Make sure Size != sizeof (EFI_MEMORY_DESCRIPTOR). This will\r
  // prevent people from having pointer math bugs in their code.\r
  // now you have to use *DescriptorSize to make things work.\r
  //\r
  sizeof (EFI_MEMORY_DESCRIPTOR) + sizeof (UINT64) - (sizeof (EFI_MEMORY_DESCRIPTOR) % sizeof (UINT64)),\r
  EFI_MEMORY_DESCRIPTOR_VERSION,\r
  0,\r
  NULL,\r
  NULL,\r
  FALSE,\r
  FALSE\r
};\r
\r
EFI_RUNTIME_ARCH_PROTOCOL *gRuntime = &gRuntimeTemplate;\r
\r
//\r
// DXE Core Global Variables for the EFI System Table, Boot Services Table,\r
// DXE Services Table, and Runtime Services Table\r
//\r
EFI_DXE_SERVICES      *gDxeCoreDS = &mDxeServices;\r
EFI_SYSTEM_TABLE      *gDxeCoreST = NULL;\r
\r
//\r
// For debug initialize gDxeCoreRT to template. gDxeCoreRT must be allocated from RT memory\r
//  but gDxeCoreRT is used for ASSERT () and DEBUG () type macros so lets give it\r
//  a value that will not cause debug infrastructure to crash early on.\r
//\r
EFI_RUNTIME_SERVICES  *gDxeCoreRT = &mEfiRuntimeServicesTableTemplate;\r
EFI_HANDLE            gDxeCoreImageHandle = NULL;\r
\r
\r
//\r
// EFI Decompress Protocol\r
//\r
EFI_DECOMPRESS_PROTOCOL  gEfiDecompress = {\r
  DxeMainUefiDecompressGetInfo,\r
  DxeMainUefiDecompress\r
};\r
\r
//\r
// Main entry point to the DXE Core\r
//\r
\r
/**\r
  Main entry point to DXE Core.\r
\r
  @param  HobStart               Pointer to the beginning of the HOB List from PEI.\r
\r
  @return This function should never return.\r
\r
**/\r
VOID\r
EFIAPI\r
DxeMain (\r
  IN  VOID *HobStart\r
  )\r
{\r
  EFI_STATUS                         Status;\r
  EFI_PHYSICAL_ADDRESS               MemoryBaseAddress;\r
  UINT64                             MemoryLength;\r
\r
  //\r
  // Initialize Memory Services\r
  //\r
  CoreInitializeMemoryServices (&HobStart, &MemoryBaseAddress, &MemoryLength);\r
\r
  //\r
  // Allocate the EFI System Table and EFI Runtime Service Table from EfiRuntimeServicesData\r
  // Use the templates to initialize the contents of the EFI System Table and EFI Runtime Services Table\r
  //\r
  gDxeCoreST = AllocateRuntimeCopyPool (sizeof (EFI_SYSTEM_TABLE), &mEfiSystemTableTemplate);\r
  ASSERT (gDxeCoreST != NULL);\r
\r
  gDxeCoreRT = AllocateRuntimeCopyPool (sizeof (EFI_RUNTIME_SERVICES), &mEfiRuntimeServicesTableTemplate);\r
  ASSERT (gDxeCoreRT != NULL);\r
\r
  gDxeCoreST->RuntimeServices = gDxeCoreRT;\r
\r
  //\r
  // Start the Image Services.\r
  //\r
  Status = CoreInitializeImageServices (HobStart);\r
  ASSERT_EFI_ERROR (Status);\r
\r
  //\r
  // Call constructor for all libraries\r
  //\r
  ProcessLibraryConstructorList (gDxeCoreImageHandle, gDxeCoreST);\r
  PERF_END   (0,PEI_TOK, NULL, 0) ;\r
  PERF_START (0,DXE_TOK, NULL, 0) ;\r
\r
  //\r
  // Initialize the Global Coherency Domain Services\r
  //\r
  Status = CoreInitializeGcdServices (&HobStart, MemoryBaseAddress, MemoryLength);\r
  ASSERT_EFI_ERROR (Status);\r
\r
  //\r
  // Install the DXE Services Table into the EFI System Tables's Configuration Table\r
  //\r
  Status = CoreInstallConfigurationTable (&gEfiDxeServicesTableGuid, gDxeCoreDS);\r
  ASSERT_EFI_ERROR (Status);\r
\r
  //\r
  // Install the HOB List into the EFI System Tables's Configuration Table\r
  //\r
  Status = CoreInstallConfigurationTable (&gEfiHobListGuid, HobStart);\r
  ASSERT_EFI_ERROR (Status);\r
\r
  //\r
  // Install Memory Type Information Table into the EFI System Tables's Configuration Table\r
  //\r
  Status = CoreInstallConfigurationTable (&gEfiMemoryTypeInformationGuid, &gMemoryTypeInformation);\r
  ASSERT_EFI_ERROR (Status);\r
\r
  //\r
  // Initialize the ReportStatusCode with PEI version, if available\r
  //\r
  CoreGetPeiProtocol (&gEfiStatusCodeRuntimeProtocolGuid, (VOID **) &gStatusCode->ReportStatusCode);\r
\r
  //\r
  // Report Status Code here for DXE_ENTRY_POINT once it is available\r
  //\r
  REPORT_STATUS_CODE (\r
    EFI_PROGRESS_CODE,\r
    FixedPcdGet32(PcdStatusCodeValueDxeCoreEntry)\r
    );\r
\r
  //\r
  // Create the aligned system table pointer structure that is used by external\r
  // debuggers to locate the system table...  Also, install debug image info\r
  // configuration table.\r
  //\r
  CoreInitializeDebugImageInfoTable ();\r
  CoreNewDebugImageInfoEntry (\r
    EFI_DEBUG_IMAGE_INFO_TYPE_NORMAL,\r
    gDxeCoreLoadedImage,\r
    gDxeCoreImageHandle\r
    );\r
\r
  DEBUG ((DEBUG_INFO | DEBUG_LOAD, "HOBLIST address in DXE = 0x%p\n", HobStart));\r
\r
  //\r
  // Initialize the Event Services\r
  //\r
  Status = CoreInitializeEventServices ();\r
  ASSERT_EFI_ERROR (Status);\r
\r
\r
  //\r
  // Get the Protocols that were passed in from PEI to DXE through GUIDed HOBs\r
  //\r
  // These Protocols are not architectural. This implementation is sharing code between\r
  // PEI and DXE in order to save FLASH space. These Protocols could also be implemented\r
  // as part of the DXE Core. However, that would also require the DXE Core to be ported\r
  // each time a different CPU is used, a different Decompression algorithm is used, or a\r
  // different Image type is used. By placing these Protocols in PEI, the DXE Core remains\r
  // generic, and only PEI and the Arch Protocols need to be ported from Platform to Platform,\r
  // and from CPU to CPU.\r
  //\r
\r
  //\r
  // Publish the EFI, Tiano, and Custom Decompress protocols for use by other DXE components\r
  //\r
  Status = CoreInstallMultipleProtocolInterfaces (\r
             &mDecompressHandle,\r
             &gEfiDecompressProtocolGuid,           &gEfiDecompress,\r
             NULL\r
             );\r
  ASSERT_EFI_ERROR (Status);\r
\r
  //\r
  // Register for the GUIDs of the Architectural Protocols, so the rest of the\r
  // EFI Boot Services and EFI Runtime Services tables can be filled in.\r
  //\r
  CoreNotifyOnArchProtocolInstallation ();\r
\r
  //\r
  // Produce Firmware Volume Protocols, one for each FV in the HOB list.\r
  //\r
  Status = FwVolBlockDriverInit (gDxeCoreImageHandle, gDxeCoreST);\r
  ASSERT_EFI_ERROR (Status);\r
\r
  Status = FwVolDriverInit (gDxeCoreImageHandle, gDxeCoreST);\r
  ASSERT_EFI_ERROR (Status);\r
\r
  //\r
  // Produce the Section Extraction Protocol\r
  //\r
  Status = InitializeSectionExtraction (gDxeCoreImageHandle, gDxeCoreST);\r
  ASSERT_EFI_ERROR (Status);\r
\r
  //\r
  // Initialize the DXE Dispatcher\r
  //\r
  PERF_START (0,"CoreInitializeDispatcher", "DxeMain", 0) ;\r
  CoreInitializeDispatcher ();\r
  PERF_END (0,"CoreInitializeDispatcher", "DxeMain", 0) ;\r
\r
  //\r
  // Invoke the DXE Dispatcher\r
  //\r
  PERF_START (0, "CoreDispatcher", "DxeMain", 0);\r
  CoreDispatcher ();\r
  PERF_END (0, "CoreDispatcher", "DxeMain", 0);\r
\r
  //\r
  // Display Architectural protocols that were not loaded if this is DEBUG build\r
  //\r
  DEBUG_CODE_BEGIN ();\r
    CoreDisplayMissingArchProtocols ();\r
  DEBUG_CODE_END ();\r
\r
  //\r
  // Assert if the Architectural Protocols are not present.\r
  //\r
  ASSERT_EFI_ERROR (CoreAllEfiServicesAvailable ());\r
\r
  //\r
  // Report Status code before transfer control to BDS\r
  //\r
  REPORT_STATUS_CODE (\r
    EFI_PROGRESS_CODE,\r
    FixedPcdGet32 (PcdStatusCodeValueDxeCoreHandoffToBds)\r
    );\r
\r
  //\r
  // Display any drivers that were not dispatched because dependency expression\r
  // evaluated to false if this is a debug build\r
  //\r
  DEBUG_CODE_BEGIN ();\r
    CoreDisplayDiscoveredNotDispatched ();\r
  DEBUG_CODE_END ();\r
\r
  //\r
  // Transfer control to the BDS Architectural Protocol\r
  //\r
  gBds->Entry (gBds);\r
\r
  //\r
  // BDS should never return\r
  //\r
  ASSERT (FALSE);\r
  CpuDeadLoop ();\r
}\r
\r
\r
\r
/**\r
  Place holder function until all the Boot Services and Runtime Services are\r
  available.\r
\r
  @return EFI_NOT_AVAILABLE_YET\r
\r
**/\r
EFI_STATUS\r
EFIAPI\r
CoreEfiNotAvailableYetArg0 (\r
  VOID\r
  )\r
{\r
  //\r
  // This function should never be executed.  If it does, then the architectural protocols\r
  // have not been designed correctly.  The CpuBreakpoint () is commented out for now until the\r
  // DXE Core and all the Architectural Protocols are complete.\r
  //\r
\r
  return EFI_NOT_AVAILABLE_YET;\r
}\r
\r
\r
/**\r
  Place holder function until all the Boot Services and Runtime Services are\r
  available.\r
\r
  @param  Arg1                   Undefined\r
\r
  @return EFI_NOT_AVAILABLE_YET\r
\r
**/\r
EFI_STATUS\r
EFIAPI\r
CoreEfiNotAvailableYetArg1 (\r
  UINTN Arg1\r
  )\r
{\r
  //\r
  // This function should never be executed.  If it does, then the architectural protocols\r
  // have not been designed correctly.  The CpuBreakpoint () is commented out for now until the\r
  // DXE Core and all the Architectural Protocols are complete.\r
  //\r
\r
  return EFI_NOT_AVAILABLE_YET;\r
}\r
\r
\r
/**\r
  Place holder function until all the Boot Services and Runtime Services are available.\r
\r
  @param  Arg1                   Undefined\r
  @param  Arg2                   Undefined\r
\r
  @return EFI_NOT_AVAILABLE_YET\r
\r
**/\r
EFI_STATUS\r
EFIAPI\r
CoreEfiNotAvailableYetArg2 (\r
  UINTN Arg1,\r
  UINTN Arg2\r
  )\r
{\r
  //\r
  // This function should never be executed.  If it does, then the architectural protocols\r
  // have not been designed correctly.  The CpuBreakpoint () is commented out for now until the\r
  // DXE Core and all the Architectural Protocols are complete.\r
  //\r
\r
  return EFI_NOT_AVAILABLE_YET;\r
}\r
\r
\r
/**\r
  Place holder function until all the Boot Services and Runtime Services are available.\r
\r
  @param  Arg1                   Undefined\r
  @param  Arg2                   Undefined\r
  @param  Arg3                   Undefined\r
\r
  @return EFI_NOT_AVAILABLE_YET\r
\r
**/\r
EFI_STATUS\r
EFIAPI\r
CoreEfiNotAvailableYetArg3 (\r
  UINTN Arg1,\r
  UINTN Arg2,\r
  UINTN Arg3\r
  )\r
{\r
  //\r
  // This function should never be executed.  If it does, then the architectural protocols\r
  // have not been designed correctly.  The CpuBreakpoint () is commented out for now until the\r
  // DXE Core and all the Architectural Protocols are complete.\r
  //\r
\r
  return EFI_NOT_AVAILABLE_YET;\r
}\r
\r
\r
/**\r
  Place holder function until all the Boot Services and Runtime Services are available.\r
\r
  @param  Arg1                   Undefined\r
  @param  Arg2                   Undefined\r
  @param  Arg3                   Undefined\r
  @param  Arg4                   Undefined\r
\r
  @return EFI_NOT_AVAILABLE_YET\r
\r
**/\r
EFI_STATUS\r
EFIAPI\r
CoreEfiNotAvailableYetArg4 (\r
  UINTN Arg1,\r
  UINTN Arg2,\r
  UINTN Arg3,\r
  UINTN Arg4\r
  )\r
{\r
  //\r
  // This function should never be executed.  If it does, then the architectural protocols\r
  // have not been designed correctly.  The CpuBreakpoint () is commented out for now until the\r
  // DXE Core and all the Architectural Protocols are complete.\r
  //\r
\r
  return EFI_NOT_AVAILABLE_YET;\r
}\r
\r
\r
/**\r
  Place holder function until all the Boot Services and Runtime Services are available.\r
\r
  @param  Arg1                   Undefined\r
  @param  Arg2                   Undefined\r
  @param  Arg3                   Undefined\r
  @param  Arg4                   Undefined\r
  @param  Arg5                   Undefined\r
\r
  @return EFI_NOT_AVAILABLE_YET\r
\r
**/\r
EFI_STATUS\r
EFIAPI\r
CoreEfiNotAvailableYetArg5 (\r
  UINTN Arg1,\r
  UINTN Arg2,\r
  UINTN Arg3,\r
  UINTN Arg4,\r
  UINTN Arg5\r
  )\r
{\r
  //\r
  // This function should never be executed.  If it does, then the architectural protocols\r
  // have not been designed correctly.  The CpuBreakpoint () is commented out for now until the\r
  // DXE Core and all the Architectural Protocols are complete.\r
  //\r
\r
  return EFI_NOT_AVAILABLE_YET;\r
}\r
\r
\r
\r
/**\r
  Searches for a Protocol Interface passed from PEI through a HOB.\r
\r
  @param  ProtocolGuid           The Protocol GUID to search for in the HOB List\r
  @param  Interface              A pointer to the interface for the Protocol GUID\r
\r
  @retval EFI_SUCCESS            The Protocol GUID was found and its interface is\r
                                 returned in Interface\r
  @retval EFI_NOT_FOUND          The Protocol GUID was not found in the HOB List\r
\r
**/\r
EFI_STATUS\r
CoreGetPeiProtocol (\r
  IN EFI_GUID  *ProtocolGuid,\r
  IN VOID      **Interface\r
  )\r
{\r
  EFI_HOB_GUID_TYPE   *GuidHob;\r
  VOID                *Buffer;\r
\r
  GuidHob = GetFirstGuidHob (ProtocolGuid);\r
  if (GuidHob == NULL) {\r
    return EFI_NOT_FOUND;\r
  }\r
\r
  Buffer = GET_GUID_HOB_DATA (GuidHob);\r
  ASSERT (Buffer != NULL);\r
\r
  *Interface = (VOID *)(*(UINTN *)(Buffer));\r
\r
  return EFI_SUCCESS;\r
}\r
\r
\r
\r
/**\r
  Calcualte the 32-bit CRC in a EFI table using the service provided by the\r
  gRuntime service.\r
\r
  @param  Hdr                    Pointer to an EFI standard header\r
\r
**/\r
VOID\r
CalculateEfiHdrCrc (\r
  IN  OUT EFI_TABLE_HEADER    *Hdr\r
  )\r
{\r
  UINT32 Crc;\r
\r
  Hdr->CRC32 = 0;\r
\r
  //\r
  // If gBS->CalculateCrce32 () == CoreEfiNotAvailableYet () then\r
  //  Crc will come back as zero if we set it to zero here\r
  //\r
  Crc = 0;\r
  gBS->CalculateCrc32 ((UINT8 *)Hdr, Hdr->HeaderSize, &Crc);\r
  Hdr->CRC32 = Crc;\r
}\r
\r
\r
\r
\r
/**\r
  Terminates all boot services.\r
\r
  @param  ImageHandle            Handle that identifies the exiting image.\r
  @param  MapKey                 Key to the latest memory map.\r
\r
  @retval EFI_SUCCESS            Boot Services terminated\r
  @retval EFI_INVALID_PARAMETER  MapKey is incorrect.\r
\r
**/\r
EFI_STATUS\r
EFIAPI\r
CoreExitBootServices (\r
  IN EFI_HANDLE   ImageHandle,\r
  IN UINTN        MapKey\r
  )\r
{\r
  EFI_STATUS                Status;\r
  EFI_STATUS                StatusTemp;\r
  EFI_TCG_PLATFORM_PROTOCOL *TcgPlatformProtocol;\r
\r
  //\r
  // Measure invocation of ExitBootServices,\r
  // which is defined by TCG_EFI_Platform_1_20_Final Specification\r
  //\r
  TcgPlatformProtocol = NULL;\r
  Status = CoreLocateProtocol (\r
             &gEfiTcgPlatformProtocolGuid,\r
             NULL,\r
             (VOID **) &TcgPlatformProtocol\r
             );\r
  if (!EFI_ERROR (Status)) {\r
    Status = TcgPlatformProtocol->MeasureAction (EFI_EXIT_BOOT_SERVICES_INVOCATION);\r
    ASSERT_EFI_ERROR (Status);\r
  }\r
\r
  //\r
  // Terminate memory services if the MapKey matches\r
  //\r
  Status = CoreTerminateMemoryMap (MapKey);\r
  if (EFI_ERROR (Status)) {\r
    //\r
    // Measure failure of ExitBootServices\r
    //\r
    if (TcgPlatformProtocol != NULL) {\r
      StatusTemp = TcgPlatformProtocol->MeasureAction (EFI_EXIT_BOOT_SERVICES_FAILED);\r
      ASSERT_EFI_ERROR (StatusTemp);\r
    }\r
\r
    return Status;\r
  }\r
\r
  //\r
  // Notify other drivers that we are exiting boot services.\r
  //\r
  CoreNotifySignalList (&gEfiEventExitBootServicesGuid);\r
\r
  //\r
  // Disable Timer\r
  //\r
  gTimer->SetTimerPeriod (gTimer, 0);\r
\r
  //\r
  // Disable CPU Interrupts\r
  //\r
  gCpu->DisableInterrupt (gCpu);\r
\r
  //\r
  // Report that ExitBootServices() has been called\r
  //\r
  REPORT_STATUS_CODE (\r
    EFI_PROGRESS_CODE,\r
    FixedPcdGet32 (PcdStatusCodeValueBootServiceExit)\r
    );\r
\r
  //\r
  // Clear the non-runtime values of the EFI System Table\r
  //\r
  gDxeCoreST->BootServices        = NULL;\r
  gDxeCoreST->ConIn               = NULL;\r
  gDxeCoreST->ConsoleInHandle     = NULL;\r
  gDxeCoreST->ConOut              = NULL;\r
  gDxeCoreST->ConsoleOutHandle    = NULL;\r
  gDxeCoreST->StdErr              = NULL;\r
  gDxeCoreST->StandardErrorHandle = NULL;\r
\r
  //\r
  // Recompute the 32-bit CRC of the EFI System Table\r
  //\r
  CalculateEfiHdrCrc (&gDxeCoreST->Hdr);\r
\r
  //\r
  // Zero out the Boot Service Table\r
  //\r
  ZeroMem (gBS, sizeof (EFI_BOOT_SERVICES));\r
  gBS = NULL;\r
\r
  //\r
  // Update the AtRuntime field in Runtiem AP.\r
  //\r
  gRuntime->AtRuntime = TRUE;\r
\r
  //\r
  // Measure success of ExitBootServices\r
  //\r
  if (TcgPlatformProtocol != NULL) {\r
    StatusTemp = TcgPlatformProtocol->MeasureAction (EFI_EXIT_BOOT_SERVICES_SUCCEEDED);\r
    ASSERT_EFI_ERROR (StatusTemp);\r
  }\r
\r
  return Status;\r
}\r
\r
\r
/**\r
  Given a compressed source buffer, this function retrieves the size of the\r
  uncompressed buffer and the size of the scratch buffer required to decompress\r
  the compressed source buffer.\r
\r
  The GetInfo() function retrieves the size of the uncompressed buffer and the\r
  temporary scratch buffer required to decompress the buffer specified by Source\r
  and SourceSize. If the size of the uncompressed buffer or the size of the\r
  scratch buffer cannot be determined from the compressed data specified by\r
  Source and SourceData, then EFI_INVALID_PARAMETER is returned. Otherwise, the\r
  size of the uncompressed buffer is returned in DestinationSize, the size of\r
  the scratch buffer is returned in ScratchSize, and EFI_SUCCESS is returned.\r
  The GetInfo() function does not have scratch buffer available to perform a\r
  thorough checking of the validity of the source data. It just retrieves the\r
  "Original Size" field from the beginning bytes of the source data and output\r
  it as DestinationSize. And ScratchSize is specific to the decompression\r
  implementation.\r
\r
  @param  This               A pointer to the EFI_DECOMPRESS_PROTOCOL instance.\r
  @param  Source             The source buffer containing the compressed data.\r
  @param  SourceSize         The size, in bytes, of the source buffer.\r
  @param  DestinationSize    A pointer to the size, in bytes, of the\r
                             uncompressed buffer that will be generated when the\r
                             compressed buffer specified by Source and\r
                             SourceSize is decompressed.\r
  @param  ScratchSize        A pointer to the size, in bytes, of the scratch\r
                             buffer that is required to decompress the\r
                             compressed buffer specified by Source and\r
                             SourceSize.\r
\r
  @retval EFI_SUCCESS        The size of the uncompressed data was returned in\r
                             DestinationSize and the size of the scratch buffer\r
                             was returned in ScratchSize.\r
  @retval EFI_INVALID_PARAMETER The size of the uncompressed data or the size of\r
                                the scratch buffer cannot be determined from the\r
                                compressed data specified by Source and\r
                                SourceSize.\r
\r
**/\r
EFI_STATUS\r
EFIAPI\r
DxeMainUefiDecompressGetInfo (\r
  IN EFI_DECOMPRESS_PROTOCOL            *This,\r
  IN   VOID                             *Source,\r
  IN   UINT32                           SourceSize,\r
  OUT  UINT32                           *DestinationSize,\r
  OUT  UINT32                           *ScratchSize\r
  )\r
{\r
  if (Source == NULL || DestinationSize == NULL || ScratchSize == NULL) {\r
    return EFI_INVALID_PARAMETER;\r
  }\r
  return UefiDecompressGetInfo (Source, SourceSize, DestinationSize, ScratchSize);\r
}\r
\r
\r
/**\r
  Decompresses a compressed source buffer.\r
\r
  The Decompress() function extracts decompressed data to its original form.\r
  This protocol is designed so that the decompression algorithm can be\r
  implemented without using any memory services. As a result, the Decompress()\r
  Function is not allowed to call AllocatePool() or AllocatePages() in its\r
  implementation. It is the caller's responsibility to allocate and free the\r
  Destination and Scratch buffers.\r
  If the compressed source data specified by Source and SourceSize is\r
  sucessfully decompressed into Destination, then EFI_SUCCESS is returned. If\r
  the compressed source data specified by Source and SourceSize is not in a\r
  valid compressed data format, then EFI_INVALID_PARAMETER is returned.\r
\r
  @param  This                A pointer to the EFI_DECOMPRESS_PROTOCOL instance.\r
  @param  Source              The source buffer containing the compressed data.\r
  @param  SourceSize          SourceSizeThe size of source data.\r
  @param  Destination         On output, the destination buffer that contains\r
                              the uncompressed data.\r
  @param  DestinationSize     The size of the destination buffer.  The size of\r
                              the destination buffer needed is obtained from\r
                              EFI_DECOMPRESS_PROTOCOL.GetInfo().\r
  @param  Scratch             A temporary scratch buffer that is used to perform\r
                              the decompression.\r
  @param  ScratchSize         The size of scratch buffer. The size of the\r
                              scratch buffer needed is obtained from GetInfo().\r
\r
  @retval EFI_SUCCESS         Decompression completed successfully, and the\r
                              uncompressed buffer is returned in Destination.\r
  @retval EFI_INVALID_PARAMETER  The source buffer specified by Source and\r
                                 SourceSize is corrupted (not in a valid\r
                                 compressed format).\r
\r
**/\r
EFI_STATUS\r
EFIAPI\r
DxeMainUefiDecompress (\r
  IN     EFI_DECOMPRESS_PROTOCOL          *This,\r
  IN     VOID                             *Source,\r
  IN     UINT32                           SourceSize,\r
  IN OUT VOID                             *Destination,\r
  IN     UINT32                           DestinationSize,\r
  IN OUT VOID                             *Scratch,\r
  IN     UINT32                           ScratchSize\r
  )\r
{\r
  EFI_STATUS  Status;\r
  UINT32      TestDestinationSize;\r
  UINT32      TestScratchSize;\r
\r
  if (Source == NULL || Destination== NULL || Scratch == NULL) {\r
    return EFI_INVALID_PARAMETER;\r
  }\r
\r
  Status = UefiDecompressGetInfo (Source, SourceSize, &TestDestinationSize, &TestScratchSize);\r
  if (EFI_ERROR (Status)) {\r
    return Status;\r
  }\r
\r
  if (ScratchSize < TestScratchSize || DestinationSize < TestDestinationSize) {\r
    return RETURN_INVALID_PARAMETER;\r
  }\r
\r
  return UefiDecompress (Source, Destination, Scratch);\r
}\r