FvLib.h File Reference

Functions
EFI_STATUS EFIAPI	FfsFindNextFile (IN EFI_FV_FILETYPE SearchType, IN EFI_FIRMWARE_VOLUME_HEADER *FwVolHeader, IN OUT EFI_FFS_FILE_HEADER **FileHeader)
EFI_STATUS EFIAPI	FfsFindSection (IN EFI_SECTION_TYPE SectionType, IN EFI_FFS_FILE_HEADER *FfsFileHeader, IN OUT EFI_COMMON_SECTION_HEADER **SectionHeader)
EFI_STATUS EFIAPI	FindFfsSectionInSections (IN VOID *Sections, IN UINTN SizeOfSections, IN EFI_SECTION_TYPE SectionType, OUT EFI_COMMON_SECTION_HEADER **FoundSection)
EFI_STATUS EFIAPI	FfsFindSectionData (IN EFI_SECTION_TYPE SectionType, IN EFI_FFS_FILE_HEADER *FfsFileHeader, OUT VOID **SectionData, OUT UINTN *SectionDataSize)

Detailed Description

Copyright (c) 2015, Intel Corporation. All rights reserved.
Copyright (c) 2016 - 2018, ARM Limited. All rights reserved.

SPDX-License-Identifier: BSD-2-Clause-Patent

Function Documentation

EFI_STATUS EFIAPI FfsFindNextFile	(	IN EFI_FV_FILETYPE	SearchType,
		IN EFI_FIRMWARE_VOLUME_HEADER *	FwVolHeader,
		IN OUT EFI_FFS_FILE_HEADER **	FileHeader
	)

Given the input file pointer, search for the next matching file in the FFS volume as defined by SearchType. The search starts from FileHeader inside the Firmware Volume defined by FwVolHeader.

Parameters

SearchType	Filter to find only files of this type. Type EFI_FV_FILETYPE_ALL causes no filtering to be done.
FwVolHeader	Pointer to the FV header of the volume to search. This parameter must point to a valid FFS volume.
FileHeader	Pointer to the current file from which to begin searching. This pointer will be updated upon return to reflect the file found.

Return values

EFI_NOT_FOUND	No files matching the search criteria were found
EFI_SUCCESS

EFI_STATUS EFIAPI FfsFindSection	(	IN EFI_SECTION_TYPE	SectionType,
		IN EFI_FFS_FILE_HEADER *	FfsFileHeader,
		IN OUT EFI_COMMON_SECTION_HEADER **	SectionHeader
	)

Given the input file pointer, search for the next matching section in the FFS volume.

Parameters

SearchType	Filter to find only sections of this type.
FfsFileHeader	Pointer to the current file to search.
SectionHeader	Pointer to the Section matching SectionType in FfsFileHeader. NULL if section not found

Return values

EFI_NOT_FOUND	No files matching the search criteria were found
EFI_SUCCESS

EFI_STATUS EFIAPI FfsFindSectionData	(	IN EFI_SECTION_TYPE	SectionType,
		IN EFI_FFS_FILE_HEADER *	FfsFileHeader,
		OUT VOID **	SectionData,
		OUT UINTN *	SectionDataSize
	)

Given the input file pointer, search for the next matching section in the FFS volume.

Parameters

SearchType	Filter to find only sections of this type.
FfsFileHeader	Pointer to the current file to search.
SectionData	Pointer to the Section matching SectionType in FfsFileHeader. NULL if section not found
SectionDataSize	The size of SectionData

Return values

EFI_NOT_FOUND	No files matching the search criteria were found
EFI_SUCCESS

EFI_STATUS EFIAPI FindFfsSectionInSections	(	IN VOID *	Sections,
		IN UINTN	SizeOfSections,
		IN EFI_SECTION_TYPE	SectionType,
		OUT EFI_COMMON_SECTION_HEADER **	FoundSection
	)

Locates a section within a series of sections with the specified section type.

Parameters

[in]	Sections	The sections to search
[in]	SizeOfSections	Total size of all sections
[in]	SectionType	The section type to locate
[out]	FoundSection	The FFS section if found

Return values

EFI_SUCCESS	The file and section was found
EFI_NOT_FOUND	The file and section was not found
EFI_VOLUME_CORRUPTED	The firmware volume was corrupted