connect - add comments and add input verification

[mirror_edk2.git] / ShellPkg / Library / UefiShellLevel2CommandsLib / Vol.c

/** @file\r
  Main file for vol shell level 2 function.\r
\r
  Copyright (c) 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 "UefiShellLevel2CommandsLib.h"\r
#include <Guid/FileSystemInfo.h>\r
#include <Guid/FileSystemVolumeLabelInfo.h>\r
\r
/**\r
  Print the info or change the volume info.\r
\r
  @param[in] Path           String with starting path.\r
  @param[in] Delete         TRUE to delete the volume label. FALSE otherwise.\r
  @param[in] Name           New name to set to the volume label.\r
\r
  @retval SHELL_SUCCESS     The operation was sucessful.\r
**/\r
SHELL_STATUS\r
EFIAPI\r
HandleVol(\r
  IN CONST CHAR16  *Path,\r
  IN CONST BOOLEAN Delete,\r
  IN CONST CHAR16  *Name\r
  )\r
{\r
  EFI_STATUS            Status;\r
  SHELL_STATUS          ShellStatus;\r
  EFI_FILE_SYSTEM_INFO  *SysInfo;\r
  UINTN                 SysInfoSize;\r
  SHELL_FILE_HANDLE     ShellFileHandle;\r
  EFI_FILE_PROTOCOL     *EfiFpHandle;\r
  UINTN                 Size1;\r
  UINTN                 Size2;\r
\r
  ShellStatus   = SHELL_SUCCESS;\r
\r
  Status = gEfiShellProtocol->OpenFileByName(\r
    Path,\r
    &ShellFileHandle,\r
    Name != NULL?EFI_FILE_MODE_READ|EFI_FILE_MODE_WRITE:EFI_FILE_MODE_READ);\r
\r
  if (EFI_ERROR(Status) || ShellFileHandle == NULL) {\r
    ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_GEN_FILE_OPEN_FAIL), gShellLevel2HiiHandle, Path);\r
    ShellStatus = SHELL_ACCESS_DENIED;\r
    return (ShellStatus);\r
  }\r
\r
  //\r
  // Get the Volume Info from ShellFileHandle\r
  //\r
  SysInfo     = NULL;\r
  SysInfoSize = 0;\r
  EfiFpHandle = ConvertShellHandleToEfiFileProtocol(ShellFileHandle);\r
  Status = EfiFpHandle->GetInfo(\r
    EfiFpHandle,\r
    &gEfiFileSystemInfoGuid,\r
    &SysInfoSize,\r
    SysInfo);\r
\r
  if (Status == EFI_BUFFER_TOO_SMALL) {\r
    SysInfo = AllocateZeroPool(SysInfoSize);\r
    Status = EfiFpHandle->GetInfo(\r
      EfiFpHandle,\r
      &gEfiFileSystemInfoGuid,\r
      &SysInfoSize,\r
      SysInfo);\r
  }\r
\r
  if (Delete) {\r
    StrCpy ((CHAR16 *) SysInfo->VolumeLabel, L"");\r
    SysInfo->Size = SIZE_OF_EFI_FILE_SYSTEM_INFO + StrSize(SysInfo->VolumeLabel);\r
    Status = EfiFpHandle->SetInfo(\r
      EfiFpHandle,\r
      &gEfiFileSystemInfoGuid,\r
      (UINTN)SysInfo->Size,\r
      SysInfo);\r
  } else if (Name != NULL) {\r
    Size1 = StrSize(Name);\r
    Size2 = StrSize(SysInfo->VolumeLabel);\r
    if (Size1 > Size2) {\r
      SysInfo = ReallocatePool((UINTN)SysInfo->Size, (UINTN)SysInfo->Size + Size1 - Size2, SysInfo);\r
    }\r
    StrCpy ((CHAR16 *) SysInfo->VolumeLabel, Name);\r
    SysInfo->Size = SIZE_OF_EFI_FILE_SYSTEM_INFO + Size1;\r
    Status = EfiFpHandle->SetInfo(\r
      EfiFpHandle,\r
      &gEfiFileSystemInfoGuid,\r
      (UINTN)SysInfo->Size,\r
      SysInfo);\r
  }  \r
\r
  FreePool(SysInfo);\r
\r
  if (Delete || Name != NULL) {\r
    if (EFI_ERROR(Status)) {\r
      ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_GEN_FILE_AD), gShellLevel2HiiHandle, Path);\r
      ShellStatus = SHELL_ACCESS_DENIED;\r
    }\r
  }\r
\r
  SysInfo = AllocateZeroPool(SysInfoSize);\r
  Status = EfiFpHandle->GetInfo(\r
    EfiFpHandle,\r
    &gEfiFileSystemInfoGuid,\r
    &SysInfoSize,\r
    SysInfo);\r
