[mirror_edk2.git] / FatPkg / EnhancedFatDxe / DirectoryManage.c

/** @file\r
  Functions for performing directory entry io.\r
\r
Copyright (c) 2005 - 2015, Intel Corporation. All rights reserved.<BR>\r
SPDX-License-Identifier: BSD-2-Clause-Patent\r
\r
**/\r
\r
#include "Fat.h"\r
\r
/**\r
\r
  Get a directory entry from disk for the Ofile.\r
\r
  @param  Parent                - The parent of the OFile which need to update.\r
  @param  IoMode                - Indicate whether to read directory entry or write directory entry.\r
  @param  EntryPos              - The position of the directory entry to be accessed.\r
  @param  Entry                 - The directory entry read or written.\r
\r
  @retval EFI_SUCCESS           - Access the directory entry successfully.\r
  @return other                 - An error occurred when reading the directory entry.\r
\r
**/\r
STATIC\r
EFI_STATUS\r
FatAccessEntry (\r
  IN     FAT_OFILE  *Parent,\r
  IN     IO_MODE    IoMode,\r
  IN     UINTN      EntryPos,\r
  IN OUT VOID       *Entry\r
  )\r
{\r
  UINTN  Position;\r
  UINTN  BufferSize;\r
\r
  Position = EntryPos * sizeof (FAT_DIRECTORY_ENTRY);\r
  if (Position >= Parent->FileSize) {\r
    //\r
    // End of directory\r
    //\r
    ASSERT (IoMode == ReadData);\r
    ((FAT_DIRECTORY_ENTRY *)Entry)->FileName[0] = EMPTY_ENTRY_MARK;\r
    ((FAT_DIRECTORY_ENTRY *)Entry)->Attributes  = 0;\r
    return EFI_SUCCESS;\r
  }\r
\r
  BufferSize = sizeof (FAT_DIRECTORY_ENTRY);\r
  return FatAccessOFile (Parent, IoMode, Position, &BufferSize, Entry, NULL);\r
}\r
\r
/**\r
\r
  Save the directory entry to disk.\r
\r
  @param  OFile                 - The parent OFile which needs to update.\r
  @param  DirEnt                - The directory entry to be saved.\r
\r
  @retval EFI_SUCCESS           - Store the directory entry successfully.\r
  @return other                 - An error occurred when writing the directory entry.\r
\r
**/\r
EFI_STATUS\r
FatStoreDirEnt (\r
  IN FAT_OFILE   *OFile,\r
  IN FAT_DIRENT  *DirEnt\r
  )\r
{\r
  EFI_STATUS         Status;\r
  FAT_DIRECTORY_LFN  LfnEntry;\r
  UINTN              EntryPos;\r
  CHAR16             *LfnBufferPointer;\r
  CHAR16             LfnBuffer[MAX_LFN_ENTRIES * LFN_CHAR_TOTAL + 1];\r
  UINT8              EntryCount;\r
  UINT8              LfnOrdinal;\r
\r
  EntryPos   = DirEnt->EntryPos;\r
  EntryCount = DirEnt->EntryCount;\r
  //\r
  // Write directory entry\r
  //\r
  Status = FatAccessEntry (OFile, WriteData, EntryPos, &DirEnt->Entry);\r
  if (EFI_ERROR (Status)) {\r
    return Status;\r
  }\r
\r
  if (--EntryCount > 0) {\r
    //\r
    // Write LFN directory entry\r
    //\r
    SetMem (LfnBuffer, sizeof (CHAR16) * LFN_CHAR_TOTAL * EntryCount, 0xff);\r
    Status = StrCpyS (\r
               LfnBuffer,\r
               ARRAY_SIZE (LfnBuffer),\r
               DirEnt->FileString\r
               );\r
    if (EFI_ERROR (Status)) {\r
      return Status;\r
    }\r
\r
    LfnBufferPointer    = LfnBuffer;\r
    LfnEntry.Attributes = FAT_ATTRIBUTE_LFN;\r
    LfnEntry.Type       = 0;\r
    LfnEntry.MustBeZero = 0;\r
    LfnEntry.Checksum   = FatCheckSum (DirEnt->Entry.FileName);\r
    for (LfnOrdinal = 1; LfnOrdinal <= EntryCount; LfnOrdinal++) {\r
      LfnEntry.Ordinal = LfnOrdinal;\r
      if (LfnOrdinal == EntryCount) {\r
        LfnEntry.Ordinal |= FAT_LFN_LAST;\r
      }\r
\r
      CopyMem (LfnEntry.Name1, LfnBufferPointer, sizeof (CHAR16) * LFN_CHAR1_LEN);\r
      LfnBufferPointer += LFN_CHAR1_LEN;\r
      CopyMem (LfnEntry.Name2, LfnBufferPointer, sizeof (CHAR16) * LFN_CHAR2_LEN);\r
      LfnBufferPointer += LFN_CHAR2_LEN;\r
      CopyMem (LfnEntry.Name3, LfnBufferPointer, sizeof (CHAR16) * LFN_CHAR3_LEN);\r
      LfnBufferPointer += LFN_CHAR3_LEN;\r
      EntryPos--;\r
      if (DirEnt->Invalid) {\r
        LfnEntry.Ordinal = DELETE_ENTRY_MARK;\r
      }\r
\r
      Status = FatAccessEntry (OFile, WriteData, EntryPos, &LfnEntry);\r
      if (EFI_ERROR (Status)) {\r
        return Status;\r
      }\r
    }\r
  }\r
\r
  return EFI_SUCCESS;\r
}\r
\r
/**\r
\r
  Determine whether the directory entry is "." or ".." entry.\r
\r
  @param  DirEnt               - The corresponding directory entry.\r
\r
  @retval TRUE                 - The directory entry is "." or ".." directory entry\r
  @retval FALSE                - The directory entry is not "." or ".." directory entry\r
\r
**/\r
BOOLEAN\r
FatIsDotDirEnt (\r
  IN FAT_DIRENT  *DirEnt\r
  )\r
{\r
  CHAR16  *FileString;\r
\r
  FileString = DirEnt->FileString;\r
  if ((StrCmp (FileString, L".") == 0) || (StrCmp (FileString, L"..") == 0)) {\r
    return TRUE;\r
  }\r
\r
  return FALSE;\r
}\r
\r
/**\r
\r
  Set the OFile's cluster info in its directory entry.\r
\r
  @param  OFile                 - The corresponding OFile.\r
\r
**/\r
STATIC\r
VOID\r
FatSetDirEntCluster (\r
  IN FAT_OFILE  *OFile\r
  )\r
{\r
  UINTN       Cluster;\r
  FAT_DIRENT  *DirEnt;\r
\r
  DirEnt                        = OFile->DirEnt;\r
  Cluster                       = OFile->FileCluster;\r
  DirEnt->Entry.FileClusterHigh = (UINT16)(Cluster >> 16);\r
  DirEnt->Entry.FileCluster     = (UINT16)Cluster;\r
}\r
\r
/**\r
\r
  Set the OFile's cluster and size info in its directory entry.\r
\r
  @param  OFile                 - The corresponding OFile.\r
\r
**/\r
VOID\r
FatUpdateDirEntClusterSizeInfo (\r
  IN FAT_OFILE  *OFile\r
  )\r
{\r
  ASSERT (OFile->ODir == NULL);\r
  OFile->DirEnt->Entry.FileSize = (UINT32)OFile->FileSize;\r
  FatSetDirEntCluster (OFile);\r
}\r
\r
/**\r
\r
  Copy all the information of DirEnt2 to DirEnt1 except for 8.3 name.\r
\r
  @param  DirEnt1               - The destination directory entry.\r
  @param  DirEnt2               - The source directory entry.\r
\r
**/\r
VOID\r
FatCloneDirEnt (\r
  IN  FAT_DIRENT  *DirEnt1,\r
  IN  FAT_DIRENT  *DirEnt2\r
  )\r
{\r
  UINT8  *Entry1;\r
  UINT8  *Entry2;\r
\r
  Entry1 = (UINT8 *)&DirEnt1->Entry;\r
  Entry2 = (UINT8 *)&DirEnt2->Entry;\r
  CopyMem (\r
    Entry1 + FAT_ENTRY_INFO_OFFSET,\r
    Entry2 + FAT_ENTRY_INFO_OFFSET,\r
    sizeof (FAT_DIRECTORY_ENTRY) - FAT_ENTRY_INFO_OFFSET\r
    );\r
}\r
\r
/**\r
\r
  Get the LFN for the directory entry.\r
\r
  @param  Parent                - The parent directory.\r
  @param  DirEnt                - The directory entry to get LFN.\r
\r
**/\r
STATIC\r
VOID\r
FatLoadLongNameEntry (\r
  IN FAT_OFILE   *Parent,\r
  IN FAT_DIRENT  *DirEnt\r
  )\r
{\r
  CHAR16             LfnBuffer[MAX_LFN_ENTRIES * LFN_CHAR_TOTAL + 1];\r
  CHAR16             *LfnBufferPointer;\r
  CHAR8              *File8Dot3Name;\r
  UINTN              EntryPos;\r
  UINT8              LfnOrdinal;\r
  UINT8              LfnChecksum;\r
  FAT_DIRECTORY_LFN  LfnEntry;\r
  EFI_STATUS         Status;\r
\r
  EntryPos         = DirEnt->EntryPos;\r
  File8Dot3Name    = DirEnt->Entry.FileName;\r
  LfnBufferPointer = LfnBuffer;\r
  //\r
  // Computes checksum for LFN\r
  //\r
  LfnChecksum = FatCheckSum (File8Dot3Name);\r
  LfnOrdinal  = 1;\r
  do {\r
    if (EntryPos == 0) {\r
      LfnBufferPointer = LfnBuffer;\r
      break;\r
    }\r
\r
    EntryPos--;\r
    Status = FatAccessEntry (Parent, ReadData, EntryPos, &LfnEntry);\r
    if (EFI_ERROR (Status) ||\r
        (LfnEntry.Attributes != FAT_ATTRIBUTE_LFN) ||\r
        (LfnEntry.MustBeZero != 0) ||\r
        (LfnEntry.Checksum != LfnChecksum) ||\r
        ((LfnEntry.Ordinal & (~FAT_LFN_LAST)) != LfnOrdinal) ||\r
        (LfnOrdinal > MAX_LFN_ENTRIES)\r
        )\r
    {\r
      //\r
      // The directory entry does not have a long file name or\r
      // some error occurs when loading long file name for a directory entry,\r
      // and then we load the long name from short name\r
      //\r
      LfnBufferPointer = LfnBuffer;\r
      break;\r
    }\r
\r
    CopyMem (LfnBufferPointer, LfnEntry.Name1, sizeof (CHAR16) * LFN_CHAR1_LEN);\r
    LfnBufferPointer += LFN_CHAR1_LEN;\r
    CopyMem (LfnBufferPointer, LfnEntry.Name2, sizeof (CHAR16) * LFN_CHAR2_LEN);\r
    LfnBufferPointer += LFN_CHAR2_LEN;\r
    CopyMem (LfnBufferPointer, LfnEntry.Name3, sizeof (CHAR16) * LFN_CHAR3_LEN);\r
    LfnBufferPointer += LFN_CHAR3_LEN;\r
    LfnOrdinal++;\r
  } while ((LfnEntry.Ordinal & FAT_LFN_LAST) == 0);\r
\r
  DirEnt->EntryCount = LfnOrdinal;\r
  //\r
  // Terminate current Lfnbuffer\r
  //\r
  *LfnBufferPointer = 0;\r
  if (LfnBufferPointer == LfnBuffer) {\r
    //\r
    // Fail to get the long file name from long file name entry,\r
    // get the file name from short name\r
    //\r
    FatGetFileNameViaCaseFlag (\r
      DirEnt,\r
      LfnBuffer,\r
      ARRAY_SIZE (LfnBuffer)\r
      );\r
  }\r
\r
  DirEnt->FileString = AllocateCopyPool (StrSize (LfnBuffer), LfnBuffer);\r
}\r
\r
/**\r
\r
  Add this directory entry node to the list of directory entries and hash table.\r
\r
  @param  ODir                  - The parent OFile which needs to be updated.\r
  @param  DirEnt                - The directory entry to be added.\r
\r
**/\r
STATIC\r
VOID\r
FatAddDirEnt (\r
  IN FAT_ODIR    *ODir,\r
  IN FAT_DIRENT  *DirEnt\r
  )\r
{\r
  if (DirEnt->Link.BackLink == NULL) {\r
    DirEnt->Link.BackLink = &ODir->ChildList;\r
  }\r
\r
  InsertTailList (DirEnt->Link.BackLink, &DirEnt->Link);\r
  FatInsertToHashTable (ODir, DirEnt);\r
}\r
\r
/**\r
\r
  Load from disk the next directory entry at current end of directory position.\r
\r
  @param  OFile                 - The parent OFile.\r
  @param  PtrDirEnt             - The directory entry that is loaded.\r
\r
  @retval EFI_SUCCESS           - Load the directory entry successfully.\r
  @retval EFI_OUT_OF_RESOURCES  - Out of resource.\r
  @return other                 - An error occurred when reading the directory entries.\r
\r
**/\r
STATIC\r
EFI_STATUS\r
FatLoadNextDirEnt (\r
  IN  FAT_OFILE   *OFile,\r
  OUT FAT_DIRENT  **PtrDirEnt\r
  )\r
{\r
  EFI_STATUS           Status;\r
  FAT_DIRENT           *DirEnt;\r
  FAT_ODIR             *ODir;\r
  FAT_DIRECTORY_ENTRY  Entry;\r
\r
  ODir = OFile->ODir;\r
  //\r
  // Make sure the parent's directory has been opened\r
  //\r
  ASSERT (ODir != NULL);\r
  //\r
  // Assert we have not reached the end of directory\r
  //\r
  ASSERT (!ODir->EndOfDir);\r
  DirEnt = NULL;\r
\r
  for ( ; ;) {\r
    //\r
    // Read the next directory entry until we find a valid directory entry (excluding lfn entry)\r
    //\r
    Status = FatAccessEntry (OFile, ReadData, ODir->CurrentEndPos, &Entry);\r
    if (EFI_ERROR (Status)) {\r
      return Status;\r
    }\r
\r
    if (((UINT8)Entry.FileName[0] != DELETE_ENTRY_MARK) && ((Entry.Attributes & FAT_ATTRIBUTE_VOLUME_ID) == 0)) {\r
      //\r
      // We get a valid directory entry, then handle it\r
      //\r
      break;\r
    }\r
\r
    ODir->CurrentEndPos++;\r
  }\r
\r
  if (Entry.FileName[0] != EMPTY_ENTRY_MARK) {\r
    //\r
    // Although FAT spec states this field is always 0 for FAT12 & FAT16, some applications\r
    // might use it for some special usage, it is safer to zero it in memory for FAT12 & FAT16.\r
    //\r
    if (OFile->Volume->FatType != Fat32) {\r
      Entry.FileClusterHigh = 0;\r
    }\r
\r
    //\r
    // This is a valid directory entry\r
    //\r
    DirEnt = AllocateZeroPool (sizeof (FAT_DIRENT));\r
    if (DirEnt == NULL) {\r
      return EFI_OUT_OF_RESOURCES;\r
    }\r
\r
    DirEnt->Signature = FAT_DIRENT_SIGNATURE;\r
    //\r
    // Remember the directory's entry position on disk\r
    //\r
    DirEnt->EntryPos = (UINT16)ODir->CurrentEndPos;\r
    CopyMem (&DirEnt->Entry, &Entry, sizeof (FAT_DIRECTORY_ENTRY));\r
    FatLoadLongNameEntry (OFile, DirEnt);\r
    if (DirEnt->FileString == NULL) {\r
      Status = EFI_OUT_OF_RESOURCES;\r
      goto Done;\r
    }\r
\r
    //\r
    // Add this directory entry to directory\r
    //\r
    FatAddDirEnt (ODir, DirEnt);\r
    //\r
    // Point to next directory entry\r
    //\r
    ODir->CurrentEndPos++;\r
  } else {\r
    ODir->EndOfDir = TRUE;\r
  }\r
\r
  *PtrDirEnt = DirEnt;\r
  return EFI_SUCCESS;\r
\r
Done:\r
  FatFreeDirEnt (DirEnt);\r
  return Status;\r
}\r
\r
/**\r
\r
  Get the directory entry's info into Buffer.\r
\r
  @param  Volume                - FAT file system volume.\r
  @param  DirEnt                - The corresponding directory entry.\r
  @param  BufferSize            - Size of Buffer.\r
  @param  Buffer                - Buffer containing file info.\r
\r
  @retval EFI_SUCCESS           - Get the file info successfully.\r
  @retval EFI_BUFFER_TOO_SMALL  - The buffer is too small.\r
\r
**/\r
EFI_STATUS\r
FatGetDirEntInfo (\r
  IN     FAT_VOLUME  *Volume,\r
  IN     FAT_DIRENT  *DirEnt,\r
  IN OUT UINTN       *BufferSize,\r
  OUT VOID           *Buffer\r
  )\r
{\r
  UINTN                Size;\r
  UINTN                NameSize;\r
  UINTN                ResultSize;\r
  UINTN                Cluster;\r
  EFI_STATUS           Status;\r
  EFI_FILE_INFO        *Info;\r
  FAT_DIRECTORY_ENTRY  *Entry;\r
  FAT_DATE_TIME        FatLastAccess;\r
\r
  ASSERT_VOLUME_LOCKED (Volume);\r
\r
  Size       = SIZE_OF_EFI_FILE_INFO;\r
  NameSize   = StrSize (DirEnt->FileString);\r
  ResultSize = Size + NameSize;\r
\r
  Status = EFI_BUFFER_TOO_SMALL;\r
  if (*BufferSize >= ResultSize) {\r
    Status     = EFI_SUCCESS;\r
    Entry      = &DirEnt->Entry;\r
    Info       = Buffer;\r
    Info->Size = ResultSize;\r
    if ((Entry->Attributes & FAT_ATTRIBUTE_DIRECTORY) != 0) {\r
      Cluster            = (Entry->FileClusterHigh << 16) | Entry->FileCluster;\r
      Info->PhysicalSize = FatPhysicalDirSize (Volume, Cluster);\r
      Info->FileSize     = Info->PhysicalSize;\r
    } else {\r
      Info->FileSize     = Entry->FileSize;\r
      Info->PhysicalSize = FatPhysicalFileSize (Volume, Entry->FileSize);\r
    }\r
\r
    ZeroMem (&FatLastAccess.Time, sizeof (FatLastAccess.Time));\r
    CopyMem (&FatLastAccess.Date, &Entry->FileLastAccess, sizeof (FatLastAccess.Date));\r
    FatFatTimeToEfiTime (&FatLastAccess, &Info->LastAccessTime);\r
    FatFatTimeToEfiTime (&Entry->FileCreateTime, &Info->CreateTime);\r
    FatFatTimeToEfiTime (&Entry->FileModificationTime, &Info->ModificationTime);\r
    Info->Attribute = Entry->Attributes & EFI_FILE_VALID_ATTR;\r
    CopyMem ((CHAR8 *)Buffer + Size, DirEnt->FileString, NameSize);\r
  }\r
\r
  *BufferSize = ResultSize;\r
  return Status;\r
}\r
\r
/**\r
\r
  Search the directory for the directory entry whose filename is FileNameString.\r
\r
  @param  OFile                 - The parent OFile whose directory is to be searched.\r
  @param  FileNameString        - The filename to be searched.\r
  @param  PtrDirEnt             - pointer to the directory entry if found.\r
\r
  @retval EFI_SUCCESS           - Find the directory entry or not found.\r
  @return other                 - An error occurred when reading the directory entries.\r
\r
**/\r
STATIC\r
EFI_STATUS\r
FatSearchODir (\r
  IN  FAT_OFILE   *OFile,\r
  IN  CHAR16      *FileNameString,\r
  OUT FAT_DIRENT  **PtrDirEnt\r
  )\r
{\r
  BOOLEAN     PossibleShortName;\r
  CHAR8       File8Dot3Name[FAT_NAME_LEN];\r
  FAT_ODIR    *ODir;\r
  FAT_DIRENT  *DirEnt;\r
  EFI_STATUS  Status;\r
\r
  ODir = OFile->ODir;\r
  ASSERT (ODir != NULL);\r
  //\r
  // Check if the file name is a valid short name\r
  //\r
  PossibleShortName = FatCheckIs8Dot3Name (FileNameString, File8Dot3Name);\r
  //\r
  // Search the hash table first\r
  //\r
  DirEnt = *FatLongNameHashSearch (ODir, FileNameString);\r
  if ((DirEnt == NULL) && PossibleShortName) {\r
    DirEnt = *FatShortNameHashSearch (ODir, File8Dot3Name);\r
  }\r
\r
  if (DirEnt == NULL) {\r
    //\r
    // We fail to get the directory entry from hash table; we then\r
    // search the rest directory\r
    //\r
    while (!ODir->EndOfDir) {\r
      Status = FatLoadNextDirEnt (OFile, &DirEnt);\r
      if (EFI_ERROR (Status)) {\r
        return Status;\r
      }\r
\r
      if (DirEnt != NULL) {\r
        if (FatStriCmp (FileNameString, DirEnt->FileString) == 0) {\r
          break;\r
        }\r
\r
        if (PossibleShortName && (CompareMem (File8Dot3Name, DirEnt->Entry.FileName, FAT_NAME_LEN) == 0)) {\r
          break;\r
        }\r
      }\r
    }\r
  }\r
\r
  *PtrDirEnt = DirEnt;\r
  return EFI_SUCCESS;\r
}\r
\r
/**\r
\r
  Set the OFile's current directory cursor to the list head.\r
\r
  @param OFile                 - The directory OFile whose directory cursor is reset.\r
\r
**/\r
VOID\r
FatResetODirCursor (\r
  IN FAT_OFILE  *OFile\r
  )\r
{\r
  FAT_ODIR  *ODir;\r
\r
  ODir = OFile->ODir;\r
  ASSERT (ODir != NULL);\r
  ODir->CurrentCursor = &(ODir->ChildList);\r
  ODir->CurrentPos    = 0;\r
}\r
\r
/**\r
\r
  Set the directory's cursor to the next and get the next directory entry.\r
\r
  @param  OFile                 - The parent OFile.\r
  @param PtrDirEnt             - The next directory entry.\r
\r
  @retval EFI_SUCCESS           - We get the next directory entry successfully.\r
  @return other                 - An error occurred when get next directory entry.\r
\r
**/\r
EFI_STATUS\r
FatGetNextDirEnt (\r
  IN  FAT_OFILE   *OFile,\r
  OUT FAT_DIRENT  **PtrDirEnt\r
  )\r
{\r
  EFI_STATUS  Status;\r
  FAT_DIRENT  *DirEnt;\r
  FAT_ODIR    *ODir;\r
\r
  ODir = OFile->ODir;\r
  ASSERT (ODir != NULL);\r
  if (ODir->CurrentCursor->ForwardLink == &ODir->ChildList) {\r
    //\r
    // End of directory, we will try one more time\r
    //\r
    if (!ODir->EndOfDir) {\r
      //\r
      // Read directory from disk\r
      //\r
      Status = FatLoadNextDirEnt (OFile, &DirEnt);\r
      if (EFI_ERROR (Status)) {\r
        return Status;\r
      }\r
    }\r
  }\r
\r
  if (ODir->CurrentCursor->ForwardLink == &ODir->ChildList) {\r
    //\r
    // End of directory, return NULL\r
    //\r
    DirEnt           = NULL;\r
    ODir->CurrentPos = ODir->CurrentEndPos;\r
  } else {\r
    ODir->CurrentCursor = ODir->CurrentCursor->ForwardLink;\r
    DirEnt              = DIRENT_FROM_LINK (ODir->CurrentCursor);\r
    ODir->CurrentPos    = DirEnt->EntryPos + 1;\r
  }\r
\r
  *PtrDirEnt = DirEnt;\r
  return EFI_SUCCESS;\r
}\r
\r
/**\r
\r
  Set the directory entry count according to the filename.\r
\r
  @param  OFile                 - The corresponding OFile.\r
  @param  DirEnt                - The directory entry to be set.\r
\r
**/\r
STATIC\r
VOID\r
FatSetEntryCount (\r
  IN FAT_OFILE   *OFile,\r
  IN FAT_DIRENT  *DirEnt\r
  )\r
{\r
  CHAR16  *FileString;\r
  CHAR8   *File8Dot3Name;\r
\r
  //\r
  // Get new entry count and set the 8.3 name\r
  //\r
  DirEnt->EntryCount = 1;\r
  FileString         = DirEnt->FileString;\r
  File8Dot3Name      = DirEnt->Entry.FileName;\r
  SetMem (File8Dot3Name, FAT_NAME_LEN, ' ');\r
  if (StrCmp (FileString, L".") == 0) {\r
    //\r
    // "." entry\r
    //\r
    File8Dot3Name[0] = '.';\r
    FatCloneDirEnt (DirEnt, OFile->DirEnt);\r
  } else if (StrCmp (FileString, L"..") == 0) {\r
    //\r
    // ".." entry\r
    //\r
    File8Dot3Name[0] = '.';\r
    File8Dot3Name[1] = '.';\r
    FatCloneDirEnt (DirEnt, OFile->Parent->DirEnt);\r
  } else {\r
    //\r
    // Normal name\r
    //\r
    if (FatCheckIs8Dot3Name (FileString, File8Dot3Name)) {\r
      //\r
      // This file name is a valid 8.3 file name, we need to further check its case flag\r
      //\r
      FatSetCaseFlag (DirEnt);\r
    } else {\r
      //\r
      // The file name is not a valid 8.3 name we need to generate an 8.3 name for it\r
      //\r
      FatCreate8Dot3Name (OFile, DirEnt);\r
      DirEnt->EntryCount = (UINT8)(LFN_ENTRY_NUMBER (StrLen (FileString)) + DirEnt->EntryCount);\r
    }\r
  }\r
}\r
\r
/**\r
\r
  Append a zero cluster to the current OFile.\r
\r
  @param  OFile        - The directory OFile which needs to be updated.\r
\r
  @retval EFI_SUCCESS  - Append a zero cluster to the OFile successfully.\r
  @return other        - An error occurred when appending the zero cluster.\r
\r
**/\r
STATIC\r
EFI_STATUS\r
FatExpandODir (\r
  IN FAT_OFILE  *OFile\r
  )\r
{\r
  return FatExpandOFile (OFile, OFile->FileSize + OFile->Volume->ClusterSize);\r
}\r
\r
/**\r
\r
  Search the Root OFile for the possible volume label.\r
\r
  @param  Root                  - The Root OFile.\r
  @param  DirEnt                - The returned directory entry of volume label.\r
\r
  @retval EFI_SUCCESS           - The search process is completed successfully.\r
  @return other                 - An error occurred when searching volume label.\r
\r
**/\r
STATIC\r
EFI_STATUS\r
FatSeekVolumeId (\r
  IN  FAT_OFILE   *Root,\r
  OUT FAT_DIRENT  *DirEnt\r
  )\r
{\r
  EFI_STATUS           Status;\r
  UINTN                EntryPos;\r
  FAT_DIRECTORY_ENTRY  *Entry;\r
\r
  EntryPos        = 0;\r
  Entry           = &DirEnt->Entry;\r
  DirEnt->Invalid = TRUE;\r
  do {\r
    Status = FatAccessEntry (Root, ReadData, EntryPos, Entry);\r
    if (EFI_ERROR (Status)) {\r
      return Status;\r
    }\r
\r
    if (((UINT8)Entry->FileName[0] != DELETE_ENTRY_MARK) && (((Entry->Attributes) & (~FAT_ATTRIBUTE_ARCHIVE)) == FAT_ATTRIBUTE_VOLUME_ID)) {\r
      DirEnt->EntryPos   = (UINT16)EntryPos;\r
      DirEnt->EntryCount = 1;\r
      DirEnt->Invalid    = FALSE;\r
      break;\r
    }\r
\r
    EntryPos++;\r
  } while (Entry->FileName[0] != EMPTY_ENTRY_MARK);\r
\r
  return EFI_SUCCESS;\r
}\r
\r
/**\r
\r
  Use First Fit Algorithm to insert directory entry.\r
  Only this function will erase "E5" entries in a directory.\r
  In view of safest recovery, this function will only be triggered\r
  when maximum directory entry number has reached.\r
\r
  @param  OFile                 - The corresponding OFile.\r
  @param  DirEnt                - The directory entry to be inserted.\r
\r
  @retval EFI_SUCCESS           - The directory entry has been successfully inserted.\r
  @retval EFI_VOLUME_FULL       - The directory can not hold more directory entries.\r
  @return Others                - Some error occurred when inserting new directory entries.\r
\r
**/\r
STATIC\r
EFI_STATUS\r
FatFirstFitInsertDirEnt (\r
  IN FAT_OFILE   *OFile,\r
  IN FAT_DIRENT  *DirEnt\r
  )\r
{\r
  EFI_STATUS  Status;\r
  FAT_ODIR    *ODir;\r
  LIST_ENTRY  *CurrentEntry;\r
  FAT_DIRENT  *CurrentDirEnt;\r
  UINT32      CurrentPos;\r
  UINT32      LabelPos;\r
  UINT32      NewEntryPos;\r
  UINT16      EntryCount;\r
  FAT_DIRENT  LabelDirEnt;\r
\r
  LabelPos = 0;\r
  if (OFile->Parent == NULL) {\r
    Status = FatSeekVolumeId (OFile, &LabelDirEnt);\r
    if (EFI_ERROR (Status)) {\r
      return Status;\r
    }\r
\r
    if (!LabelDirEnt.Invalid) {\r
      LabelPos = LabelDirEnt.EntryPos;\r
    }\r
  }\r
\r
  EntryCount  = DirEnt->EntryCount;\r
  NewEntryPos = EntryCount;\r
  CurrentPos  = 0;\r
  ODir        = OFile->ODir;\r
  for (CurrentEntry = ODir->ChildList.ForwardLink;\r
       CurrentEntry != &ODir->ChildList;\r
       CurrentEntry = CurrentEntry->ForwardLink\r
       )\r
  {\r
    CurrentDirEnt = DIRENT_FROM_LINK (CurrentEntry);\r
    if (NewEntryPos + CurrentDirEnt->EntryCount <= CurrentDirEnt->EntryPos) {\r
      if ((LabelPos > NewEntryPos) || (LabelPos <= CurrentPos)) {\r
        //\r
        // first fit succeeded\r
        //\r
        goto Done;\r
      }\r
    }\r
\r
    CurrentPos  = CurrentDirEnt->EntryPos;\r
    NewEntryPos = CurrentPos + EntryCount;\r
  }\r
\r
  if (NewEntryPos >= ODir->CurrentEndPos) {\r
    return EFI_VOLUME_FULL;\r
  }\r
\r
Done:\r
  DirEnt->EntryPos      = (UINT16)NewEntryPos;\r
  DirEnt->Link.BackLink = CurrentEntry;\r
  return EFI_SUCCESS;\r
}\r
\r
/**\r
\r
  Find the new directory entry position for the directory entry.\r
\r
  @param  OFile                 - The corresponding OFile.\r
  @param  DirEnt                - The directory entry whose new position is to be set.\r
\r
  @retval EFI_SUCCESS           - The new directory entry position is successfully found.\r
  @retval EFI_VOLUME_FULL       - The directory has reach its maximum capacity.\r
  @return other                 - An error occurred when reading the directory entry.\r
\r
**/\r
STATIC\r
EFI_STATUS\r
FatNewEntryPos (\r
  IN FAT_OFILE   *OFile,\r
  IN FAT_DIRENT  *DirEnt\r
  )\r
{\r
  EFI_STATUS  Status;\r
  FAT_ODIR    *ODir;\r
  FAT_DIRENT  *TempDirEnt;\r
  UINT32      NewEndPos;\r
\r
  ODir = OFile->ODir;\r
  ASSERT (ODir != NULL);\r
  //\r
  // Make sure the whole directory has been loaded\r
  //\r
  while (!ODir->EndOfDir) {\r
    Status = FatLoadNextDirEnt (OFile, &TempDirEnt);\r
    if (EFI_ERROR (Status)) {\r
      return Status;\r
    }\r
  }\r
\r
  //\r
  // We will append this entry to the end of directory\r
  //\r
  FatGetCurrentFatTime (&DirEnt->Entry.FileCreateTime);\r
  CopyMem (&DirEnt->Entry.FileModificationTime, &DirEnt->Entry.FileCreateTime, sizeof (FAT_DATE_TIME));\r
  CopyMem (&DirEnt->Entry.FileLastAccess, &DirEnt->Entry.FileCreateTime.Date, sizeof (FAT_DATE));\r
  NewEndPos = ODir->CurrentEndPos + DirEnt->EntryCount;\r
  if (NewEndPos * sizeof (FAT_DIRECTORY_ENTRY) > OFile->FileSize) {\r
    if (NewEndPos >= (OFile->IsFixedRootDir ? OFile->Volume->RootEntries : FAT_MAX_DIRENTRY_COUNT)) {\r
      //\r
      // We try to use fist fit algorithm to insert this directory entry\r
      //\r
      return FatFirstFitInsertDirEnt (OFile, DirEnt);\r
    }\r
\r
    //\r
    // We should allocate a new cluster for this directory\r
    //\r
    Status = FatExpandODir (OFile);\r
    if (EFI_ERROR (Status)) {\r
      return Status;\r
    }\r
  }\r
\r
  //\r
  // We append our directory entry at the end of directory file\r
  //\r
  ODir->CurrentEndPos = NewEndPos;\r
  DirEnt->EntryPos    = (UINT16)(ODir->CurrentEndPos - 1);\r
  return EFI_SUCCESS;\r
}\r
\r
/**\r
\r
  Get the directory entry for the volume.\r
\r
  @param  Volume                - FAT file system volume.\r
  @param  Name                  - The file name of the volume.\r
\r
  @retval EFI_SUCCESS           - Update the volume with the directory entry successfully.\r
  @return others                - An error occurred when getting volume label.\r
\r
**/\r
EFI_STATUS\r
FatGetVolumeEntry (\r
  IN FAT_VOLUME  *Volume,\r
  IN CHAR16      *Name\r
  )\r
{\r
  EFI_STATUS  Status;\r
  FAT_DIRENT  LabelDirEnt;\r
\r
  *Name  = 0;\r
  Status = FatSeekVolumeId (Volume->Root, &LabelDirEnt);\r
  if (!EFI_ERROR (Status)) {\r
    if (!LabelDirEnt.Invalid) {\r
      FatNameToStr (LabelDirEnt.Entry.FileName, FAT_NAME_LEN, FALSE, Name);\r
    }\r
  }\r
\r
  return Status;\r
}\r
\r
/**\r
\r
  Set the relevant directory entry into disk for the volume.\r
\r
  @param  Volume              - FAT file system volume.\r
  @param  Name                - The new file name of the volume.\r
\r
  @retval EFI_SUCCESS         - Update the Volume successfully.\r
  @retval EFI_UNSUPPORTED     - The input label is not a valid volume label.\r
  @return other               - An error occurred when setting volume label.\r
\r
**/\r
EFI_STATUS\r
FatSetVolumeEntry (\r
  IN FAT_VOLUME  *Volume,\r
  IN CHAR16      *Name\r
  )\r
{\r
  EFI_STATUS  Status;\r
  FAT_DIRENT  LabelDirEnt;\r
  FAT_OFILE   *Root;\r
\r
  Root   = Volume->Root;\r
  Status = FatSeekVolumeId (Volume->Root, &LabelDirEnt);\r
  if (EFI_ERROR (Status)) {\r
    return Status;\r
  }\r
\r
  if (LabelDirEnt.Invalid) {\r
    //\r
    // If there is not the relevant directory entry, create a new one\r
    //\r
    ZeroMem (&LabelDirEnt, sizeof (FAT_DIRENT));\r
    LabelDirEnt.EntryCount = 1;\r
    Status                 = FatNewEntryPos (Root, &LabelDirEnt);\r
    if (EFI_ERROR (Status)) {\r
      return Status;\r
    }\r
\r
    LabelDirEnt.Entry.Attributes = FAT_ATTRIBUTE_VOLUME_ID;\r
  }\r
\r
  SetMem (LabelDirEnt.Entry.FileName, FAT_NAME_LEN, ' ');\r
  if (FatStrToFat (Name, FAT_NAME_LEN, LabelDirEnt.Entry.FileName)) {\r
    return EFI_UNSUPPORTED;\r
  }\r
\r
  FatGetCurrentFatTime (&LabelDirEnt.Entry.FileModificationTime);\r
  return FatStoreDirEnt (Root, &LabelDirEnt);\r
}\r
\r
/**\r
\r
  Create "." and ".." directory entries in the newly-created parent OFile.\r
\r
  @param  OFile                 - The parent OFile.\r
\r
  @retval EFI_SUCCESS           - The dot directory entries are successfully created.\r
  @return other                 - An error occurred when creating the directory entry.\r
\r
**/\r
EFI_STATUS\r
FatCreateDotDirEnts (\r
  IN FAT_OFILE  *OFile\r
  )\r
{\r
  EFI_STATUS  Status;\r
  FAT_DIRENT  *DirEnt;\r
\r
  Status = FatExpandODir (OFile);\r
  if (EFI_ERROR (Status)) {\r
    return Status;\r
  }\r
\r
  FatSetDirEntCluster (OFile);\r
  //\r
  // Create "."\r
  //\r
  Status = FatCreateDirEnt (OFile, L".", FAT_ATTRIBUTE_DIRECTORY, &DirEnt);\r
  if (EFI_ERROR (Status)) {\r
    return Status;\r
  }\r
\r
  //\r
  // Create ".."\r
  //\r
  Status = FatCreateDirEnt (OFile, L"..", FAT_ATTRIBUTE_DIRECTORY, &DirEnt);\r
  return Status;\r
}\r
\r
/**\r
\r
  Create a directory entry in the parent OFile.\r
\r
  @param  OFile                 - The parent OFile.\r
  @param  FileName              - The filename of the newly-created directory entry.\r
  @param  Attributes            - The attribute of the newly-created directory entry.\r
  @param  PtrDirEnt             - The pointer to the newly-created directory entry.\r
\r
  @retval EFI_SUCCESS           - The directory entry is successfully created.\r
  @retval EFI_OUT_OF_RESOURCES  - Not enough memory to create the directory entry.\r
  @return other                 - An error occurred when creating the directory entry.\r
\r
**/\r
EFI_STATUS\r
FatCreateDirEnt (\r
  IN  FAT_OFILE   *OFile,\r
  IN  CHAR16      *FileName,\r
  IN  UINT8       Attributes,\r
  OUT FAT_DIRENT  **PtrDirEnt\r
  )\r
{\r
  FAT_DIRENT  *DirEnt;\r
  FAT_ODIR    *ODir;\r
  EFI_STATUS  Status;\r
\r
  ASSERT (OFile != NULL);\r
  ODir = OFile->ODir;\r
  ASSERT (ODir != NULL);\r
  DirEnt = AllocateZeroPool (sizeof (FAT_DIRENT));\r
  if (DirEnt == NULL) {\r
    return EFI_OUT_OF_RESOURCES;\r
  }\r
\r
  DirEnt->Signature  = FAT_DIRENT_SIGNATURE;\r
  DirEnt->FileString = AllocateCopyPool (StrSize (FileName), FileName);\r
  if (DirEnt->FileString == NULL) {\r
    Status = EFI_OUT_OF_RESOURCES;\r
    goto Done;\r
  }\r
\r
  //\r
  // Determine how many directory entries we need\r
  //\r
  FatSetEntryCount (OFile, DirEnt);\r
  //\r
  // Determine the file's directory entry position\r
  //\r
  Status = FatNewEntryPos (OFile, DirEnt);\r
  if (EFI_ERROR (Status)) {\r
    goto Done;\r
  }\r
\r
  FatAddDirEnt (ODir, DirEnt);\r
  DirEnt->Entry.Attributes = Attributes;\r
  *PtrDirEnt               = DirEnt;\r
  DEBUG ((DEBUG_INFO, "FSOpen: Created new directory entry '%S'\n", DirEnt->FileString));\r
  return FatStoreDirEnt (OFile, DirEnt);\r
\r
Done:\r
  FatFreeDirEnt (DirEnt);\r
  return Status;\r
}\r
\r
/**\r
\r
  Remove this directory entry node from the list of directory entries and hash table.\r
\r
  @param  OFile                - The parent OFile.\r
  @param  DirEnt               - The directory entry to be removed.\r
\r
  @retval EFI_SUCCESS          - The directory entry is successfully removed.\r
  @return other                - An error occurred when removing the directory entry.\r
\r
**/\r
EFI_STATUS\r
FatRemoveDirEnt (\r
  IN FAT_OFILE   *OFile,\r
  IN FAT_DIRENT  *DirEnt\r
  )\r
{\r
  FAT_ODIR  *ODir;\r
\r
  ODir = OFile->ODir;\r
  if (ODir->CurrentCursor == &DirEnt->Link) {\r
    //\r
    // Move the directory cursor to its previous directory entry\r
    //\r
    ODir->CurrentCursor = ODir->CurrentCursor->BackLink;\r
  }\r
\r
  //\r
  // Remove from directory entry list\r
  //\r
  RemoveEntryList (&DirEnt->Link);\r
  //\r
  // Remove from hash table\r
  //\r
  FatDeleteFromHashTable (ODir, DirEnt);\r
  DirEnt->Entry.FileName[0] = DELETE_ENTRY_MARK;\r
  DirEnt->Invalid           = TRUE;\r
  return FatStoreDirEnt (OFile, DirEnt);\r
}\r
\r
/**\r
\r
  Open the directory entry to get the OFile.\r
\r
  @param  Parent                - The parent OFile.\r
  @param  DirEnt                - The directory entry to be opened.\r
\r
  @retval EFI_SUCCESS           - The directory entry is successfully opened.\r
  @retval EFI_OUT_OF_RESOURCES  - not enough memory to allocate a new OFile.\r
  @return other                 - An error occurred when opening the directory entry.\r
\r
**/\r
EFI_STATUS\r
FatOpenDirEnt (\r
  IN FAT_OFILE   *Parent,\r
  IN FAT_DIRENT  *DirEnt\r
  )\r
{\r
  FAT_OFILE   *OFile;\r
  FAT_VOLUME  *Volume;\r
\r
  if (DirEnt->OFile == NULL) {\r
    //\r
    // Open the directory entry\r
    //\r
    OFile = AllocateZeroPool (sizeof (FAT_OFILE));\r
    if (OFile == NULL) {\r
      return EFI_OUT_OF_RESOURCES;\r
    }\r
\r
    OFile->Signature = FAT_OFILE_SIGNATURE;\r
    InitializeListHead (&OFile->Opens);\r
    InitializeListHead (&OFile->ChildHead);\r
    OFile->Parent = Parent;\r
    OFile->DirEnt = DirEnt;\r
    if (Parent != NULL) {\r
      //\r
      // The newly created OFile is not root\r
      //\r
      Volume             = Parent->Volume;\r
      OFile->FullPathLen = Parent->FullPathLen + 1 + StrLen (DirEnt->FileString);\r
      OFile->FileCluster = ((DirEnt->Entry.FileClusterHigh) << 16) | (DirEnt->Entry.FileCluster);\r
      InsertTailList (&Parent->ChildHead, &OFile->ChildLink);\r
    } else {\r
      //\r
      // The newly created OFile is root\r
      //\r
      Volume             = VOLUME_FROM_ROOT_DIRENT (DirEnt);\r
      Volume->Root       = OFile;\r
      OFile->FileCluster = Volume->RootCluster;\r
      if (Volume->FatType  != Fat32) {\r
        OFile->IsFixedRootDir = TRUE;\r
      }\r
    }\r
\r
    OFile->FileCurrentCluster = OFile->FileCluster;\r
    OFile->Volume             = Volume;\r
    InsertHeadList (&Volume->CheckRef, &OFile->CheckLink);\r
\r
    OFile->FileSize = DirEnt->Entry.FileSize;\r
    if ((DirEnt->Entry.Attributes & FAT_ATTRIBUTE_DIRECTORY) != 0) {\r
      if (OFile->IsFixedRootDir) {\r
        OFile->FileSize = Volume->RootEntries * sizeof (FAT_DIRECTORY_ENTRY);\r
      } else {\r
        OFile->FileSize = FatPhysicalDirSize (Volume, OFile->FileCluster);\r
      }\r
\r
      FatRequestODir (OFile);\r
      if (OFile->ODir == NULL) {\r
        return EFI_OUT_OF_RESOURCES;\r
      }\r
    }\r
\r
    DirEnt->OFile = OFile;\r
  }\r
\r
  return EFI_SUCCESS;\r
}\r
\r
/**\r
\r
  Close the directory entry and free the OFile.\r
\r
  @param  DirEnt               - The directory entry to be closed.\r
\r
**/\r
VOID\r
FatCloseDirEnt (\r
  IN FAT_DIRENT  *DirEnt\r
  )\r
{\r
  FAT_OFILE   *OFile;\r
  FAT_VOLUME  *Volume;\r
\r
  OFile = DirEnt->OFile;\r
  ASSERT (OFile != NULL);\r
  Volume = OFile->Volume;\r
\r
  if (OFile->ODir != NULL) {\r
    FatDiscardODir (OFile);\r
  }\r
\r
  if (OFile->Parent == NULL) {\r
    Volume->Root = NULL;\r
  } else {\r
    RemoveEntryList (&OFile->ChildLink);\r
  }\r
\r
  FreePool (OFile);\r
  DirEnt->OFile = NULL;\r
  if (DirEnt->Invalid == TRUE) {\r
    //\r
    // Free directory entry itself\r
    //\r
    FatFreeDirEnt (DirEnt);\r
  }\r
}\r
\r
/**\r
\r
  Traverse filename and open all OFiles that can be opened.\r
  Update filename pointer to the component that can't be opened.\r
  If more than one name component remains, returns an error;\r
  otherwise, return the remaining name component so that the caller might choose to create it.\r
\r
  @param  PtrOFile              - As input, the reference OFile; as output, the located OFile.\r
  @param  FileName              - The file name relevant to the OFile.\r
  @param  Attributes            - The attribute of the destination OFile.\r
  @param  NewFileName           - The remaining file name.\r
\r
  @retval EFI_NOT_FOUND         - The file name can't be opened and there is more than one\r
                          components within the name left (this means the name can\r
                          not be created either).\r
  @retval EFI_INVALID_PARAMETER - The parameter is not valid.\r
  @retval EFI_SUCCESS           - Open the file successfully.\r
  @return other                 - An error occurred when locating the OFile.\r
\r
**/\r
EFI_STATUS\r
FatLocateOFile (\r
  IN OUT FAT_OFILE  **PtrOFile,\r
  IN     CHAR16     *FileName,\r
  IN     UINT8      Attributes,\r
  OUT CHAR16        *NewFileName\r
  )\r
{\r
  EFI_STATUS  Status;\r
  FAT_VOLUME  *Volume;\r
  CHAR16      ComponentName[EFI_PATH_STRING_LENGTH];\r
  UINTN       FileNameLen;\r
  BOOLEAN     DirIntended;\r
  CHAR16      *Next;\r
  FAT_OFILE   *OFile;\r
  FAT_DIRENT  *DirEnt;\r
\r
  DirEnt = NULL;\r
\r
  FileNameLen = StrLen (FileName);\r
  if (FileNameLen == 0) {\r
    return EFI_INVALID_PARAMETER;\r
  }\r
\r
  OFile  = *PtrOFile;\r
  Volume = OFile->Volume;\r
\r
  DirIntended = FALSE;\r
  if (FileName[FileNameLen - 1] == PATH_NAME_SEPARATOR) {\r
    DirIntended = TRUE;\r
  }\r
\r
  //\r
  // If name starts with path name separator, then move to root OFile\r
  //\r
  if (*FileName == PATH_NAME_SEPARATOR) {\r
    OFile = Volume->Root;\r
    FileName++;\r
    FileNameLen--;\r
  }\r
\r
  //\r
  // Per FAT Spec the file name should meet the following criteria:\r
  //   C1. Length (FileLongName) <= 255\r
  //   C2. Length (X:FileFullPath<NUL>) <= 260\r
  // Here we check C2 first.\r
  //\r
  if (2 + OFile->FullPathLen + 1 + FileNameLen + 1 > EFI_PATH_STRING_LENGTH) {\r
    //\r
    // Full path length can not surpass 256\r
    //\r
    return EFI_INVALID_PARAMETER;\r
  }\r
\r
  //\r
  // Start at current location\r
  //\r
  Next = FileName;\r
  for ( ; ;) {\r
    //\r
    // Get the next component name\r
    //\r
    FileName = Next;\r
    Next     = FatGetNextNameComponent (FileName, ComponentName);\r
\r
    //\r
    // If end of the file name, we're done\r
    //\r
    if (ComponentName[0] == 0) {\r
      if (DirIntended && (OFile->ODir == NULL)) {\r
        return EFI_NOT_FOUND;\r
      }\r
\r
      NewFileName[0] = 0;\r
      break;\r
    }\r
\r
    //\r
    // If "dot", then current\r
    //\r
    if (StrCmp (ComponentName, L".") == 0) {\r
      continue;\r
    }\r
\r
    //\r
    // If "dot dot", then parent\r
    //\r
    if (StrCmp (ComponentName, L"..") == 0) {\r
      if (OFile->Parent == NULL) {\r
        return EFI_INVALID_PARAMETER;\r
      }\r
\r
      OFile = OFile->Parent;\r
      continue;\r
    }\r
\r
    if (!FatFileNameIsValid (ComponentName, NewFileName)) {\r
      return EFI_INVALID_PARAMETER;\r
    }\r
\r
    //\r
    // We have a component name, try to open it\r
    //\r
    if (OFile->ODir == NULL) {\r
      //\r
      // This file isn't a directory, can't open it\r
      //\r
      return EFI_NOT_FOUND;\r
    }\r
\r
    //\r
    // Search the compName in the directory\r
    //\r
    Status = FatSearchODir (OFile, NewFileName, &DirEnt);\r
    if (EFI_ERROR (Status)) {\r
      return Status;\r
    }\r
\r
    if (DirEnt == NULL) {\r
      //\r
      // component name is not found in the directory\r
      //\r
      if (*Next != 0) {\r
        return EFI_NOT_FOUND;\r
      }\r
\r
      if (DirIntended && ((Attributes & FAT_ATTRIBUTE_DIRECTORY) == 0)) {\r
        return EFI_INVALID_PARAMETER;\r
      }\r
\r
      //\r
      // It's the last component name - return with the open\r
      // path and the remaining name\r
      //\r
      break;\r
    }\r
\r
    Status = FatOpenDirEnt (OFile, DirEnt);\r
    if (EFI_ERROR (Status)) {\r
      return Status;\r
    }\r
\r
    OFile = DirEnt->OFile;\r
  }\r
\r
  *PtrOFile = OFile;\r
  return EFI_SUCCESS;\r
}\r