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

/** @file\r
  Main file for ls shell level 2 function.\r
\r
  (C) Copyright 2013-2015 Hewlett-Packard Development Company, L.P.<BR>\r
  Copyright (c) 2009 - 2018, Intel Corporation. All rights reserved.<BR>\r
  SPDX-License-Identifier: BSD-2-Clause-Patent\r
\r
**/\r
\r
#include "UefiShellLevel2CommandsLib.h"\r
#include <Guid/FileSystemInfo.h>\r
\r
UINTN     mDayOfMonth[] = {31, 28, 31, 30, 31, 30, 31, 30, 31, 30, 31, 30};\r
\r
/**\r
  print out the standard format output volume entry.\r
\r
  @param[in] TheList           a list of files from the volume.\r
**/\r
EFI_STATUS\r
PrintSfoVolumeInfoTableEntry(\r
  IN CONST EFI_SHELL_FILE_INFO *TheList\r
  )\r
{\r
  EFI_STATUS            Status;\r
  EFI_SHELL_FILE_INFO   *Node;\r
  CHAR16                *DirectoryName;\r
  EFI_FILE_SYSTEM_INFO  *SysInfo;\r
  UINTN                 SysInfoSize;\r
  SHELL_FILE_HANDLE     ShellFileHandle;\r
  EFI_FILE_PROTOCOL     *EfiFpHandle;\r
\r
  //\r
  // Get the first valid handle (directories)\r
  //\r
  for ( Node = (EFI_SHELL_FILE_INFO *)GetFirstNode(&TheList->Link)\r
      ; !IsNull(&TheList->Link, &Node->Link) && Node->Handle == NULL\r
      ; Node = (EFI_SHELL_FILE_INFO *)GetNextNode(&TheList->Link, &Node->Link)\r
     );\r
\r
  if (Node->Handle == NULL) {\r
    DirectoryName = GetFullyQualifiedPath(((EFI_SHELL_FILE_INFO *)GetFirstNode(&TheList->Link))->FullName);\r
\r
    //\r
    // We need to open something up to get system information\r
    //\r
    Status = gEfiShellProtocol->OpenFileByName(\r
      DirectoryName,\r
      &ShellFileHandle,\r
      EFI_FILE_MODE_READ\r
      );\r
\r
    ASSERT_EFI_ERROR(Status);\r
    FreePool(DirectoryName);\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
\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
\r
    ASSERT_EFI_ERROR(Status);\r
\r
    gEfiShellProtocol->CloseFile(ShellFileHandle);\r
  } else {\r
    //\r
    // Get the Volume Info from Node->Handle\r
    //\r
    SysInfo = NULL;\r
    SysInfoSize = 0;\r
    EfiFpHandle = ConvertShellHandleToEfiFileProtocol(Node->Handle);\r
    Status = EfiFpHandle->GetInfo(\r
      EfiFpHandle,\r
      &gEfiFileSystemInfoGuid,\r
      &SysInfoSize,\r
      SysInfo\r
      );\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
\r
    ASSERT_EFI_ERROR(Status);\r
  }\r
\r
  ShellPrintHiiEx (\r
    -1,\r
    -1,\r
    NULL,\r
    STRING_TOKEN (STR_GEN_SFO_HEADER),\r
    gShellLevel2HiiHandle,\r
    L"ls"\r
    );\r
  //\r
  // print VolumeInfo table\r
  //\r
  ASSERT(SysInfo != NULL);\r
  ShellPrintHiiEx (\r
    0,\r
    gST->ConOut->Mode->CursorRow,\r
    NULL,\r
    STRING_TOKEN (STR_LS_SFO_VOLINFO),\r
    gShellLevel2HiiHandle,\r
    SysInfo->VolumeLabel,\r
    SysInfo->VolumeSize,\r
    SysInfo->ReadOnly?L"TRUE":L"FALSE",\r
    SysInfo->FreeSpace,\r
    SysInfo->BlockSize\r
    );\r
\r
  SHELL_FREE_NON_NULL(SysInfo);\r
\r
  return (Status);\r
}\r
\r
/**\r
  print out the info on a single file.\r
\r
  @param[in] Sfo      TRUE if in SFO, false otherwise.\r
  @param[in] TheNode  the EFI_SHELL_FILE_INFO node to print out information on.\r
  @param[in] Files    incremented if a file is printed.\r
  @param[in] Size     incremented by file size.\r
  @param[in] Dirs     incremented if a directory is printed.\r
\r
**/\r
VOID\r
PrintFileInformation(\r
  IN CONST BOOLEAN              Sfo,\r
  IN CONST EFI_SHELL_FILE_INFO  *TheNode,\r
  IN UINT64                     *Files,\r
  IN UINT64                     *Size,\r
  IN UINT64                     *Dirs\r
  )\r
{\r
  ASSERT(Files    != NULL);\r
  ASSERT(Size     != NULL);\r
  ASSERT(Dirs     != NULL);\r
  ASSERT(TheNode  != NULL);\r
\r
  if (Sfo) {\r
    //\r
    // Print the FileInfo Table\r
    //\r
    ShellPrintHiiEx (\r
      0,\r
      gST->ConOut->Mode->CursorRow,\r
      NULL,\r
      STRING_TOKEN (STR_LS_SFO_FILEINFO),\r
      gShellLevel2HiiHandle,\r
      TheNode->FullName,\r
      TheNode->Info->FileSize,\r
      TheNode->Info->PhysicalSize,\r
      (TheNode->Info->Attribute & EFI_FILE_ARCHIVE)   != 0?L"a":L"",\r
      (TheNode->Info->Attribute & EFI_FILE_DIRECTORY) != 0?L"d":L"",\r
      (TheNode->Info->Attribute & EFI_FILE_HIDDEN)    != 0?L"h":L"",\r
      (TheNode->Info->Attribute & EFI_FILE_READ_ONLY) != 0?L"r":L"",\r
      (TheNode->Info->Attribute & EFI_FILE_SYSTEM)    != 0?L"s":L"",\r
      TheNode->Info->CreateTime.Hour,\r
      TheNode->Info->CreateTime.Minute,\r
      TheNode->Info->CreateTime.Second,\r
      TheNode->Info->CreateTime.Day,\r
      TheNode->Info->CreateTime.Month,\r
      TheNode->Info->CreateTime.Year,\r
      TheNode->Info->LastAccessTime.Hour,\r
      TheNode->Info->LastAccessTime.Minute,\r
      TheNode->Info->LastAccessTime.Second,\r
      TheNode->Info->LastAccessTime.Day,\r
      TheNode->Info->LastAccessTime.Month,\r
      TheNode->Info->LastAccessTime.Year,\r
      TheNode->Info->ModificationTime.Hour,\r
      TheNode->Info->ModificationTime.Minute,\r
      TheNode->Info->ModificationTime.Second,\r
      TheNode->Info->ModificationTime.Day,\r
      TheNode->Info->ModificationTime.Month,\r
      TheNode->Info->ModificationTime.Year\r
      );\r
  } else {\r
    //\r
    // print this one out...\r
    // first print the universal start, next print the type specific name format, last print the CRLF\r
    //\r
    ShellPrintHiiEx (\r
      -1,\r
      -1,\r
      NULL,\r
      STRING_TOKEN (STR_LS_LINE_START_ALL),\r
      gShellLevel2HiiHandle,\r
      &TheNode->Info->ModificationTime,\r
      (TheNode->Info->Attribute & EFI_FILE_DIRECTORY) != 0?L"<DIR>":L"",\r
      (TheNode->Info->Attribute & EFI_FILE_READ_ONLY) != 0?L'r':L' ',\r
      TheNode->Info->FileSize\r
      );\r
    if (TheNode->Info->Attribute & EFI_FILE_DIRECTORY) {\r
      (*Dirs)++;\r
      ShellPrintHiiEx (\r
        -1,\r
        -1,\r
        NULL,\r
        STRING_TOKEN (STR_LS_LINE_END_DIR),\r
        gShellLevel2HiiHandle,\r
        TheNode->FileName\r
        );\r
    } else {\r
      (*Files)++;\r
      (*Size) += TheNode->Info->FileSize;\r
      if ( (gUnicodeCollation->StriColl(gUnicodeCollation, (CHAR16*)L".nsh", (CHAR16*)&(TheNode->FileName[StrLen (TheNode->FileName) - 4])) == 0)\r
        || (gUnicodeCollation->StriColl(gUnicodeCollation, (CHAR16*)L".efi", (CHAR16*)&(TheNode->FileName[StrLen (TheNode->FileName) - 4])) == 0)\r
       ){\r
        ShellPrintHiiEx (\r
          -1,\r
          -1,\r
          NULL,\r
          STRING_TOKEN (STR_LS_LINE_END_EXE),\r
          gShellLevel2HiiHandle,\r
          TheNode->FileName\r
          );\r
      } else {\r
        ShellPrintHiiEx (\r
          -1,\r
          -1,\r
          NULL,\r
          STRING_TOKEN (STR_LS_LINE_END_FILE),\r
          gShellLevel2HiiHandle,\r
          TheNode->FileName\r
          );\r
      }\r
    }\r
  }\r
}\r
\r
/**\r
  print out the header when not using standard format output.\r
\r
  @param[in] Path           String with starting path.\r
**/\r
VOID\r
PrintNonSfoHeader(\r
  IN CONST CHAR16 *Path\r
  )\r
{\r
  CHAR16 *DirectoryName;\r
\r
  //\r
  // get directory name from path...\r
  //\r
  DirectoryName = GetFullyQualifiedPath(Path);\r
\r
  if (DirectoryName != NULL) {\r
    //\r
    // print header\r
    //\r
    ShellPrintHiiEx (\r
      0,\r
      gST->ConOut->Mode->CursorRow,\r
      NULL,\r
      STRING_TOKEN (STR_LS_HEADER_LINE1),\r
      gShellLevel2HiiHandle,\r
      DirectoryName\r
      );\r
\r
    SHELL_FREE_NON_NULL(DirectoryName);\r
  }\r
}\r
\r
/**\r
  print out the footer when not using standard format output.\r
\r
  @param[in] Files            The number of files.\r
  @param[in] Size             The size of files in bytes.\r
  @param[in] Dirs             The number of directories.\r
**/\r
VOID\r
PrintNonSfoFooter(\r
  IN UINT64                     Files,\r
  IN UINT64                     Size,\r
  IN UINT64                     Dirs\r
  )\r
{\r
  //\r
  // print footer\r
  //\r
  ShellPrintHiiEx (\r
    -1,\r
    -1,\r
    NULL,\r
    STRING_TOKEN (STR_LS_FOOTER_LINE),\r
    gShellLevel2HiiHandle,\r
    Files,\r
    Size,\r
    Dirs\r
   );\r
}\r
\r
/**\r
  Change the file time to local time based on the timezone.\r
\r
  @param[in] Time               The file time.\r
  @param[in] LocalTimeZone      Local time zone.\r
**/\r
VOID\r
FileTimeToLocalTime (\r
  IN EFI_TIME             *Time,\r
  IN INT16                LocalTimeZone\r
  )\r
{\r
  INTN                    MinuteDiff;\r
  INTN                    TempMinute;\r
  INTN                    HourNumberOfTempMinute;\r
  INTN                    TempHour;\r
  INTN                    DayNumberOfTempHour;\r
  INTN                    TempDay;\r
  INTN                    MonthNumberOfTempDay;\r
  INTN                    TempMonth;\r
  INTN                    YearNumberOfTempMonth;\r
  INTN                    MonthRecord;\r
\r
  ASSERT ((Time->TimeZone >= -1440) && (Time->TimeZone <=1440));\r
  ASSERT ((LocalTimeZone >= -1440) && (LocalTimeZone <=1440));\r
  ASSERT ((Time->Month >= 1) && (Time->Month <= 12));\r
\r
  if(Time->TimeZone == LocalTimeZone) {\r
    //\r
    //if the file timezone is equal to the local timezone, there is no need to adjust the file time.\r
    //\r
    return;\r
  }\r
\r
  if((Time->Year % 4 == 0 && Time->Year / 100 != 0)||(Time->Year % 400 == 0)) {\r
    //\r
    // Day in February of leap year is 29.\r
    //\r
    mDayOfMonth[1] = 29;\r
  }\r
\r
  MinuteDiff = Time->TimeZone - LocalTimeZone;\r
  TempMinute = Time->Minute + MinuteDiff;\r
\r
  //\r
  // Calculate Time->Minute\r
  // TempHour will be used to calculate Time->Hour\r
  //\r
  HourNumberOfTempMinute = TempMinute / 60;\r
  if(TempMinute < 0) {\r
    HourNumberOfTempMinute --;\r
  }\r
  TempHour = Time->Hour + HourNumberOfTempMinute;\r
  Time->Minute = (UINT8)(TempMinute - 60 * HourNumberOfTempMinute);\r
\r
  //\r
  // Calculate Time->Hour\r
  // TempDay will be used to calculate Time->Day\r
  //\r
  DayNumberOfTempHour = TempHour / 24 ;\r
  if(TempHour < 0){\r
    DayNumberOfTempHour--;\r
  }\r
  TempDay = Time->Day + DayNumberOfTempHour;\r
  Time->Hour = (UINT8)(TempHour - 24 * DayNumberOfTempHour);\r
\r
  //\r
  // Calculate Time->Day\r
  // TempMonth will be used to calculate Time->Month\r
  //\r
  MonthNumberOfTempDay = (TempDay - 1) / (INTN)mDayOfMonth[Time->Month - 1];\r
  MonthRecord = (INTN)(Time->Month) ;\r
  if(TempDay - 1 < 0){\r
    MonthNumberOfTempDay -- ;\r
    MonthRecord -- ;\r
  }\r
  TempMonth = Time->Month + MonthNumberOfTempDay;\r
  Time->Day = (UINT8)(TempDay - (INTN)mDayOfMonth[(MonthRecord - 1 + 12) % 12] * MonthNumberOfTempDay);\r
\r
  //\r
  // Calculate Time->Month, Time->Year\r
  //\r
  YearNumberOfTempMonth = (TempMonth - 1) / 12;\r
  if(TempMonth - 1 < 0){\r
    YearNumberOfTempMonth --;\r
  }\r
  Time->Month = (UINT8)(TempMonth - 12 * (YearNumberOfTempMonth));\r
  Time->Year = (UINT16)(Time->Year + YearNumberOfTempMonth);\r
}\r
\r
/**\r
  print out the list of files and directories from the LS command\r
\r
  @param[in] Rec            TRUE to automatically recurse into each found directory\r
                            FALSE to only list the specified directory.\r
  @param[in] Attribs        List of required Attribute for display.\r
                            If 0 then all non-system and non-hidden files will be printed.\r
  @param[in] Sfo            TRUE to use Standard Format Output, FALSE otherwise\r
  @param[in] RootPath       String with starting path to search in.\r
  @param[in] SearchString   String with search string.\r
  @param[in] Found          Set to TRUE, if anyone were found.\r
  @param[in] Count          The count of bits enabled in Attribs.\r
  @param[in] TimeZone       The current time zone offset.\r
  @param[in] ListUnfiltered TRUE to request listing the directory contents\r
                            unfiltered.\r
\r
  @retval SHELL_SUCCESS     the printing was sucessful.\r
**/\r
SHELL_STATUS\r
PrintLsOutput(\r
  IN CONST BOOLEAN Rec,\r
  IN CONST UINT64  Attribs,\r
  IN CONST BOOLEAN Sfo,\r
  IN CONST CHAR16  *RootPath,\r
  IN CONST CHAR16  *SearchString,\r
  IN       BOOLEAN *Found,\r
  IN CONST UINTN   Count,\r
  IN CONST INT16   TimeZone,\r
  IN CONST BOOLEAN ListUnfiltered\r
  )\r
{\r
  EFI_STATUS            Status;\r
  EFI_SHELL_FILE_INFO   *ListHead;\r
  EFI_SHELL_FILE_INFO   *Node;\r
  SHELL_STATUS          ShellStatus;\r
  UINT64                FileCount;\r
  UINT64                DirCount;\r
  UINT64                FileSize;\r
  UINTN                 LongestPath;\r
  CHAR16                *CorrectedPath;\r
  BOOLEAN               FoundOne;\r
  BOOLEAN               HeaderPrinted;\r
  EFI_TIME              LocalTime;\r
\r
  HeaderPrinted = FALSE;\r
  FileCount     = 0;\r
  DirCount      = 0;\r
  FileSize      = 0;\r
  ListHead      = NULL;\r
  ShellStatus   = SHELL_SUCCESS;\r
  LongestPath   = 0;\r
  CorrectedPath = NULL;\r
\r
  if (Found != NULL) {\r
    FoundOne = *Found;\r
  } else {\r
    FoundOne = FALSE;\r
  }\r
\r
  CorrectedPath = StrnCatGrow(&CorrectedPath, &LongestPath, RootPath,     0);\r
  if (CorrectedPath == NULL) {\r
    return SHELL_OUT_OF_RESOURCES;\r
  }\r
  if (CorrectedPath[StrLen(CorrectedPath)-1] != L'\\'\r
    &&CorrectedPath[StrLen(CorrectedPath)-1] != L'/') {\r
    CorrectedPath = StrnCatGrow(&CorrectedPath, &LongestPath, L"\\",     0);\r
  }\r
  CorrectedPath = StrnCatGrow(&CorrectedPath, &LongestPath, SearchString, 0);\r
  if (CorrectedPath == NULL) {\r
    return (SHELL_OUT_OF_RESOURCES);\r
  }\r
\r
  PathCleanUpDirectories(CorrectedPath);\r
\r
  Status = ShellOpenFileMetaArg((CHAR16*)CorrectedPath, EFI_FILE_MODE_READ, &ListHead);\r
  if (!EFI_ERROR(Status)) {\r
    if (ListHead == NULL || IsListEmpty(&ListHead->Link)) {\r
      SHELL_FREE_NON_NULL(CorrectedPath);\r
      return (SHELL_SUCCESS);\r
    }\r
\r
    if (Sfo && Found == NULL) {\r
      PrintSfoVolumeInfoTableEntry(ListHead);\r
    }\r
\r
    if (!Sfo) {\r
      //\r
      // Sort the file list by FileName, stably.\r
      //\r
      // If the call below fails, then the EFI_SHELL_FILE_INFO list anchored to\r
      // ListHead will not be changed in any way.\r
      //\r
      ShellSortFileList (\r
        &ListHead,\r
        NULL,                       // Duplicates\r
        ShellSortFileListByFileName\r
        );\r
    }\r
\r
    for ( Node = (EFI_SHELL_FILE_INFO *)GetFirstNode(&ListHead->Link), LongestPath = 0\r
        ; !IsNull(&ListHead->Link, &Node->Link)\r
        ; Node = (EFI_SHELL_FILE_INFO *)GetNextNode(&ListHead->Link, &Node->Link)\r
        ){\r
      if (ShellGetExecutionBreakFlag ()) {\r
        ShellStatus = SHELL_ABORTED;\r
        break;\r
      }\r
      ASSERT(Node != NULL);\r
\r
      //\r
      // Change the file time to local time.\r
      //\r
      Status = gRT->GetTime(&LocalTime, NULL);\r
      if (!EFI_ERROR (Status) && (LocalTime.TimeZone != EFI_UNSPECIFIED_TIMEZONE)) {\r
        if ((Node->Info->CreateTime.TimeZone != EFI_UNSPECIFIED_TIMEZONE) &&\r
            (Node->Info->CreateTime.Month >= 1 && Node->Info->CreateTime.Month <= 12)) {\r
          //\r
          // FileTimeToLocalTime () requires Month is in a valid range, other buffer out-of-band access happens.\r
          //\r
          FileTimeToLocalTime (&Node->Info->CreateTime, LocalTime.TimeZone);\r
        }\r
        if ((Node->Info->LastAccessTime.TimeZone != EFI_UNSPECIFIED_TIMEZONE) &&\r
            (Node->Info->LastAccessTime.Month >= 1 && Node->Info->LastAccessTime.Month <= 12)) {\r
          FileTimeToLocalTime (&Node->Info->LastAccessTime, LocalTime.TimeZone);\r
        }\r
        if ((Node->Info->ModificationTime.TimeZone != EFI_UNSPECIFIED_TIMEZONE) &&\r
            (Node->Info->ModificationTime.Month >= 1 && Node->Info->ModificationTime.Month <= 12)) {\r
          FileTimeToLocalTime (&Node->Info->ModificationTime, LocalTime.TimeZone);\r
        }\r
      }\r
\r
      if (LongestPath < StrSize(Node->FullName)) {\r
        LongestPath = StrSize(Node->FullName);\r
      }\r
      ASSERT(Node->Info != NULL);\r
      ASSERT((Node->Info->Attribute & EFI_FILE_VALID_ATTR) == Node->Info->Attribute);\r
      if (Attribs == 0) {\r
        //\r
        // NOT system & NOT hidden\r
        //\r
        if ( (Node->Info->Attribute & EFI_FILE_SYSTEM)\r
          || (Node->Info->Attribute & EFI_FILE_HIDDEN)\r
         ){\r
          continue;\r
        }\r
      } else if ((Attribs != EFI_FILE_VALID_ATTR) ||\r
                 (Count == 5)) {\r
        //\r
        // Only matches the bits which "Attribs" contains, not\r
        // all files/directories with any of the bits.\r
        // Count == 5 is used to tell the difference between a user\r
        // specifying all bits (EX: -arhsda) and just specifying\r
        // -a (means display all files with any attribute).\r
        //\r
        if ( (Node->Info->Attribute & Attribs) != Attribs) {\r
          continue;\r
        }\r
      }\r
\r
      if (!Sfo && !HeaderPrinted) {\r
        PathRemoveLastItem (CorrectedPath);\r
        PrintNonSfoHeader(CorrectedPath);\r
      }\r
      PrintFileInformation(Sfo, Node, &FileCount, &FileSize, &DirCount);\r
      FoundOne = TRUE;\r
      HeaderPrinted = TRUE;\r
    }\r
\r
    if (!Sfo && ShellStatus != SHELL_ABORTED && HeaderPrinted) {\r
      PrintNonSfoFooter(FileCount, FileSize, DirCount);\r
    }\r
  }\r
\r
  if (Rec && ShellStatus != SHELL_ABORTED) {\r
    //\r
    // Re-Open all the files under the starting path for directories that didnt necessarily match our file filter\r
    //\r
    ShellCloseFileMetaArg(&ListHead);\r
    CorrectedPath[0] = CHAR_NULL;\r
    CorrectedPath = StrnCatGrow(&CorrectedPath, &LongestPath, RootPath, 0);\r
    if (CorrectedPath == NULL) {\r
      return SHELL_OUT_OF_RESOURCES;\r
    }\r
    if (CorrectedPath[StrLen(CorrectedPath)-1] != L'\\'\r
      &&CorrectedPath[StrLen(CorrectedPath)-1] != L'/') {\r
      CorrectedPath = StrnCatGrow(&CorrectedPath, &LongestPath, L"\\",     0);\r
    }\r
    CorrectedPath = StrnCatGrow(&CorrectedPath, &LongestPath, L"*",     0);\r
    Status = ShellOpenFileMetaArg((CHAR16*)CorrectedPath, EFI_FILE_MODE_READ, &ListHead);\r
\r
    if (!EFI_ERROR(Status)) {\r
      for ( Node = (EFI_SHELL_FILE_INFO *)GetFirstNode(&ListHead->Link)\r
          ; !IsNull(&ListHead->Link, &Node->Link) && ShellStatus == SHELL_SUCCESS\r
          ; Node = (EFI_SHELL_FILE_INFO *)GetNextNode(&ListHead->Link, &Node->Link)\r
         ){\r
        if (ShellGetExecutionBreakFlag ()) {\r
          ShellStatus = SHELL_ABORTED;\r
          break;\r
        }\r
\r
        //\r
        // recurse on any directory except the traversing ones...\r
        //\r
        if (((Node->Info->Attribute & EFI_FILE_DIRECTORY) == EFI_FILE_DIRECTORY)\r
          && StrCmp(Node->FileName, L".") != 0\r
          && StrCmp(Node->FileName, L"..") != 0\r
         ){\r
          ShellStatus = PrintLsOutput(\r
            Rec,\r
            Attribs,\r
            Sfo,\r
            Node->FullName,\r
            SearchString,\r
            &FoundOne,\r
            Count,\r
            TimeZone,\r
            FALSE);\r
\r
          //\r
          // Since it's running recursively, we have to break immediately when returned SHELL_ABORTED\r
          //\r
          if (ShellStatus == SHELL_ABORTED) {\r
            break;\r
          }\r
        }\r
      }\r
    }\r
  }\r
\r
  SHELL_FREE_NON_NULL(CorrectedPath);\r
  ShellCloseFileMetaArg(&ListHead);\r
\r
  if (Found == NULL && !FoundOne) {\r
    if (ListUnfiltered) {\r
      //\r
      // When running "ls" without any filtering request, avoid outputing\r
      // "File not found" when the directory is entirely empty, but print\r
      // header and footer stating "0 File(s), 0 Dir(s)".\r
      //\r
      if (!Sfo) {\r
        PrintNonSfoHeader (RootPath);\r
        if (ShellStatus != SHELL_ABORTED) {\r
          PrintNonSfoFooter (FileCount, FileSize, DirCount);\r
        }\r
      }\r
    } else {\r
      return (SHELL_NOT_FOUND);\r
    }\r
  }\r
\r
  if (Found != NULL) {\r
    *Found = FoundOne;\r
  }\r
\r
  return (ShellStatus);\r
}\r
\r
STATIC CONST SHELL_PARAM_ITEM LsParamList[] = {\r
  {L"-r", TypeFlag},\r
  {L"-a", TypeStart},\r
  {L"-sfo", TypeFlag},\r
  {NULL, TypeMax}\r
  };\r
