mirror of
https://git.proxmox.com/git/mirror_edk2
synced 2025-10-31 15:06:49 +00:00
2e351cbe8e
https://bugzilla.tianocore.org/show_bug.cgi?id=1373 Replace BSD 2-Clause License with BSD+Patent License. This change is based on the following emails: https://lists.01.org/pipermail/edk2-devel/2019-February/036260.html https://lists.01.org/pipermail/edk2-devel/2018-October/030385.html RFCs with detailed process for the license change: V3: https://lists.01.org/pipermail/edk2-devel/2019-March/038116.html V2: https://lists.01.org/pipermail/edk2-devel/2019-March/037669.html V1: https://lists.01.org/pipermail/edk2-devel/2019-March/037500.html Contributed-under: TianoCore Contribution Agreement 1.1 Signed-off-by: Michael D Kinney <michael.d.kinney@intel.com> Reviewed-by: Bob Feng <bob.c.feng@intel.com>
403 lines
12 KiB
C
403 lines
12 KiB
C
/** @file
|
|
This file contains describes the public interfaces to the GenFvImage Library.
|
|
The basic purpose of the library is to create Firmware Volume images.
|
|
|
|
Copyright (c) 2004 - 2018, Intel Corporation. All rights reserved.<BR>
|
|
SPDX-License-Identifier: BSD-2-Clause-Patent
|
|
|
|
**/
|
|
|
|
#ifndef _EFI_GEN_FV_INTERNAL_LIB_H
|
|
#define _EFI_GEN_FV_INTERNAL_LIB_H
|
|
|
|
//
|
|
// Include files
|
|
//
|
|
#include <stdlib.h>
|
|
|
|
#include <Common/UefiBaseTypes.h>
|
|
#include <Common/UefiCapsule.h>
|
|
|
|
#include <Common/PiFirmwareFile.h>
|
|
#include <Common/PiFirmwareVolume.h>
|
|
#include <Guid/PiFirmwareFileSystem.h>
|
|
#include <IndustryStandard/PeImage.h>
|
|
|
|
#include "CommonLib.h"
|
|
#include "ParseInf.h"
|
|
#include "EfiUtilityMsgs.h"
|
|
|
|
//
|
|
// Different file separator for Linux and Windows
|
|
//
|
|
#define FILE_SEP_CHAR '/'
|
|
|
|
//
|
|
// The maximum number of Pad file guid entries.
|
|
//
|
|
#define MAX_NUMBER_OF_PAD_FILE_GUIDS 1024
|
|
|
|
//
|
|
// The maximum number of block map entries supported by the library
|
|
//
|
|
#define MAX_NUMBER_OF_FV_BLOCKS 100
|
|
|
|
//
|
|
// The maximum number of files in the FV supported by the library
|
|
//
|
|
#define MAX_NUMBER_OF_FILES_IN_FV 1000
|
|
#define MAX_NUMBER_OF_FILES_IN_CAP 1000
|
|
#define EFI_FFS_FILE_HEADER_ALIGNMENT 8
|
|
//
|
|
// INF file strings
|
|
//
|
|
#define OPTIONS_SECTION_STRING "[options]"
|
|
#define ATTRIBUTES_SECTION_STRING "[attributes]"
|
|
#define FILES_SECTION_STRING "[files]"
|
|
#define FV_BASE_ADDRESS_STRING "[FV_BASE_ADDRESS]"
|
|
|
|
//
|
|
// Options section
|
|
//
|
|
#define EFI_FV_BASE_ADDRESS_STRING "EFI_BASE_ADDRESS"
|
|
#define EFI_FV_FILE_NAME_STRING "EFI_FILE_NAME"
|
|
#define EFI_NUM_BLOCKS_STRING "EFI_NUM_BLOCKS"
|
|
#define EFI_BLOCK_SIZE_STRING "EFI_BLOCK_SIZE"
|
|
#define EFI_GUID_STRING "EFI_GUID"
|
|
#define EFI_FV_FILESYSTEMGUID_STRING "EFI_FV_GUID"
|
|
#define EFI_FV_NAMEGUID_STRING "EFI_FVNAME_GUID"
|
|
#define EFI_CAPSULE_GUID_STRING "EFI_CAPSULE_GUID"
|
|
#define EFI_CAPSULE_HEADER_SIZE_STRING "EFI_CAPSULE_HEADER_SIZE"
|
|
#define EFI_CAPSULE_FLAGS_STRING "EFI_CAPSULE_FLAGS"
|
|
#define EFI_OEM_CAPSULE_FLAGS_STRING "EFI_OEM_CAPSULE_FLAGS"
|
|
#define EFI_CAPSULE_VERSION_STRING "EFI_CAPSULE_VERSION"
|
|
|
|
#define EFI_FV_TOTAL_SIZE_STRING "EFI_FV_TOTAL_SIZE"
|
|
#define EFI_FV_TAKEN_SIZE_STRING "EFI_FV_TAKEN_SIZE"
|
|
#define EFI_FV_SPACE_SIZE_STRING "EFI_FV_SPACE_SIZE"
|
|
|
|
//
|
|
// Attributes section
|
|
//
|
|
#define EFI_FVB2_READ_DISABLED_CAP_STRING "EFI_READ_DISABLED_CAP"
|
|
#define EFI_FVB2_READ_ENABLED_CAP_STRING "EFI_READ_ENABLED_CAP"
|
|
#define EFI_FVB2_READ_STATUS_STRING "EFI_READ_STATUS"
|
|
|
|
#define EFI_FVB2_WRITE_DISABLED_CAP_STRING "EFI_WRITE_DISABLED_CAP"
|
|
#define EFI_FVB2_WRITE_ENABLED_CAP_STRING "EFI_WRITE_ENABLED_CAP"
|
|
#define EFI_FVB2_WRITE_STATUS_STRING "EFI_WRITE_STATUS"
|
|
|
|
#define EFI_FVB2_LOCK_CAP_STRING "EFI_LOCK_CAP"
|
|
#define EFI_FVB2_LOCK_STATUS_STRING "EFI_LOCK_STATUS"
|
|
|
|
#define EFI_FVB2_STICKY_WRITE_STRING "EFI_STICKY_WRITE"
|
|
#define EFI_FVB2_MEMORY_MAPPED_STRING "EFI_MEMORY_MAPPED"
|
|
#define EFI_FVB2_ERASE_POLARITY_STRING "EFI_ERASE_POLARITY"
|
|
|
|
#define EFI_FVB2_READ_LOCK_CAP_STRING "EFI_READ_LOCK_CAP"
|
|
#define EFI_FVB2_READ_LOCK_STATUS_STRING "EFI_READ_LOCK_STATUS"
|
|
#define EFI_FVB2_WRITE_LOCK_CAP_STRING "EFI_WRITE_LOCK_CAP"
|
|
#define EFI_FVB2_WRITE_LOCK_STATUS_STRING "EFI_WRITE_LOCK_STATUS"
|
|
|
|
#define EFI_FVB2_ALIGNMENT_1_STRING "EFI_FVB2_ALIGNMENT_1"
|
|
#define EFI_FVB2_ALIGNMENT_2_STRING "EFI_FVB2_ALIGNMENT_2"
|
|
#define EFI_FVB2_ALIGNMENT_4_STRING "EFI_FVB2_ALIGNMENT_4"
|
|
#define EFI_FVB2_ALIGNMENT_8_STRING "EFI_FVB2_ALIGNMENT_8"
|
|
#define EFI_FVB2_ALIGNMENT_16_STRING "EFI_FVB2_ALIGNMENT_16"
|
|
#define EFI_FVB2_ALIGNMENT_32_STRING "EFI_FVB2_ALIGNMENT_32"
|
|
#define EFI_FVB2_ALIGNMENT_64_STRING "EFI_FVB2_ALIGNMENT_64"
|
|
#define EFI_FVB2_ALIGNMENT_128_STRING "EFI_FVB2_ALIGNMENT_128"
|
|
#define EFI_FVB2_ALIGNMENT_256_STRING "EFI_FVB2_ALIGNMENT_256"
|
|
#define EFI_FVB2_ALIGNMENT_512_STRING "EFI_FVB2_ALIGNMENT_512"
|
|
#define EFI_FVB2_ALIGNMENT_1K_STRING "EFI_FVB2_ALIGNMENT_1K"
|
|
#define EFI_FVB2_ALIGNMENT_2K_STRING "EFI_FVB2_ALIGNMENT_2K"
|
|
#define EFI_FVB2_ALIGNMENT_4K_STRING "EFI_FVB2_ALIGNMENT_4K"
|
|
#define EFI_FVB2_ALIGNMENT_8K_STRING "EFI_FVB2_ALIGNMENT_8K"
|
|
#define EFI_FVB2_ALIGNMENT_16K_STRING "EFI_FVB2_ALIGNMENT_16K"
|
|
#define EFI_FVB2_ALIGNMENT_32K_STRING "EFI_FVB2_ALIGNMENT_32K"
|
|
#define EFI_FVB2_ALIGNMENT_64K_STRING "EFI_FVB2_ALIGNMENT_64K"
|
|
#define EFI_FVB2_ALIGNMENT_128K_STRING "EFI_FVB2_ALIGNMENT_128K"
|
|
#define EFI_FVB2_ALIGNMENT_256K_STRING "EFI_FVB2_ALIGNMENT_256K"
|
|
#define EFI_FVB2_ALIGNMENT_512K_STRING "EFI_FVB2_ALIGNMENT_512K"
|
|
#define EFI_FVB2_ALIGNMENT_1M_STRING "EFI_FVB2_ALIGNMENT_1M"
|
|
#define EFI_FVB2_ALIGNMENT_2M_STRING "EFI_FVB2_ALIGNMENT_2M"
|
|
#define EFI_FVB2_ALIGNMENT_4M_STRING "EFI_FVB2_ALIGNMENT_4M"
|
|
#define EFI_FVB2_ALIGNMENT_8M_STRING "EFI_FVB2_ALIGNMENT_8M"
|
|
#define EFI_FVB2_ALIGNMENT_16M_STRING "EFI_FVB2_ALIGNMENT_16M"
|
|
#define EFI_FVB2_ALIGNMENT_32M_STRING "EFI_FVB2_ALIGNMENT_32M"
|
|
#define EFI_FVB2_ALIGNMENT_64M_STRING "EFI_FVB2_ALIGNMENT_64M"
|
|
#define EFI_FVB2_ALIGNMENT_128M_STRING "EFI_FVB2_ALIGNMENT_128M"
|
|
#define EFI_FVB2_ALIGNMENT_256M_STRING "EFI_FVB2_ALIGNMENT_256M"
|
|
#define EFI_FVB2_ALIGNMENT_512M_STRING "EFI_FVB2_ALIGNMENT_512M"
|
|
#define EFI_FVB2_ALIGNMENT_1G_STRING "EFI_FVB2_ALIGNMENT_1G"
|
|
#define EFI_FVB2_ALIGNMENT_2G_STRING "EFI_FVB2_ALIGNMENT_2G"
|
|
|
|
#define EFI_FV_WEAK_ALIGNMENT_STRING "EFI_WEAK_ALIGNMENT"
|
|
|
|
//
|
|
// File sections
|
|
//
|
|
#define EFI_FILE_NAME_STRING "EFI_FILE_NAME"
|
|
|
|
#define ONE_STRING "1"
|
|
#define ZERO_STRING "0"
|
|
#define TRUE_STRING "TRUE"
|
|
#define FALSE_STRING "FALSE"
|
|
#define NULL_STRING "NULL"
|
|
|
|
//
|
|
//
|
|
//
|
|
#define EFI_FV_EXT_HEADER_FILE_NAME "EFI_FV_EXT_HEADER_FILE_NAME"
|
|
|
|
|
|
//
|
|
// VTF (Firmware Volume Top File) signatures
|
|
//
|
|
#define IA32_X64_VTF_SIGNATURE_OFFSET 0x14
|
|
#define IA32_X64_VTF0_SIGNATURE SIGNATURE_32('V','T','F',0)
|
|
|
|
//
|
|
// Defines to calculate the offset for PEI CORE entry points
|
|
//
|
|
#define IA32_PEI_CORE_ENTRY_OFFSET 0x20
|
|
|
|
//
|
|
// Defines to calculate the offset for IA32 SEC CORE entry point
|
|
//
|
|
#define IA32_SEC_CORE_ENTRY_OFFSET 0xD
|
|
|
|
//
|
|
// Symbol file definitions, current max size if 512K
|
|
//
|
|
#define SYMBOL_FILE_SIZE 0x80000
|
|
|
|
#define FV_IMAGES_TOP_ADDRESS 0x100000000ULL
|
|
|
|
//
|
|
// Following definition is used for FIT in IPF
|
|
//
|
|
#define COMP_TYPE_FIT_PEICORE 0x10
|
|
#define COMP_TYPE_FIT_UNUSED 0x7F
|
|
|
|
#define FIT_TYPE_MASK 0x7F
|
|
#define CHECKSUM_BIT_MASK 0x80
|
|
|
|
//
|
|
// Private data types
|
|
//
|
|
//
|
|
// Component information
|
|
//
|
|
typedef struct {
|
|
UINTN Size;
|
|
CHAR8 ComponentName[MAX_LONG_FILE_PATH];
|
|
} COMPONENT_INFO;
|
|
|
|
//
|
|
// FV and capsule information holder
|
|
//
|
|
typedef struct {
|
|
BOOLEAN BaseAddressSet;
|
|
EFI_PHYSICAL_ADDRESS BaseAddress;
|
|
EFI_GUID FvFileSystemGuid;
|
|
BOOLEAN FvFileSystemGuidSet;
|
|
EFI_GUID FvNameGuid;
|
|
BOOLEAN FvNameGuidSet;
|
|
CHAR8 FvExtHeaderFile[MAX_LONG_FILE_PATH];
|
|
UINTN Size;
|
|
EFI_FVB_ATTRIBUTES_2 FvAttributes;
|
|
CHAR8 FvName[MAX_LONG_FILE_PATH];
|
|
EFI_FV_BLOCK_MAP_ENTRY FvBlocks[MAX_NUMBER_OF_FV_BLOCKS];
|
|
CHAR8 FvFiles[MAX_NUMBER_OF_FILES_IN_FV][MAX_LONG_FILE_PATH];
|
|
UINT32 SizeofFvFiles[MAX_NUMBER_OF_FILES_IN_FV];
|
|
BOOLEAN IsPiFvImage;
|
|
INT8 ForceRebase;
|
|
} FV_INFO;
|
|
|
|
typedef struct {
|
|
EFI_GUID CapGuid;
|
|
UINT32 HeaderSize;
|
|
UINT32 Flags;
|
|
CHAR8 CapName[MAX_LONG_FILE_PATH];
|
|
CHAR8 CapFiles[MAX_NUMBER_OF_FILES_IN_CAP][MAX_LONG_FILE_PATH];
|
|
} CAP_INFO;
|
|
|
|
#pragma pack(1)
|
|
|
|
typedef struct {
|
|
UINT64 CompAddress;
|
|
UINT32 CompSize;
|
|
UINT16 CompVersion;
|
|
UINT8 CvAndType;
|
|
UINT8 CheckSum;
|
|
} FIT_TABLE;
|
|
|
|
#pragma pack()
|
|
|
|
#define FV_DEFAULT_ATTRIBUTE 0x0004FEFF
|
|
extern FV_INFO mFvDataInfo;
|
|
extern CAP_INFO mCapDataInfo;
|
|
extern EFI_GUID mEfiFirmwareFileSystem2Guid;
|
|
extern EFI_GUID mEfiFirmwareFileSystem3Guid;
|
|
extern UINT32 mFvTotalSize;
|
|
extern UINT32 mFvTakenSize;
|
|
|
|
extern EFI_PHYSICAL_ADDRESS mFvBaseAddress[];
|
|
extern UINT32 mFvBaseAddressNumber;
|
|
//
|
|
// Local function prototypes
|
|
//
|
|
EFI_STATUS
|
|
ParseFvInf (
|
|
IN MEMORY_FILE *InfFile,
|
|
OUT FV_INFO *FvInfo
|
|
)
|
|
;
|
|
|
|
EFI_STATUS
|
|
UpdatePeiCoreEntryInFit (
|
|
IN FIT_TABLE *FitTablePtr,
|
|
IN UINT64 PeiCorePhysicalAddress
|
|
)
|
|
/*++
|
|
|
|
Routine Description:
|
|
|
|
This function is used to update the Pei Core address in FIT, this can be used by Sec core to pass control from
|
|
Sec to Pei Core
|
|
|
|
Arguments:
|
|
|
|
FitTablePtr - The pointer of FIT_TABLE.
|
|
PeiCorePhysicalAddress - The address of Pei Core entry.
|
|
|
|
Returns:
|
|
|
|
EFI_SUCCESS - The PEI_CORE FIT entry was updated successfully.
|
|
EFI_NOT_FOUND - Not found the PEI_CORE FIT entry.
|
|
|
|
--*/
|
|
;
|
|
|
|
VOID
|
|
UpdateFitCheckSum (
|
|
IN FIT_TABLE *FitTablePtr
|
|
)
|
|
/*++
|
|
|
|
Routine Description:
|
|
|
|
This function is used to update the checksum for FIT.
|
|
|
|
|
|
Arguments:
|
|
|
|
FitTablePtr - The pointer of FIT_TABLE.
|
|
|
|
Returns:
|
|
|
|
None.
|
|
|
|
--*/
|
|
;
|
|
|
|
EFI_STATUS
|
|
GetPe32Info (
|
|
IN UINT8 *Pe32,
|
|
OUT UINT32 *EntryPoint,
|
|
OUT UINT32 *BaseOfCode,
|
|
OUT UINT16 *MachineType
|
|
);
|
|
|
|
EFI_STATUS
|
|
ParseCapInf (
|
|
IN MEMORY_FILE *InfFile,
|
|
OUT CAP_INFO *CapInfo
|
|
);
|
|
|
|
EFI_STATUS
|
|
FindApResetVectorPosition (
|
|
IN MEMORY_FILE *FvImage,
|
|
OUT UINT8 **Pointer
|
|
);
|
|
|
|
EFI_STATUS
|
|
CalculateFvSize (
|
|
FV_INFO *FvInfoPtr
|
|
);
|
|
|
|
EFI_STATUS
|
|
FfsRebase (
|
|
IN OUT FV_INFO *FvInfo,
|
|
IN CHAR8 *FileName,
|
|
IN OUT EFI_FFS_FILE_HEADER *FfsFile,
|
|
IN UINTN XipOffset,
|
|
IN FILE *FvMapFile
|
|
);
|
|
|
|
//
|
|
// Exported function prototypes
|
|
//
|
|
EFI_STATUS
|
|
GenerateCapImage (
|
|
IN CHAR8 *InfFileImage,
|
|
IN UINTN InfFileSize,
|
|
IN CHAR8 *CapFileName
|
|
)
|
|
/*++
|
|
|
|
Routine Description:
|
|
|
|
This is the main function which will be called from application to
|
|
generate UEFI Capsule image.
|
|
|
|
Arguments:
|
|
|
|
InfFileImage Buffer containing the INF file contents.
|
|
InfFileSize Size of the contents of the InfFileImage buffer.
|
|
CapFileName Requested name for the Cap file.
|
|
|
|
Returns:
|
|
|
|
EFI_SUCCESS Function completed successfully.
|
|
EFI_OUT_OF_RESOURCES Could not allocate required resources.
|
|
EFI_ABORTED Error encountered.
|
|
EFI_INVALID_PARAMETER A required parameter was NULL.
|
|
|
|
--*/
|
|
;
|
|
|
|
EFI_STATUS
|
|
GenerateFvImage (
|
|
IN CHAR8 *InfFileImage,
|
|
IN UINTN InfFileSize,
|
|
IN CHAR8 *FvFileName,
|
|
IN CHAR8 *MapFileName
|
|
)
|
|
/*++
|
|
|
|
Routine Description:
|
|
|
|
This is the main function which will be called from application to
|
|
generate Firmware Image conforms to PI spec.
|
|
|
|
Arguments:
|
|
|
|
InfFileImage Buffer containing the INF file contents.
|
|
InfFileSize Size of the contents of the InfFileImage buffer.
|
|
FvFileName Requested name for the FV file.
|
|
MapFileName Fv map file to log fv driver information.
|
|
|
|
Returns:
|
|
|
|
EFI_SUCCESS Function completed successfully.
|
|
EFI_OUT_OF_RESOURCES Could not allocate required resources.
|
|
EFI_ABORTED Error encountered.
|
|
EFI_INVALID_PARAMETER A required parameter was NULL.
|
|
|
|
--*/
|
|
;
|
|
|
|
#endif
|