ArmPkg/Include/Library/BdsLib.h

   1 /** @file
   2 *
   3 *  Copyright (c) 2011, ARM Limited. All rights reserved.
   4 *
   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
   9 *
  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.
  12 *
  13 **/
  14
  15 #ifndef __BDS_ENTRY_H__
  16 #define __BDS_ENTRY_H__
  17
  18 typedef UINT8* EFI_LOAD_OPTION;
  19
  20 /**
  21   This is defined by the UEFI specs, don't change it
  22 **/
  23 typedef struct {
  24   UINT16                      LoadOptionIndex;
  25   EFI_LOAD_OPTION             LoadOption;
  26   UINTN                       LoadOptionSize;
  27
  28   UINT32                      Attributes;
  29   UINT16                      FilePathListLength;
  30   CHAR16                      *Description;
  31   EFI_DEVICE_PATH_PROTOCOL    *FilePathList;
  32
  33   VOID*                       OptionalData;
  34   UINTN                       OptionalDataSize;
  35 } BDS_LOAD_OPTION;
  36
  37 /**
  38   Connect a Device Path and return the handle of the driver that support this DevicePath
  39
  40   @param  DevicePath            Device Path of the File to connect
  41   @param  Handle                Handle of the driver that support this DevicePath
  42   @param  RemainingDevicePath   Remaining DevicePath nodes that do not match the driver DevicePath
  43
  44   @retval EFI_SUCCESS           A driver that matches the Device Path has been found
  45   @retval EFI_NOT_FOUND         No handles match the search.
  46   @retval EFI_INVALID_PARAMETER DevicePath or Handle is NULL
  47
  48 **/
  49 EFI_STATUS
  50 BdsConnectDevicePath (
  51   IN  EFI_DEVICE_PATH_PROTOCOL* DevicePath,
  52   OUT EFI_HANDLE                *Handle,
  53   OUT EFI_DEVICE_PATH_PROTOCOL  **RemainingDevicePath
  54   );
  55
  56 /**
  57   Connect all DXE drivers
  58
  59   @retval EFI_SUCCESS           All drivers have been connected
  60   @retval EFI_NOT_FOUND         No handles match the search.
  61   @retval EFI_OUT_OF_RESOURCES  There is not resource pool memory to store the matching results.
  62
  63 **/
  64 EFI_STATUS
  65 BdsConnectAllDrivers (
  66   VOID
  67   );
  68
  69 /**
  70   Start a Linux kernel from a Device Path
  71
  72   @param  LinuxKernel           Device Path to the Linux Kernel
  73   @param  Parameters            Linux kernel arguments
  74   @param  Fdt                   Device Path to the Flat Device Tree
  75
  76   @retval EFI_SUCCESS           All drivers have been connected
  77   @retval EFI_NOT_FOUND         The Linux kernel Device Path has not been found
  78   @retval EFI_OUT_OF_RESOURCES  There is not enough resource memory to store the matching results.
  79
  80 **/
  81 EFI_STATUS
  82 BdsBootLinux (
  83   IN  EFI_DEVICE_PATH_PROTOCOL* LinuxKernelDevicePath,
  84   IN  EFI_DEVICE_PATH_PROTOCOL* InitrdDevicePath,
  85   IN  CONST CHAR8*              Arguments,
  86   IN  EFI_DEVICE_PATH_PROTOCOL* FdtDevicePath
  87   );
  88
  89 /**
  90   Start an EFI Application from a Device Path
  91
  92   @param  ParentImageHandle     Handle of the calling image
  93   @param  DevicePath            Location of the EFI Application
  94
  95   @retval EFI_SUCCESS           All drivers have been connected
  96   @retval EFI_NOT_FOUND         The Linux kernel Device Path has not been found
  97   @retval EFI_OUT_OF_RESOURCES  There is not enough resource memory to store the matching results.
  98
  99 **/
 100 EFI_STATUS
 101 BdsStartEfiApplication (
 102   IN EFI_HANDLE                  ParentImageHandle,
 103   IN EFI_DEVICE_PATH_PROTOCOL    *DevicePath,
 104   IN UINTN                       LoadOptionsSize,
 105   IN VOID*                       LoadOptions
 106   );
 107
 108 /**
 109   Start an EFI Application from any Firmware Volume
 110
 111   @param  EfiApp                EFI Application Name
 112
 113   @retval EFI_SUCCESS           All drivers have been connected
 114   @retval EFI_NOT_FOUND         The Linux kernel Device Path has not been found
 115   @retval EFI_OUT_OF_RESOURCES  There is not enough resource memory to store the matching results.
 116
 117 **/
 118 EFI_STATUS
 119 BdsLoadApplication (
 120   IN EFI_HANDLE                  ParentImageHandle,
 121   IN CHAR16*                     EfiApp,
 122   IN UINTN                       LoadOptionsSize,
 123   IN VOID*                       LoadOptions
 124   );
 125
 126 #endif