[mirror_edk2.git] / ShellPkg / Library / UefiShellDebug1CommandsLib / Bcfg.c

/** @file\r
  Main file for bcfg shell Debug1 function.\r
\r
  Copyright (c) 2010 - 2011, Intel Corporation. All rights reserved.<BR>\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
#include "UefiShellDebug1CommandsLib.h"\r
#include <Guid/GlobalVariable.h>\r
#include <Library/PrintLib.h>\r
#include <Library/HandleParsingLib.h>\r
#include <Library/DevicePathLib.h>\r
\r
typedef enum {\r
  BcfgTargetBootOrder    = 0,\r
  BcfgTargetDriverOrder  = 1,\r
  BcfgTargetMax          = 2\r
} BCFG_OPERATION_TARGET;\r
\r
typedef enum {\r
  BcfgTypeDump       = 0,\r
  BcfgTypeAdd        = 1,\r
  BcfgTypeAddp       = 2,\r
  BcfgTypeAddh       = 3,\r
  BcfgTypeRm         = 4,\r
  BcfgTypeMv         = 5,\r
  BcfgTypeOpt        = 6,\r
  BcfgTypeMax        = 7\r
} BCFG_OPERATION_TYPE;\r
\r
typedef struct {\r
  BCFG_OPERATION_TARGET Target;\r
  BCFG_OPERATION_TYPE   Type;\r
  UINT16                Number1;\r
  UINT16                Number2;\r
  UINTN                 HandleIndex;\r
  CHAR16                *FileName;\r
  CHAR16                *Description;\r
  UINT16                *Order;\r
  CONST CHAR16          *OptData;\r
} BGFG_OPERATION;\r
\r
/**\r
  This function will populate the device path protocol parameter based on TheHandle.\r
  \r
  @param[in,out] DevPath       On a sucessful return the device path to the handle.\r
\r
  @retval EFI_SUCCESS           The device path was sucessfully returned.\r
  @retval other                 A error from gBS->HandleProtocol.\r
\r
  @sa HandleProtocol\r
**/\r
EFI_STATUS\r
EFIAPI\r
GetDevicePathForDriverHandleDebug1 (\r
  IN EFI_HANDLE                   TheHandle,\r
  IN OUT EFI_DEVICE_PATH_PROTOCOL **FilePath\r
  )\r
{\r
  EFI_STATUS                Status;\r
  EFI_LOADED_IMAGE_PROTOCOL *LoadedImage;\r
  EFI_DEVICE_PATH_PROTOCOL  *ImageDevicePath;\r
\r
  Status = gBS->OpenProtocol (\r
                TheHandle,\r
                &gEfiLoadedImageProtocolGuid,\r
                (VOID**)&LoadedImage,\r
                gImageHandle,\r
                NULL,\r
                EFI_OPEN_PROTOCOL_GET_PROTOCOL\r
               );\r
  if (!EFI_ERROR (Status)) {\r
    Status = gBS->OpenProtocol (\r
                  LoadedImage->DeviceHandle,\r
                  &gEfiDevicePathProtocolGuid,\r
                  (VOID**)&ImageDevicePath,\r
                  gImageHandle,\r
                  NULL,\r
                  EFI_OPEN_PROTOCOL_GET_PROTOCOL\r
                 );\r
    if (!EFI_ERROR (Status)) {\r
//      *DevPath  = DuplicateDevicePath (ImageDevicePath);\r
//      *FilePath = DuplicateDevicePath (LoadedImage->FilePath);\r
        *FilePath = AppendDevicePath(ImageDevicePath,LoadedImage->FilePath);\r
      gBS->CloseProtocol(\r
                  LoadedImage->DeviceHandle,\r
                  &gEfiDevicePathProtocolGuid,\r
                  gImageHandle,\r
                  NULL);\r
    }\r
    gBS->CloseProtocol(\r
                TheHandle,\r
                &gEfiLoadedImageProtocolGuid,\r
                gImageHandle,\r
                NULL);\r
  }\r
  return (Status);\r
}\r
\r
/**\r
  Function to add a option.\r
\r
  @param[in] Position       The position to add Target at.\r
  @param[in] File           The file to make the target.\r
  @param[in] Desc           The description text.\r
  @param[in] CurrentOrder   The pointer to the current order of items.\r
  @param[in] OrderCount     The number if items in CurrentOrder.\r
  @param[in] Target         The info on the option to add.\r
  @param[in] UseHandle      TRUE to use HandleNumber, FALSE to use File and Desc.\r
  @param[in] UsePath        TRUE to convert to devicepath.\r
  @param[in] HandleNumber   The handle number to add.\r
\r
  @retval SHELL_SUCCESS             The operation was successful.\r
  @retval SHELL_INVALID_PARAMETER   A parameter was invalid.\r
**/\r
SHELL_STATUS\r
EFIAPI\r
BcfgAddDebug1(\r
  IN       UINTN                  Position,\r
  IN CONST CHAR16                 *File,\r
  IN CONST CHAR16                 *Desc,\r
  IN CONST UINT16                 *CurrentOrder,\r
  IN CONST UINTN                  OrderCount,\r
  IN CONST BCFG_OPERATION_TARGET  Target,\r
  IN CONST BOOLEAN                UseHandle,\r
  IN CONST BOOLEAN                UsePath,\r
  IN CONST UINTN                  HandleNumber\r
  )\r
{\r
  EFI_STATUS                Status;\r
  EFI_DEVICE_PATH_PROTOCOL  *DevicePath;\r
  EFI_DEVICE_PATH_PROTOCOL  *FilePath;\r
  EFI_DEVICE_PATH_PROTOCOL  *FileNode;\r
//  EFI_DEVICE_PATH_PROTOCOL  *DevPath;\r
  CHAR16                    *Str;\r
//  CONST CHAR16              *StringWalker;\r
  UINT8                     *TempByteBuffer;\r
  UINT8                     *TempByteStart;\r
  EFI_SHELL_FILE_INFO       *Arg;\r
  EFI_SHELL_FILE_INFO       *FileList;\r
  CHAR16                    OptionStr[40];\r
  UINTN                     DescSize, FilePathSize;\r
  BOOLEAN                   Found;\r
  UINTN                     TargetLocation;\r
  UINTN                     Index;\r
  EFI_HANDLE                *Handles;\r
  EFI_HANDLE                CurHandle;\r
  UINTN                     DriverBindingHandleCount;\r
  UINTN                     ParentControllerHandleCount;\r
  UINTN                     ChildControllerHandleCount;\r
  SHELL_STATUS              ShellStatus;\r
  UINT16                    *NewOrder;\r
\r
  if (!UseHandle) {\r
    if (File == NULL || Desc == NULL) {\r
      return (SHELL_INVALID_PARAMETER);\r
    }\r
  } else {\r
    if (HandleNumber == 0) {\r
      return (SHELL_INVALID_PARAMETER);\r
    }\r
  }\r
\r
  if (Position > OrderCount) {\r
    Position =  OrderCount;\r
  }\r
\r
  Str             = NULL;\r
  FilePath        = NULL;\r
  FileNode        = NULL;\r
  FileList        = NULL;\r
  Handles         = NULL;\r
  ShellStatus     = SHELL_SUCCESS;\r
  TargetLocation  = 0xFFFF;\r
\r
  if (UseHandle) {\r
    CurHandle = ConvertHandleIndexToHandle(HandleNumber);\r
    if (CurHandle == NULL) {\r
      ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_GEN_PROBLEM), gShellDebug1HiiHandle, L"Handle Number");\r
      ShellStatus = SHELL_INVALID_PARAMETER;\r
    } else {\r
      if (Target == BcfgTargetBootOrder) {\r
        //\r
        //Make sure that the handle should point to a real controller\r
        //\r
        Status = PARSE_HANDLE_DATABASE_UEFI_DRIVERS (\r
                   CurHandle,\r
                   &DriverBindingHandleCount,\r
                   NULL);\r
\r
        Status = PARSE_HANDLE_DATABASE_PARENTS (\r
                   CurHandle,\r
                   &ParentControllerHandleCount,\r
                   NULL);\r
\r
        Status = ParseHandleDatabaseForChildControllers (\r
                   CurHandle,\r
                   &ChildControllerHandleCount,\r
                   NULL);\r
\r
        if (DriverBindingHandleCount > 0\r
              || ParentControllerHandleCount > 0\r
              || ChildControllerHandleCount > 0) {\r
          FilePath = NULL;\r
          Status = gBS->HandleProtocol (\r
                     CurHandle,\r
                     &gEfiDevicePathProtocolGuid,\r
                     (VOID**)&FilePath);\r
        }\r
        if (EFI_ERROR (Status)) {\r
          ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_BCFG_HANDLE), gShellDebug1HiiHandle, HandleNumber);\r
          ShellStatus = SHELL_INVALID_PARAMETER;\r
        }\r
      } else {\r
        //\r
        //Make sure that the handle should point to driver, not a controller.\r
        //\r
        Status = PARSE_HANDLE_DATABASE_UEFI_DRIVERS (\r
                   CurHandle,\r
                   &DriverBindingHandleCount,\r
                   NULL);\r
\r
        Status = PARSE_HANDLE_DATABASE_PARENTS (\r
                   CurHandle,\r
                   &ParentControllerHandleCount,\r
                   NULL);\r
\r
        Status = ParseHandleDatabaseForChildControllers (\r
                   CurHandle,\r
                   &ChildControllerHandleCount,\r
                   NULL);\r
\r
        Status = gBS->HandleProtocol (\r
                   CurHandle,\r
                   &gEfiDevicePathProtocolGuid,\r
                   (VOID**)&FilePath);\r
\r
        if (DriverBindingHandleCount > 0\r
              || ParentControllerHandleCount > 0\r
              || ChildControllerHandleCount > 0\r
              || !EFI_ERROR(Status) ) {\r
          ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_GEN_PROBLEM), gShellDebug1HiiHandle, L"Handle Number");\r
          ShellStatus = SHELL_INVALID_PARAMETER;\r
        } else {\r
          //\r
          // Get the DevicePath from the loaded image information.\r
          //\r
          Status = GetDevicePathForDriverHandleDebug1(CurHandle, &FilePath);\r
        }\r
      }\r
    }\r
  } else {\r
    //\r
    // Get file info\r
    //\r
    ShellOpenFileMetaArg ((CHAR16*)File, EFI_FILE_MODE_READ, &FileList);\r
\r
    if (FileList == NULL) {\r
      //\r
      // If filename matched nothing fail\r
      //\r
      ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_GEN_FILE_OPEN_FAIL), gShellDebug1HiiHandle, File);\r
      ShellStatus = SHELL_INVALID_PARAMETER;\r
    } else if (FileList->Link.ForwardLink != FileList->Link.BackLink) {\r
      //\r
      // If filename expanded to multiple names, fail\r
      //\r
      ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_BCFG_FILE), gShellDebug1HiiHandle, File);\r
      ShellStatus = SHELL_INVALID_PARAMETER;\r
    } else {\r
      Arg = (EFI_SHELL_FILE_INFO*)GetFirstNode(&FileList->Link);\r
      if (EFI_ERROR(Arg->Status)) {\r
        ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_BCFG_FILE_OPEN), gShellDebug1HiiHandle, File, Arg->Status);\r
        ShellStatus = SHELL_INVALID_PARAMETER;\r
      } else {\r
        //\r
        // Build FilePath to the filename\r
        //\r
\r
        //\r
        // get the device path\r
        //\r
        DevicePath = gEfiShellProtocol->GetDevicePathFromFilePath(Arg->FullName);\r
        if (DevicePath == NULL) {\r
          ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_BCFG_FILE_DP), gShellDebug1HiiHandle, Arg->FullName);\r
          ShellStatus = SHELL_UNSUPPORTED;\r
        } else {\r
/*\r
          if (UsePath) {\r
            DevPath = DevicePath;\r
            while (!IsDevicePathEnd(DevPath)) {\r
              if ((DevicePathType(DevPath) == MEDIA_DEVICE_PATH) &&\r
                (DevicePathSubType(DevPath) == MEDIA_HARDDRIVE_DP)) {\r
\r
                //\r
                // If we find it use it instead\r
                //\r
                DevicePath = DevPath;\r
                break;\r
              }\r
              DevPath = NextDevicePathNode(DevPath);\r
            }\r
            //\r
            // append the file\r
            //\r
            for(StringWalker=Arg->FullName; *StringWalker != CHAR_NULL && *StringWalker != ':'; StringWalker++);\r
            FileNode = FileDevicePath(NULL, StringWalker+1);\r
            FilePath = AppendDevicePath(DevicePath, FileNode);\r
            FreePool(FileNode);\r
          } else {\r
*/\r
            FilePath = DuplicateDevicePath(DevicePath);\r
/*\r
          }\r
*/\r
          FreePool(DevicePath);\r
        }\r
      }\r
    }\r
  }\r
