code.delx.au - refind/blob - EfiLib/legacy.h

   1 /*
   2  * EfiLib/legacy.h
   3  * CSM/legacy boot support functions
   4  *
   5  * Taken from Tianocore source code (mostly IntelFrameworkModulePkg/Universal/BdsDxe/BootMaint/BBSsupport.c)
   6  *
   7  * Copyright (c) 2004 - 2011, Intel Corporation. All rights reserved.<BR>
   8  * This program and the accompanying materials
   9  * are licensed and made available under the terms and conditions of the BSD License
  10  * which accompanies this distribution.  The full text of the license may be found at
  11  * http://opensource.org/licenses/bsd-license.php
  12  *
  13  * THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
  14  * WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
  15  *
  16  */
  17
  18 #include "LegacyBios.h"
  19
  20 #ifndef __LEGACY_H_
  21 #define __LEGACY_H_
  22
  23 #define BBS_MEDIA_PRESENT        0x0800
  24 #define BBS_MEDIA_MAYBE_PRESENT  0x0400
  25
  26 typedef UINT8 BBS_TYPE;
  27
  28 #define VAR_FLAG  EFI_VARIABLE_BOOTSERVICE_ACCESS | EFI_VARIABLE_RUNTIME_ACCESS | EFI_VARIABLE_NON_VOLATILE
  29
  30 #pragma pack(1)
  31 ///
  32 /// For each legacy boot option in BBS table, a corresponding Boot#### variables is created.
  33 /// The structure saves the mapping relationship between #### and the index in the BBS table.
  34 ///
  35 typedef struct {
  36    UINT16    BootOptionNumber;
  37    UINT16    BbsIndex;
  38    UINT16    BbsType;
  39 } BOOT_OPTION_BBS_MAPPING;
  40 #pragma pack()
  41
  42 #pragma pack(1)
  43 typedef struct {
  44    BBS_TYPE  BbsType;
  45    ///
  46    /// Length = sizeof (UINT16) + sizeof (Data)
  47    ///
  48    UINT16    Length;
  49    UINT16    Data[1];
  50 } LEGACY_DEV_ORDER_ENTRY;
  51 #pragma pack()
  52
  53 EFI_STATUS
  54 BdsAddNonExistingLegacyBootOptions (
  55    VOID
  56 );
  57
  58 /**
  59   Delete all the invalid legacy boot options.
  60
  61   @retval EFI_SUCCESS             All invalide legacy boot options are deleted.
  62   @retval EFI_OUT_OF_RESOURCES    Fail to allocate necessary memory.
  63   @retval EFI_NOT_FOUND           Fail to retrive variable of boot order.
  64 **/
  65 EFI_STATUS
  66 BdsDeleteAllInvalidLegacyBootOptions (
  67   VOID
  68   );
  69
  70 BOOLEAN
  71 BdsIsLegacyBootOption (
  72    IN UINT8                 *BootOptionVar,
  73    OUT BBS_TABLE            **BbsEntry,
  74    OUT UINT16               *BbsIndex
  75 );
  76
  77 VOID
  78 BdsBuildLegacyDevNameString (
  79    IN  BBS_TABLE                 *CurBBSEntry,
  80    IN  UINTN                     Index,
  81    IN  UINTN                     BufSize,
  82    OUT CHAR16                    *BootString
  83 );
  84
  85 #endif