[mirror_edk2.git] / IntelFrameworkModulePkg / Universal / FirmwareVolume / FwVolDxe / FwVol.c

/** @file\r
\r
  Firmware File System driver that produce full Firmware Volume2 protocol.\r
  Layers on top of Firmware Block protocol to produce a file abstraction\r
  of FV based files.\r
\r
  Copyright (c) 2006 - 2017, Intel Corporation. All rights reserved.<BR>\r
\r
  This program and the accompanying materials\r
  are licensed and made available under the terms and conditions\r
  of the BSD License which accompanies this distribution.  The\r
  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 "FwVolDriver.h"\r
\r
#define KEYSIZE sizeof (UINTN)\r
\r
/**\r
  Given the supplied FW_VOL_BLOCK_PROTOCOL, allocate a buffer for output and\r
  copy the real length volume header into it.\r
\r
  @param  Fvb                   The FW_VOL_BLOCK_PROTOCOL instance from which to\r
                                read the volume header\r
  @param  FwVolHeader           Pointer to pointer to allocated buffer in which\r
                                the volume header is returned.\r
\r
  @retval EFI_OUT_OF_RESOURCES  No enough buffer could be allocated.\r
  @retval EFI_SUCCESS           Successfully read volume header to the allocated\r
                                buffer.\r
  @retval EFI_ACCESS_DENIED     Read status of FV is not enabled.\r
  @retval EFI_INVALID_PARAMETER The FV Header signature is not as expected or\r
                                the file system could not be understood.\r
**/\r
EFI_STATUS\r
GetFwVolHeader (\r
  IN     EFI_FIRMWARE_VOLUME_BLOCK_PROTOCOL     *Fvb,\r
  OUT EFI_FIRMWARE_VOLUME_HEADER                **FwVolHeader\r
  )\r
{\r
  EFI_STATUS                  Status;\r
  EFI_FIRMWARE_VOLUME_HEADER  TempFvh;\r
  EFI_FVB_ATTRIBUTES_2        FvbAttributes;\r
  UINTN                       FvhLength;\r
  EFI_PHYSICAL_ADDRESS        BaseAddress;\r
\r
  //\r
  // Determine the real length of FV header\r
  //\r
  Status = Fvb->GetAttributes (\r
                  Fvb,\r
                  &FvbAttributes\r
                  );\r
  if (EFI_ERROR (Status)) {\r
    return Status;\r
  }\r
\r
  if ((FvbAttributes & EFI_FVB2_READ_STATUS) == 0) {\r
    return EFI_ACCESS_DENIED;\r
  }\r
\r
  //\r
  // Just avoid compiling warning\r
  //\r
  BaseAddress = 0;\r
  FvhLength   = sizeof (EFI_FIRMWARE_VOLUME_HEADER);\r
\r
  //\r
  // memory-mapped FV and non memory-mapped has different ways to read\r
  //\r
  if ((FvbAttributes & EFI_FVB2_MEMORY_MAPPED) != 0) {\r
    Status = Fvb->GetPhysicalAddress (\r
                    Fvb,\r
                    &BaseAddress\r
                    );\r
    if (EFI_ERROR (Status)) {\r
      return Status;\r
    }\r
    CopyMem (&TempFvh, (VOID *) (UINTN) BaseAddress, FvhLength);\r
  } else {\r
    Status = Fvb->Read (\r
                    Fvb,\r
                    0,\r
                    0,\r
                    &FvhLength,\r
                    (UINT8 *) &TempFvh\r
                    );\r
  }\r
\r
  //\r
  // Validate FV Header signature, if not as expected, continue.\r
  //\r
  if (TempFvh.Signature != EFI_FVH_SIGNATURE) {\r
    return EFI_INVALID_PARAMETER;\r
  }\r
\r
  //\r
  // Check to see that the file system is indeed formatted in a way we can\r
  // understand it...\r
  //\r
  if ((!CompareGuid (&TempFvh.FileSystemGuid, &gEfiFirmwareFileSystem2Guid)) &&\r
      (!CompareGuid (&TempFvh.FileSystemGuid, &gEfiFirmwareFileSystem3Guid))) {\r
    return EFI_INVALID_PARAMETER;\r
  }\r
\r
  *FwVolHeader = AllocatePool (TempFvh.HeaderLength);\r
  if (*FwVolHeader == NULL) {\r
    return EFI_OUT_OF_RESOURCES;\r
  }\r
  //\r
  // Read the whole header\r
  //\r
  if ((FvbAttributes & EFI_FVB2_MEMORY_MAPPED) != 0) {\r
    CopyMem (*FwVolHeader, (VOID *) (UINTN) BaseAddress, TempFvh.HeaderLength);\r
  } else {\r
    //\r
    // Assumed the first block is bigger than the length of Fv headder\r
    //\r
    FvhLength = TempFvh.HeaderLength;\r
    Status = Fvb->Read (\r
                    Fvb,\r
                    0,\r
                    0,\r
                    &FvhLength,\r
                    (UINT8 *) *FwVolHeader\r
                    );\r
    //\r
    // Check whether Read successes.\r
    //\r
    if (EFI_ERROR (Status)) {\r
      FreePool (*FwVolHeader);\r
      *FwVolHeader = NULL;\r
      return Status;\r
    }\r
  }\r
\r
  return EFI_SUCCESS;\r
}\r
\r
/**\r
  Free FvDevice resource when error happens.\r
\r
  @param FvDevice   Pointer to the FvDevice to be freed.\r
**/\r
VOID\r
FreeFvDeviceResource (\r
  IN FV_DEVICE  *FvDevice\r
  )\r
{\r
  LBA_ENTRY           *LbaEntry;\r
  FREE_SPACE_ENTRY    *FreeSpaceEntry;\r
  FFS_FILE_LIST_ENTRY *FfsFileEntry;\r
  LIST_ENTRY      *NextEntry;\r
\r
  //\r
  // Free LAB Entry\r
  //\r
  LbaEntry = (LBA_ENTRY *) FvDevice->LbaHeader.ForwardLink;\r
  while (&LbaEntry->Link != &FvDevice->LbaHeader) {\r
    NextEntry = (&LbaEntry->Link)->ForwardLink;\r
    FreePool (LbaEntry);\r
    LbaEntry = (LBA_ENTRY *) NextEntry;\r
  }\r
  //\r
  // Free File List Entry\r
  //\r
  FfsFileEntry = (FFS_FILE_LIST_ENTRY *) FvDevice->FfsFileListHeader.ForwardLink;\r
  while (&FfsFileEntry->Link != &FvDevice->FfsFileListHeader) {\r
    NextEntry = (&FfsFileEntry->Link)->ForwardLink;\r
    FreePool (FfsFileEntry);\r
    FfsFileEntry = (FFS_FILE_LIST_ENTRY *) NextEntry;\r
  }\r
  //\r
  // Free Space Entry\r
  //\r
  FreeSpaceEntry = (FREE_SPACE_ENTRY *) FvDevice->FreeSpaceHeader.ForwardLink;\r
  while (&FreeSpaceEntry->Link != &FvDevice->FreeSpaceHeader) {\r
    NextEntry = (&FreeSpaceEntry->Link)->ForwardLink;\r
    FreePool (FreeSpaceEntry);\r
    FreeSpaceEntry = (FREE_SPACE_ENTRY *) NextEntry;\r
  }\r
  //\r
  // Free the cache\r
  //\r
  FreePool ((UINT8 *) (UINTN) FvDevice->CachedFv);\r
\r
  return ;\r
}\r
\r
/**\r
\r
  Firmware volume inherits authentication status from the FV image file and section(in another firmware volume)\r
  where it came from or propagated from PEI-phase.\r
\r
  @param  FvDevice              A pointer to the FvDevice.\r
\r
**/\r
VOID\r
FwVolInheritAuthenticationStatus (\r
  IN FV_DEVICE  *FvDevice\r
  )\r
{\r
  EFI_STATUS                            Status;\r
  EFI_FIRMWARE_VOLUME_HEADER            *CachedFvHeader;\r
  EFI_FIRMWARE_VOLUME_EXT_HEADER        *CachedFvExtHeader;\r
  EFI_FIRMWARE_VOLUME2_PROTOCOL         *ParentFvProtocol;\r
  UINTN                                 Key;\r
  EFI_GUID                              FileNameGuid;\r
  EFI_FV_FILETYPE                       FileType;\r
  EFI_FV_FILE_ATTRIBUTES                FileAttributes;\r
  UINTN                                 FileSize;\r
  EFI_SECTION_TYPE                      SectionType;\r
  UINT32                                AuthenticationStatus;\r
  EFI_FIRMWARE_VOLUME_HEADER            *FvHeader;\r
  EFI_FIRMWARE_VOLUME_EXT_HEADER        *FvExtHeader;\r
  UINTN                                 BufferSize;\r
  EFI_FIRMWARE_VOLUME_BLOCK_PROTOCOL    *Fvb;\r
  EFI_FVB_ATTRIBUTES_2                  FvbAttributes;\r
  EFI_PHYSICAL_ADDRESS                  BaseAddress;\r
  EFI_PEI_HOB_POINTERS                  Fv3Hob;\r
\r
  if (FvDevice->Fv.ParentHandle != NULL) {\r
    CachedFvHeader = (EFI_FIRMWARE_VOLUME_HEADER *) (UINTN) FvDevice->CachedFv;\r
\r
    //\r
    // By Parent Handle, find out the FV image file and section(in another firmware volume) where the firmware volume came from\r
    //\r
    Status = gBS->HandleProtocol (FvDevice->Fv.ParentHandle, &gEfiFirmwareVolume2ProtocolGuid, (VOID **) &ParentFvProtocol);\r
    if (!EFI_ERROR (Status) && (ParentFvProtocol != NULL)) {\r
      Key = 0;\r
      do {\r
        FileType = EFI_FV_FILETYPE_FIRMWARE_VOLUME_IMAGE;\r
        Status = ParentFvProtocol->GetNextFile (\r
                                     ParentFvProtocol,\r
                                     &Key,\r
                                     &FileType,\r
                                     &FileNameGuid,\r
                                     &FileAttributes,\r
                                     &FileSize\r
                                     );\r
        if (EFI_ERROR (Status)) {\r
          return;\r
        }\r
\r
        SectionType = EFI_SECTION_FIRMWARE_VOLUME_IMAGE;\r
        FvHeader = NULL;\r
        BufferSize = 0;\r
        Status = ParentFvProtocol->ReadSection (\r
                                     ParentFvProtocol,\r
                                     &FileNameGuid,\r
                                     SectionType,\r
                                     0,\r
                                     (VOID **) &FvHeader,\r
                                     &BufferSize,\r
                                     &AuthenticationStatus\r
                                     );\r
        if (!EFI_ERROR (Status)) {\r
          if ((FvHeader->FvLength == CachedFvHeader->FvLength) &&\r
              (FvHeader->ExtHeaderOffset == CachedFvHeader->ExtHeaderOffset)) {\r
            if (FvHeader->ExtHeaderOffset != 0) {\r
              //\r
              // Both FVs contain extension header, then compare their FV Name GUID\r
              //\r
              FvExtHeader = (EFI_FIRMWARE_VOLUME_EXT_HEADER *) ((UINTN) FvHeader + FvHeader->ExtHeaderOffset);\r
              CachedFvExtHeader = (EFI_FIRMWARE_VOLUME_EXT_HEADER *) ((UINTN) CachedFvHeader + CachedFvHeader->ExtHeaderOffset);\r
              if (CompareGuid (&FvExtHeader->FvName, &CachedFvExtHeader->FvName)) {\r
                //\r
                // Found the FV image section where the firmware volume came from,\r
                // and then inherit authentication status from it.\r
                //\r
                FvDevice->AuthenticationStatus = AuthenticationStatus;\r
                FreePool ((VOID *) FvHeader);\r
                return;\r
              }\r
            } else {\r
              //\r
              // Both FVs don't contain extension header, then compare their whole FV Image.\r
              //\r
              if (CompareMem ((VOID *) FvHeader, (VOID *) CachedFvHeader, (UINTN) FvHeader->FvLength) == 0) {\r
                //\r
                // Found the FV image section where the firmware volume came from\r
                // and then inherit authentication status from it.\r
                //\r
                FvDevice->AuthenticationStatus = AuthenticationStatus;\r
                FreePool ((VOID *) FvHeader);\r
                return;\r
              }\r
            }\r
          }\r
          FreePool ((VOID *) FvHeader);\r
        }\r
      } while (TRUE);\r
    }\r
  } else {\r
    Fvb = FvDevice->Fvb;\r
\r
    Status  = Fvb->GetAttributes (Fvb, &FvbAttributes);\r
    if (EFI_ERROR (Status)) {\r
      return;\r
    }\r
\r
    if ((FvbAttributes & EFI_FVB2_MEMORY_MAPPED) != 0) {\r
      //\r
      // Get volume base address\r
      //\r
      Status = Fvb->GetPhysicalAddress (Fvb, &BaseAddress);\r
      if (EFI_ERROR (Status)) {\r
        return;\r
      }\r
\r
      //\r
      // Get the authentication status propagated from PEI-phase to DXE.\r
      //\r
      Fv3Hob.Raw = GetHobList ();\r
      while ((Fv3Hob.Raw = GetNextHob (EFI_HOB_TYPE_FV3, Fv3Hob.Raw)) != NULL) {\r
        if (Fv3Hob.FirmwareVolume3->BaseAddress == BaseAddress) {\r
          FvDevice->AuthenticationStatus = Fv3Hob.FirmwareVolume3->AuthenticationStatus;\r
          return;\r
        }\r
        Fv3Hob.Raw = GET_NEXT_HOB (Fv3Hob);\r
      }\r
    }\r
  }\r
}\r
\r
/**\r
  Check if an FV is consistent and allocate cache for it.\r
\r
  @param  FvDevice              A pointer to the FvDevice to be checked.\r
\r
  @retval EFI_OUT_OF_RESOURCES  No enough buffer could be allocated.\r
  @retval EFI_VOLUME_CORRUPTED  File system is corrupted.\r
  @retval EFI_SUCCESS           FV is consistent and cache is allocated.\r
\r
**/\r
EFI_STATUS\r
FvCheck (\r
  IN FV_DEVICE  *FvDevice\r
  )\r
{\r
  EFI_STATUS                          Status;\r
  EFI_FIRMWARE_VOLUME_BLOCK_PROTOCOL  *Fvb;\r
  EFI_FVB_ATTRIBUTES_2                FvbAttributes;\r
  EFI_FV_BLOCK_MAP_ENTRY              *BlockMap;\r
  EFI_FIRMWARE_VOLUME_HEADER          *FwVolHeader;\r
  EFI_FIRMWARE_VOLUME_EXT_HEADER      *FwVolExtHeader;\r
  UINT8                               *FwCache;\r
  LBA_ENTRY                           *LbaEntry;\r
  FREE_SPACE_ENTRY                    *FreeSpaceEntry;\r
  FFS_FILE_LIST_ENTRY                 *FfsFileEntry;\r
  UINT8                               *LbaStart;\r
  UINTN                               Index;\r
  EFI_LBA                             LbaIndex;\r
  UINT8                               *Ptr;\r
  UINTN                               Size;\r
  UINT8                               *FreeStart;\r
  UINTN                               FreeSize;\r
  UINT8                               ErasePolarity;\r
  EFI_FFS_FILE_STATE                  FileState;\r
  UINT8                               *TopFvAddress;\r
  UINTN                               TestLength;\r
  EFI_PHYSICAL_ADDRESS                BaseAddress;\r
\r
  Fvb     = FvDevice->Fvb;\r
\r
  Status  = Fvb->GetAttributes (Fvb, &FvbAttributes);\r
  if (EFI_ERROR (Status)) {\r
    return Status;\r
  }\r
\r
  InitializeListHead (&FvDevice->LbaHeader);\r
  InitializeListHead (&FvDevice->FreeSpaceHeader);\r
  InitializeListHead (&FvDevice->FfsFileListHeader);\r
\r
  FwVolHeader = NULL;\r
  Status = GetFwVolHeader (Fvb, &FwVolHeader);\r
  if (EFI_ERROR (Status)) {\r
    return Status;\r
  }\r
  ASSERT (FwVolHeader != NULL);\r
\r
  FvDevice->IsFfs3Fv = CompareGuid (&FwVolHeader->FileSystemGuid, &gEfiFirmwareFileSystem3Guid);\r
\r
  //\r
  // Double Check firmware volume header here\r
  //\r
  if (!VerifyFvHeaderChecksum (FwVolHeader)) {\r
    FreePool (FwVolHeader);\r
    return EFI_VOLUME_CORRUPTED;\r
  }\r
\r
  BlockMap = FwVolHeader->BlockMap;\r
\r
  //\r
  // FwVolHeader->FvLength is the whole FV length including FV header\r
  //\r
  FwCache = AllocateZeroPool ((UINTN) FwVolHeader->FvLength);\r
  if (FwCache == NULL) {\r
    FreePool (FwVolHeader);\r
    return EFI_OUT_OF_RESOURCES;\r
  }\r
\r
  FvDevice->CachedFv = (EFI_PHYSICAL_ADDRESS) (UINTN) FwCache;\r
\r
  //\r
  // Copy to memory\r
  //\r
  LbaStart  = FwCache;\r
  LbaIndex  = 0;\r
  Ptr       = NULL;\r
\r
  if ((FvbAttributes & EFI_FVB2_MEMORY_MAPPED) != 0) {\r
    //\r
    // Get volume base address\r
    //\r
    Status = Fvb->GetPhysicalAddress (Fvb, &BaseAddress);\r
    if (EFI_ERROR (Status)) {\r
      FreePool (FwVolHeader);\r
      return Status;\r
    }\r
\r
    Ptr = (UINT8 *) ((UINTN) BaseAddress);\r
\r
    DEBUG((EFI_D_INFO, "Fv Base Address is 0x%LX\n", BaseAddress));\r
  }\r
  //\r
  // Copy whole FV into the memory\r
  //\r
  while ((BlockMap->NumBlocks != 0) || (BlockMap->Length != 0)) {\r
\r
    for (Index = 0; Index < BlockMap->NumBlocks; Index++) {\r
      LbaEntry = AllocatePool (sizeof (LBA_ENTRY));\r
      if (LbaEntry == NULL) {\r
        FreePool (FwVolHeader);\r
        FreeFvDeviceResource (FvDevice);\r
        return EFI_OUT_OF_RESOURCES;\r
      }\r
\r
      LbaEntry->LbaIndex        = LbaIndex;\r
      LbaEntry->StartingAddress = LbaStart;\r
      LbaEntry->BlockLength     = BlockMap->Length;\r
\r
      //\r
      // Copy each LBA into memory\r
      //\r
      if ((FvbAttributes & EFI_FVB2_MEMORY_MAPPED) != 0) {\r
\r
        CopyMem (LbaStart, Ptr, BlockMap->Length);\r
        Ptr += BlockMap->Length;\r
\r
      } else {\r
\r
        Size = BlockMap->Length;\r
        Status = Fvb->Read (\r
                        Fvb,\r
                        LbaIndex,\r
                        0,\r
                        &Size,\r
                        LbaStart\r
                        );\r
        //\r
        // Not check EFI_BAD_BUFFER_SIZE, for Size = BlockMap->Length\r
        //\r
        if (EFI_ERROR (Status)) {\r
          FreePool (FwVolHeader);\r
          FreeFvDeviceResource (FvDevice);\r
          return Status;\r
        }\r
\r
      }\r
\r
      LbaIndex++;\r
      LbaStart += BlockMap->Length;\r
\r
      InsertTailList (&FvDevice->LbaHeader, &LbaEntry->Link);\r
    }\r
\r
    BlockMap++;\r
  }\r
\r
  FvDevice->FwVolHeader = (EFI_FIRMWARE_VOLUME_HEADER *) FwCache;\r
\r
  //\r
  // it is not used any more, so free FwVolHeader\r
  //\r
  FreePool (FwVolHeader);\r
\r
  //\r
  // Scan to check the free space & File list\r
  //\r
  if ((FvbAttributes & EFI_FVB2_ERASE_POLARITY) != 0) {\r
    ErasePolarity = 1;\r
  } else {\r
    ErasePolarity = 0;\r
  }\r
\r
  FvDevice->ErasePolarity = ErasePolarity;\r
\r
  //\r
  // go through the whole FV cache, check the consistence of the FV\r
  //\r
  if (FvDevice->FwVolHeader->ExtHeaderOffset != 0) {\r
    //\r
    // Searching for files starts on an 8 byte aligned boundary after the end of the Extended Header if it exists.\r
    //\r
    FwVolExtHeader = (EFI_FIRMWARE_VOLUME_EXT_HEADER *) (UINTN) (FvDevice->CachedFv + FvDevice->FwVolHeader->ExtHeaderOffset);\r
    Ptr = (UINT8 *) FwVolExtHeader + FwVolExtHeader->ExtHeaderSize;\r
    Ptr = (UINT8 *) ALIGN_POINTER (Ptr, 8);\r
  } else {\r
    Ptr = (UINT8 *) (UINTN) (FvDevice->CachedFv + FvDevice->FwVolHeader->HeaderLength);\r
  }\r
  TopFvAddress = (UINT8 *) (UINTN) (FvDevice->CachedFv + FvDevice->FwVolHeader->FvLength);\r
\r
  //\r
  // Build FFS list & Free Space List here\r
  //\r
  while (Ptr < TopFvAddress) {\r
    TestLength = TopFvAddress - Ptr;\r
\r
    if (TestLength > sizeof (EFI_FFS_FILE_HEADER)) {\r
      TestLength = sizeof (EFI_FFS_FILE_HEADER);\r
    }\r
\r
    if (IsBufferErased (ErasePolarity, Ptr, TestLength)) {\r
      //\r
      // We found free space\r
      //\r
      FreeStart = Ptr;\r
      FreeSize  = 0;\r
\r
      do {\r
        TestLength = TopFvAddress - Ptr;\r
\r
        if (TestLength > sizeof (EFI_FFS_FILE_HEADER)) {\r
          TestLength = sizeof (EFI_FFS_FILE_HEADER);\r
        }\r
\r
        if (!IsBufferErased (ErasePolarity, Ptr, TestLength)) {\r
          break;\r
        }\r
\r
        FreeSize += TestLength;\r
        Ptr += TestLength;\r
      } while (Ptr < TopFvAddress);\r
\r
      FreeSpaceEntry = AllocateZeroPool (sizeof (FREE_SPACE_ENTRY));\r
      if (FreeSpaceEntry == NULL) {\r
        FreeFvDeviceResource (FvDevice);\r
        return EFI_OUT_OF_RESOURCES;\r
      }\r
      //\r
      // Create a Free space entry\r
      //\r
      FreeSpaceEntry->StartingAddress = FreeStart;\r
      FreeSpaceEntry->Length          = FreeSize;\r
      InsertTailList (&FvDevice->FreeSpaceHeader, &FreeSpaceEntry->Link);\r
      continue;\r
    }\r
    //\r
    // double check boundary\r
    //\r
    if (TestLength < sizeof (EFI_FFS_FILE_HEADER)) {\r
      break;\r
    }\r
\r
    if (!IsValidFFSHeader (\r
          FvDevice->ErasePolarity,\r
          (EFI_FFS_FILE_HEADER *) Ptr\r
          )) {\r
      FileState = GetFileState (\r
                    FvDevice->ErasePolarity,\r
                    (EFI_FFS_FILE_HEADER *) Ptr\r
                    );\r
      if ((FileState == EFI_FILE_HEADER_INVALID) || (FileState == EFI_FILE_HEADER_CONSTRUCTION)) {\r
        if (IS_FFS_FILE2 (Ptr)) {\r
          if (!FvDevice->IsFfs3Fv) {\r
            DEBUG ((EFI_D_ERROR, "Found a FFS3 formatted file: %g in a non-FFS3 formatted FV.\n", &((EFI_FFS_FILE_HEADER *) Ptr)->Name));\r
          }\r
          Ptr = Ptr + sizeof (EFI_FFS_FILE_HEADER2);\r
        } else {\r
          Ptr = Ptr + sizeof (EFI_FFS_FILE_HEADER);\r
        }\r
\r
        continue;\r
\r
      } else {\r
        //\r
        // File system is corrputed, return\r
        //\r
        FreeFvDeviceResource (FvDevice);\r
        return EFI_VOLUME_CORRUPTED;\r
      }\r
    }\r
\r
    if (IS_FFS_FILE2 (Ptr)) {\r
      ASSERT (FFS_FILE2_SIZE (Ptr) > 0x00FFFFFF);\r
      if (!FvDevice->IsFfs3Fv) {\r
        DEBUG ((EFI_D_ERROR, "Found a FFS3 formatted file: %g in a non-FFS3 formatted FV.\n", &((EFI_FFS_FILE_HEADER *) Ptr)->Name));\r
        Ptr = Ptr + FFS_FILE2_SIZE (Ptr);\r
        //\r
        // Adjust Ptr to the next 8-byte aligned boundary.\r
        //\r
        while (((UINTN) Ptr & 0x07) != 0) {\r
          Ptr++;\r
        }\r
        continue;\r
      }\r
    }\r
\r
    if (IsValidFFSFile (FvDevice, (EFI_FFS_FILE_HEADER *) Ptr)) {\r
      FileState = GetFileState (\r
                    FvDevice->ErasePolarity,\r
                    (EFI_FFS_FILE_HEADER *) Ptr\r
                    );\r
\r
      //\r
      // check for non-deleted file\r
      //\r
      if (FileState != EFI_FILE_DELETED) {\r
        //\r
        // Create a FFS list entry for each non-deleted file\r
        //\r
        FfsFileEntry = AllocateZeroPool (sizeof (FFS_FILE_LIST_ENTRY));\r
        if (FfsFileEntry == NULL) {\r
          FreeFvDeviceResource (FvDevice);\r
          return EFI_OUT_OF_RESOURCES;\r
        }\r
\r
        FfsFileEntry->FfsHeader = Ptr;\r
        InsertTailList (&FvDevice->FfsFileListHeader, &FfsFileEntry->Link);\r
      }\r
\r
      if (IS_FFS_FILE2 (Ptr)) {\r
        Ptr = Ptr + FFS_FILE2_SIZE (Ptr);\r
      } else {\r
        Ptr = Ptr + FFS_FILE_SIZE (Ptr);\r
      }\r
\r
      //\r
      // Adjust Ptr to the next 8-byte aligned boundary.\r
      //\r
      while (((UINTN) Ptr & 0x07) != 0) {\r
        Ptr++;\r
      }\r
    } else {\r
      //\r
      // File system is corrupted, return\r
      //\r
      FreeFvDeviceResource (FvDevice);\r
      return EFI_VOLUME_CORRUPTED;\r
    }\r
  }\r
\r
  FvDevice->CurrentFfsFile = NULL;\r
\r
  return EFI_SUCCESS;\r
}\r
\r
/**\r
  Entry point function does install/reinstall FV2 protocol with full functionality.\r
\r
  @param ImageHandle   A handle for the image that is initializing this driver\r
  @param SystemTable   A pointer to the EFI system table\r
\r
  @retval EFI_SUCCESS    At least one Fv protocol install/reinstall successfully.\r
  @retval EFI_NOT_FOUND  No FV protocol install/reinstall successfully.\r
**/\r
EFI_STATUS\r
EFIAPI\r
FwVolDriverInit (\r
  IN EFI_HANDLE                   ImageHandle,\r
  IN EFI_SYSTEM_TABLE             *SystemTable\r
  )\r
{\r
  EFI_STATUS                          Status;\r
  EFI_HANDLE                          *HandleBuffer;\r
  UINTN                               HandleCount;\r
  UINTN                               Index;\r
  EFI_FIRMWARE_VOLUME_BLOCK_PROTOCOL  *Fvb;\r
  EFI_FIRMWARE_VOLUME2_PROTOCOL       *Fv;\r
  FV_DEVICE                           *FvDevice;\r
  EFI_FIRMWARE_VOLUME_HEADER          *FwVolHeader;\r
  BOOLEAN                             Reinstall;\r
  BOOLEAN                             InstallFlag;\r
\r
  DEBUG ((EFI_D_INFO, "=========FwVol writable driver installed\n"));\r
  InstallFlag   =  FALSE;\r
  //\r
  // Locate all handles of Fvb protocol\r
  //\r
  Status = gBS->LocateHandleBuffer (\r
                  ByProtocol,\r
                  &gEfiFirmwareVolumeBlockProtocolGuid,\r
                  NULL,\r
                  &HandleCount,\r
                  &HandleBuffer\r
                  );\r
  if (EFI_ERROR (Status)) {\r
    return EFI_NOT_FOUND;\r
  }\r
\r
  for (Index = 0; Index < HandleCount; Index += 1) {\r
    Status = gBS->HandleProtocol (\r
                    HandleBuffer[Index],\r
                    &gEfiFirmwareVolumeBlockProtocolGuid,\r
                    (VOID **) &Fvb\r
                    );\r
    if (EFI_ERROR (Status)) {\r
      continue;\r
    }\r
\r
    FwVolHeader = NULL;\r
    Status = GetFwVolHeader (Fvb, &FwVolHeader);\r
    if (EFI_ERROR (Status)) {\r
      continue;\r
    }\r
    ASSERT (FwVolHeader != NULL);\r
    FreePool (FwVolHeader);\r
\r
    Reinstall = FALSE;\r
    //\r
    // Check if there is an FV protocol already installed in that handle\r
    //\r
    Status = gBS->HandleProtocol (\r
                    HandleBuffer[Index],\r
                    &gEfiFirmwareVolume2ProtocolGuid,\r
                    (VOID **) &Fv\r
                    );\r
    if (!EFI_ERROR (Status)) {\r
      Reinstall = TRUE;\r
    }\r
    //\r
    // FwVol protocol on the handle so create a new one\r
    //\r
    FvDevice = AllocateZeroPool (sizeof (FV_DEVICE));\r
    if (FvDevice == NULL) {\r
      goto Done;\r
    }\r
\r
    FvDevice->Signature = FV_DEVICE_SIGNATURE;\r
    FvDevice->Fvb       = Fvb;\r
\r
    //\r
    // Firmware Volume Protocol interface\r
    //\r
    FvDevice->Fv.GetVolumeAttributes  = FvGetVolumeAttributes;\r
    FvDevice->Fv.SetVolumeAttributes  = FvSetVolumeAttributes;\r
    FvDevice->Fv.ReadFile             = FvReadFile;\r
    FvDevice->Fv.ReadSection          = FvReadFileSection;\r
    FvDevice->Fv.WriteFile            = FvWriteFile;\r
    FvDevice->Fv.GetNextFile          = FvGetNextFile;\r
    FvDevice->Fv.KeySize              = KEYSIZE;\r
    FvDevice->Fv.GetInfo              = FvGetVolumeInfo;\r
    FvDevice->Fv.SetInfo              = FvSetVolumeInfo;\r
    FvDevice->Fv.ParentHandle         = Fvb->ParentHandle;\r
\r
    Status = FvCheck (FvDevice);\r
    if (EFI_ERROR (Status)) {\r
      //\r
      // The file system is not consistence\r
      //\r
      FreePool (FvDevice);\r
      continue;\r
    }\r
\r
    FwVolInheritAuthenticationStatus (FvDevice);\r
\r
    if (Reinstall) {\r
      //\r
      // Reinstall an New FV protocol\r
      //\r
      // FvDevice = FV_DEVICE_FROM_THIS (Fv);\r
      // FvDevice->Fvb = Fvb;\r
      // FreeFvDeviceResource (FvDevice);\r
      //\r
      Status = gBS->ReinstallProtocolInterface (\r
                      HandleBuffer[Index],\r
                      &gEfiFirmwareVolume2ProtocolGuid,\r
                      Fv,\r
                      &FvDevice->Fv\r
                      );\r
      if (!EFI_ERROR (Status)) {\r
        InstallFlag = TRUE;\r
      } else {\r
        FreePool (FvDevice);\r
      }\r
      \r
      DEBUG ((EFI_D_INFO, "Reinstall FV protocol as writable - %r\n", Status));\r
      ASSERT_EFI_ERROR (Status);\r
    } else {\r
      //\r
      // Install an New FV protocol\r
      //\r
      Status = gBS->InstallProtocolInterface (\r
                      &FvDevice->Handle,\r
                      &gEfiFirmwareVolume2ProtocolGuid,\r
                      EFI_NATIVE_INTERFACE,\r
                      &FvDevice->Fv\r
                      );\r
      if (!EFI_ERROR (Status)) {\r
        InstallFlag = TRUE;\r
      } else {\r
        FreePool (FvDevice);\r
      }\r
      \r
      DEBUG ((EFI_D_INFO, "Install FV protocol as writable - %r\n", Status));\r
      ASSERT_EFI_ERROR (Status);\r
    }\r
  }\r
\r
Done:\r
  //\r
  // As long as one Fv protocol install/reinstall successfully,\r
  // success should return to ensure this image will be not unloaded.\r
  // Otherwise, new Fv protocols are corrupted by other loaded driver.\r
  //\r
  if (InstallFlag) {\r
    return EFI_SUCCESS;\r
  }\r
  \r
  //\r
  // No FV protocol install/reinstall successfully.\r
  // EFI_NOT_FOUND should return to ensure this image will be unloaded.\r
  //\r
  return EFI_NOT_FOUND;\r
}\r