\r
\r
  if (ShellStatus == SHELL_SUCCESS) {\r
    //\r
    // Find a free target ,a brute force implementation\r
    //\r
    Found = FALSE;\r
    for (TargetLocation=0; TargetLocation < 0xFFFF; TargetLocation++) {\r
      Found = TRUE;\r
      for (Index=0; Index < OrderCount; Index++) {\r
        if (CurrentOrder[Index] == TargetLocation) {\r
          Found = FALSE;\r
          break;\r
        }\r
      }\r
\r
      if (Found) {\r
        break;\r
      }\r
    }\r
\r
    if (TargetLocation == 0xFFFF) {\r
      ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_BCFG_TARGET_NF), gShellDebug1HiiHandle);\r
    } else {\r
      ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_BCFG_TARGET), gShellDebug1HiiHandle, TargetLocation);\r
    }\r
  }\r
\r
  if (ShellStatus == SHELL_SUCCESS) {\r
    //\r
    // Add the option\r
    //\r
    DescSize = StrSize(Desc);\r
    FilePathSize = GetDevicePathSize (FilePath);\r
\r
    TempByteBuffer = AllocateZeroPool(sizeof(UINT32) + sizeof(UINT16) + DescSize + FilePathSize);\r
    if (TempByteBuffer != NULL) {\r
      TempByteStart  = TempByteBuffer;\r
      *((UINT32 *) TempByteBuffer) = LOAD_OPTION_ACTIVE;      // Attributes\r
      TempByteBuffer += sizeof (UINT32);\r
\r
      *((UINT16 *) TempByteBuffer) = (UINT16)FilePathSize;    // FilePathListLength\r
      TempByteBuffer += sizeof (UINT16);\r
\r
      CopyMem (TempByteBuffer, Desc, DescSize);\r
      TempByteBuffer += DescSize;\r
      CopyMem (TempByteBuffer, FilePath, FilePathSize);\r
\r
      UnicodeSPrint (OptionStr, sizeof(OptionStr), L"%s%04x", Target == BcfgTargetBootOrder?L"Boot":L"Driver", TargetLocation);\r
      Status = gRT->SetVariable (\r
            OptionStr,\r
            &gEfiGlobalVariableGuid,\r
            EFI_VARIABLE_NON_VOLATILE|EFI_VARIABLE_BOOTSERVICE_ACCESS|EFI_VARIABLE_RUNTIME_ACCESS,\r
            sizeof(UINT32) + sizeof(UINT16) + DescSize + FilePathSize,\r
            TempByteStart\r
           );\r
\r
      FreePool(TempByteStart);\r
    } else {\r
      Status = EFI_OUT_OF_RESOURCES;\r
    }\r
\r
    if (EFI_ERROR(Status)) {\r
      ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_BCFG_SET_VAR_FAIL), gShellDebug1HiiHandle, OptionStr, Status);\r
    } else {\r
      NewOrder = AllocateZeroPool((OrderCount+1)*sizeof(NewOrder[0]));\r
      ASSERT(NewOrder != NULL);\r
      CopyMem(NewOrder, CurrentOrder, (OrderCount)*sizeof(NewOrder[0]));\r
\r
      //\r
      // Insert target into order list\r
      //\r
      for (Index=OrderCount; Index > Position; Index--) {\r
        NewOrder[Index] = NewOrder[Index-1];\r
      }\r
\r
      NewOrder[Position] = (UINT16) TargetLocation;\r
      Status = gRT->SetVariable (\r
        Target == BcfgTargetBootOrder?L"BootOrder":L"DriverOrder",\r
        &gEfiGlobalVariableGuid,\r
        EFI_VARIABLE_NON_VOLATILE|EFI_VARIABLE_BOOTSERVICE_ACCESS|EFI_VARIABLE_RUNTIME_ACCESS,\r
        (OrderCount+1) * sizeof(UINT16),\r
        NewOrder\r
       );\r
\r
      FreePool(NewOrder);\r
\r
      if (EFI_ERROR(Status)) {\r
        ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_BCFG_WRITE_FAIL), gShellDebug1HiiHandle, Target == BcfgTargetBootOrder?L"BootOrder":L"DriverOrder", Status);\r
        ShellStatus = SHELL_INVALID_PARAMETER;\r
      } else {\r
        Print (L"bcfg: Add %s as %x\n", OptionStr, Position);\r
      }\r
    }\r
  }\r