\r
  gEfiShellProtocol->CloseFile(ShellFileHandle);\r
\r
  //\r
  // print VolumeInfo table\r
  //\r
  ShellPrintHiiEx (\r
    0,\r
    gST->ConOut->Mode->CursorRow,\r
    NULL,\r
    STRING_TOKEN (STR_VOL_VOLINFO),\r
    gShellLevel2HiiHandle,\r
    SysInfo->VolumeLabel,\r
    SysInfo->ReadOnly?L"r":L"rw",\r
    SysInfo->VolumeSize,\r
    SysInfo->FreeSpace,\r
    SysInfo->BlockSize\r
   );\r
  SHELL_FREE_NON_NULL(SysInfo);\r
\r
  return (ShellStatus);\r
}\r
\r
STATIC CONST SHELL_PARAM_ITEM ParamList[] = {\r
  {L"-d", TypeFlag},\r
  {L"-n", TypeValue},\r
  {NULL, TypeMax}\r
  };\r
\r
/**\r
  Function for 'Vol' 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
ShellCommandRunVol (\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
  CONST CHAR16  *PathName;\r
  CONST CHAR16  *CurDir;\r
  BOOLEAN       DeleteMode;\r
  CHAR16        *FullPath;\r
  UINTN         Length;\r
\r
  Length              = 0;\r
  ProblemParam        = NULL;\r
  ShellStatus         = SHELL_SUCCESS;\r
  PathName            = NULL;\r
  CurDir              = NULL;\r
  FullPath            = NULL;\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
  //\r
  // Fix local copies of the protocol pointers\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), gShellLevel2HiiHandle, ProblemParam);\r
      FreePool(ProblemParam);\r
      ShellStatus = SHELL_INVALID_PARAMETER;\r
    } else {\r
      ASSERT(FALSE);\r
    }\r
  } else {\r
    //\r
    // check for "-?"\r
    //\r
    if (ShellCommandLineGetFlag(Package, L"-?")) {\r
      ASSERT(FALSE);\r
    }\r
\r
    if (ShellCommandLineGetCount(Package) > 2) {\r
      ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_GEN_TOO_MANY), gShellLevel2HiiHandle);\r
      ShellStatus = SHELL_INVALID_PARAMETER;\r
    } else {\r
      PathName = ShellCommandLineGetRawValue(Package, 1);\r
      if (PathName == NULL) {\r
        CurDir = gEfiShellProtocol->GetCurDir(NULL);\r
        if (CurDir == NULL) {\r
          ShellStatus = SHELL_NOT_FOUND;\r
          ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_GEN_NO_CWD), gShellLevel2HiiHandle);\r
        } else {\r
          PathName = CurDir;\r
        }\r
      }\r
      if (PathName != NULL) {\r
        StrnCatGrow(&FullPath, &Length, PathName, StrStr(PathName, L"\\")==NULL?0:StrStr(PathName, L"\\")-PathName+1);\r
        if (StrStr(FullPath, L":\\") == NULL) {\r
          StrnCatGrow(&FullPath, &Length, L":\\", 0);\r
        }\r
        DeleteMode = ShellCommandLineGetFlag(Package, L"-d");\r
        if (DeleteMode && ShellCommandLineGetFlag(Package, L"-n")) {\r
          ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_GEN_PARAM_CON), gShellLevel2HiiHandle);\r
          ShellStatus = SHELL_INVALID_PARAMETER;\r
        } else if (ShellCommandLineGetFlag(Package, L"-n") && ShellCommandLineGetValue(Package, L"-n") == NULL) {\r
          ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_GEN_NO_VALUE), gShellLevel2HiiHandle, L"-n");\r
          ShellStatus = SHELL_INVALID_PARAMETER;\r
        } else if (ShellCommandLineGetValue(Package, L"-n") != NULL && StrLen(ShellCommandLineGetValue(Package, L"-n")) > 11) {\r
          ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_GEN_PROBLEM_VAL), gShellLevel2HiiHandle, L"-n");\r
          ShellStatus = SHELL_INVALID_PARAMETER;\r
        } else if (ShellStatus == SHELL_SUCCESS) {\r
          ShellStatus = HandleVol(\r
            FullPath,\r
            DeleteMode,\r
            ShellCommandLineGetValue(Package, L"-n")\r
           );\r
        }\r
      }\r
    }\r
  }\r
\r
  SHELL_FREE_NON_NULL(FullPath);\r
\r
  //\r
  // free the command line package\r
  //\r
  ShellCommandLineFreeVarList (Package);\r
\r
  return (ShellStatus);\r
}\r