MdeModulePkg/Core/Dxe/DxeMain/DxeMain.c

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