\r
//\r
//If always Free FilePath, will free devicepath in system when use "addh"\r
//\r
  if (FilePath!=NULL && !UseHandle) {\r
    FreePool (FilePath);\r
  }\r
\r
  if (Str != NULL) {\r
    FreePool(Str);\r
  }\r
\r
  if (Handles != NULL) {\r
    FreePool (Handles);\r
  }\r
\r
  if (FileList != NULL) {\r
    ShellCloseFileMetaArg (&FileList);\r
  }\r
\r
  return (ShellStatus);\r
}\r
\r
/**\r
  Funciton to remove an item.\r
\r
  @param[in] Target         The target item to move.\r
  @param[in] CurrentOrder   The pointer to the current order of items.\r
  @param[in] OrderCount     The number if items in CurrentOrder.\r
  @param[in] Location       The current location of the Target.\r
\r
  @retval SHELL_SUCCESS             The operation was successful.\r
  @retval SHELL_INVALID_PARAMETER   A parameter was invalid.\r
**/\r
SHELL_STATUS\r
EFIAPI\r
BcfgRemoveDebug1(\r
  IN CONST BCFG_OPERATION_TARGET  Target,\r
  IN CONST UINT16                 *CurrentOrder,\r
  IN CONST UINTN                  OrderCount,\r
  IN CONST UINT16                 Location\r
  )\r
{\r
  CHAR16      VariableName[12];\r
  UINT16      *NewOrder;\r
  EFI_STATUS  Status;\r
  UINTN       NewCount;\r
\r
  UnicodeSPrint(VariableName, sizeof(VariableName), L"%s%04x", Target == BcfgTargetBootOrder?L"Boot":L"Driver", CurrentOrder[Location]);\r
  Status = gRT->SetVariable(\r
    VariableName,\r
    (EFI_GUID*)&gEfiGlobalVariableGuid,\r
    EFI_VARIABLE_NON_VOLATILE|EFI_VARIABLE_BOOTSERVICE_ACCESS|EFI_VARIABLE_RUNTIME_ACCESS,\r
    0,\r
    NULL);\r
  if (EFI_ERROR(Status)) {\r
    ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_BCFG_WRITE_FAIL), gShellDebug1HiiHandle, VariableName, Status);\r
    return (SHELL_INVALID_PARAMETER);\r
  }\r
  NewOrder = AllocateZeroPool(OrderCount*sizeof(CurrentOrder[0]));\r
  if (NewOrder != NULL) {\r
    NewCount = OrderCount;\r
    CopyMem(NewOrder, CurrentOrder, OrderCount*sizeof(CurrentOrder[0]));\r
    CopyMem(NewOrder+Location, NewOrder+Location+1, (OrderCount - Location - 1)*sizeof(CurrentOrder[0]));\r
    NewCount--;\r
\r
    Status = gRT->SetVariable(\r
      Target == BcfgTargetBootOrder?(CHAR16*)L"BootOrder":(CHAR16*)L"DriverOrder",\r
      (EFI_GUID*)&gEfiGlobalVariableGuid,\r
      EFI_VARIABLE_NON_VOLATILE|EFI_VARIABLE_BOOTSERVICE_ACCESS|EFI_VARIABLE_RUNTIME_ACCESS,\r
      NewCount*sizeof(NewOrder[0]),\r
      NewOrder);\r
    FreePool(NewOrder);\r
  } else {\r
    Status = EFI_OUT_OF_RESOURCES;\r
  }\r
  if (EFI_ERROR(Status)) {\r
    ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_BCFG_WRITE_FAIL), gShellDebug1HiiHandle, Target == BcfgTargetBootOrder?(CHAR16*)L"BootOrder":(CHAR16*)L"DriverOrder", Status);\r
    return (SHELL_INVALID_PARAMETER);\r
  }\r
  return (SHELL_SUCCESS);\r
}\r
\r
/**\r
  Funciton to move a item to another location.\r
\r
  @param[in] Target         The target item to move.\r
  @param[in] CurrentOrder   The pointer to the current order of items.\r
  @param[in] OrderCount     The number if items in CurrentOrder.\r
  @param[in] OldLocation    The current location of the Target.\r
  @param[in] NewLocation    The desired location of the Target.\r
\r
  @retval SHELL_SUCCESS             The operation was successful.\r
  @retval SHELL_INVALID_PARAMETER   A parameter was invalid.\r
**/\r
SHELL_STATUS\r
EFIAPI\r
BcfgMoveDebug1(\r
  IN CONST BCFG_OPERATION_TARGET  Target,\r
  IN CONST UINT16                 *CurrentOrder,\r
  IN CONST UINTN                  OrderCount,\r
  IN CONST UINT16                 OldLocation,\r
  IN CONST UINT16                 NewLocation\r
  )\r
{\r
  UINT16            *NewOrder;\r
  EFI_STATUS        Status;\r
  UINT16            Temp;\r
\r
  NewOrder = AllocateZeroPool(OrderCount*sizeof(CurrentOrder[0]));\r
  ASSERT(NewOrder != NULL);\r
\r
  Temp = CurrentOrder[OldLocation];\r
  CopyMem(NewOrder, CurrentOrder, OrderCount*sizeof(CurrentOrder[0]));\r
  CopyMem(NewOrder+OldLocation, NewOrder+OldLocation+1, (OrderCount - OldLocation - 1)*sizeof(CurrentOrder[0]));\r
  CopyMem(NewOrder+NewLocation+1, NewOrder+NewLocation, (OrderCount - NewLocation - 1)*sizeof(CurrentOrder[0]));\r
  NewOrder[NewLocation] = Temp;\r
\r
\r
  Status = gRT->SetVariable(\r
    Target == BcfgTargetBootOrder?(CHAR16*)L"BootOrder":(CHAR16*)L"DriverOrder",\r
    (EFI_GUID*)&gEfiGlobalVariableGuid,\r
    EFI_VARIABLE_NON_VOLATILE|EFI_VARIABLE_BOOTSERVICE_ACCESS|EFI_VARIABLE_RUNTIME_ACCESS,\r
    OrderCount*sizeof(CurrentOrder[0]),\r
    NewOrder);\r
\r
  FreePool(NewOrder);\r
\r
  if (EFI_ERROR(Status)) {\r
    ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_BCFG_WRITE_FAIL), gShellDebug1HiiHandle, Target == BcfgTargetBootOrder?(CHAR16*)L"BootOrder":(CHAR16*)L"DriverOrder", Status);\r
    return (SHELL_INVALID_PARAMETER);\r
  }\r
  return (SHELL_SUCCESS);\r
}\r
\r
/**\r
  Function to add optional data to an option.\r
\r
  @param[in] OptData      The optional data to add.\r
  @param[in] Target       The target of the operation.\r
\r
  @retval SHELL_SUCCESS   The operation was succesful.\r
**/\r
SHELL_STATUS\r
EFIAPI\r
BcfgAddOptDebug1(\r
  IN CONST CHAR16                 *OptData,\r
  IN CONST BCFG_OPERATION_TARGET  Target\r
  )\r
{\r
  ASSERT(OptData != NULL);\r
  return SHELL_SUCCESS;\r
}\r
\r
/**\r
  Function to dump the Bcfg information.\r
\r
  @param[in] Op             The operation.\r
  @param[in] OrderCount     How many to dump.\r
  @param[in] CurrentOrder   The pointer to the current order of items.\r
  @param[in] VerboseOutput  TRUE for extra output.  FALSE otherwise.\r
\r
  @retval SHELL_SUCCESS           The dump was successful.\r
  @retval SHELL_INVALID_PARAMETER A parameter was invalid.\r
**/\r
SHELL_STATUS\r
EFIAPI\r
BcfgDisplayDumpDebug1(\r
  IN CONST CHAR16   *Op,\r
  IN CONST UINTN    OrderCount,\r
  IN CONST UINT16   *CurrentOrder,\r
  IN CONST BOOLEAN  VerboseOutput\r
  )\r
{\r
  EFI_STATUS  Status;\r
  UINT8       *Buffer;\r
  UINTN       BufferSize;\r
  CHAR16      VariableName[12];\r
  UINTN       LoopVar;\r
  UINTN       LoopVar2;\r
  CHAR16      *DevPathString;\r
  VOID        *DevPath;\r
\r
  if (OrderCount == 0) {\r
    ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN(STR_BCFG_NONE), gShellDebug1HiiHandle);\r
    return (SHELL_SUCCESS);\r
  }\r
