ArmPkg: Fixed GetEnvironmentVariable() when the UEFI Variable did not exist

[mirror_edk2.git] / ArmPkg / Include / Library / BdsLib.h

/** @file\r
*\r
*  Copyright (c) 2013, ARM Limited. All rights reserved.\r
*\r
*  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
#ifndef __BDS_ENTRY_H__\r
#define __BDS_ENTRY_H__\r
\r
typedef UINT8* EFI_LOAD_OPTION;\r
\r
/**\r
  This is defined by the UEFI specs, don't change it\r
**/\r
typedef struct {\r
  UINT16                      LoadOptionIndex;\r
  EFI_LOAD_OPTION             LoadOption;\r
  UINTN                       LoadOptionSize;\r
\r
  UINT32                      Attributes;\r
  UINT16                      FilePathListLength;\r
  CHAR16                      *Description;\r
  EFI_DEVICE_PATH_PROTOCOL    *FilePathList;\r
\r
  VOID*                       OptionalData;\r
  UINTN                       OptionalDataSize;\r
} BDS_LOAD_OPTION;\r
\r
/**\r
  Connect a Device Path and return the handle of the driver that support this DevicePath\r
\r
  @param  DevicePath            Device Path of the File to connect\r
  @param  Handle                Handle of the driver that support this DevicePath\r
  @param  RemainingDevicePath   Remaining DevicePath nodes that do not match the driver DevicePath\r
\r
  @retval EFI_SUCCESS           A driver that matches the Device Path has been found\r
  @retval EFI_NOT_FOUND         No handles match the search.\r
  @retval EFI_INVALID_PARAMETER DevicePath or Handle is NULL\r
\r
**/\r
EFI_STATUS\r
BdsConnectDevicePath (\r
  IN  EFI_DEVICE_PATH_PROTOCOL* DevicePath,\r
  OUT EFI_HANDLE                *Handle,\r
  OUT EFI_DEVICE_PATH_PROTOCOL  **RemainingDevicePath\r
  );\r
\r
/**\r
  Connect all DXE drivers\r
\r
  @retval EFI_SUCCESS           All drivers have been connected\r
  @retval EFI_NOT_FOUND         No handles match the search.\r
  @retval EFI_OUT_OF_RESOURCES  There is not resource pool memory to store the matching results.\r
\r
**/\r
EFI_STATUS\r
BdsConnectAllDrivers (\r
  VOID\r
  );\r
\r
/**\r
  Return the value of a global variable defined by its VariableName.\r
  The variable must be defined with the VendorGuid gEfiGlobalVariableGuid.\r
\r
  @param  VariableName          A Null-terminated string that is the name of the vendor's\r
                                variable.\r
  @param  DefaultValue          Value returned by the function if the variable does not exist\r
  @param  DataSize              On input, the size in bytes of the return Data buffer.\r
                                On output the size of data returned in Data.\r
  @param  Value                 Value read from the UEFI Variable or copy of the default value\r
                                if the UEFI Variable does not exist\r
\r
  @retval EFI_SUCCESS           All drivers have been connected\r
  @retval EFI_NOT_FOUND         No handles match the search.\r
  @retval EFI_OUT_OF_RESOURCES  There is not resource pool memory to store the matching results.\r
\r
**/\r
EFI_STATUS\r
GetGlobalEnvironmentVariable (\r
  IN     CONST CHAR16*   VariableName,\r
  IN     VOID*           DefaultValue,\r
  IN OUT UINTN*          Size,\r
  OUT    VOID**          Value\r
  );\r
\r
/**\r
  Return the value of the variable defined by its VariableName and VendorGuid\r
\r
  @param  VariableName          A Null-terminated string that is the name of the vendor's\r
                                variable.\r
  @param  VendorGuid            A unique identifier for the vendor.\r
  @param  DefaultValue          Value returned by the function if the variable does not exist\r
  @param  DataSize              On input, the size in bytes of the return Data buffer.\r
                                On output the size of data returned in Data.\r
  @param  Value                 Value read from the UEFI Variable or copy of the default value\r
                                if the UEFI Variable does not exist\r
\r
  @retval EFI_SUCCESS           All drivers have been connected\r
  @retval EFI_NOT_FOUND         No handles match the search.\r
  @retval EFI_OUT_OF_RESOURCES  There is not resource pool memory to store the matching results.\r
\r
**/\r
EFI_STATUS\r
GetEnvironmentVariable (\r
  IN     CONST CHAR16*   VariableName,\r
  IN     EFI_GUID*       VendorGuid,\r
  IN     VOID*           DefaultValue,\r
  IN OUT UINTN*          Size,\r
  OUT    VOID**          Value\r
  );\r