\r
/**\r
  Function for 'ls' 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
ShellCommandRunLs (\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
  CONST CHAR16  *Attribs;\r
  SHELL_STATUS  ShellStatus;\r
  UINT64        RequiredAttributes;\r
  CONST CHAR16  *PathName;\r
  CONST CHAR16  *CurDir;\r
  UINTN         Count;\r
  CHAR16        *FullPath;\r
  UINTN         Size;\r
  EFI_TIME      TheTime;\r
  CHAR16        *SearchString;\r
  BOOLEAN       ListUnfiltered;\r
\r
  Size                = 0;\r
  FullPath            = NULL;\r
  ProblemParam        = NULL;\r
  Attribs             = NULL;\r
  ShellStatus         = SHELL_SUCCESS;\r
  RequiredAttributes  = 0;\r
  PathName            = NULL;\r
  SearchString        = NULL;\r
  CurDir              = NULL;\r
  Count               = 0;\r
  ListUnfiltered      = FALSE;\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 (LsParamList, &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, L"ls", 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, L"ls");\r
      ShellStatus = SHELL_INVALID_PARAMETER;\r
    } else {\r
      //\r
      // check for -a\r
      //\r
      if (ShellCommandLineGetFlag(Package, L"-a")) {\r
        for ( Attribs = ShellCommandLineGetValue(Package, L"-a")\r
            ; Attribs != NULL && *Attribs != CHAR_NULL && ShellStatus == SHELL_SUCCESS\r
            ; Attribs++\r
           ){\r
          switch (*Attribs) {\r
            case L'a':\r
            case L'A':\r
              RequiredAttributes |= EFI_FILE_ARCHIVE;\r
              Count++;\r
              continue;\r
            case L's':\r
            case L'S':\r
              RequiredAttributes |= EFI_FILE_SYSTEM;\r
              Count++;\r
              continue;\r
            case L'h':\r
            case L'H':\r
              RequiredAttributes |= EFI_FILE_HIDDEN;\r
              Count++;\r
              continue;\r
            case L'r':\r
            case L'R':\r
              RequiredAttributes |= EFI_FILE_READ_ONLY;\r
              Count++;\r
              continue;\r
            case L'd':\r
            case L'D':\r
              RequiredAttributes |= EFI_FILE_DIRECTORY;\r
              Count++;\r
              continue;\r
            default:\r
              ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_GEN_ATTRIBUTE), gShellLevel2HiiHandle, L"ls", ShellCommandLineGetValue(Package, L"-a"));\r
              ShellStatus = SHELL_INVALID_PARAMETER;\r
              break;\r
          } // switch\r
        } // for loop\r
        //\r
        // if nothing is specified all are specified\r
        //\r
        if (RequiredAttributes == 0) {\r
          RequiredAttributes = EFI_FILE_VALID_ATTR;\r
        }\r
      } // if -a present\r
      if (ShellStatus == SHELL_SUCCESS) {\r
        PathName = ShellCommandLineGetRawValue(Package, 1);\r
        if (PathName == NULL) {\r
          //\r
          // Nothing specified... must start from current directory\r
          //\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, L"ls");\r
          }\r
          ListUnfiltered = TRUE;\r
          //\r
          // Copy to the 2 strings for starting path and file search string\r
          //\r
          ASSERT(SearchString == NULL);\r
          ASSERT(FullPath == NULL);\r
          StrnCatGrow(&SearchString, NULL, L"*", 0);\r
          StrnCatGrow(&FullPath, NULL, CurDir, 0);\r
          Size = FullPath != NULL? StrSize(FullPath) : 0;\r
          StrnCatGrow(&FullPath, &Size, L"\\", 0);\r
        } else {\r
          if (StrStr(PathName, L":") == NULL && gEfiShellProtocol->GetCurDir(NULL) == NULL) {\r
            //\r
            // If we got something and it doesnt have a fully qualified path, then we needed to have a CWD.\r
            //\r
            ShellStatus = SHELL_NOT_FOUND;\r
            ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_GEN_NO_CWD), gShellLevel2HiiHandle, L"ls");\r
          } else {\r
            //\r
            // We got a valid fully qualified path or we have a CWD\r
            //\r
            ASSERT((FullPath == NULL && Size == 0) || (FullPath != NULL));\r
            if (StrStr(PathName, L":") == NULL) {\r
              StrnCatGrow(&FullPath, &Size, gEfiShellProtocol->GetCurDir(NULL), 0);\r
              if (FullPath == NULL) {\r
                ShellCommandLineFreeVarList (Package);\r
                return SHELL_OUT_OF_RESOURCES;\r
              }\r
              Size = FullPath != NULL? StrSize(FullPath) : 0;\r
              StrnCatGrow(&FullPath, &Size, L"\\", 0);\r
            }\r
            StrnCatGrow(&FullPath, &Size, PathName, 0);\r
            if (FullPath == NULL) {\r
                ShellCommandLineFreeVarList (Package);\r
                return SHELL_OUT_OF_RESOURCES;\r
            }\r
\r
            if  (ShellIsDirectory(PathName) == EFI_SUCCESS) {\r
              //\r
              // is listing ends with a directory, then we list all files in that directory\r
              //\r
              ListUnfiltered = TRUE;\r
              StrnCatGrow(&SearchString, NULL, L"*", 0);\r
            } else {\r
              //\r
              // must split off the search part that applies to files from the end of the directory part\r
              //\r
              StrnCatGrow(&SearchString, NULL, FullPath, 0);\r
              if (SearchString == NULL) {\r
                FreePool (FullPath);\r
                ShellCommandLineFreeVarList (Package);\r
                return SHELL_OUT_OF_RESOURCES;\r
              }\r
              PathRemoveLastItem (FullPath);\r
              CopyMem (SearchString, SearchString + StrLen (FullPath), StrSize (SearchString + StrLen (FullPath)));\r
            }\r
          }\r
        }\r
        Status = gRT->GetTime(&TheTime, NULL);\r
        if (EFI_ERROR(Status)) {\r
          ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_GEN_UEFI_FUNC_WARN), gShellLevel2HiiHandle, L"ls", L"gRT->GetTime", Status);\r
          TheTime.TimeZone = EFI_UNSPECIFIED_TIMEZONE;\r
        }\r
\r
        if (ShellStatus == SHELL_SUCCESS) {\r
          ShellStatus = PrintLsOutput(\r
            ShellCommandLineGetFlag(Package, L"-r"),\r
            RequiredAttributes,\r
            ShellCommandLineGetFlag(Package, L"-sfo"),\r
            FullPath,\r
            SearchString,\r
            NULL,\r
            Count,\r
            TheTime.TimeZone,\r
            ListUnfiltered\r
           );\r
          if (ShellStatus == SHELL_NOT_FOUND) {\r
            ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_LS_FILE_NOT_FOUND), gShellLevel2HiiHandle, L"ls", FullPath);\r
          } else if (ShellStatus == SHELL_INVALID_PARAMETER) {\r
            ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_GEN_PARAM_INV), gShellLevel2HiiHandle, L"ls", FullPath);\r
          } else if (ShellStatus == SHELL_ABORTED) {\r
            //\r
            // Ignore aborting.\r
            //\r
          } else if (ShellStatus != SHELL_SUCCESS) {\r
            ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_GEN_PARAM_INV), gShellLevel2HiiHandle, L"ls", FullPath);\r
          }\r
        }\r
      }\r
    }\r
  }\r
\r
  //\r
  // Free memory allocated\r
  //\r
  SHELL_FREE_NON_NULL(SearchString);\r
  SHELL_FREE_NON_NULL(FullPath);\r
  ShellCommandLineFreeVarList (Package);\r
\r
  return (ShellStatus);\r
}\r