\r
  for (LoopVar = 0 ; LoopVar < OrderCount ; LoopVar++) {\r
    Buffer      = NULL;\r
    BufferSize  = 0;\r
    UnicodeSPrint(VariableName, sizeof(VariableName), L"%s%04x", Op, CurrentOrder[LoopVar]);\r
\r
    Status = gRT->GetVariable(\r
        VariableName,\r
        (EFI_GUID*)&gEfiGlobalVariableGuid,\r
        NULL,\r
        &BufferSize,\r
        Buffer);\r
    if (Status == EFI_BUFFER_TOO_SMALL) {\r
      Buffer = AllocateZeroPool(BufferSize);\r
      Status = gRT->GetVariable(\r
          VariableName,\r
          (EFI_GUID*)&gEfiGlobalVariableGuid,\r
          NULL,\r
          &BufferSize,\r
          Buffer);\r
    }\r
\r
    if (EFI_ERROR(Status) || Buffer == NULL) {\r
      ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_BCFG_READ_FAIL), gShellDebug1HiiHandle, VariableName, Status);\r
      return (SHELL_INVALID_PARAMETER);\r
    }\r
\r
    if ((*(UINT16*)(Buffer+4)) != 0) {\r
      DevPath = AllocateZeroPool(*(UINT16*)(Buffer+4));\r
      CopyMem(DevPath, Buffer+6+StrSize((CHAR16*)(Buffer+6)), *(UINT16*)(Buffer+4));\r
      DevPathString = gDevPathToText->ConvertDevicePathToText(DevPath, TRUE, FALSE);\r
    } else {\r
      DevPath       = NULL;\r
      DevPathString = NULL;\r
    }\r
    ShellPrintHiiEx(\r
      -1,\r
      -1,\r
      NULL,\r
      STRING_TOKEN(STR_BCFG_LOAD_OPTIONS),\r
      gShellDebug1HiiHandle,\r
      LoopVar,\r
      VariableName,\r
      (CHAR16*)(Buffer+6),\r
      DevPathString,\r
      (StrSize((CHAR16*)(Buffer+6)) + *(UINT16*)(Buffer+4) + 6) <= BufferSize?L'N':L'Y');\r
    if (VerboseOutput) {\r
      for (LoopVar2 = (StrSize((CHAR16*)(Buffer+6)) + *(UINT16*)(Buffer+4) + 6);LoopVar2<BufferSize;LoopVar2++){\r
        ShellPrintEx(\r
          -1,\r
          -1,\r
          NULL,\r
          L"%02x",\r
          Buffer[LoopVar2]);\r
      }\r
      ShellPrintEx(\r
        -1,\r
        -1,\r
        NULL,\r
        L"\r\n");\r
    }\r