\r
EFI_STATUS\r
BootOptionFromLoadOptionIndex (\r
  IN  UINT16            LoadOptionIndex,\r
  OUT BDS_LOAD_OPTION** BdsLoadOption\r
  );\r
\r
EFI_STATUS\r
BootOptionFromLoadOptionVariable (\r
  IN  CHAR16*           BootVariableName,\r
  OUT BDS_LOAD_OPTION** BdsLoadOption\r
  );\r
\r
EFI_STATUS\r
BootOptionToLoadOptionVariable (\r
  IN BDS_LOAD_OPTION*   BdsLoadOption\r
  );\r
\r
UINT16\r
BootOptionAllocateBootIndex (\r
  VOID\r
  );\r
\r
/**\r
  Start a Linux kernel from a Device Path\r
\r
  @param  LinuxKernel           Device Path to the Linux Kernel\r
  @param  Parameters            Linux kernel arguments\r
\r
  @retval EFI_SUCCESS           All drivers have been connected\r
  @retval EFI_NOT_FOUND         The Linux kernel Device Path has not been found\r
  @retval EFI_OUT_OF_RESOURCES  There is not enough resource memory to store the matching results.\r
\r
**/\r
EFI_STATUS\r
BdsBootLinuxAtag (\r
  IN  EFI_DEVICE_PATH_PROTOCOL* LinuxKernelDevicePath,\r
  IN  EFI_DEVICE_PATH_PROTOCOL* InitrdDevicePath,\r
  IN  CONST CHAR8*              Arguments\r
  );\r
\r
/**\r
  Start a Linux kernel from a Device Path\r
\r
  @param  LinuxKernel           Device Path to the Linux Kernel\r
  @param  Parameters            Linux kernel arguments\r
  @param  Fdt                   Device Path to the Flat Device Tree\r
\r
  @retval EFI_SUCCESS           All drivers have been connected\r
  @retval EFI_NOT_FOUND         The Linux kernel Device Path has not been found\r
  @retval EFI_OUT_OF_RESOURCES  There is not enough resource memory to store the matching results.\r
\r
**/\r
EFI_STATUS\r
BdsBootLinuxFdt (\r
  IN  EFI_DEVICE_PATH_PROTOCOL* LinuxKernelDevicePath,\r
  IN  EFI_DEVICE_PATH_PROTOCOL* InitrdDevicePath,\r
  IN  CONST CHAR8*              Arguments,\r
  IN  EFI_DEVICE_PATH_PROTOCOL* FdtDevicePath\r
  );\r
\r
/**\r
  Start an EFI Application from a Device Path\r
\r
  @param  ParentImageHandle     Handle of the calling image\r
  @param  DevicePath            Location of the EFI Application\r
\r
  @retval EFI_SUCCESS           All drivers have been connected\r
  @retval EFI_NOT_FOUND         The Linux kernel Device Path has not been found\r
  @retval EFI_OUT_OF_RESOURCES  There is not enough resource memory to store the matching results.\r
\r
**/\r
EFI_STATUS\r
BdsStartEfiApplication (\r
  IN EFI_HANDLE                  ParentImageHandle,\r
  IN EFI_DEVICE_PATH_PROTOCOL    *DevicePath,\r
  IN UINTN                       LoadOptionsSize,\r
  IN VOID*                       LoadOptions\r
  );\r
\r
/**\r
  Start an EFI Application from any Firmware Volume\r
\r
  @param  EfiApp                EFI Application Name\r
\r
  @retval EFI_SUCCESS           All drivers have been connected\r
  @retval EFI_NOT_FOUND         The Linux kernel Device Path has not been found\r
  @retval EFI_OUT_OF_RESOURCES  There is not enough resource memory to store the matching results.\r
\r
**/\r
EFI_STATUS\r
BdsLoadApplication (\r
  IN EFI_HANDLE                  ParentImageHandle,\r
  IN CHAR16*                     EfiApp,\r
  IN UINTN                       LoadOptionsSize,\r
  IN VOID*                       LoadOptions\r
  );\r
\r
EFI_STATUS\r
BdsLoadImage (\r
  IN     EFI_DEVICE_PATH       *DevicePath,\r
  IN     EFI_ALLOCATE_TYPE     Type,\r
  IN OUT EFI_PHYSICAL_ADDRESS* Image,\r
  OUT    UINTN                 *FileSize\r
  );\r
\r
#endif\r