54a3d5ec48
Support RISC-V image relocation. REF: https://bugzilla.tianocore.org/show_bug.cgi?id=2672 Signed-off-by: Abner Chang <abner.chang@hpe.com> Co-authored-by: Gilbert Chen <gilbert.chen@hpe.com> Reviewed-by: Leif Lindholm <leif.lindholm@linaro.org> Reviewed-by: Zhiguang Liu <zhiguang.liu@intel.com> Cc: Michael D Kinney <michael.d.kinney@intel.com> Cc: Liming Gao <liming.gao@intel.com> Cc: Leif Lindholm <leif.lindholm@linaro.org> Cc: Gilbert Chen <gilbert.chen@hpe.com>
137 lines
3.9 KiB
C
137 lines
3.9 KiB
C
/** @file
|
|
Declaration of internal functions in PE/COFF Lib.
|
|
|
|
Copyright (c) 2006 - 2010, Intel Corporation. All rights reserved.<BR>
|
|
Portions Copyright (c) 2020, Hewlett Packard Enterprise Development LP. All rights reserved.<BR>
|
|
SPDX-License-Identifier: BSD-2-Clause-Patent
|
|
|
|
**/
|
|
|
|
#ifndef __BASE_PECOFF_LIB_INTERNALS__
|
|
#define __BASE_PECOFF_LIB_INTERNALS__
|
|
|
|
#include <Base.h>
|
|
#include <Library/PeCoffLib.h>
|
|
#include <Library/BaseMemoryLib.h>
|
|
#include <Library/DebugLib.h>
|
|
#include <Library/PeCoffExtraActionLib.h>
|
|
#include <IndustryStandard/PeImage.h>
|
|
|
|
//
|
|
// Macro definitions for RISC-V architecture.
|
|
//
|
|
#define RV_X(x, s, n) (((x) >> (s)) & ((1<<(n))-1))
|
|
#define RISCV_IMM_BITS 12
|
|
#define RISCV_IMM_REACH (1LL<<RISCV_IMM_BITS)
|
|
#define RISCV_CONST_HIGH_PART(VALUE) \
|
|
(((VALUE) + (RISCV_IMM_REACH/2)) & ~(RISCV_IMM_REACH-1))
|
|
|
|
|
|
/**
|
|
Performs an Itanium-based specific relocation fixup and is a no-op on other
|
|
instruction sets.
|
|
|
|
@param Reloc The pointer to the relocation record.
|
|
@param Fixup The pointer to the address to fix up.
|
|
@param FixupData The pointer to a buffer to log the fixups.
|
|
@param Adjust The offset to adjust the fixup.
|
|
|
|
@return Status code.
|
|
|
|
**/
|
|
RETURN_STATUS
|
|
PeCoffLoaderRelocateImageEx (
|
|
IN UINT16 *Reloc,
|
|
IN OUT CHAR8 *Fixup,
|
|
IN OUT CHAR8 **FixupData,
|
|
IN UINT64 Adjust
|
|
);
|
|
|
|
|
|
/**
|
|
Performs an Itanium-based specific re-relocation fixup and is a no-op on other
|
|
instruction sets. This is used to re-relocated the image into the EFI virtual
|
|
space for runtime calls.
|
|
|
|
@param Reloc The pointer to the relocation record.
|
|
@param Fixup The pointer to the address to fix up.
|
|
@param FixupData The pointer to a buffer to log the fixups.
|
|
@param Adjust The offset to adjust the fixup.
|
|
|
|
@return Status code.
|
|
|
|
**/
|
|
RETURN_STATUS
|
|
PeHotRelocateImageEx (
|
|
IN UINT16 *Reloc,
|
|
IN OUT CHAR8 *Fixup,
|
|
IN OUT CHAR8 **FixupData,
|
|
IN UINT64 Adjust
|
|
);
|
|
|
|
|
|
/**
|
|
Returns TRUE if the machine type of PE/COFF image is supported. Supported
|
|
does not mean the image can be executed it means the PE/COFF loader supports
|
|
loading and relocating of the image type. It's up to the caller to support
|
|
the entry point.
|
|
|
|
@param Machine Machine type from the PE Header.
|
|
|
|
@return TRUE if this PE/COFF loader can load the image
|
|
|
|
**/
|
|
BOOLEAN
|
|
PeCoffLoaderImageFormatSupported (
|
|
IN UINT16 Machine
|
|
);
|
|
|
|
/**
|
|
Retrieves the magic value from the PE/COFF header.
|
|
|
|
@param Hdr The buffer in which to return the PE32, PE32+, or TE header.
|
|
|
|
@return EFI_IMAGE_NT_OPTIONAL_HDR32_MAGIC - Image is PE32
|
|
@return EFI_IMAGE_NT_OPTIONAL_HDR64_MAGIC - Image is PE32+
|
|
|
|
**/
|
|
UINT16
|
|
PeCoffLoaderGetPeHeaderMagicValue (
|
|
IN EFI_IMAGE_OPTIONAL_HEADER_PTR_UNION Hdr
|
|
);
|
|
|
|
/**
|
|
Retrieves the PE or TE Header from a PE/COFF or TE image.
|
|
|
|
@param ImageContext The context of the image being loaded.
|
|
@param Hdr The buffer in which to return the PE32, PE32+, or TE header.
|
|
|
|
@retval RETURN_SUCCESS The PE or TE Header is read.
|
|
@retval Other The error status from reading the PE/COFF or TE image using the ImageRead function.
|
|
|
|
**/
|
|
RETURN_STATUS
|
|
PeCoffLoaderGetPeHeader (
|
|
IN OUT PE_COFF_LOADER_IMAGE_CONTEXT *ImageContext,
|
|
OUT EFI_IMAGE_OPTIONAL_HEADER_PTR_UNION Hdr
|
|
);
|
|
|
|
/**
|
|
Converts an image address to the loaded address.
|
|
|
|
@param ImageContext The context of the image being loaded.
|
|
@param Address The address to be converted to the loaded address.
|
|
@param TeStrippedOffset Stripped offset for TE image.
|
|
|
|
@return The converted address or NULL if the address can not be converted.
|
|
|
|
**/
|
|
VOID *
|
|
PeCoffLoaderImageAddress (
|
|
IN OUT PE_COFF_LOADER_IMAGE_CONTEXT *ImageContext,
|
|
IN UINTN Address,
|
|
IN UINTN TeStrippedOffset
|
|
);
|
|
|
|
#endif
|