\r
    if (Buffer != NULL) {\r
      FreePool(Buffer);\r
    }\r
    if (DevPath != NULL) {\r
      FreePool(DevPath);\r
    }\r
    if (DevPathString != NULL) {\r
      FreePool(DevPathString);\r
    }\r
  }\r
  return (SHELL_SUCCESS);\r
}\r
\r
/**\r
  Function to initialize the BCFG operation structure.\r
\r
  @param[in] Struct   The stuct to initialize.\r
**/\r
VOID\r
EFIAPI\r
InitBcfgStructDebug1(\r
  IN BGFG_OPERATION *Struct\r
  )\r
{\r
  ASSERT(Struct != NULL);\r
  Struct->Target      = BcfgTargetMax;\r
  Struct->Type        = BcfgTypeMax;\r
  Struct->Number1     = 0;\r
  Struct->Number2     = 0;\r
  Struct->HandleIndex = 0;\r
  Struct->FileName    = NULL;\r
  Struct->Description = NULL;\r
  Struct->Order       = NULL;\r
  Struct->OptData     = NULL;\r
}\r
\r
\r
STATIC CONST SHELL_PARAM_ITEM ParamList[] = {\r
  {L"-v", TypeFlag},\r
  {L"-opt", TypeMaxValue},\r
  {NULL, TypeMax}\r
  };\r
