ShellPkg/Library/UefiShellLevel2CommandsLib/Ls.c

   1 /** @file
   2   Main file for ls shell level 2 function.
   3
   4   Copyright (c) 2013 Hewlett-Packard Development Company, L.P.
   5   Copyright (c) 2009 - 2014, Intel Corporation. All rights reserved.<BR>
   6   This program and the accompanying materials
   7   are licensed and made available under the terms and conditions of the BSD License
   8   which accompanies this distribution.  The full text of the license may be found at
   9   http://opensource.org/licenses/bsd-license.php
  10
  11   THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
  12   WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
  13
  14 **/
  15
  16 #include "UefiShellLevel2CommandsLib.h"
  17 #include <Guid/FileSystemInfo.h>
  18
  19 /**
  20   print out the standard format output volume entry.
  21
  22   @param[in] TheList           a list of files from the volume.
  23 **/
  24 EFI_STATUS
  25 EFIAPI
  26 PrintSfoVolumeInfoTableEntry(
  27   IN CONST EFI_SHELL_FILE_INFO *TheList
  28   )
  29 {
  30   EFI_STATUS            Status;
  31   EFI_SHELL_FILE_INFO   *Node;
  32   CHAR16                *DirectoryName;
  33   EFI_FILE_SYSTEM_INFO  *SysInfo;
  34   UINTN                 SysInfoSize;
  35   SHELL_FILE_HANDLE     ShellFileHandle;
  36   EFI_FILE_PROTOCOL     *EfiFpHandle;
  37
  38   //
  39   // Get the first valid handle (directories)
  40   //
  41   for ( Node = (EFI_SHELL_FILE_INFO *)GetFirstNode(&TheList->Link)
  42       ; !IsNull(&TheList->Link, &Node->Link) && Node->Handle == NULL
  43       ; Node = (EFI_SHELL_FILE_INFO *)GetNextNode(&TheList->Link, &Node->Link)
  44      );
  45
  46   if (Node->Handle == NULL) {
  47     DirectoryName = GetFullyQualifiedPath(((EFI_SHELL_FILE_INFO *)GetFirstNode(&TheList->Link))->FullName);
  48
  49     //
  50     // We need to open something up to get system information
  51     //
  52     Status = gEfiShellProtocol->OpenFileByName(
  53       DirectoryName,
  54       &ShellFileHandle,
  55       EFI_FILE_MODE_READ
  56       );
  57
  58     ASSERT_EFI_ERROR(Status);
  59     FreePool(DirectoryName);
  60
  61     //
  62     // Get the Volume Info from ShellFileHandle
  63     //
  64     SysInfo     = NULL;
  65     SysInfoSize = 0;
  66     EfiFpHandle = ConvertShellHandleToEfiFileProtocol(ShellFileHandle);
  67     Status = EfiFpHandle->GetInfo(
  68       EfiFpHandle,
  69       &gEfiFileSystemInfoGuid,
  70       &SysInfoSize,
  71       SysInfo
  72       );
  73
  74     if (Status == EFI_BUFFER_TOO_SMALL) {
  75       SysInfo = AllocateZeroPool(SysInfoSize);
  76       Status = EfiFpHandle->GetInfo(
  77         EfiFpHandle,
  78         &gEfiFileSystemInfoGuid,
  79         &SysInfoSize,
  80         SysInfo
  81         );
  82     }
  83
  84     ASSERT_EFI_ERROR(Status);
  85
  86     gEfiShellProtocol->CloseFile(ShellFileHandle);
  87   } else {
  88     //
  89     // Get the Volume Info from Node->Handle
  90     //
  91     SysInfo = NULL;
  92     SysInfoSize = 0;
  93     EfiFpHandle = ConvertShellHandleToEfiFileProtocol(Node->Handle);
  94     Status = EfiFpHandle->GetInfo(
  95       EfiFpHandle,
  96       &gEfiFileSystemInfoGuid,
  97       &SysInfoSize,
  98       SysInfo
  99       );
 100
 101     if (Status == EFI_BUFFER_TOO_SMALL) {
 102       SysInfo = AllocateZeroPool(SysInfoSize);
 103       Status = EfiFpHandle->GetInfo(
 104         EfiFpHandle,
 105         &gEfiFileSystemInfoGuid,
 106         &SysInfoSize,
 107         SysInfo
 108         );
 109     }
 110
 111     ASSERT_EFI_ERROR(Status);
 112   }
 113
 114   ShellPrintHiiEx (
 115     -1,
 116     -1,
 117     NULL,
 118     STRING_TOKEN (STR_GEN_SFO_HEADER),
 119     gShellLevel2HiiHandle,
 120     L"ls"
 121     );
 122   //
 123   // print VolumeInfo table
 124   //
 125   ASSERT(SysInfo != NULL);
 126   ShellPrintHiiEx (
 127     0,
 128     gST->ConOut->Mode->CursorRow,
 129     NULL,
 130     STRING_TOKEN (STR_LS_SFO_VOLINFO),
 131     gShellLevel2HiiHandle,
 132     SysInfo->VolumeLabel,
 133     SysInfo->VolumeSize,
 134     SysInfo->ReadOnly?L"TRUE":L"FALSE",
 135     SysInfo->FreeSpace,
 136     SysInfo->BlockSize
 137     );
 138
 139   SHELL_FREE_NON_NULL(SysInfo);
 140
 141   return (Status);
 142 }
 143
 144 /**
 145   print out the info on a single file.
 146
 147   @param[in] Sfo      TRUE if in SFO, false otherwise.
 148   @param[in] TheNode  the EFI_SHELL_FILE_INFO node to print out information on.
 149   @param[in] Files    incremented if a file is printed.
 150   @param[in] Size     incremented by file size.
 151   @param[in] Dirs     incremented if a directory is printed.
 152
 153 **/
 154 VOID
 155 EFIAPI
 156 PrintFileInformation(
 157   IN CONST BOOLEAN              Sfo,
 158   IN CONST EFI_SHELL_FILE_INFO  *TheNode,
 159   IN UINT64                     *Files,
 160   IN UINT64                     *Size,
 161   IN UINT64                     *Dirs
 162   )
 163 {
 164   ASSERT(Files    != NULL);
 165   ASSERT(Size     != NULL);
 166   ASSERT(Dirs     != NULL);
 167   ASSERT(TheNode  != NULL);
 168
 169   if (Sfo) {
 170     //
 171     // Print the FileInfo Table
 172     //
 173     ShellPrintHiiEx (
 174       0,
 175       gST->ConOut->Mode->CursorRow,
 176       NULL,
 177       STRING_TOKEN (STR_LS_SFO_FILEINFO),
 178       gShellLevel2HiiHandle,
 179       TheNode->FullName,
 180       TheNode->Info->FileSize,
 181       TheNode->Info->PhysicalSize,
 182       (TheNode->Info->Attribute & EFI_FILE_ARCHIVE)   != 0?L"a":L"",
 183       (TheNode->Info->Attribute & EFI_FILE_DIRECTORY) != 0?L"d":L"",
 184       (TheNode->Info->Attribute & EFI_FILE_HIDDEN)    != 0?L"h":L"",
 185       (TheNode->Info->Attribute & EFI_FILE_READ_ONLY) != 0?L"r":L"",
 186       (TheNode->Info->Attribute & EFI_FILE_SYSTEM)    != 0?L"s":L"",
 187       TheNode->Info->CreateTime.Hour,
 188       TheNode->Info->CreateTime.Minute,
 189       TheNode->Info->CreateTime.Second,
 190       TheNode->Info->CreateTime.Day,
 191       TheNode->Info->CreateTime.Month,
 192       TheNode->Info->CreateTime.Year,
 193       TheNode->Info->LastAccessTime.Hour,
 194       TheNode->Info->LastAccessTime.Minute,
 195       TheNode->Info->LastAccessTime.Second,
 196       TheNode->Info->LastAccessTime.Day,
 197       TheNode->Info->LastAccessTime.Month,
 198       TheNode->Info->LastAccessTime.Year,
 199       TheNode->Info->ModificationTime.Hour,
 200       TheNode->Info->ModificationTime.Minute,
 201       TheNode->Info->ModificationTime.Second,
 202       TheNode->Info->ModificationTime.Day,
 203       TheNode->Info->ModificationTime.Month,
 204       TheNode->Info->ModificationTime.Year
 205       );
 206   } else {
 207     //
 208     // print this one out...
 209     // first print the universal start, next print the type specific name format, last print the CRLF
 210     //
 211     ShellPrintHiiEx (
 212       -1,
 213       -1,
 214       NULL,
 215       STRING_TOKEN (STR_LS_LINE_START_ALL),
 216       gShellLevel2HiiHandle,
 217       &TheNode->Info->ModificationTime,
 218       (TheNode->Info->Attribute & EFI_FILE_DIRECTORY) != 0?L"<DIR>":L"",
 219       (TheNode->Info->Attribute & EFI_FILE_READ_ONLY) != 0?L'r':L' ',
 220       TheNode->Info->FileSize
 221       );
 222     if (TheNode->Info->Attribute & EFI_FILE_DIRECTORY) {
 223       (*Dirs)++;
 224       ShellPrintHiiEx (
 225         -1,
 226         -1,
 227         NULL,
 228         STRING_TOKEN (STR_LS_LINE_END_DIR),
 229         gShellLevel2HiiHandle,
 230         TheNode->FileName
 231         );
 232     } else {
 233       (*Files)++;
 234       (*Size) += TheNode->Info->FileSize;
 235       if ( (gUnicodeCollation->StriColl(gUnicodeCollation, (CHAR16*)L".nsh", (CHAR16*)&(TheNode->FileName[StrLen (TheNode->FileName) - 4])) == 0)
 236         || (gUnicodeCollation->StriColl(gUnicodeCollation, (CHAR16*)L".efi", (CHAR16*)&(TheNode->FileName[StrLen (TheNode->FileName) - 4])) == 0)
 237        ){
 238         ShellPrintHiiEx (
 239           -1,
 240           -1,
 241           NULL,
 242           STRING_TOKEN (STR_LS_LINE_END_EXE),
 243           gShellLevel2HiiHandle,
 244           TheNode->FileName
 245           );
 246       } else {
 247         ShellPrintHiiEx (
 248           -1,
 249           -1,
 250           NULL,
 251           STRING_TOKEN (STR_LS_LINE_END_FILE),
 252           gShellLevel2HiiHandle,
 253           TheNode->FileName
 254           );
 255       }
 256     }
 257   }
 258 }
 259
 260 /**
 261   print out the header when not using standard format output.
 262
 263   @param[in] Path           String with starting path.
 264 **/
 265 VOID
 266 EFIAPI
 267 PrintNonSfoHeader(
 268   IN CONST CHAR16 *Path
 269   )
 270 {
 271   CHAR16 *DirectoryName;
 272
 273   //
 274   // get directory name from path...
 275   //
 276   DirectoryName = GetFullyQualifiedPath(Path);
 277
 278   if (DirectoryName != NULL) {
 279     //
 280     // print header
 281     //
 282     ShellPrintHiiEx (
 283       0,
 284       gST->ConOut->Mode->CursorRow,
 285       NULL,
 286       STRING_TOKEN (STR_LS_HEADER_LINE1),
 287       gShellLevel2HiiHandle,
 288       DirectoryName
 289       );
 290
 291     SHELL_FREE_NON_NULL(DirectoryName);
 292   }
 293 }
 294
 295 /**
 296   print out the footer when not using standard format output.
 297
 298   @param[in] Files            The number of files.
 299   @param[in] Size             The size of files in bytes.
 300   @param[in] Dirs             The number of directories.
 301 **/
 302 VOID
 303 EFIAPI
 304 PrintNonSfoFooter(
 305   IN UINT64                     Files,
 306   IN UINT64                     Size,
 307   IN UINT64                     Dirs
 308   )
 309 {
 310   //
 311   // print footer
 312   //
 313   ShellPrintHiiEx (
 314     -1,
 315     -1,
 316     NULL,
 317     STRING_TOKEN (STR_LS_FOOTER_LINE),
 318     gShellLevel2HiiHandle,
 319     Files,
 320     Size,
 321     Dirs
 322    );
 323 }
 324
 325 /**
 326   print out the list of files and directories from the LS command
 327
 328   @param[in] Rec            TRUE to automatically recurse into each found directory
 329                             FALSE to only list the specified directory.
 330   @param[in] Attribs        List of required Attribute for display.
 331                             If 0 then all non-system and non-hidden files will be printed.
 332   @param[in] Sfo            TRUE to use Standard Format Output, FALSE otherwise
 333   @param[in] Path           String with starting path.
 334   @param[in] First          TRUE for the original and FALSE for any recursion spawned instances.
 335   @param[in] Count          The count of bits enabled in Attribs.
 336   @param[in] TimeZone       The current time zone offset.
 337
 338   @retval SHELL_SUCCESS     the printing was sucessful.
 339 **/
 340 SHELL_STATUS
 341 EFIAPI
 342 PrintLsOutput(
 343   IN CONST BOOLEAN Rec,
 344   IN CONST UINT64  Attribs,
 345   IN CONST BOOLEAN Sfo,
 346   IN CONST CHAR16  *Path,
 347   IN CONST BOOLEAN First,
 348   IN CONST UINTN   Count,
 349   IN CONST INT16   TimeZone
 350   )
 351 {
 352   EFI_STATUS            Status;
 353   EFI_SHELL_FILE_INFO   *ListHead;
 354   EFI_SHELL_FILE_INFO   *Node;
 355   SHELL_STATUS          ShellStatus;
 356   UINT64                FileCount;
 357   UINT64                DirCount;
 358   UINT64                FileSize;
 359   CHAR16                *DirectoryName;
 360   UINTN                 LongestPath;
 361   CHAR16                *CorrectedPath;
 362
 363   FileCount     = 0;
 364   DirCount      = 0;
 365   FileSize      = 0;
 366   ListHead      = NULL;
 367   ShellStatus   = SHELL_SUCCESS;
 368   LongestPath   = 0;
 369   CorrectedPath = NULL;
 370
 371   CorrectedPath = StrnCatGrow(&CorrectedPath, NULL, Path, 0);
 372   if (CorrectedPath == NULL) {
 373     return (SHELL_OUT_OF_RESOURCES);
 374   }
 375
 376   PathCleanUpDirectories(CorrectedPath);
 377
 378   if (!Sfo) {
 379     PrintNonSfoHeader(CorrectedPath);
 380   }
 381
 382   Status = ShellOpenFileMetaArg((CHAR16*)CorrectedPath, EFI_FILE_MODE_READ, &ListHead);
 383   if (EFI_ERROR(Status)) {
 384     SHELL_FREE_NON_NULL(CorrectedPath);
 385     if(Status == EFI_NOT_FOUND){
 386       return (SHELL_NOT_FOUND);
 387     }
 388     return (SHELL_DEVICE_ERROR);
 389   }
 390   if (ListHead == NULL || IsListEmpty(&ListHead->Link)) {
 391     SHELL_FREE_NON_NULL(CorrectedPath);
 392     //
 393     // On the first one only we expect to find something...
 394     // do we find the . and .. directories otherwise?
 395     //
 396     if (First) {
 397       return (SHELL_NOT_FOUND);
 398     }
 399     return (SHELL_SUCCESS);
 400   }
 401
 402   if (Sfo && First) {
 403     PrintSfoVolumeInfoTableEntry(ListHead);
 404   }
 405
 406   for ( Node = (EFI_SHELL_FILE_INFO *)GetFirstNode(&ListHead->Link)
 407       ; !IsNull(&ListHead->Link, &Node->Link)
 408       ; Node = (EFI_SHELL_FILE_INFO *)GetNextNode(&ListHead->Link, &Node->Link)
 409       ){
 410     ASSERT(Node != NULL);
 411     if (LongestPath < StrSize(Node->FullName)) {
 412       LongestPath = StrSize(Node->FullName);
 413     }
 414     ASSERT(Node->Info != NULL);
 415     ASSERT((Node->Info->Attribute & EFI_FILE_VALID_ATTR) == Node->Info->Attribute);
 416     if (Attribs == 0) {
 417       //
 418       // NOT system & NOT hidden
 419       //
 420       if ( (Node->Info->Attribute & EFI_FILE_SYSTEM)
 421         || (Node->Info->Attribute & EFI_FILE_HIDDEN)
 422        ){
 423         continue;
 424       }
 425     } else if ((Attribs != EFI_FILE_VALID_ATTR) ||
 426                (Count == 5)) {
 427       //
 428       // Only matches the bits which "Attribs" contains, not
 429       // all files/directories with any of the bits.
 430       // Count == 5 is used to tell the difference between a user
 431       // specifying all bits (EX: -arhsda) and just specifying
 432       // -a (means display all files with any attribute).
 433       //
 434       if ( (Node->Info->Attribute & Attribs) != Attribs) {
 435         continue;
 436       }
 437     }
 438
 439     PrintFileInformation(Sfo, Node, &FileCount, &FileSize, &DirCount);
 440   }
 441
 442   if (!Sfo) {
 443     PrintNonSfoFooter(FileCount, FileSize, DirCount);
 444   }
 445
 446   if (Rec){
 447     DirectoryName = AllocateZeroPool(LongestPath + 2*sizeof(CHAR16));
 448     if (DirectoryName == NULL) {
 449       ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_GEN_NO_MEM), gShellLevel2HiiHandle);
 450       ShellStatus = SHELL_OUT_OF_RESOURCES;
 451     } else {
 452       for ( Node = (EFI_SHELL_FILE_INFO *)GetFirstNode(&ListHead->Link)
 453           ; !IsNull(&ListHead->Link, &Node->Link) && ShellStatus == SHELL_SUCCESS
 454           ; Node = (EFI_SHELL_FILE_INFO *)GetNextNode(&ListHead->Link, &Node->Link)
 455          ){
 456         if (ShellGetExecutionBreakFlag ()) {
 457           ShellStatus = SHELL_ABORTED;
 458           break;
 459         }
 460
 461         //
 462         // recurse on any directory except the traversing ones...
 463         //
 464         if (((Node->Info->Attribute & EFI_FILE_DIRECTORY) == EFI_FILE_DIRECTORY)
 465           && StrCmp(Node->FileName, L".") != 0
 466           && StrCmp(Node->FileName, L"..") != 0
 467          ){
 468           StrCpy(DirectoryName, Node->FullName);
 469           StrCat(DirectoryName, L"\\*");
 470           ShellStatus = PrintLsOutput(
 471             Rec,
 472             Attribs,
 473             Sfo,
 474             DirectoryName,
 475             FALSE,
 476             Count,
 477             TimeZone);
 478         }
 479       }
 480       FreePool(DirectoryName);
 481     }
 482   }
 483
 484   FreePool(CorrectedPath);
 485   ShellCloseFileMetaArg(&ListHead);
 486   return (ShellStatus);
 487 }
 488
 489 STATIC CONST SHELL_PARAM_ITEM LsParamList[] = {
 490   {L"-r", TypeFlag},
 491   {L"-a", TypeStart},
 492   {L"-sfo", TypeFlag},
 493   {NULL, TypeMax}
 494   };
 495
 496 /**
 497   Function for 'ls' command.
 498
 499   @param[in] ImageHandle  Handle to the Image (NULL if Internal).
 500   @param[in] SystemTable  Pointer to the System Table (NULL if Internal).
 501 **/
 502 SHELL_STATUS
 503 EFIAPI
 504 ShellCommandRunLs (
 505   IN EFI_HANDLE        ImageHandle,
 506   IN EFI_SYSTEM_TABLE  *SystemTable
 507   )
 508 {
 509   EFI_STATUS    Status;
 510   LIST_ENTRY    *Package;
 511   CHAR16        *ProblemParam;
 512   CONST CHAR16  *Attribs;
 513   SHELL_STATUS  ShellStatus;
 514   UINT64        RequiredAttributes;
 515   CONST CHAR16  *PathName;
 516   CONST CHAR16  *CurDir;
 517   UINTN         Count;
 518   CHAR16        *FullPath;
 519   UINTN         Size;
 520   EFI_TIME      TheTime;
 521   BOOLEAN       SfoMode;
 522
 523   Size                = 0;
 524   FullPath            = NULL;
 525   ProblemParam        = NULL;
 526   Attribs             = NULL;
 527   ShellStatus         = SHELL_SUCCESS;
 528   RequiredAttributes  = 0;
 529   PathName            = NULL;
 530   CurDir              = NULL;
 531   Count               = 0;
 532
 533   //
 534   // initialize the shell lib (we must be in non-auto-init...)
 535   //
 536   Status = ShellInitialize();
 537   ASSERT_EFI_ERROR(Status);
 538
 539   //
 540   // Fix local copies of the protocol pointers
 541   //
 542   Status = CommandInit();
 543   ASSERT_EFI_ERROR(Status);
 544
 545   //
 546   // parse the command line
 547   //
 548   Status = ShellCommandLineParse (LsParamList, &Package, &ProblemParam, TRUE);
 549   if (EFI_ERROR(Status)) {
 550     if (Status == EFI_VOLUME_CORRUPTED && ProblemParam != NULL) {
 551       ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_GEN_PROBLEM), gShellLevel2HiiHandle, ProblemParam);
 552       FreePool(ProblemParam);
 553       ShellStatus = SHELL_INVALID_PARAMETER;
 554     } else {
 555       ASSERT(FALSE);
 556     }
 557   } else {
 558     //
 559     // check for "-?"
 560     //
 561     if (ShellCommandLineGetFlag(Package, L"-?")) {
 562       ASSERT(FALSE);
 563     }
 564
 565     if (ShellCommandLineGetCount(Package) > 2) {
 566       ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_GEN_TOO_MANY), gShellLevel2HiiHandle);
 567       ShellStatus = SHELL_INVALID_PARAMETER;
 568     } else {
 569       //
 570       // check for -a
 571       //
 572       if (ShellCommandLineGetFlag(Package, L"-a")) {
 573         for ( Attribs = ShellCommandLineGetValue(Package, L"-a")
 574             ; Attribs != NULL && *Attribs != CHAR_NULL && ShellStatus == SHELL_SUCCESS
 575             ; Attribs++
 576            ){
 577           switch (*Attribs) {
 578             case L'a':
 579             case L'A':
 580               RequiredAttributes |= EFI_FILE_ARCHIVE;
 581               Count++;
 582               continue;
 583             case L's':
 584             case L'S':
 585               RequiredAttributes |= EFI_FILE_SYSTEM;
 586               Count++;
 587               continue;
 588             case L'h':
 589             case L'H':
 590               RequiredAttributes |= EFI_FILE_HIDDEN;
 591               Count++;
 592               continue;
 593             case L'r':
 594             case L'R':
 595               RequiredAttributes |= EFI_FILE_READ_ONLY;
 596               Count++;
 597               continue;
 598             case L'd':
 599             case L'D':
 600               RequiredAttributes |= EFI_FILE_DIRECTORY;
 601               Count++;
 602               continue;
 603             default:
 604               ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_GEN_ATTRIBUTE), gShellLevel2HiiHandle, ShellCommandLineGetValue(Package, L"-a"));
 605               ShellStatus = SHELL_INVALID_PARAMETER;
 606               break;
 607           } // switch
 608         } // for loop
 609         //
 610         // if nothing is specified all are specified
 611         //
 612         if (RequiredAttributes == 0) {
 613           RequiredAttributes = EFI_FILE_VALID_ATTR;
 614         }
 615       } // if -a present
 616       if (ShellStatus == SHELL_SUCCESS) {
 617         PathName = ShellCommandLineGetRawValue(Package, 1);
 618         if (PathName == NULL) {
 619           CurDir = gEfiShellProtocol->GetCurDir(NULL);
 620           if (CurDir == NULL) {
 621             ShellStatus = SHELL_NOT_FOUND;
 622             ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_GEN_NO_CWD), gShellLevel2HiiHandle);
 623           }
 624         }
 625         if (PathName != NULL) {
 626           if (StrStr(PathName, L":") == NULL && gEfiShellProtocol->GetCurDir(NULL) == NULL) {
 627             ShellStatus = SHELL_NOT_FOUND;
 628             ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_GEN_NO_CWD), gShellLevel2HiiHandle);
 629           } else {
 630             ASSERT((FullPath == NULL && Size == 0) || (FullPath != NULL));
 631             StrnCatGrow(&FullPath, &Size, PathName, 0);
 632             if  (ShellIsDirectory(PathName) == EFI_SUCCESS) {
 633               if (PathName[StrLen (PathName) - 1] == '\\') {
 634                 //
 635                 // For path ending with '\', just append '*'.
 636                 //
 637                 StrnCatGrow (&FullPath, &Size, L"*", 0);
 638               } else if (PathName[StrLen (PathName) - 1] == '*') {
 639                 //
 640                 // For path ending with '*', do nothing.
 641                 //
 642               } else {
 643                 //
 644                 // Otherwise, append '\*' to directory name.
 645                 //
 646                 StrnCatGrow (&FullPath, &Size, L"\\*", 0);
 647               }
 648             }
 649           }
 650         } else {
 651           ASSERT(FullPath == NULL);
 652           StrnCatGrow(&FullPath, NULL, L"*", 0);
 653         }
 654         Status = gRT->GetTime(&TheTime, NULL);
 655         if (EFI_ERROR(Status)) {
 656           ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_GEN_UEFI_FUNC_WARN), gShellLevel2HiiHandle, L"gRT->GetTime", Status);
 657           TheTime.TimeZone = EFI_UNSPECIFIED_TIMEZONE;
 658         }
 659
 660         SfoMode = ShellCommandLineGetFlag(Package, L"-sfo");
 661         if (ShellStatus == SHELL_SUCCESS) {
 662           ShellStatus = PrintLsOutput(
 663             ShellCommandLineGetFlag(Package, L"-r"),
 664             RequiredAttributes,
 665             SfoMode,
 666             FullPath,
 667             TRUE,
 668             Count,
 669             (INT16)(TheTime.TimeZone==EFI_UNSPECIFIED_TIMEZONE?0:TheTime.TimeZone)
 670            );
 671           if (ShellStatus == SHELL_NOT_FOUND) {
 672             ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_LS_FILE_NOT_FOUND), gShellLevel2HiiHandle);
 673           } else if (ShellStatus == SHELL_INVALID_PARAMETER) {
 674             ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_GEN_PARAM_INV), gShellLevel2HiiHandle);
 675           } else if (ShellStatus == SHELL_ABORTED) {
 676             //
 677             // Ignore aborting.
 678             //
 679           } else if (ShellStatus != SHELL_SUCCESS) {
 680             ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_GEN_PARAM_INV), gShellLevel2HiiHandle);
 681           }
 682         }
 683       }
 684     }
 685   }
 686
 687   if (FullPath != NULL) {
 688     FreePool(FullPath);
 689   }
 690   //
 691   // free the command line package
 692   //
 693   ShellCommandLineFreeVarList (Package);
 694
 695   return (ShellStatus);
 696 }