\r
/**\r
  Function for 'bcfg' command.\r
\r
  @param[in] ImageHandle  Handle to the Image (NULL if Internal).\r
  @param[in] SystemTable  Pointer to the System Table (NULL if Internal).\r
**/\r
SHELL_STATUS\r
EFIAPI\r
ShellCommandRunBcfg (\r
  IN EFI_HANDLE        ImageHandle,\r
  IN EFI_SYSTEM_TABLE  *SystemTable\r
  )\r
{\r
  EFI_STATUS            Status;\r
  LIST_ENTRY            *Package;\r
  CHAR16                *ProblemParam;\r
  SHELL_STATUS          ShellStatus;\r
  UINTN                 ParamNumber;\r
  CONST CHAR16          *CurrentParam;\r
  BGFG_OPERATION        CurrentOperation;\r
  UINTN                 Length;\r
  UINT64                Intermediate;\r
\r
  Length              = 0;\r
  ProblemParam        = NULL;\r
  Package             = NULL;\r
  ShellStatus         = SHELL_SUCCESS;\r
\r
  InitBcfgStructDebug1(&CurrentOperation);\r
\r
  //\r
  // initialize the shell lib (we must be in non-auto-init...)\r
  //\r
  Status = ShellInitialize();\r
  ASSERT_EFI_ERROR(Status);\r
\r
  Status = CommandInit();\r
  ASSERT_EFI_ERROR(Status);\r
\r
  //\r
  // parse the command line\r
  //\r
  Status = ShellCommandLineParse (ParamList, &Package, &ProblemParam, TRUE);\r
  if (EFI_ERROR(Status)) {\r
    if (Status == EFI_VOLUME_CORRUPTED && ProblemParam != NULL) {\r
      ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_GEN_PROBLEM), gShellDebug1HiiHandle, ProblemParam);\r
      FreePool(ProblemParam);\r
      ShellStatus = SHELL_INVALID_PARAMETER;\r
    } else {\r
      ASSERT(FALSE);\r
    }\r
  } else {\r
    //\r
    // Read in if we are doing -OPT\r
    //\r
    if (ShellCommandLineGetFlag(Package, L"-opt")) {\r
      CurrentOperation.OptData = ShellCommandLineGetValue(Package, L"-opt");\r
      if (CurrentOperation.OptData == NULL) {\r
        ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_GEN_PROBLEM_VAL), gShellDebug1HiiHandle, L"-opt");\r
        ShellStatus = SHELL_INVALID_PARAMETER;\r
      }\r
      CurrentOperation.Type = BcfgTypeOpt;\r
    }\r
\r
    //\r
    // small block to read the target of the operation\r
    //\r
    if ((ShellCommandLineGetCount(Package) < 3 && CurrentOperation.Type != BcfgTypeOpt) ||\r
        (ShellCommandLineGetCount(Package) < 2 && CurrentOperation.Type == BcfgTypeOpt)\r
       ){\r
      ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_GEN_TOO_FEW), gShellDebug1HiiHandle);\r
      ShellStatus = SHELL_INVALID_PARAMETER;\r
    } else if (gUnicodeCollation->StriColl(gUnicodeCollation, (CHAR16*)ShellCommandLineGetRawValue(Package, 1), L"driver") == 0) {\r
      CurrentOperation.Target = BcfgTargetDriverOrder;\r
    } else if (gUnicodeCollation->StriColl(gUnicodeCollation, (CHAR16*)ShellCommandLineGetRawValue(Package, 1), L"boot") == 0) {\r
      CurrentOperation.Target = BcfgTargetBootOrder;\r
    } else {\r
      ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_GEN_NO_DRIVER_BOOT), gShellDebug1HiiHandle);\r
      ShellStatus = SHELL_INVALID_PARAMETER;\r
    }\r
\r
\r
    //\r
    // Read in the boot or driver order environment variable (not needed for opt)\r
    //\r
    if (ShellStatus == SHELL_SUCCESS && CurrentOperation.Target < BcfgTargetMax && CurrentOperation.Type != BcfgTypeOpt) {\r
      Length = 0;\r
      Status = gRT->GetVariable(\r
        CurrentOperation.Target == BcfgTargetBootOrder?(CHAR16*)L"BootOrder":(CHAR16*)L"DriverOrder",\r
        (EFI_GUID*)&gEfiGlobalVariableGuid,\r
        NULL,\r
        &Length,\r
        CurrentOperation.Order);\r
      if (Status == EFI_BUFFER_TOO_SMALL) {\r
        CurrentOperation.Order = AllocateZeroPool(Length+(4*sizeof(CurrentOperation.Order[0])));\r
        Status = gRT->GetVariable(\r
          CurrentOperation.Target == BcfgTargetBootOrder?(CHAR16*)L"BootOrder":(CHAR16*)L"DriverOrder",\r
          (EFI_GUID*)&gEfiGlobalVariableGuid,\r
          NULL,\r
          &Length,\r
          CurrentOperation.Order);\r
      }\r
    }\r
\r
    //\r
    // large block to read the type of operation and verify parameter types for the info.\r
    //\r
    if (ShellStatus == SHELL_SUCCESS && CurrentOperation.Target < BcfgTargetMax) {\r
      for (ParamNumber = 2 ; ParamNumber < ShellCommandLineGetCount(Package) && ShellStatus == SHELL_SUCCESS; ParamNumber++) {\r
        CurrentParam = ShellCommandLineGetRawValue(Package, ParamNumber);\r
        if        (gUnicodeCollation->StriColl(gUnicodeCollation, (CHAR16*)CurrentParam, L"dump") == 0)    {\r
          CurrentOperation.Type = BcfgTypeDump;\r
        } else if (ShellCommandLineGetFlag(Package, L"-v")) {\r
          ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_GEN_PROBLEM), gShellDebug1HiiHandle, L"-v (without dump)");\r
          ShellStatus = SHELL_INVALID_PARAMETER;\r
        } else if (gUnicodeCollation->StriColl(gUnicodeCollation, (CHAR16*)CurrentParam, L"add") == 0)     {\r
          if ((ParamNumber + 3) >= ShellCommandLineGetCount(Package)) {\r
            ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_GEN_TOO_FEW), gShellDebug1HiiHandle);\r
            ShellStatus = SHELL_INVALID_PARAMETER;\r
          }\r
          CurrentOperation.Type = BcfgTypeAdd;\r
          CurrentParam = ShellCommandLineGetRawValue(Package, ++ParamNumber);\r
          if (CurrentParam == NULL || !ShellIsHexOrDecimalNumber(CurrentParam, TRUE, FALSE)) {\r
            ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_GEN_PROBLEM), gShellDebug1HiiHandle, CurrentParam);\r
            ShellStatus = SHELL_INVALID_PARAMETER;\r
          } else {\r
            Status = ShellConvertStringToUint64(CurrentParam, &Intermediate, TRUE, FALSE);\r
            CurrentOperation.Number1     = (UINT16)Intermediate;\r
            ASSERT(CurrentOperation.FileName == NULL);\r
            CurrentOperation.FileName    = StrnCatGrow(&CurrentOperation.FileName   , NULL, ShellCommandLineGetRawValue(Package, ++ParamNumber), 0);\r
            ASSERT(CurrentOperation.Description == NULL);\r
            CurrentOperation.Description = StrnCatGrow(&CurrentOperation.Description, NULL, ShellCommandLineGetRawValue(Package, ++ParamNumber), 0);\r
          }\r
        } else if (gUnicodeCollation->StriColl(gUnicodeCollation, (CHAR16*)CurrentParam, L"addp") == 0)    {\r
          if ((ParamNumber + 3) >= ShellCommandLineGetCount(Package)) {\r
            ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_GEN_TOO_FEW), gShellDebug1HiiHandle);\r
            ShellStatus = SHELL_INVALID_PARAMETER;\r
          }\r
          CurrentOperation.Type = BcfgTypeAddp;\r
          CurrentParam = ShellCommandLineGetRawValue(Package, ++ParamNumber);\r
          if (CurrentParam == NULL || !ShellIsHexOrDecimalNumber(CurrentParam, TRUE, FALSE)) {\r
            ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_GEN_PROBLEM), gShellDebug1HiiHandle, CurrentParam);\r
            ShellStatus = SHELL_INVALID_PARAMETER;\r
          } else {\r
            Status = ShellConvertStringToUint64(CurrentParam, &Intermediate, TRUE, FALSE);\r
            CurrentOperation.Number1     = (UINT16)Intermediate;\r
            ASSERT(CurrentOperation.FileName == NULL);\r
            CurrentOperation.FileName    = StrnCatGrow(&CurrentOperation.FileName   , NULL, ShellCommandLineGetRawValue(Package, ++ParamNumber), 0);\r
            ASSERT(CurrentOperation.Description == NULL);\r
            CurrentOperation.Description = StrnCatGrow(&CurrentOperation.Description, NULL, ShellCommandLineGetRawValue(Package, ++ParamNumber), 0);\r
          }\r
        } else if (gUnicodeCollation->StriColl(gUnicodeCollation, (CHAR16*)CurrentParam, L"addh") == 0)    {\r
          if ((ParamNumber + 3) >= ShellCommandLineGetCount(Package)) {\r
            ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_GEN_TOO_FEW), gShellDebug1HiiHandle);\r
            ShellStatus = SHELL_INVALID_PARAMETER;\r
          }\r
          CurrentOperation.Type = BcfgTypeAddh;\r
          CurrentParam = ShellCommandLineGetRawValue(Package, ++ParamNumber);\r
          if (CurrentParam == NULL || !ShellIsHexOrDecimalNumber(CurrentParam, TRUE, FALSE)) {\r
            ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_GEN_PROBLEM), gShellDebug1HiiHandle, CurrentParam);\r
            ShellStatus = SHELL_INVALID_PARAMETER;\r
          } else {\r
            Status = ShellConvertStringToUint64(CurrentParam, &Intermediate, TRUE, FALSE);\r
            CurrentOperation.Number1     = (UINT16)Intermediate;\r
            CurrentParam = ShellCommandLineGetRawValue(Package, ++ParamNumber);\r
            if (CurrentParam == NULL || !ShellIsHexOrDecimalNumber(CurrentParam, TRUE, FALSE)) {\r
              ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_GEN_PROBLEM), gShellDebug1HiiHandle, CurrentParam);\r
              ShellStatus = SHELL_INVALID_PARAMETER;\r
            } else {\r
              Status = ShellConvertStringToUint64(CurrentParam, &Intermediate, TRUE, FALSE);\r
              CurrentOperation.HandleIndex = (UINT16)Intermediate;\r
              ASSERT(CurrentOperation.Description == NULL);\r
              CurrentOperation.Description = StrnCatGrow(&CurrentOperation.Description, NULL, ShellCommandLineGetRawValue(Package, ++ParamNumber), 0);\r
            }\r
          }\r
        } else if (gUnicodeCollation->StriColl(gUnicodeCollation, (CHAR16*)CurrentParam, L"rm") == 0)      {\r
          if ((ParamNumber + 1) >= ShellCommandLineGetCount(Package)) {\r
            ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_GEN_TOO_FEW), gShellDebug1HiiHandle);\r
            ShellStatus = SHELL_INVALID_PARAMETER;\r
          }\r
          CurrentOperation.Type = BcfgTypeRm;\r
          CurrentParam = ShellCommandLineGetRawValue(Package, ++ParamNumber);\r
          if (CurrentParam == NULL || !ShellIsHexOrDecimalNumber(CurrentParam, TRUE, FALSE)) {\r
            ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_GEN_PROBLEM), gShellDebug1HiiHandle, CurrentParam);\r
            ShellStatus = SHELL_INVALID_PARAMETER;\r
          } else {\r
            Status = ShellConvertStringToUint64(CurrentParam, &Intermediate, TRUE, FALSE);\r
            CurrentOperation.Number1     = (UINT16)Intermediate;\r
            if (CurrentOperation.Number1 > (Length / sizeof(CurrentOperation.Order[0]))){\r
              ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_BCFG_NUMB_RANGE), gShellDebug1HiiHandle, Length / sizeof(CurrentOperation.Order[0]));\r
              ShellStatus = SHELL_INVALID_PARAMETER;\r
            }\r
          }\r
        } else if (gUnicodeCollation->StriColl(gUnicodeCollation, (CHAR16*)CurrentParam, L"mv") == 0)      {\r
          if ((ParamNumber + 2) >= ShellCommandLineGetCount(Package)) {\r
            ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_GEN_TOO_FEW), gShellDebug1HiiHandle);\r
            ShellStatus = SHELL_INVALID_PARAMETER;\r
          }\r
          CurrentOperation.Type = BcfgTypeMv;\r
          CurrentParam = ShellCommandLineGetRawValue(Package, ++ParamNumber);\r
          if (CurrentParam == NULL || !ShellIsHexOrDecimalNumber(CurrentParam, TRUE, FALSE)) {\r
            ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_GEN_PROBLEM), gShellDebug1HiiHandle, CurrentParam);\r
            ShellStatus = SHELL_INVALID_PARAMETER;\r
          } else {\r
            Status = ShellConvertStringToUint64(CurrentParam, &Intermediate, TRUE, FALSE);\r
            CurrentOperation.Number1     = (UINT16)Intermediate;\r
            if (CurrentOperation.Number1 > (Length / sizeof(CurrentOperation.Order[0]))){\r
              ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_BCFG_NUMB_RANGE), gShellDebug1HiiHandle, Length / sizeof(CurrentOperation.Order[0]));\r
              ShellStatus = SHELL_INVALID_PARAMETER;\r
            }\r
            CurrentParam = ShellCommandLineGetRawValue(Package, ++ParamNumber);\r
            if (CurrentParam == NULL || !ShellIsHexOrDecimalNumber(CurrentParam, TRUE, FALSE)) {\r
              ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_GEN_PROBLEM), gShellDebug1HiiHandle, CurrentParam);\r
              ShellStatus = SHELL_INVALID_PARAMETER;\r
            } else {\r
              Status = ShellConvertStringToUint64(CurrentParam, &Intermediate, TRUE, FALSE);\r
              CurrentOperation.Number2     = (UINT16)Intermediate;\r
            }\r
            if (CurrentOperation.Number2 == CurrentOperation.Number1\r
              ||CurrentOperation.Number1 > (Length / sizeof(CurrentOperation.Order[0]))\r
              ||CurrentOperation.Number2 > (Length / sizeof(CurrentOperation.Order[0]))\r
             ){\r
              ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_BCFG_NUMB_RANGE), gShellDebug1HiiHandle, Length / sizeof(CurrentOperation.Order[0]));\r
              ShellStatus = SHELL_INVALID_PARAMETER;\r
            }\r
          }\r
        } else {\r
          ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_GEN_PROBLEM), gShellDebug1HiiHandle, CurrentParam);\r
          ShellStatus = SHELL_INVALID_PARAMETER;\r
        }\r
      }\r
    }\r
    if (ShellStatus == SHELL_SUCCESS && CurrentOperation.Target < BcfgTargetMax && CurrentOperation.Type < BcfgTypeMax) {\r
      //\r
      // we have all the info.  Do the work\r
      //\r
      switch (CurrentOperation.Type) {\r
        case   BcfgTypeDump:\r
          ShellStatus = BcfgDisplayDumpDebug1(\r
            CurrentOperation.Target == BcfgTargetBootOrder?L"Boot":L"Driver",\r
            Length / sizeof(CurrentOperation.Order[0]),\r
            CurrentOperation.Order,\r
            ShellCommandLineGetFlag(Package, L"-v"));\r
          break;\r
        case   BcfgTypeMv:\r
          ShellStatus = BcfgMoveDebug1(\r
            CurrentOperation.Target,\r
            CurrentOperation.Order,\r
            Length / sizeof(CurrentOperation.Order[0]),\r
            CurrentOperation.Number1,\r
            CurrentOperation.Number2);\r
          break;\r
        case   BcfgTypeRm:\r
          ShellStatus = BcfgRemoveDebug1(\r
            CurrentOperation.Target,\r
            CurrentOperation.Order,\r
            Length / sizeof(CurrentOperation.Order[0]),\r
            CurrentOperation.Number1);\r
          break;\r
        case   BcfgTypeAdd:\r
        case   BcfgTypeAddp:\r
        case   BcfgTypeAddh:\r
          ShellStatus = BcfgAddDebug1(\r
            CurrentOperation.Number1,\r
            CurrentOperation.FileName,\r
            CurrentOperation.Description,\r
            CurrentOperation.Order,\r
            Length / sizeof(CurrentOperation.Order[0]),\r
            CurrentOperation.Target,\r
            (BOOLEAN)(CurrentOperation.Type == BcfgTypeAddh),\r
            (BOOLEAN)(CurrentOperation.Type == BcfgTypeAddp),\r
            CurrentOperation.HandleIndex);\r
          break;\r
        case   BcfgTypeOpt:\r
          ShellStatus = BcfgAddOptDebug1(\r
            CurrentOperation.OptData,\r
            CurrentOperation.Target);\r
          break;\r
        default:\r
          ASSERT(FALSE);\r
      }\r
    }\r
  }\r
\r
  if (Package != NULL) {\r
    ShellCommandLineFreeVarList (Package);\r
  }\r
  if (CurrentOperation.FileName != NULL) {\r
    FreePool(CurrentOperation.FileName);\r
  }\r
  if (CurrentOperation.Description != NULL) {\r
    FreePool(CurrentOperation.Description);\r
  }\r
  if (CurrentOperation.Order != NULL) {\r
    FreePool(CurrentOperation.Order);\r
  }\r
\r
  return (ShellStatus);\r
}\r