[PATCH v2 2/3] UefiPayloadPkg: Add PayloadLoaderPeim which can load ELF payload


Ni, Ray
 

Per universal payload spec, the payload is in ELF format.
The patch adds a payload loader that supports to load ELF image.

The location of extra data sections whose names start with "upld."
is stored in PLD_EXTRA_DATA HOB.

Signed-off-by: Maurice Ma <maurice.ma@...>
Signed-off-by: Ray Ni <ray.ni@...>
Cc: Maurice Ma <maurice.ma@...>
Cc: Guo Dong <guo.dong@...>
Cc: Benjamin You <benjamin.you@...>
---
UefiPayloadPkg/PayloadLoaderPeim/ElfLib.h | 122 +++
.../PayloadLoaderPeim/ElfLib/Elf32.h | 252 +++++
.../PayloadLoaderPeim/ElfLib/Elf32Lib.c | 451 ++++++++
.../PayloadLoaderPeim/ElfLib/Elf64.h | 254 +++++
.../PayloadLoaderPeim/ElfLib/Elf64Lib.c | 460 ++++++++
.../PayloadLoaderPeim/ElfLib/ElfCommon.h | 983 ++++++++++++++++++
.../PayloadLoaderPeim/ElfLib/ElfLib.c | 473 +++++++++
.../PayloadLoaderPeim/ElfLib/ElfLibInternal.h | 109 ++
.../PayloadLoaderPeim/PayloadLoaderPeim.c | 187 ++++
.../PayloadLoaderPeim/PayloadLoaderPeim.inf | 59 ++
10 files changed, 3350 insertions(+)
create mode 100644 UefiPayloadPkg/PayloadLoaderPeim/ElfLib.h
create mode 100644 UefiPayloadPkg/PayloadLoaderPeim/ElfLib/Elf32.h
create mode 100644 UefiPayloadPkg/PayloadLoaderPeim/ElfLib/Elf32Lib.c
create mode 100644 UefiPayloadPkg/PayloadLoaderPeim/ElfLib/Elf64.h
create mode 100644 UefiPayloadPkg/PayloadLoaderPeim/ElfLib/Elf64Lib.c
create mode 100644 UefiPayloadPkg/PayloadLoaderPeim/ElfLib/ElfCommon.h
create mode 100644 UefiPayloadPkg/PayloadLoaderPeim/ElfLib/ElfLib.c
create mode 100644 UefiPayloadPkg/PayloadLoaderPeim/ElfLib/ElfLibInternal.h
create mode 100644 UefiPayloadPkg/PayloadLoaderPeim/PayloadLoaderPeim.c
create mode 100644 UefiPayloadPkg/PayloadLoaderPeim/PayloadLoaderPeim.inf

diff --git a/UefiPayloadPkg/PayloadLoaderPeim/ElfLib.h b/UefiPayloadPkg/Pay=
loadLoaderPeim/ElfLib.h
new file mode 100644
index 0000000000..9cfc2912cf
--- /dev/null
+++ b/UefiPayloadPkg/PayloadLoaderPeim/ElfLib.h
@@ -0,0 +1,122 @@
+/** @file=0D
+ ELF library=0D
+=0D
+ Copyright (c) 2018 - 2021, Intel Corporation. All rights reserved.<BR>=0D
+ SPDX-License-Identifier: BSD-2-Clause-Patent=0D
+=0D
+**/=0D
+=0D
+#ifndef ELF_LIB_H_=0D
+#define ELF_LIB_H_=0D
+=0D
+#include <PiPei.h>=0D
+=0D
+#define ELF_CLASS32 1=0D
+#define ELF_CLASS64 2=0D
+=0D
+#define ELF_PT_LOAD 1=0D
+=0D
+typedef struct {=0D
+ RETURN_STATUS ParseStatus; ///< Return the status after Pars=
eElfImage().=0D
+ UINT8 *FileBase; ///< The source location in memor=
y.=0D
+ UINTN FileSize; ///< The size including sections =
that don't require loading.=0D
+ UINT8 *PreferredImageAddress; ///< The preferred image to be lo=
aded. No relocation is needed if loaded to this address.=0D
+ BOOLEAN ReloadRequired; ///< The image needs a new memory=
location for running.=0D
+ UINT8 *ImageAddress; ///< The destination memory addre=
ss set by caller.=0D
+ UINTN ImageSize; ///< The memory size for loading =
and execution.=0D
+ UINT32 EiClass;=0D
+ UINT32 ShNum;=0D
+ UINT32 PhNum;=0D
+ UINTN ShStrOff;=0D
+ UINTN ShStrLen;=0D
+ UINTN EntryPoint; ///< Return the actual entry poin=
t after LoadElfImage().=0D
+} ELF_IMAGE_CONTEXT;=0D
+=0D
+=0D
+typedef struct {=0D
+ UINT32 PtType;=0D
+ UINTN Offset;=0D
+ UINTN Length;=0D
+ UINTN MemLen;=0D
+ UINTN MemAddr;=0D
+ UINTN Alignment;=0D
+} SEGMENT_INFO;=0D
+=0D
+/**=0D
+ Parse the ELF image info.=0D
+=0D
+ @param[in] ImageBase Memory address of an image.=0D
+ @param[out] ElfCt The EFL image context pointer.=0D
+=0D
+ @retval EFI_INVALID_PARAMETER Input parameters are not valid.=0D
+ @retval EFI_UNSUPPORTED Unsupported binary type.=0D
+ @retval EFI_LOAD_ERROR ELF binary loading error.=0D
+ @retval EFI_SUCCESS ELF binary is loaded successfully.=0D
+**/=0D
+EFI_STATUS=0D
+EFIAPI=0D
+ParseElfImage (=0D
+ IN VOID *ImageBase,=0D
+ OUT ELF_IMAGE_CONTEXT *ElfCt=0D
+ );=0D
+=0D
+/**=0D
+ Load the ELF segments to specified address in ELF header.=0D
+=0D
+ This function loads ELF image segments into memory address specified=0D
+ in ELF program header.=0D
+=0D
+ @param[in] ElfCt ELF image context pointer.=0D
+=0D
+ @retval EFI_INVALID_PARAMETER Input parameters are not valid.=0D
+ @retval EFI_UNSUPPORTED Unsupported binary type.=0D
+ @retval EFI_LOAD_ERROR ELF binary loading error.=0D
+ @retval EFI_SUCCESS ELF binary is loaded successfully.=0D
+**/=0D
+EFI_STATUS=0D
+EFIAPI=0D
+LoadElfImage (=0D
+ IN ELF_IMAGE_CONTEXT *ElfCt=0D
+ );=0D
+=0D
+/**=0D
+ Get a ELF section name from its index.=0D
+=0D
+ @param[in] ElfCt ELF image context pointer.=0D
+ @param[in] SectionIndex ELF section index.=0D
+ @param[out] SectionName The pointer to the section name.=0D
+=0D
+ @retval EFI_INVALID_PARAMETER ElfCt or SecName is NULL.=0D
+ @retval EFI_NOT_FOUND Could not find the section.=0D
+ @retval EFI_SUCCESS Section name was filled successfully.=0D
+**/=0D
+EFI_STATUS=0D
+EFIAPI=0D
+GetElfSectionName (=0D
+ IN ELF_IMAGE_CONTEXT *ElfCt,=0D
+ IN UINT32 SectionIndex,=0D
+ OUT CHAR8 **SectionName=0D
+ );=0D
+=0D
+/**=0D
+ Get the offset and size of x-th ELF section.=0D
+=0D
+ @param[in] ElfCt ELF image context pointer.=0D
+ @param[in] Index ELF section index.=0D
+ @param[out] Offset Return the offset of the specific sectio=
n.=0D
+ @param[out] Size Return the size of the specific section.=
=0D
+=0D
+ @retval EFI_INVALID_PARAMETER ImageBase, Offset or Size is NULL.=0D
+ @retval EFI_INVALID_PARAMETER EiClass doesn't equal to ELFCLASS32 or E=
LFCLASS64.=0D
+ @retval EFI_NOT_FOUND Could not find the section.=0D
+ @retval EFI_SUCCESS Offset and Size are returned.=0D
+**/=0D
+EFI_STATUS=0D
+EFIAPI=0D
+GetElfSectionPos (=0D
+ IN ELF_IMAGE_CONTEXT *ElfCt,=0D
+ IN UINT32 Index,=0D
+ OUT UINTN *Offset,=0D
+ OUT UINTN *Size=0D
+ );=0D
+#endif /* ELF_LIB_H_ */=0D
diff --git a/UefiPayloadPkg/PayloadLoaderPeim/ElfLib/Elf32.h b/UefiPayloadP=
kg/PayloadLoaderPeim/ElfLib/Elf32.h
new file mode 100644
index 0000000000..ebed5f00c3
--- /dev/null
+++ b/UefiPayloadPkg/PayloadLoaderPeim/ElfLib/Elf32.h
@@ -0,0 +1,252 @@
+/** @file=0D
+Ported ELF include files from FreeBSD=0D
+=0D
+Copyright (c) 2009 - 2010, Apple Inc. All rights reserved.<BR>=0D
+SPDX-License-Identifier: BSD-2-Clause-Patent=0D
+=0D
+=0D
+**/=0D
+/*-=0D
+ * Copyright (c) 1996-1998 John D. Polstra.=0D
+ * All rights reserved.=0D
+ *=0D
+ * Redistribution and use in source and binary forms, with or without=0D
+ * modification, are permitted provided that the following conditions=0D
+ * are met:=0D
+ * 1. Redistributions of source code must retain the above copyright=0D
+ * notice, this list of conditions and the following disclaimer.=0D
+ * 2. Redistributions in binary form must reproduce the above copyright=0D
+ * notice, this list of conditions and the following disclaimer in the=
=0D
+ * documentation and/or other materials provided with the distribution.=
=0D
+ *=0D
+ * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND=
=0D
+ * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE=0D
+ * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURP=
OSE=0D
+ * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE=
=0D
+ * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENT=
IAL=0D
+ * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS=
=0D
+ * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)=0D
+ * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STR=
ICT=0D
+ * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY W=
AY=0D
+ * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF=
=0D
+ * SUCH DAMAGE.=0D
+ *=0D
+ * $FreeBSD: src/sys/sys/elf32.h,v 1.8.14.2 2007/12/03 21:30:36 marius Exp=
$=0D
+ */=0D
+=0D
+#ifndef _SYS_ELF32_H_=0D
+#define _SYS_ELF32_H_ 1=0D
+=0D
+=0D
+/*=0D
+ * ELF definitions common to all 32-bit architectures.=0D
+ */=0D
+=0D
+typedef UINT32 Elf32_Addr;=0D
+typedef UINT16 Elf32_Half;=0D
+typedef UINT32 Elf32_Off;=0D
+typedef INT32 Elf32_Sword;=0D
+typedef UINT32 Elf32_Word;=0D
+typedef UINT64 Elf32_Lword;=0D
+=0D
+typedef Elf32_Word Elf32_Hashelt;=0D
+=0D
+/* Non-standard class-dependent datatype used for abstraction. */=0D
+typedef Elf32_Word Elf32_Size;=0D
+typedef Elf32_Sword Elf32_Ssize;=0D
+=0D
+/*=0D
+ * ELF header.=0D
+ */=0D
+=0D
+typedef struct {=0D
+ unsigned char e_ident[EI_NIDENT]; /* File identification. */=0D
+ Elf32_Half e_type; /* File type. */=0D
+ Elf32_Half e_machine; /* Machine architecture. */=0D
+ Elf32_Word e_version; /* ELF format version. */=0D
+ Elf32_Addr e_entry; /* Entry point. */=0D
+ Elf32_Off e_phoff; /* Program header file offset. */=0D
+ Elf32_Off e_shoff; /* Section header file offset. */=0D
+ Elf32_Word e_flags; /* Architecture-specific flags. */=0D
+ Elf32_Half e_ehsize; /* Size of ELF header in bytes. */=0D
+ Elf32_Half e_phentsize; /* Size of program header entry. */=0D
+ Elf32_Half e_phnum; /* Number of program header entries. */=0D
+ Elf32_Half e_shentsize; /* Size of section header entry. */=0D
+ Elf32_Half e_shnum; /* Number of section header entries. */=0D
+ Elf32_Half e_shstrndx; /* Section name strings section. */=0D
+} Elf32_Ehdr;=0D
+=0D
+/*=0D
+ * Section header.=0D
+ */=0D
+=0D
+typedef struct {=0D
+ Elf32_Word sh_name; /* Section name (index into the=0D
+ section header string table). */=0D
+ Elf32_Word sh_type; /* Section type. */=0D
+ Elf32_Word sh_flags; /* Section flags. */=0D
+ Elf32_Addr sh_addr; /* Address in memory image. */=0D
+ Elf32_Off sh_offset; /* Offset in file. */=0D
+ Elf32_Word sh_size; /* Size in bytes. */=0D
+ Elf32_Word sh_link; /* Index of a related section. */=0D
+ Elf32_Word sh_info; /* Depends on section type. */=0D
+ Elf32_Word sh_addralign; /* Alignment in bytes. */=0D
+ Elf32_Word sh_entsize; /* Size of each entry in section. */=0D
+} Elf32_Shdr;=0D
+=0D
+/*=0D
+ * Program header.=0D
+ */=0D
+=0D
+typedef struct {=0D
+ Elf32_Word p_type; /* Entry type. */=0D
+ Elf32_Off p_offset; /* File offset of contents. */=0D
+ Elf32_Addr p_vaddr; /* Virtual address in memory image. */=0D
+ Elf32_Addr p_paddr; /* Physical address (not used). */=0D
+ Elf32_Word p_filesz; /* Size of contents in file. */=0D
+ Elf32_Word p_memsz; /* Size of contents in memory. */=0D
+ Elf32_Word p_flags; /* Access permission flags. */=0D
+ Elf32_Word p_align; /* Alignment in memory and file. */=0D
+} Elf32_Phdr;=0D
+=0D
+/*=0D
+ * Dynamic structure. The ".dynamic" section contains an array of them.=0D
+ */=0D
+=0D
+typedef struct {=0D
+ Elf32_Sword d_tag; /* Entry type. */=0D
+ union {=0D
+ Elf32_Word d_val; /* Integer value. */=0D
+ Elf32_Addr d_ptr; /* Address value. */=0D
+ } d_un;=0D
+} Elf32_Dyn;=0D
+=0D
+/*=0D
+ * Relocation entries.=0D
+ */=0D
+=0D
+/* Relocations that don't need an addend field. */=0D
+typedef struct {=0D
+ Elf32_Addr r_offset; /* Location to be relocated. */=0D
+ Elf32_Word r_info; /* Relocation type and symbol index. */=0D
+} Elf32_Rel;=0D
+=0D
+/* Relocations that need an addend field. */=0D
+typedef struct {=0D
+ Elf32_Addr r_offset; /* Location to be relocated. */=0D
+ Elf32_Word r_info; /* Relocation type and symbol index. */=0D
+ Elf32_Sword r_addend; /* Addend. */=0D
+} Elf32_Rela;=0D
+=0D
+/* Macros for accessing the fields of r_info. */=0D
+#define ELF32_R_SYM(info) ((info) >> 8)=0D
+#define ELF32_R_TYPE(info) ((unsigned char)(info))=0D
+=0D
+/* Macro for constructing r_info from field values. */=0D
+#define ELF32_R_INFO(sym, type) (((sym) << 8) + (unsigned char)(type))=0D
+=0D
+/*=0D
+ * Note entry header=0D
+ */=0D
+typedef Elf_Note Elf32_Nhdr;=0D
+=0D
+/*=0D
+ * Move entry=0D
+ */=0D
+typedef struct {=0D
+ Elf32_Lword m_value; /* symbol value */=0D
+ Elf32_Word m_info; /* size + index */=0D
+ Elf32_Word m_poffset; /* symbol offset */=0D
+ Elf32_Half m_repeat; /* repeat count */=0D
+ Elf32_Half m_stride; /* stride info */=0D
+} Elf32_Move;=0D
+=0D
+/*=0D
+ * The macros compose and decompose values for Move.r_info=0D
+ *=0D
+ * sym =3D ELF32_M_SYM(M.m_info)=0D
+ * size =3D ELF32_M_SIZE(M.m_info)=0D
+ * M.m_info =3D ELF32_M_INFO(sym, size)=0D
+ */=0D
+#define ELF32_M_SYM(info) ((info)>>8)=0D
+#define ELF32_M_SIZE(info) ((unsigned char)(info))=0D
+#define ELF32_M_INFO(sym, size) (((sym)<<8)+(unsigned char)(size))=0D
+=0D
+/*=0D
+ * Hardware/Software capabilities entry=0D
+ */=0D
+typedef struct {=0D
+ Elf32_Word c_tag; /* how to interpret value */=0D
+ union {=0D
+ Elf32_Word c_val;=0D
+ Elf32_Addr c_ptr;=0D
+ } c_un;=0D
+} Elf32_Cap;=0D
+=0D
+/*=0D
+ * Symbol table entries.=0D
+ */=0D
+=0D
+typedef struct {=0D
+ Elf32_Word st_name; /* String table index of name. */=0D
+ Elf32_Addr st_value; /* Symbol value. */=0D
+ Elf32_Word st_size; /* Size of associated object. */=0D
+ unsigned char st_info; /* Type and binding information. */=0D
+ unsigned char st_other; /* Reserved (not used). */=0D
+ Elf32_Half st_shndx; /* Section index of symbol. */=0D
+} Elf32_Sym;=0D
+=0D
+/* Macros for accessing the fields of st_info. */=0D
+#define ELF32_ST_BIND(info) ((info) >> 4)=0D
+#define ELF32_ST_TYPE(info) ((info) & 0xf)=0D
+=0D
+/* Macro for constructing st_info from field values. */=0D
+#define ELF32_ST_INFO(bind, type) (((bind) << 4) + ((type) & 0xf))=0D
+=0D
+/* Macro for accessing the fields of st_other. */=0D
+#define ELF32_ST_VISIBILITY(oth) ((oth) & 0x3)=0D
+=0D
+/* Structures used by Sun & GNU symbol versioning. */=0D
+typedef struct=0D
+{=0D
+ Elf32_Half vd_version;=0D
+ Elf32_Half vd_flags;=0D
+ Elf32_Half vd_ndx;=0D
+ Elf32_Half vd_cnt;=0D
+ Elf32_Word vd_hash;=0D
+ Elf32_Word vd_aux;=0D
+ Elf32_Word vd_next;=0D
+} Elf32_Verdef;=0D
+=0D
+typedef struct=0D
+{=0D
+ Elf32_Word vda_name;=0D
+ Elf32_Word vda_next;=0D
+} Elf32_Verdaux;=0D
+=0D
+typedef struct=0D
+{=0D
+ Elf32_Half vn_version;=0D
+ Elf32_Half vn_cnt;=0D
+ Elf32_Word vn_file;=0D
+ Elf32_Word vn_aux;=0D
+ Elf32_Word vn_next;=0D
+} Elf32_Verneed;=0D
+=0D
+typedef struct=0D
+{=0D
+ Elf32_Word vna_hash;=0D
+ Elf32_Half vna_flags;=0D
+ Elf32_Half vna_other;=0D
+ Elf32_Word vna_name;=0D
+ Elf32_Word vna_next;=0D
+} Elf32_Vernaux;=0D
+=0D
+typedef Elf32_Half Elf32_Versym;=0D
+=0D
+typedef struct {=0D
+ Elf32_Half si_boundto; /* direct bindings - symbol bound to */=0D
+ Elf32_Half si_flags; /* per symbol flags */=0D
+} Elf32_Syminfo;=0D
+=0D
+#endif /* !_SYS_ELF32_H_ */=0D
diff --git a/UefiPayloadPkg/PayloadLoaderPeim/ElfLib/Elf32Lib.c b/UefiPaylo=
adPkg/PayloadLoaderPeim/ElfLib/Elf32Lib.c
new file mode 100644
index 0000000000..3fa100ce4a
--- /dev/null
+++ b/UefiPayloadPkg/PayloadLoaderPeim/ElfLib/Elf32Lib.c
@@ -0,0 +1,451 @@
+/** @file=0D
+ ELF library=0D
+=0D
+ Copyright (c) 2019 - 2021, Intel Corporation. All rights reserved.<BR>=0D
+ SPDX-License-Identifier: BSD-2-Clause-Patent=0D
+=0D
+**/=0D
+=0D
+#include "ElfLibInternal.h"=0D
+=0D
+/**=0D
+ Return the section header specified by Index.=0D
+=0D
+ @param ImageBase The image base.=0D
+ @param Index The section index.=0D
+=0D
+ @return Pointer to the section header.=0D
+**/=0D
+Elf32_Shdr *=0D
+GetElf32SectionByIndex (=0D
+ IN UINT8 *ImageBase,=0D
+ IN UINT32 Index=0D
+ )=0D
+{=0D
+ Elf32_Ehdr *Ehdr;=0D
+=0D
+ Ehdr =3D (Elf32_Ehdr *)ImageBase;=0D
+ if (Index >=3D Ehdr->e_shnum) {=0D
+ return NULL;=0D
+ }=0D
+=0D
+ return (Elf32_Shdr *)(ImageBase + Ehdr->e_shoff + Index * Ehdr->e_shents=
ize);=0D
+}=0D
+=0D
+/**=0D
+ Return the segment header specified by Index.=0D
+=0D
+ @param ImageBase The image base.=0D
+ @param Index The segment index.=0D
+=0D
+ @return Pointer to the segment header.=0D
+**/=0D
+Elf32_Phdr *=0D
+GetElf32SegmentByIndex (=0D
+ IN UINT8 *ImageBase,=0D
+ IN UINT32 Index=0D
+ )=0D
+{=0D
+ Elf32_Ehdr *Ehdr;=0D
+=0D
+ Ehdr =3D (Elf32_Ehdr *)ImageBase;=0D
+ if (Index >=3D Ehdr->e_phnum) {=0D
+ return NULL;=0D
+ }=0D
+=0D
+ return (Elf32_Phdr *)(ImageBase + Ehdr->e_phoff + Index * Ehdr->e_phents=
ize);=0D
+}=0D
+=0D
+/**=0D
+ Return the section header specified by the range.=0D
+=0D
+ @param ImageBase The image base.=0D
+ @param Offset The section offset.=0D
+ @param Size The section size.=0D
+=0D
+ @return Pointer to the section header.=0D
+**/=0D
+Elf32_Shdr *=0D
+GetElf32SectionByRange (=0D
+ IN UINT8 *ImageBase,=0D
+ IN UINT32 Offset,=0D
+ IN UINT32 Size=0D
+ )=0D
+{=0D
+ UINT32 Index;=0D
+ Elf32_Ehdr *Ehdr;=0D
+ Elf32_Shdr *Shdr;=0D
+=0D
+ Ehdr =3D (Elf32_Ehdr *)ImageBase;=0D
+=0D
+ Shdr =3D (Elf32_Shdr *) (ImageBase + Ehdr->e_shoff);=0D
+ for (Index =3D 0; Index < Ehdr->e_shnum; Index++) {=0D
+ if ((Shdr->sh_offset =3D=3D Offset) && (Shdr->sh_size =3D=3D Size)) {=
=0D
+ return Shdr;=0D
+ }=0D
+ Shdr =3D ELF_NEXT_ENTRY (Elf32_Shdr, Shdr, Ehdr->e_shentsize);=0D
+ }=0D
+ return NULL;=0D
+}=0D
+=0D
+/**=0D
+ Fix up the image based on the relocation entries.=0D
+=0D
+ @param Rela Relocation entries.=0D
+ @param RelaSize Total size of relocation entries.=0D
+ @param RelaEntrySize Relocation entry size.=0D
+ @param RelaType Type of relocation entry.=0D
+ @param Delta The delta between preferred image base and th=
e actual image base.=0D
+ @param DynamicLinking TRUE when fixing up according to dynamic relo=
cation.=0D
+=0D
+ @retval EFI_SUCCESS The image fix up is processed successfully.=0D
+**/=0D
+EFI_STATUS=0D
+ProcessRelocation32 (=0D
+ IN Elf32_Rela *Rela,=0D
+ IN UINT32 RelaSize,=0D
+ IN UINT32 RelaEntrySize,=0D
+ IN UINT32 RelaType,=0D
+ IN INTN Delta,=0D
+ IN BOOLEAN DynamicLinking=0D
+ )=0D
+{=0D
+ UINTN Index;=0D
+ UINT32 *Ptr;=0D
+ UINT32 Type;=0D
+=0D
+ for ( Index =3D 0=0D
+ ; RelaEntrySize * Index < RelaSize=0D
+ ; Index++, Rela =3D ELF_NEXT_ENTRY (Elf32_Rela, Rela, RelaEntrySize)=
=0D
+ ) {=0D
+ //=0D
+ // r_offset is the virtual address of the storage unit affected by the=
relocation.=0D
+ //=0D
+ Ptr =3D (UINT32 *)(UINTN)(Rela->r_offset + Delta);=0D
+ Type =3D ELF32_R_TYPE(Rela->r_info);=0D
+ switch (Type) {=0D
+ case R_386_NONE:=0D
+ case R_386_PC32:=0D
+ //=0D
+ // No fixup entry required.=0D
+ //=0D
+ break;=0D
+=0D
+ case R_386_32:=0D
+ if (DynamicLinking) {=0D
+ //=0D
+ // Dynamic section doesn't contain entries of this type.=0D
+ //=0D
+ DEBUG ((DEBUG_INFO, "Unsupported relocation type %02X\n", Type))=
;=0D
+ ASSERT (FALSE);=0D
+ } else {=0D
+ *Ptr +=3D (UINT32) Delta;=0D
+ }=0D
+ break;=0D
+=0D
+ case R_386_RELATIVE:=0D
+ if (DynamicLinking) {=0D
+ //=0D
+ // A: Represents the addend used to compute the value of the rel=
ocatable field.=0D
+ // B: Represents the base address at which a shared object has b=
een loaded into memory during execution.=0D
+ // Generally, a shared object is built with a 0 base virtual =
address, but the execution address will be different.=0D
+ //=0D
+ // B (Base Address) in ELF spec is slightly different:=0D
+ // An executable or shared object file's base address (on plat=
forms that support the concept) is calculated during=0D
+ // execution from three values: the virtual memory load addres=
s, the maximum page size, and the lowest virtual address=0D
+ // of a program's loadable segment. To compute the base addres=
s, one determines the memory address associated with the=0D
+ // lowest p_vaddr value for a PT_LOAD segment. This address is=
truncated to the nearest multiple of the maximum page size.=0D
+ // The corresponding p_vaddr value itself is also truncated to=
the nearest multiple of the maximum page size.=0D
+ //=0D
+ // *** The base address is the difference between the truncate=
d memory address and the truncated p_vaddr value. ***=0D
+ //=0D
+ // Delta in this function is B.=0D
+ //=0D
+ // Calculation: B + A=0D
+ //=0D
+ if (RelaType =3D=3D SHT_RELA) {=0D
+ ASSERT (*Ptr =3D=3D 0);=0D
+ *Ptr =3D (UINT32) Delta + Rela->r_addend;=0D
+ } else {=0D
+ //=0D
+ // A is stored in the field of relocation for REL type.=0D
+ //=0D
+ *Ptr =3D (UINT32) Delta + *Ptr;=0D
+ }=0D
+ } else {=0D
+ //=0D
+ // non-Dynamic section doesn't contain entries of this type.=0D
+ //=0D
+ DEBUG ((DEBUG_INFO, "Unsupported relocation type %02X\n", Type))=
;=0D
+ ASSERT (FALSE);=0D
+ }=0D
+ break;=0D
+=0D
+ default:=0D
+ DEBUG ((DEBUG_INFO, "Unsupported relocation type %02X\n", Type));=
=0D
+ }=0D
+ }=0D
+ return EFI_SUCCESS;=0D
+}=0D
+=0D
+/**=0D
+ Relocate the DYN type image.=0D
+=0D
+ @param ElfCt Point to image context.=0D
+=0D
+ @retval EFI_SUCCESS The relocation succeeds.=0D
+ @retval EFI_UNSUPPORTED The image doesn't contain a dynamic section.=0D
+**/=0D
+EFI_STATUS=0D
+RelocateElf32Dynamic (=0D
+ IN ELF_IMAGE_CONTEXT *ElfCt=0D
+ )=0D
+{=0D
+ UINT32 Index;=0D
+ Elf32_Phdr *Phdr;=0D
+ Elf32_Shdr *DynShdr;=0D
+ Elf32_Shdr *RelShdr;=0D
+ Elf32_Dyn *Dyn;=0D
+ UINT32 RelaOffset;=0D
+ UINT32 RelaCount;=0D
+ UINT32 RelaSize;=0D
+ UINT32 RelaEntrySize;=0D
+ UINT32 RelaType;=0D
+=0D
+ //=0D
+ // 1. Locate the dynamic section.=0D
+ //=0D
+ // If an object file participates in dynamic linking, its program header=
table=0D
+ // will have an element of type PT_DYNAMIC.=0D
+ // This ``segment'' contains the .dynamic section. A special symbol, _DY=
NAMIC,=0D
+ // labels the section, which contains an array of Elf32_Dyn or Elf64_Dyn=
.=0D
+ //=0D
+ DynShdr =3D NULL;=0D
+ for (Index =3D 0; Index < ElfCt->PhNum; Index++) {=0D
+ Phdr =3D GetElf32SegmentByIndex (ElfCt->FileBase, Index);=0D
+ ASSERT (Phdr !=3D NULL);=0D
+ if (Phdr->p_type =3D=3D PT_DYNAMIC) {=0D
+ //=0D
+ // Verify the existence of the dynamic section.=0D
+ //=0D
+ DynShdr =3D GetElf32SectionByRange (ElfCt->FileBase, Phdr->p_offset,=
Phdr->p_filesz);=0D
+ break;=0D
+ }=0D
+ }=0D
+=0D
+ //=0D
+ // It's abnormal a DYN ELF doesn't contain a dynamic section.=0D
+ //=0D
+ ASSERT (DynShdr !=3D NULL);=0D
+ if (DynShdr =3D=3D NULL) {=0D
+ return EFI_UNSUPPORTED;=0D
+ }=0D
+ ASSERT (DynShdr->sh_type =3D=3D SHT_DYNAMIC);=0D
+ ASSERT (DynShdr->sh_entsize >=3D sizeof (*Dyn));=0D
+=0D
+ //=0D
+ // 2. Locate the relocation section from the dynamic section.=0D
+ //=0D
+ RelaOffset =3D MAX_UINT32;=0D
+ RelaSize =3D 0;=0D
+ RelaCount =3D 0;=0D
+ RelaEntrySize =3D 0;=0D
+ RelaType =3D 0;=0D
+ for ( Index =3D 0, Dyn =3D (Elf32_Dyn *) (ElfCt->FileBase + DynShdr->sh_=
offset)=0D
+ ; Index < DynShdr->sh_size / DynShdr->sh_entsize=0D
+ ; Index++, Dyn =3D ELF_NEXT_ENTRY (Elf32_Dyn, Dyn, DynShdr->sh_entsi=
ze)=0D
+ ) {=0D
+ switch (Dyn->d_tag) {=0D
+ case DT_RELA:=0D
+ case DT_REL:=0D
+ //=0D
+ // DT_REL represent program virtual addresses.=0D
+ // A file's virtual addresses might not match the memory virtual a=
ddresses during execution.=0D
+ // When interpreting addresses contained in the dynamic structure,=
the dynamic linker computes actual addresses,=0D
+ // based on the original file value and the memory base address.=0D
+ // For consistency, files do not contain relocation entries to ``c=
orrect'' addresses in the dynamic structure.=0D
+ //=0D
+ RelaOffset =3D Dyn->d_un.d_ptr - (UINT32) (UINTN) ElfCt->Preferred=
ImageAddress;=0D
+ RelaType =3D (Dyn->d_tag =3D=3D DT_RELA) ? SHT_RELA: SHT_REL;=0D
+ break;=0D
+ case DT_RELACOUNT:=0D
+ case DT_RELCOUNT:=0D
+ RelaCount =3D Dyn->d_un.d_val;=0D
+ break;=0D
+ case DT_RELENT:=0D
+ case DT_RELAENT:=0D
+ RelaEntrySize =3D Dyn->d_un.d_val;=0D
+ break;=0D
+ case DT_RELSZ:=0D
+ case DT_RELASZ:=0D
+ RelaSize =3D Dyn->d_un.d_val;=0D
+ break;=0D
+ default:=0D
+ break;=0D
+ }=0D
+ }=0D
+=0D
+ if (RelaOffset =3D=3D MAX_UINT64) {=0D
+ ASSERT (RelaCount =3D=3D 0);=0D
+ ASSERT (RelaEntrySize =3D=3D 0);=0D
+ ASSERT (RelaSize =3D=3D 0);=0D
+ //=0D
+ // It's fine that a DYN ELF doesn't contain relocation section.=0D
+ //=0D
+ return EFI_SUCCESS;=0D
+ }=0D
+=0D
+ //=0D
+ // Verify the existence of the relocation section.=0D
+ //=0D
+ RelShdr =3D GetElf32SectionByRange (ElfCt->FileBase, RelaOffset, RelaSiz=
e);=0D
+ ASSERT (RelShdr !=3D NULL);=0D
+ if (RelShdr =3D=3D NULL) {=0D
+ return EFI_UNSUPPORTED;=0D
+ }=0D
+ ASSERT (RelShdr->sh_type =3D=3D RelaType);=0D
+ ASSERT (RelShdr->sh_entsize =3D=3D RelaEntrySize);=0D
+=0D
+ //=0D
+ // 3. Process the relocation section.=0D
+ //=0D
+ ProcessRelocation32 (=0D
+ (Elf32_Rela *) (ElfCt->FileBase + RelShdr->sh_offset),=0D
+ RelShdr->sh_size, RelShdr->sh_entsize, RelShdr->sh_type,=0D
+ (UINTN) ElfCt->ImageAddress - (UINTN) ElfCt->PreferredImageAddress,=0D
+ TRUE=0D
+ );=0D
+ return EFI_SUCCESS;=0D
+}=0D
+=0D
+/**=0D
+ Relocate all sections in a ELF image.=0D
+=0D
+ @param[in] ElfCt ELF image context pointer.=0D
+=0D
+ @retval EFI_UNSUPPORTED Relocation is not supported.=0D
+ @retval EFI_SUCCESS ELF image was relocated successfully.=0D
+**/=0D
+EFI_STATUS=0D
+RelocateElf32Sections (=0D
+ IN ELF_IMAGE_CONTEXT *ElfCt=0D
+ )=0D
+{=0D
+ EFI_STATUS Status;=0D
+ Elf32_Ehdr *Ehdr;=0D
+ Elf32_Shdr *RelShdr;=0D
+ Elf32_Shdr *Shdr;=0D
+ UINT32 Index;=0D
+ UINTN Delta;=0D
+=0D
+ Ehdr =3D (Elf32_Ehdr *)ElfCt->FileBase;=0D
+ if (Ehdr->e_machine !=3D EM_386) {=0D
+ return EFI_UNSUPPORTED;=0D
+ }=0D
+=0D
+ Delta =3D (UINTN) ElfCt->ImageAddress - (UINTN) ElfCt->PreferredImageAdd=
ress;=0D
+ ElfCt->EntryPoint =3D (UINTN)(Ehdr->e_entry + Delta);=0D
+=0D
+ //=0D
+ // 1. Relocate dynamic ELF using the relocation section pointed by dynam=
ic section=0D
+ //=0D
+ if (Ehdr->e_type =3D=3D ET_DYN) {=0D
+ DEBUG ((DEBUG_INFO, "DYN ELF: Relocate using dynamic sections...\n"));=
=0D
+ Status =3D RelocateElf32Dynamic (ElfCt);=0D
+ ASSERT_EFI_ERROR (Status);=0D
+ return Status;=0D
+ }=0D
+=0D
+ //=0D
+ // 2. Executable ELF: Fix up the delta between actual image address and =
preferred image address.=0D
+ //=0D
+ // Linker already fixed up EXEC ELF based on the preferred image addres=
s.=0D
+ // A ELF loader in modern OS only loads it into the preferred image add=
ress.=0D
+ // The below relocation is unneeded in that case.=0D
+ // But the ELF loader in firmware supports to load the image to a diffe=
rent address.=0D
+ // The below relocation is needed in this case.=0D
+ //=0D
+ DEBUG ((DEBUG_INFO, "EXEC ELF: Fix actual/preferred base address delta .=
..\n"));=0D
+ for ( Index =3D 0, RelShdr =3D (Elf32_Shdr *) (ElfCt->FileBase + Ehdr->e=
_shoff)=0D
+ ; Index < Ehdr->e_shnum=0D
+ ; Index++, RelShdr =3D ELF_NEXT_ENTRY (Elf32_Shdr, RelShdr, Ehdr->=
e_shentsize)=0D
+ ) {=0D
+ if ((RelShdr->sh_type !=3D SHT_REL) && (RelShdr->sh_type !=3D SHT_RELA=
)) {=0D
+ continue;=0D
+ }=0D
+ Shdr =3D GetElf32SectionByIndex (ElfCt->FileBase, RelShdr->sh_info);=0D
+ if ((Shdr->sh_flags & SHF_ALLOC) =3D=3D SHF_ALLOC) {=0D
+ //=0D
+ // Only fix up sections that occupy memory during process execution.=
=0D
+ //=0D
+ ProcessRelocation32 (=0D
+ (Elf32_Rela *)((UINT8*)Ehdr + RelShdr->sh_offset),=0D
+ RelShdr->sh_size, RelShdr->sh_entsize, RelShdr->sh_type,=0D
+ Delta, FALSE=0D
+ );=0D
+ }=0D
+ }=0D
+=0D
+ return EFI_SUCCESS;=0D
+}=0D
+=0D
+/**=0D
+ Load ELF image which has 32-bit architecture.=0D
+=0D
+ Caller should set Context.ImageAddress to a proper value, either pointin=
g to=0D
+ a new allocated memory whose size equal to Context.ImageSize, or pointin=
g=0D
+ to Context.PreferredImageAddress.=0D
+=0D
+ @param[in] ElfCt ELF image context pointer.=0D
+=0D
+ @retval EFI_SUCCESS ELF binary is loaded successfully.=0D
+ @retval Others Loading ELF binary fails.=0D
+=0D
+**/=0D
+EFI_STATUS=0D
+LoadElf32Image (=0D
+ IN ELF_IMAGE_CONTEXT *ElfCt=0D
+ )=0D
+{=0D
+ Elf32_Ehdr *Ehdr;=0D
+ Elf32_Phdr *Phdr;=0D
+ UINT16 Index;=0D
+ UINTN Delta;=0D
+=0D
+ ASSERT (ElfCt !=3D NULL);=0D
+=0D
+ //=0D
+ // Per the sprit of ELF, loading to memory only consumes info from progr=
am headers.=0D
+ //=0D
+ Ehdr =3D (Elf32_Ehdr *)ElfCt->FileBase;=0D
+=0D
+ for ( Index =3D 0, Phdr =3D (Elf32_Phdr *)(ElfCt->FileBase + Ehdr->e_pho=
ff)=0D
+ ; Index < Ehdr->e_phnum=0D
+ ; Index++, Phdr =3D ELF_NEXT_ENTRY (Elf32_Phdr, Phdr, Ehdr->e_phents=
ize)=0D
+ ) {=0D
+ //=0D
+ // Skip segments that don't require load (type tells, or size is 0)=0D
+ //=0D
+ if ((Phdr->p_type !=3D PT_LOAD) ||=0D
+ (Phdr->p_memsz =3D=3D 0)) {=0D
+ continue;=0D
+ }=0D
+=0D
+ //=0D
+ // The memory offset of segment relative to the image base=0D
+ // Note: CopyMem() does nothing when the dst equals to src.=0D
+ //=0D
+ Delta =3D Phdr->p_paddr - (UINT32) (UINTN) ElfCt->PreferredImageAddres=
s;=0D
+ CopyMem (ElfCt->ImageAddress + Delta, ElfCt->FileBase + Phdr->p_offset=
, Phdr->p_filesz);=0D
+ ZeroMem (ElfCt->ImageAddress + Delta + Phdr->p_filesz, Phdr->p_memsz -=
Phdr->p_filesz);=0D
+ }=0D
+=0D
+ //=0D
+ // Relocate when new new image base is not the preferred image base.=0D
+ //=0D
+ if (ElfCt->ImageAddress !=3D ElfCt->PreferredImageAddress) {=0D
+ RelocateElf32Sections (ElfCt);=0D
+ }=0D
+=0D
+ return EFI_SUCCESS;=0D
+}=0D
diff --git a/UefiPayloadPkg/PayloadLoaderPeim/ElfLib/Elf64.h b/UefiPayloadP=
kg/PayloadLoaderPeim/ElfLib/Elf64.h
new file mode 100644
index 0000000000..d64dc64a6a
--- /dev/null
+++ b/UefiPayloadPkg/PayloadLoaderPeim/ElfLib/Elf64.h
@@ -0,0 +1,254 @@
+/** @file=0D
+Ported ELF include files from FreeBSD=0D
+=0D
+Copyright (c) 2009 - 2010, Apple Inc. All rights reserved.<BR>=0D
+SPDX-License-Identifier: BSD-2-Clause-Patent=0D
+=0D
+**/=0D
+/*-=0D
+ * Copyright (c) 1996-1998 John D. Polstra.=0D
+ * All rights reserved.=0D
+ *=0D
+ * Redistribution and use in source and binary forms, with or without=0D
+ * modification, are permitted provided that the following conditions=0D
+ * are met:=0D
+ * 1. Redistributions of source code must retain the above copyright=0D
+ * notice, this list of conditions and the following disclaimer.=0D
+ * 2. Redistributions in binary form must reproduce the above copyright=0D
+ * notice, this list of conditions and the following disclaimer in the=
=0D
+ * documentation and/or other materials provided with the distribution.=
=0D
+ *=0D
+ * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND=
=0D
+ * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE=0D
+ * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURP=
OSE=0D
+ * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE=
=0D
+ * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENT=
IAL=0D
+ * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS=
=0D
+ * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)=0D
+ * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STR=
ICT=0D
+ * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY W=
AY=0D
+ * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF=
=0D
+ * SUCH DAMAGE.=0D
+ *=0D
+ * $FreeBSD: src/sys/sys/elf64.h,v 1.10.14.2 2007/12/03 21:30:36 marius Ex=
p $=0D
+ */=0D
+=0D
+#ifndef _SYS_ELF64_H_=0D
+#define _SYS_ELF64_H_ 1=0D
+=0D
+=0D
+/*=0D
+ * ELF definitions common to all 64-bit architectures.=0D
+ */=0D
+=0D
+typedef UINT64 Elf64_Addr;=0D
+typedef UINT16 Elf64_Half;=0D
+typedef UINT64 Elf64_Off;=0D
+typedef INT32 Elf64_Sword;=0D
+typedef INT64 Elf64_Sxword;=0D
+typedef UINT32 Elf64_Word;=0D
+typedef UINT64 Elf64_Lword;=0D
+typedef UINT64 Elf64_Xword;=0D
+=0D
+/*=0D
+ * Types of dynamic symbol hash table bucket and chain elements.=0D
+ *=0D
+ * This is inconsistent among 64 bit architectures, so a machine dependent=
=0D
+ * typedef is required.=0D
+ */=0D
+=0D
+typedef Elf64_Word Elf64_Hashelt;=0D
+=0D
+/* Non-standard class-dependent datatype used for abstraction. */=0D
+typedef Elf64_Xword Elf64_Size;=0D
+typedef Elf64_Sxword Elf64_Ssize;=0D
+=0D
+/*=0D
+ * ELF header.=0D
+ */=0D
+=0D
+typedef struct {=0D
+ unsigned char e_ident[EI_NIDENT]; /* File identification. */=0D
+ Elf64_Half e_type; /* File type. */=0D
+ Elf64_Half e_machine; /* Machine architecture. */=0D
+ Elf64_Word e_version; /* ELF format version. */=0D
+ Elf64_Addr e_entry; /* Entry point. */=0D
+ Elf64_Off e_phoff; /* Program header file offset. */=0D
+ Elf64_Off e_shoff; /* Section header file offset. */=0D
+ Elf64_Word e_flags; /* Architecture-specific flags. */=0D
+ Elf64_Half e_ehsize; /* Size of ELF header in bytes. */=0D
+ Elf64_Half e_phentsize; /* Size of program header entry. */=0D
+ Elf64_Half e_phnum; /* Number of program header entries. */=0D
+ Elf64_Half e_shentsize; /* Size of section header entry. */=0D
+ Elf64_Half e_shnum; /* Number of section header entries. */=0D
+ Elf64_Half e_shstrndx; /* Section name strings section. */=0D
+} Elf64_Ehdr;=0D
+=0D
+/*=0D
+ * Section header.=0D
+ */=0D
+=0D
+typedef struct {=0D
+ Elf64_Word sh_name; /* Section name (index into the=0D
+ section header string table). */=0D
+ Elf64_Word sh_type; /* Section type. */=0D
+ Elf64_Xword sh_flags; /* Section flags. */=0D
+ Elf64_Addr sh_addr; /* Address in memory image. */=0D
+ Elf64_Off sh_offset; /* Offset in file. */=0D
+ Elf64_Xword sh_size; /* Size in bytes. */=0D
+ Elf64_Word sh_link; /* Index of a related section. */=0D
+ Elf64_Word sh_info; /* Depends on section type. */=0D
+ Elf64_Xword sh_addralign; /* Alignment in bytes. */=0D
+ Elf64_Xword sh_entsize; /* Size of each entry in section. */=0D
+} Elf64_Shdr;=0D
+=0D
+/*=0D
+ * Program header.=0D
+ */=0D
+=0D
+typedef struct {=0D
+ Elf64_Word p_type; /* Entry type. */=0D
+ Elf64_Word p_flags; /* Access permission flags. */=0D
+ Elf64_Off p_offset; /* File offset of contents. */=0D
+ Elf64_Addr p_vaddr; /* Virtual address in memory image. */=0D
+ Elf64_Addr p_paddr; /* Physical address (not used). */=0D
+ Elf64_Xword p_filesz; /* Size of contents in file. */=0D
+ Elf64_Xword p_memsz; /* Size of contents in memory. */=0D
+ Elf64_Xword p_align; /* Alignment in memory and file. */=0D
+} Elf64_Phdr;=0D
+=0D
+/*=0D
+ * Dynamic structure. The ".dynamic" section contains an array of them.=0D
+ */=0D
+=0D
+typedef struct {=0D
+ Elf64_Sxword d_tag; /* Entry type. */=0D
+ union {=0D
+ Elf64_Xword d_val; /* Integer value. */=0D
+ Elf64_Addr d_ptr; /* Address value. */=0D
+ } d_un;=0D
+} Elf64_Dyn;=0D
+=0D
+/*=0D
+ * Relocation entries.=0D
+ */=0D
+=0D
+/* Relocations that don't need an addend field. */=0D
+typedef struct {=0D
+ Elf64_Addr r_offset; /* Location to be relocated. */=0D
+ Elf64_Xword r_info; /* Relocation type and symbol index. */=0D
+} Elf64_Rel;=0D
+=0D
+/* Relocations that need an addend field. */=0D
+typedef struct {=0D
+ Elf64_Addr r_offset; /* Location to be relocated. */=0D
+ Elf64_Xword r_info; /* Relocation type and symbol index. */=0D
+ Elf64_Sxword r_addend; /* Addend. */=0D
+} Elf64_Rela;=0D
+=0D
+/* Macros for accessing the fields of r_info. */=0D
+#define ELF64_R_SYM(info) ((UINT32) RShiftU64 ((info), 32))=0D
+#define ELF64_R_TYPE(info) ((info) & 0xffffffffL)=0D
+=0D
+/* Macro for constructing r_info from field values. */=0D
+#define ELF64_R_INFO(sym, type) (((sym) << 32) + ((type) & 0xffffffffL))=
=0D
+=0D
+#define ELF64_R_TYPE_DATA(info) (((Elf64_Xword)(info)<<32)>>40)=0D
+#define ELF64_R_TYPE_ID(info) (((Elf64_Xword)(info)<<56)>>56)=0D
+#define ELF64_R_TYPE_INFO(data, type) \=0D
+ (((Elf64_Xword)(data)<<8)+(Elf64_Xword)(type))=0D
+=0D
+/*=0D
+ * Note entry header=0D
+ */=0D
+typedef Elf_Note Elf64_Nhdr;=0D
+=0D
+/*=0D
+ * Move entry=0D
+ */=0D
+typedef struct {=0D
+ Elf64_Lword m_value; /* symbol value */=0D
+ Elf64_Xword m_info; /* size + index */=0D
+ Elf64_Xword m_poffset; /* symbol offset */=0D
+ Elf64_Half m_repeat; /* repeat count */=0D
+ Elf64_Half m_stride; /* stride info */=0D
+} Elf64_Move;=0D
+=0D
+#define ELF64_M_SYM(info) ((info)>>8)=0D
+#define ELF64_M_SIZE(info) ((unsigned char)(info))=0D
+#define ELF64_M_INFO(sym, size) (((sym)<<8)+(unsigned char)(size))=0D
+=0D
+/*=0D
+ * Hardware/Software capabilities entry=0D
+ */=0D
+typedef struct {=0D
+ Elf64_Xword c_tag; /* how to interpret value */=0D
+ union {=0D
+ Elf64_Xword c_val;=0D
+ Elf64_Addr c_ptr;=0D
+ } c_un;=0D
+} Elf64_Cap;=0D
+=0D
+/*=0D
+ * Symbol table entries.=0D
+ */=0D
+=0D
+typedef struct {=0D
+ Elf64_Word st_name; /* String table index of name. */=0D
+ unsigned char st_info; /* Type and binding information. */=0D
+ unsigned char st_other; /* Reserved (not used). */=0D
+ Elf64_Half st_shndx; /* Section index of symbol. */=0D
+ Elf64_Addr st_value; /* Symbol value. */=0D
+ Elf64_Xword st_size; /* Size of associated object. */=0D
+} Elf64_Sym;=0D
+=0D
+/* Macros for accessing the fields of st_info. */=0D
+#define ELF64_ST_BIND(info) ((info) >> 4)=0D
+#define ELF64_ST_TYPE(info) ((info) & 0xf)=0D
+=0D
+/* Macro for constructing st_info from field values. */=0D
+#define ELF64_ST_INFO(bind, type) (((bind) << 4) + ((type) & 0xf))=0D
+=0D
+/* Macro for accessing the fields of st_other. */=0D
+#define ELF64_ST_VISIBILITY(oth) ((oth) & 0x3)=0D
+=0D
+/* Structures used by Sun & GNU-style symbol versioning. */=0D
+typedef struct {=0D
+ Elf64_Half vd_version;=0D
+ Elf64_Half vd_flags;=0D
+ Elf64_Half vd_ndx;=0D
+ Elf64_Half vd_cnt;=0D
+ Elf64_Word vd_hash;=0D
+ Elf64_Word vd_aux;=0D
+ Elf64_Word vd_next;=0D
+} Elf64_Verdef;=0D
+=0D
+typedef struct {=0D
+ Elf64_Word vda_name;=0D
+ Elf64_Word vda_next;=0D
+} Elf64_Verdaux;=0D
+=0D
+typedef struct {=0D
+ Elf64_Half vn_version;=0D
+ Elf64_Half vn_cnt;=0D
+ Elf64_Word vn_file;=0D
+ Elf64_Word vn_aux;=0D
+ Elf64_Word vn_next;=0D
+} Elf64_Verneed;=0D
+=0D
+typedef struct {=0D
+ Elf64_Word vna_hash;=0D
+ Elf64_Half vna_flags;=0D
+ Elf64_Half vna_other;=0D
+ Elf64_Word vna_name;=0D
+ Elf64_Word vna_next;=0D
+} Elf64_Vernaux;=0D
+=0D
+typedef Elf64_Half Elf64_Versym;=0D
+=0D
+typedef struct {=0D
+ Elf64_Half si_boundto; /* direct bindings - symbol bound to */=0D
+ Elf64_Half si_flags; /* per symbol flags */=0D
+} Elf64_Syminfo;=0D
+=0D
+#endif /* !_SYS_ELF64_H_ */=0D
diff --git a/UefiPayloadPkg/PayloadLoaderPeim/ElfLib/Elf64Lib.c b/UefiPaylo=
adPkg/PayloadLoaderPeim/ElfLib/Elf64Lib.c
new file mode 100644
index 0000000000..e364807007
--- /dev/null
+++ b/UefiPayloadPkg/PayloadLoaderPeim/ElfLib/Elf64Lib.c
@@ -0,0 +1,460 @@
+/** @file=0D
+ ELF library=0D
+=0D
+ Copyright (c) 2019 - 2021, Intel Corporation. All rights reserved.<BR>=0D
+ SPDX-License-Identifier: BSD-2-Clause-Patent=0D
+=0D
+**/=0D
+=0D
+#include "ElfLibInternal.h"=0D
+=0D
+/**=0D
+ Return the section header specified by Index.=0D
+=0D
+ @param ImageBase The image base.=0D
+ @param Index The section index.=0D
+=0D
+ @return Pointer to the section header.=0D
+**/=0D
+Elf64_Shdr *=0D
+GetElf64SectionByIndex (=0D
+ IN UINT8 *ImageBase,=0D
+ IN UINT32 Index=0D
+ )=0D
+{=0D
+ Elf64_Ehdr *Ehdr;=0D
+=0D
+ Ehdr =3D (Elf64_Ehdr *)ImageBase;=0D
+ if (Index >=3D Ehdr->e_shnum) {=0D
+ return NULL;=0D
+ }=0D
+=0D
+ return (Elf64_Shdr *)(ImageBase + Ehdr->e_shoff + Index * Ehdr->e_shents=
ize);=0D
+}=0D
+=0D
+/**=0D
+ Return the segment header specified by Index.=0D
+=0D
+ @param ImageBase The image base.=0D
+ @param Index The segment index.=0D
+=0D
+ @return Pointer to the segment header.=0D
+**/=0D
+Elf64_Phdr *=0D
+GetElf64SegmentByIndex (=0D
+ IN UINT8 *ImageBase,=0D
+ IN UINT32 Index=0D
+ )=0D
+{=0D
+ Elf64_Ehdr *Ehdr;=0D
+=0D
+ Ehdr =3D (Elf64_Ehdr *)ImageBase;=0D
+ if (Index >=3D Ehdr->e_phnum) {=0D
+ return NULL;=0D
+ }=0D
+=0D
+ return (Elf64_Phdr *)(ImageBase + Ehdr->e_phoff + Index * Ehdr->e_phents=
ize);=0D
+}=0D
+=0D
+/**=0D
+ Return the section header specified by the range.=0D
+=0D
+ @param ImageBase The image base.=0D
+ @param Offset The section offset.=0D
+ @param Size The section size.=0D
+=0D
+ @return Pointer to the section header.=0D
+**/=0D
+Elf64_Shdr *=0D
+GetElf64SectionByRange (=0D
+ IN UINT8 *ImageBase,=0D
+ IN UINT64 Offset,=0D
+ IN UINT64 Size=0D
+ )=0D
+{=0D
+ UINT32 Index;=0D
+ Elf64_Ehdr *Ehdr;=0D
+ Elf64_Shdr *Shdr;=0D
+=0D
+ Ehdr =3D (Elf64_Ehdr *)ImageBase;=0D
+=0D
+ Shdr =3D (Elf64_Shdr *) (ImageBase + Ehdr->e_shoff);=0D
+ for (Index =3D 0; Index < Ehdr->e_shnum; Index++) {=0D
+ if ((Shdr->sh_offset =3D=3D Offset) && (Shdr->sh_size =3D=3D Size)) {=
=0D
+ return Shdr;=0D
+ }=0D
+ Shdr =3D ELF_NEXT_ENTRY (Elf64_Shdr, Shdr, Ehdr->e_shentsize);=0D
+ }=0D
+ return NULL;=0D
+}=0D
+=0D
+/**=0D
+ Fix up the image based on the relocation entries.=0D
+=0D
+ @param Rela Relocation entries.=0D
+ @param RelaSize Total size of relocation entries.=0D
+ @param RelaEntrySize Relocation entry size.=0D
+ @param RelaType Type of relocation entry.=0D
+ @param Delta The delta between preferred image base and th=
e actual image base.=0D
+ @param DynamicLinking TRUE when fixing up according to dynamic relo=
cation.=0D
+=0D
+ @retval EFI_SUCCESS The image fix up is processed successfully.=0D
+**/=0D
+EFI_STATUS=0D
+ProcessRelocation64 (=0D
+ IN Elf64_Rela *Rela,=0D
+ IN UINT64 RelaSize,=0D
+ IN UINT64 RelaEntrySize,=0D
+ IN UINT64 RelaType,=0D
+ IN INTN Delta,=0D
+ IN BOOLEAN DynamicLinking=0D
+ )=0D
+{=0D
+ UINTN Index;=0D
+ UINT64 *Ptr;=0D
+ UINT32 Type;=0D
+=0D
+ for ( Index =3D 0=0D
+ ; MultU64x64 (RelaEntrySize, Index) < RelaSize=0D
+ ; Index++, Rela =3D ELF_NEXT_ENTRY (Elf64_Rela, Rela, RelaEntrySize)=
=0D
+ ) {=0D
+ //=0D
+ // r_offset is the virtual address of the storage unit affected by the=
relocation.=0D
+ //=0D
+ Ptr =3D (UINT64 *)(UINTN)(Rela->r_offset + Delta);=0D
+ Type =3D ELF64_R_TYPE(Rela->r_info);=0D
+ switch (Type) {=0D
+ case R_X86_64_NONE:=0D
+ case R_X86_64_PC32:=0D
+ case R_X86_64_PLT32:=0D
+ case R_X86_64_GOTPCREL:=0D
+ case R_X86_64_GOTPCRELX:=0D
+ case R_X86_64_REX_GOTPCRELX:=0D
+ break;=0D
+=0D
+ case R_X86_64_64:=0D
+ if (DynamicLinking) {=0D
+ //=0D
+ // Dynamic section doesn't contain entries of this type.=0D
+ //=0D
+ DEBUG ((DEBUG_INFO, "Unsupported relocation type %02X\n", Type))=
;=0D
+ ASSERT (FALSE);=0D
+ } else {=0D
+ *Ptr +=3D Delta;=0D
+ }=0D
+ break;=0D
+=0D
+ case R_X86_64_32:=0D
+ //=0D
+ // Dynamic section doesn't contain entries of this type.=0D
+ //=0D
+ DEBUG ((DEBUG_INFO, "Unsupported relocation type %02X\n", Type));=
=0D
+ ASSERT (FALSE);=0D
+ break;=0D
+=0D
+ case R_X86_64_RELATIVE:=0D
+ if (DynamicLinking) {=0D
+ //=0D
+ // A: Represents the addend used to compute the value of the rel=
ocatable field.=0D
+ // B: Represents the base address at which a shared object has b=
een loaded into memory during execution.=0D
+ // Generally, a shared object is built with a 0 base virtual =
address, but the execution address will be different.=0D
+ //=0D
+ // B (Base Address) in ELF spec is slightly different:=0D
+ // An executable or shared object file's base address (on plat=
forms that support the concept) is calculated during=0D
+ // execution from three values: the virtual memory load addres=
s, the maximum page size, and the lowest virtual address=0D
+ // of a program's loadable segment. To compute the base addres=
s, one determines the memory address associated with the=0D
+ // lowest p_vaddr value for a PT_LOAD segment. This address is=
truncated to the nearest multiple of the maximum page size.=0D
+ // The corresponding p_vaddr value itself is also truncated to=
the nearest multiple of the maximum page size.=0D
+ //=0D
+ // *** The base address is the difference between the truncate=
d memory address and the truncated p_vaddr value. ***=0D
+ //=0D
+ // Delta in this function is B.=0D
+ //=0D
+ // Calculation: B + A=0D
+ //=0D
+ if (RelaType =3D=3D SHT_RELA) {=0D
+ ASSERT (*Ptr =3D=3D 0);=0D
+ *Ptr =3D Delta + Rela->r_addend;=0D
+ } else {=0D
+ //=0D
+ // A is stored in the field of relocation for REL type.=0D
+ //=0D
+ *Ptr =3D Delta + *Ptr;=0D
+ }=0D
+ } else {=0D
+ //=0D
+ // non-Dynamic section doesn't contain entries of this type.=0D
+ //=0D
+ DEBUG ((DEBUG_INFO, "Unsupported relocation type %02X\n", Type))=
;=0D
+ ASSERT (FALSE);=0D
+ }=0D
+ break;=0D
+=0D
+ default:=0D
+ DEBUG ((DEBUG_INFO, "Unsupported relocation type %02X\n", Type));=
=0D
+ }=0D
+ }=0D
+ return EFI_SUCCESS;=0D
+}=0D
+=0D
+/**=0D
+ Relocate the DYN type image.=0D
+=0D
+ @param ElfCt Point to image context.=0D
+=0D
+ @retval EFI_SUCCESS The relocation succeeds.=0D
+ @retval EFI_UNSUPPORTED The image doesn't contain a dynamic section.=0D
+**/=0D
+EFI_STATUS=0D
+RelocateElf64Dynamic (=0D
+ IN ELF_IMAGE_CONTEXT *ElfCt=0D
+ )=0D
+{=0D
+ UINT32 Index;=0D
+ Elf64_Phdr *Phdr;=0D
+ Elf64_Shdr *DynShdr;=0D
+ Elf64_Shdr *RelShdr;=0D
+ Elf64_Dyn *Dyn;=0D
+ UINT64 RelaOffset;=0D
+ UINT64 RelaCount;=0D
+ UINT64 RelaSize;=0D
+ UINT64 RelaEntrySize;=0D
+ UINT64 RelaType;=0D
+=0D
+ //=0D
+ // 1. Locate the dynamic section.=0D
+ //=0D
+ // If an object file participates in dynamic linking, its program header=
table=0D
+ // will have an element of type PT_DYNAMIC.=0D
+ // This ``segment'' contains the .dynamic section. A special symbol, _DY=
NAMIC,=0D
+ // labels the section, which contains an array of Elf32_Dyn or Elf64_Dyn=
.=0D
+ //=0D
+ DynShdr =3D NULL;=0D
+ for (Index =3D 0; Index < ElfCt->PhNum; Index++) {=0D
+ Phdr =3D GetElf64SegmentByIndex (ElfCt->FileBase, Index);=0D
+ ASSERT (Phdr !=3D NULL);=0D
+ if (Phdr->p_type =3D=3D PT_DYNAMIC) {=0D
+ //=0D
+ // Verify the existence of the dynamic section.=0D
+ //=0D
+ DynShdr =3D GetElf64SectionByRange (ElfCt->FileBase, Phdr->p_offset,=
Phdr->p_filesz);=0D
+ break;=0D
+ }=0D
+ }=0D
+=0D
+ //=0D
+ // It's abnormal a DYN ELF doesn't contain a dynamic section.=0D
+ //=0D
+ ASSERT (DynShdr !=3D NULL);=0D
+ if (DynShdr =3D=3D NULL) {=0D
+ return EFI_UNSUPPORTED;=0D
+ }=0D
+ ASSERT (DynShdr->sh_type =3D=3D SHT_DYNAMIC);=0D
+ ASSERT (DynShdr->sh_entsize >=3D sizeof (*Dyn));=0D
+=0D
+ //=0D
+ // 2. Locate the relocation section from the dynamic section.=0D
+ //=0D
+ RelaOffset =3D MAX_UINT64;=0D
+ RelaSize =3D 0;=0D
+ RelaCount =3D 0;=0D
+ RelaEntrySize =3D 0;=0D
+ RelaType =3D 0;=0D
+ for ( Index =3D 0, Dyn =3D (Elf64_Dyn *) (ElfCt->FileBase + DynShdr->sh_=
offset)=0D
+ ; Index < DivU64x64Remainder (DynShdr->sh_size, DynShdr->sh_entsize,=
NULL)=0D
+ ; Index++, Dyn =3D ELF_NEXT_ENTRY (Elf64_Dyn, Dyn, DynShdr->sh_entsi=
ze)=0D
+ ) {=0D
+ switch (Dyn->d_tag) {=0D
+ case DT_RELA:=0D
+ case DT_REL:=0D
+ //=0D
+ // DT_REL represent program virtual addresses.=0D
+ // A file's virtual addresses might not match the memory virtual a=
ddresses during execution.=0D
+ // When interpreting addresses contained in the dynamic structure,=
the dynamic linker computes actual addresses,=0D
+ // based on the original file value and the memory base address.=0D
+ // For consistency, files do not contain relocation entries to ``c=
orrect'' addresses in the dynamic structure.=0D
+ //=0D
+ RelaOffset =3D Dyn->d_un.d_ptr - (UINTN) ElfCt->PreferredImageAddr=
ess;=0D
+ RelaType =3D (Dyn->d_tag =3D=3D DT_RELA) ? SHT_RELA: SHT_REL;=0D
+ break;=0D
+ case DT_RELACOUNT:=0D
+ case DT_RELCOUNT:=0D
+ RelaCount =3D Dyn->d_un.d_val;=0D
+ break;=0D
+ case DT_RELENT:=0D
+ case DT_RELAENT:=0D
+ RelaEntrySize =3D Dyn->d_un.d_val;=0D
+ break;=0D
+ case DT_RELSZ:=0D
+ case DT_RELASZ:=0D
+ RelaSize =3D Dyn->d_un.d_val;=0D
+ break;=0D
+ default:=0D
+ break;=0D
+ }=0D
+ }=0D
+=0D
+ if (RelaOffset =3D=3D MAX_UINT64) {=0D
+ ASSERT (RelaCount =3D=3D 0);=0D
+ ASSERT (RelaEntrySize =3D=3D 0);=0D
+ ASSERT (RelaSize =3D=3D 0);=0D
+ //=0D
+ // It's fine that a DYN ELF doesn't contain relocation section.=0D
+ //=0D
+ return EFI_SUCCESS;=0D
+ }=0D
+=0D
+ //=0D
+ // Verify the existence of the relocation section.=0D
+ //=0D
+ RelShdr =3D GetElf64SectionByRange (ElfCt->FileBase, RelaOffset, RelaSiz=
e);=0D
+ ASSERT (RelShdr !=3D NULL);=0D
+ if (RelShdr =3D=3D NULL) {=0D
+ return EFI_UNSUPPORTED;=0D
+ }=0D
+ ASSERT (RelShdr->sh_type =3D=3D RelaType);=0D
+ ASSERT (RelShdr->sh_entsize =3D=3D RelaEntrySize);=0D
+=0D
+ //=0D
+ // 3. Process the relocation section.=0D
+ //=0D
+ ProcessRelocation64 (=0D
+ (Elf64_Rela *) (ElfCt->FileBase + RelShdr->sh_offset),=0D
+ RelShdr->sh_size, RelShdr->sh_entsize, RelShdr->sh_type,=0D
+ (UINTN) ElfCt->ImageAddress - (UINTN) ElfCt->PreferredImageAddress,=0D
+ TRUE=0D
+ );=0D
+ return EFI_SUCCESS;=0D
+}=0D
+=0D
+/**=0D
+ Relocate all sections in a ELF image.=0D
+=0D
+ @param[in] ElfCt ELF image context pointer.=0D
+=0D
+ @retval EFI_UNSUPPORTED Relocation is not supported.=0D
+ @retval EFI_SUCCESS ELF image was relocated successfully.=0D
+**/=0D
+EFI_STATUS=0D
+RelocateElf64Sections (=0D
+ IN ELF_IMAGE_CONTEXT *ElfCt=0D
+ )=0D
+{=0D
+ EFI_STATUS Status;=0D
+ Elf64_Ehdr *Ehdr;=0D
+ Elf64_Shdr *RelShdr;=0D
+ Elf64_Shdr *Shdr;=0D
+ UINT32 Index;=0D
+ UINTN Delta;=0D
+=0D
+ Ehdr =3D (Elf64_Ehdr *)ElfCt->FileBase;=0D
+ if (Ehdr->e_machine !=3D EM_X86_64) {=0D
+ return EFI_UNSUPPORTED;=0D
+ }=0D
+=0D
+ Delta =3D (UINTN) ElfCt->ImageAddress - (UINTN) ElfCt->PreferredImageAdd=
ress;=0D
+ ElfCt->EntryPoint =3D (UINTN)(Ehdr->e_entry + Delta);=0D
+=0D
+ //=0D
+ // 1. Relocate dynamic ELF using the relocation section pointed by dynam=
ic section=0D
+ //=0D
+ if (Ehdr->e_type =3D=3D ET_DYN) {=0D
+ DEBUG ((DEBUG_INFO, "DYN ELF: Relocate using dynamic sections...\n"));=
=0D
+ Status =3D RelocateElf64Dynamic (ElfCt);=0D
+ ASSERT_EFI_ERROR (Status);=0D
+ return Status;=0D
+ }=0D
+=0D
+ //=0D
+ // 2. Executable ELF: Fix up the delta between actual image address and =
preferred image address.=0D
+ //=0D
+ // Linker already fixed up EXEC ELF based on the preferred image addres=
s.=0D
+ // A ELF loader in modern OS only loads it into the preferred image add=
ress.=0D
+ // The below relocation is unneeded in that case.=0D
+ // But the ELF loader in firmware supports to load the image to a diffe=
rent address.=0D
+ // The below relocation is needed in this case.=0D
+ //=0D
+ DEBUG ((DEBUG_INFO, "EXEC ELF: Fix actual/preferred base address delta .=
..\n"));=0D
+ for ( Index =3D 0, RelShdr =3D (Elf64_Shdr *) (ElfCt->FileBase + Ehdr->e=
_shoff)=0D
+ ; Index < Ehdr->e_shnum=0D
+ ; Index++, RelShdr =3D ELF_NEXT_ENTRY (Elf64_Shdr, RelShdr, Ehdr->=
e_shentsize)=0D
+ ) {=0D
+ if ((RelShdr->sh_type !=3D SHT_REL) && (RelShdr->sh_type !=3D SHT_RELA=
)) {=0D
+ continue;=0D
+ }=0D
+ Shdr =3D GetElf64SectionByIndex (ElfCt->FileBase, RelShdr->sh_info);=0D
+ if ((Shdr->sh_flags & SHF_ALLOC) =3D=3D SHF_ALLOC) {=0D
+ //=0D
+ // Only fix up sections that occupy memory during process execution.=
=0D
+ //=0D
+ ProcessRelocation64 (=0D
+ (Elf64_Rela *)((UINT8*)Ehdr + RelShdr->sh_offset),=0D
+ RelShdr->sh_size, RelShdr->sh_entsize, RelShdr->sh_type,=0D
+ Delta, FALSE=0D
+ );=0D
+ }=0D
+ }=0D
+=0D
+ return EFI_SUCCESS;=0D
+}=0D
+=0D
+/**=0D
+ Load ELF image which has 64-bit architecture.=0D
+=0D
+ Caller should set Context.ImageAddress to a proper value, either pointin=
g to=0D
+ a new allocated memory whose size equal to Context.ImageSize, or pointin=
g=0D
+ to Context.PreferredImageAddress.=0D
+=0D
+ @param[in] ElfCt ELF image context pointer.=0D
+=0D
+ @retval EFI_SUCCESS ELF binary is loaded successfully.=0D
+ @retval Others Loading ELF binary fails.=0D
+=0D
+**/=0D
+EFI_STATUS=0D
+LoadElf64Image (=0D
+ IN ELF_IMAGE_CONTEXT *ElfCt=0D
+ )=0D
+{=0D
+ Elf64_Ehdr *Ehdr;=0D
+ Elf64_Phdr *Phdr;=0D
+ UINT16 Index;=0D
+ UINTN Delta;=0D
+=0D
+ ASSERT (ElfCt !=3D NULL);=0D
+=0D
+ //=0D
+ // Per the sprit of ELF, loading to memory only consumes info from progr=
am headers.=0D
+ //=0D
+ Ehdr =3D (Elf64_Ehdr *)ElfCt->FileBase;=0D
+=0D
+ for ( Index =3D 0, Phdr =3D (Elf64_Phdr *)(ElfCt->FileBase + Ehdr->e_pho=
ff)=0D
+ ; Index < Ehdr->e_phnum=0D
+ ; Index++, Phdr =3D ELF_NEXT_ENTRY (Elf64_Phdr, Phdr, Ehdr->e_phents=
ize)=0D
+ ) {=0D
+ //=0D
+ // Skip segments that don't require load (type tells, or size is 0)=0D
+ //=0D
+ if ((Phdr->p_type !=3D PT_LOAD) ||=0D
+ (Phdr->p_memsz =3D=3D 0)) {=0D
+ continue;=0D
+ }=0D
+=0D
+ //=0D
+ // The memory offset of segment relative to the image base=0D
+ // Note: CopyMem() does nothing when the dst equals to src.=0D
+ //=0D
+ Delta =3D (UINTN) Phdr->p_paddr - (UINTN) ElfCt->PreferredImageAddress=
;=0D
+ CopyMem (ElfCt->ImageAddress + Delta, ElfCt->FileBase + (UINTN) Phdr->=
p_offset, (UINTN) Phdr->p_filesz);=0D
+ ZeroMem (ElfCt->ImageAddress + Delta + (UINTN) Phdr->p_filesz, (UINTN)=
(Phdr->p_memsz - Phdr->p_filesz));=0D
+ }=0D
+=0D
+ //=0D
+ // Relocate when new new image base is not the preferred image base.=0D
+ //=0D
+ if (ElfCt->ImageAddress !=3D ElfCt->PreferredImageAddress) {=0D
+ RelocateElf64Sections (ElfCt);=0D
+ }=0D
+=0D
+ return EFI_SUCCESS;=0D
+}=0D
diff --git a/UefiPayloadPkg/PayloadLoaderPeim/ElfLib/ElfCommon.h b/UefiPayl=
oadPkg/PayloadLoaderPeim/ElfLib/ElfCommon.h
new file mode 100644
index 0000000000..15c9e33d3f
--- /dev/null
+++ b/UefiPayloadPkg/PayloadLoaderPeim/ElfLib/ElfCommon.h
@@ -0,0 +1,983 @@
+/** @file=0D
+Ported ELF include files from FreeBSD=0D
+=0D
+Copyright (c) 2009 - 2010, Apple Inc. All rights reserved.<BR>=0D
+Portions Copyright (c) 2011 - 2013, ARM Ltd. All rights reserved.<BR>=0D
+SPDX-License-Identifier: BSD-2-Clause-Patent=0D
+=0D
+=0D
+**/=0D
+/*-=0D
+ * Copyright (c) 1998 John D. Polstra.=0D
+ * All rights reserved.=0D
+ *=0D
+ * Redistribution and use in source and binary forms, with or without=0D
+ * modification, are permitted provided that the following conditions=0D
+ * are met:=0D
+ * 1. Redistributions of source code must retain the above copyright=0D
+ * notice, this list of conditions and the following disclaimer.=0D
+ * 2. Redistributions in binary form must reproduce the above copyright=0D
+ * notice, this list of conditions and the following disclaimer in the=
=0D
+ * documentation and/or other materials provided with the distribution.=
=0D
+ *=0D
+ * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND=
=0D
+ * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE=0D
+ * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURP=
OSE=0D
+ * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE=
=0D
+ * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENT=
IAL=0D
+ * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS=
=0D
+ * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)=0D
+ * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STR=
ICT=0D
+ * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY W=
AY=0D
+ * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF=
=0D
+ * SUCH DAMAGE.=0D
+ *=0D
+ * $FreeBSD: src/sys/sys/elf_common.h,v 1.15.8.2 2007/12/03 21:30:36 mariu=
s Exp $=0D
+ */=0D
+=0D
+#ifndef _SYS_ELF_COMMON_H_=0D
+#define _SYS_ELF_COMMON_H_ 1=0D
+=0D
+/*=0D
+ * ELF definitions that are independent of architecture or word size.=0D
+ */=0D
+=0D
+/*=0D
+ * Note header. The ".note" section contains an array of notes. Each=0D
+ * begins with this header, aligned to a word boundary. Immediately=0D
+ * following the note header is n_namesz bytes of name, padded to the=0D
+ * next word boundary. Then comes n_descsz bytes of descriptor, again=0D
+ * padded to a word boundary. The values of n_namesz and n_descsz do=0D
+ * not include the padding.=0D
+ */=0D
+=0D
+typedef struct {=0D
+ UINT32 n_namesz; /* Length of name. */=0D
+ UINT32 n_descsz; /* Length of descriptor. */=0D
+ UINT32 n_type; /* Type of this note. */=0D
+} Elf_Note;=0D
+=0D
+/* Indexes into the e_ident array. Keep synced with=0D
+ http://www.sco.com/developers/gabi/latest/ch4.eheader.html */=0D
+#define EI_MAG0 0 /* Magic number, byte 0. */=0D
+#define EI_MAG1 1 /* Magic number, byte 1. */=0D
+#define EI_MAG2 2 /* Magic number, byte 2. */=0D
+#define EI_MAG3 3 /* Magic number, byte 3. */=0D
+#define EI_CLASS 4 /* Class of machine. */=0D
+#define EI_DATA 5 /* Data format. */=0D
+#define EI_VERSION 6 /* ELF format version. */=0D
+#define EI_OSABI 7 /* Operating system / ABI identification */=0D
+#define EI_ABIVERSION 8 /* ABI version */=0D
+#define OLD_EI_BRAND 8 /* Start of architecture identification. */=0D
+#define EI_PAD 9 /* Start of padding (per SVR4 ABI). */=0D
+#define EI_NIDENT 16 /* Size of e_ident array. */=0D
+=0D
+/* Values for the magic number bytes. */=0D
+#define ELFMAG0 0x7f=0D
+#define ELFMAG1 'E'=0D
+#define ELFMAG2 'L'=0D
+#define ELFMAG3 'F'=0D
+#define ELFMAG "\177ELF" /* magic string */=0D
+#define SELFMAG 4 /* magic string size */=0D
+=0D
+/* Values for e_ident[EI_VERSION] and e_version. */=0D
+#define EV_NONE 0=0D
+#define EV_CURRENT 1=0D
+=0D
+/* Values for e_ident[EI_CLASS]. */=0D
+#define ELFCLASSNONE 0 /* Unknown class. */=0D
+#define ELFCLASS32 1 /* 32-bit architecture. */=0D
+#define ELFCLASS64 2 /* 64-bit architecture. */=0D
+=0D
+/* Values for e_ident[EI_DATA]. */=0D
+#define ELFDATANONE 0 /* Unknown data format. */=0D
+#define ELFDATA2LSB 1 /* 2's complement little-endian. */=0D
+#define ELFDATA2MSB 2 /* 2's complement big-endian. */=0D
+=0D
+/* Values for e_ident[EI_OSABI]. */=0D
+#define ELFOSABI_NONE 0 /* UNIX System V ABI */=0D
+#define ELFOSABI_HPUX 1 /* HP-UX operating system */=0D
+#define ELFOSABI_NETBSD 2 /* NetBSD */=0D
+#define ELFOSABI_LINUX 3 /* GNU/Linux */=0D
+#define ELFOSABI_HURD 4 /* GNU/Hurd */=0D
+#define ELFOSABI_86OPEN 5 /* 86Open common IA32 ABI */=0D
+#define ELFOSABI_SOLARIS 6 /* Solaris */=0D
+#define ELFOSABI_AIX 7 /* AIX */=0D
+#define ELFOSABI_IRIX 8 /* IRIX */=0D
+#define ELFOSABI_FREEBSD 9 /* FreeBSD */=0D
+#define ELFOSABI_TRU64 10 /* TRU64 UNIX */=0D
+#define ELFOSABI_MODESTO 11 /* Novell Modesto */=0D
+#define ELFOSABI_OPENBSD 12 /* OpenBSD */=0D
+#define ELFOSABI_OPENVMS 13 /* Open VMS */=0D
+#define ELFOSABI_NSK 14 /* HP Non-Stop Kernel */=0D
+#define ELFOSABI_ARM 97 /* ARM */=0D
+#define ELFOSABI_STANDALONE 255 /* Standalone (embedded) application */=
=0D
+=0D
+#define ELFOSABI_SYSV ELFOSABI_NONE /* symbol used in old spec */=0D
+#define ELFOSABI_MONTEREY ELFOSABI_AIX /* Monterey */=0D
+=0D
+/* e_ident */=0D
+#define IS_ELF(ehdr) ((ehdr).e_ident[EI_MAG0] =3D=3D ELFMAG0 && \=0D
+ (ehdr).e_ident[EI_MAG1] =3D=3D ELFMAG1 && \=0D
+ (ehdr).e_ident[EI_MAG2] =3D=3D ELFMAG2 && \=0D
+ (ehdr).e_ident[EI_MAG3] =3D=3D ELFMAG3)=0D
+=0D
+/* Values for e_type. */=0D
+#define ET_NONE 0 /* Unknown type. */=0D
+#define ET_REL 1 /* Relocatable. */=0D
+#define ET_EXEC 2 /* Executable. */=0D
+#define ET_DYN 3 /* Shared object. */=0D
+#define ET_CORE 4 /* Core file. */=0D
+#define ET_LOOS 0xfe00 /* First operating system specific. */=0D
+#define ET_HIOS 0xfeff /* Last operating system-specific. */=0D
+#define ET_LOPROC 0xff00 /* First processor-specific. */=0D
+#define ET_HIPROC 0xffff /* Last processor-specific. */=0D
+=0D
+/* Values for e_machine. */=0D
+#define EM_NONE 0 /* Unknown machine. */=0D
+#define EM_M32 1 /* AT&T WE32100. */=0D
+#define EM_SPARC 2 /* Sun SPARC. */=0D
+#define EM_386 3 /* Intel i386. */=0D
+#define EM_68K 4 /* Motorola 68000. */=0D
+#define EM_88K 5 /* Motorola 88000. */=0D
+#define EM_860 7 /* Intel i860. */=0D
+#define EM_MIPS 8 /* MIPS R3000 Big-Endian only. */=0D
+#define EM_S370 9 /* IBM System/370. */=0D
+#define EM_MIPS_RS3_LE 10 /* MIPS R3000 Little-Endian. */=0D
+#define EM_PARISC 15 /* HP PA-RISC. */=0D
+#define EM_VPP500 17 /* Fujitsu VPP500. */=0D
+#define EM_SPARC32PLUS 18 /* SPARC v8plus. */=0D
+#define EM_960 19 /* Intel 80960. */=0D
+#define EM_PPC 20 /* PowerPC 32-bit. */=0D
+#define EM_PPC64 21 /* PowerPC 64-bit. */=0D
+#define EM_S390 22 /* IBM System/390. */=0D
+#define EM_V800 36 /* NEC V800. */=0D
+#define EM_FR20 37 /* Fujitsu FR20. */=0D
+#define EM_RH32 38 /* TRW RH-32. */=0D
+#define EM_RCE 39 /* Motorola RCE. */=0D
+#define EM_ARM 40 /* ARM. */=0D
+#define EM_SH 42 /* Hitachi SH. */=0D
+#define EM_SPARCV9 43 /* SPARC v9 64-bit. */=0D
+#define EM_TRICORE 44 /* Siemens TriCore embedded processor. */=0D
+#define EM_ARC 45 /* Argonaut RISC Core. */=0D
+#define EM_H8_300 46 /* Hitachi H8/300. */=0D
+#define EM_H8_300H 47 /* Hitachi H8/300H. */=0D
+#define EM_H8S 48 /* Hitachi H8S. */=0D
+#define EM_H8_500 49 /* Hitachi H8/500. */=0D
+#define EM_MIPS_X 51 /* Stanford MIPS-X. */=0D
+#define EM_COLDFIRE 52 /* Motorola ColdFire. */=0D
+#define EM_68HC12 53 /* Motorola M68HC12. */=0D
+#define EM_MMA 54 /* Fujitsu MMA. */=0D
+#define EM_PCP 55 /* Siemens PCP. */=0D
+#define EM_NCPU 56 /* Sony nCPU. */=0D
+#define EM_NDR1 57 /* Denso NDR1 microprocessor. */=0D
+#define EM_STARCORE 58 /* Motorola Star*Core processor. */=0D
+#define EM_ME16 59 /* Toyota ME16 processor. */=0D
+#define EM_ST100 60 /* STMicroelectronics ST100 processor. */=0D
+#define EM_TINYJ 61 /* Advanced Logic Corp. TinyJ processor. */=0D
+#define EM_X86_64 62 /* Advanced Micro Devices x86-64 */=0D
+#define EM_AMD64 EM_X86_64 /* Advanced Micro Devices x86-64 (compat) */=
=0D
+#define EM_AARCH64 183 /* ARM 64bit Architecture */=0D
+=0D
+/* Non-standard or deprecated. */=0D
+#define EM_486 6 /* Intel i486. */=0D
+#define EM_MIPS_RS4_BE 10 /* MIPS R4000 Big-Endian */=0D
+#define EM_ALPHA_STD 41 /* Digital Alpha (standard value). */=0D
+#define EM_ALPHA 0x9026 /* Alpha (written in the absence of an ABI) */=0D
+=0D
+/* Special section indexes. */=0D
+#define SHN_UNDEF 0 /* Undefined, missing, irrelevant. */=0D
+#define SHN_LORESERVE 0xff00 /* First of reserved range. */=0D
+#define SHN_LOPROC 0xff00 /* First processor-specific. */=0D
+#define SHN_HIPROC 0xff1f /* Last processor-specific. */=0D
+#define SHN_LOOS 0xff20 /* First operating system-specific. */=0D
+#define SHN_HIOS 0xff3f /* Last operating system-specific. */=0D
+#define SHN_ABS 0xfff1 /* Absolute values. */=0D
+#define SHN_COMMON 0xfff2 /* Common data. */=0D
+#define SHN_XINDEX 0xffff /* Escape -- index stored elsewhere. */=0D
+#define SHN_HIRESERVE 0xffff /* Last of reserved range. */=0D
+=0D
+/* sh_type */=0D
+#define SHT_NULL 0 /* inactive */=0D
+#define SHT_PROGBITS 1 /* program defined information */=0D
+#define SHT_SYMTAB 2 /* symbol table section */=0D
+#define SHT_STRTAB 3 /* string table section */=0D
+#define SHT_RELA 4 /* relocation section with addends */=0D
+#define SHT_HASH 5 /* symbol hash table section */=0D
+#define SHT_DYNAMIC 6 /* dynamic section */=0D
+#define SHT_NOTE 7 /* note section */=0D
+#define SHT_NOBITS 8 /* no space section */=0D
+#define SHT_REL 9 /* relocation section - no addends */=0D
+#define SHT_SHLIB 10 /* reserved - purpose unknown */=0D
+#define SHT_DYNSYM 11 /* dynamic symbol table section */=0D
+#define SHT_INIT_ARRAY 14 /* Initialization function pointers. */=0D
+#define SHT_FINI_ARRAY 15 /* Termination function pointers. */=0D
+#define SHT_PREINIT_ARRAY 16 /* Pre-initialization function ptrs. */=0D
+#define SHT_GROUP 17 /* Section group. */=0D
+#define SHT_SYMTAB_SHNDX 18 /* Section indexes (see SHN_XINDEX). */=0D
+#define SHT_LOOS 0x60000000 /* First of OS specific semantics */=0D
+#define SHT_LOSUNW 0x6ffffff4=0D
+#define SHT_SUNW_dof 0x6ffffff4=0D
+#define SHT_SUNW_cap 0x6ffffff5=0D
+#define SHT_SUNW_SIGNATURE 0x6ffffff6=0D
+#define SHT_SUNW_ANNOTATE 0x6ffffff7=0D
+#define SHT_SUNW_DEBUGSTR 0x6ffffff8=0D
+#define SHT_SUNW_DEBUG 0x6ffffff9=0D
+#define SHT_SUNW_move 0x6ffffffa=0D
+#define SHT_SUNW_COMDAT 0x6ffffffb=0D
+#define SHT_SUNW_syminfo 0x6ffffffc=0D
+#define SHT_SUNW_verdef 0x6ffffffd=0D
+#define SHT_GNU_verdef 0x6ffffffd /* Symbol versions provided */=0D
+#define SHT_SUNW_verneed 0x6ffffffe=0D
+#define SHT_GNU_verneed 0x6ffffffe /* Symbol versions required */=0D
+#define SHT_SUNW_versym 0x6fffffff=0D
+#define SHT_GNU_versym 0x6fffffff /* Symbol version table */=0D
+#define SHT_HISUNW 0x6fffffff=0D
+#define SHT_HIOS 0x6fffffff /* Last of OS specific semantics */=0D
+#define SHT_LOPROC 0x70000000 /* reserved range for processor */=0D
+#define SHT_AMD64_UNWIND 0x70000001 /* unwind information */=0D
+#define SHT_HIPROC 0x7fffffff /* specific section header types */=0D
+#define SHT_LOUSER 0x80000000 /* reserved range for application */=0D
+#define SHT_HIUSER 0xffffffff /* specific indexes */=0D
+=0D
+/* Flags for sh_flags. */=0D
+#define SHF_WRITE 0x1 /* Section contains writable data. */=0D
+#define SHF_ALLOC 0x2 /* Section occupies memory. */=0D
+#define SHF_EXECINSTR 0x4 /* Section contains instructions. */=0D
+#define SHF_MERGE 0x10 /* Section may be merged. */=0D
+#define SHF_STRINGS 0x20 /* Section contains strings. */=0D
+#define SHF_INFO_LINK 0x40 /* sh_info holds section index. */=0D
+#define SHF_LINK_ORDER 0x80 /* Special ordering requirements. */=0D
+#define SHF_OS_NONCONFORMING 0x100 /* OS-specific processing required. *=
/=0D
+#define SHF_GROUP 0x200 /* Member of section group. */=0D
+#define SHF_TLS 0x400 /* Section contains TLS data. */=0D
+#define SHF_MASKOS 0x0ff00000 /* OS-specific semantics. */=0D
+#define SHF_MASKPROC 0xf0000000 /* Processor-specific semantics. */=0D
+=0D
+/* Values for p_type. */=0D
+#define PT_NULL 0 /* Unused entry. */=0D
+#define PT_LOAD 1 /* Loadable segment. */=0D
+#define PT_DYNAMIC 2 /* Dynamic linking information segment. */=0D
+#define PT_INTERP 3 /* Pathname of interpreter. */=0D
+#define PT_NOTE 4 /* Auxiliary information. */=0D
+#define PT_SHLIB 5 /* Reserved (not used). */=0D
+#define PT_PHDR 6 /* Location of program header itself. */=0D
+#define PT_TLS 7 /* Thread local storage segment */=0D
+#define PT_LOOS 0x60000000 /* First OS-specific. */=0D
+#define PT_SUNW_UNWIND 0x6464e550 /* amd64 UNWIND program header */=0D
+#define PT_GNU_EH_FRAME 0x6474e550=0D
+#define PT_LOSUNW 0x6ffffffa=0D
+#define PT_SUNWBSS 0x6ffffffa /* Sun Specific segment */=0D
+#define PT_SUNWSTACK 0x6ffffffb /* describes the stack segment */=0D
+#define PT_SUNWDTRACE 0x6ffffffc /* private */=0D
+#define PT_SUNWCAP 0x6ffffffd /* hard/soft capabilities segment */=0D
+#define PT_HISUNW 0x6fffffff=0D
+#define PT_HIOS 0x6fffffff /* Last OS-specific. */=0D
+#define PT_LOPROC 0x70000000 /* First processor-specific type. */=0D
+#define PT_HIPROC 0x7fffffff /* Last processor-specific type. */=0D
+=0D
+/* Values for p_flags. */=0D
+#define PF_X 0x1 /* Executable. */=0D
+#define PF_W 0x2 /* Writable. */=0D
+#define PF_R 0x4 /* Readable. */=0D
+#define PF_MASKOS 0x0ff00000 /* Operating system-specific. */=0D
+#define PF_MASKPROC 0xf0000000 /* Processor-specific. */=0D
+=0D
+/* Extended program header index. */=0D
+#define PN_XNUM 0xffff=0D
+=0D
+/* Values for d_tag. */=0D
+#define DT_NULL 0 /* Terminating entry. */=0D
+#define DT_NEEDED 1 /* String table offset of a needed shared=0D
+ library. */=0D
+#define DT_PLTRELSZ 2 /* Total size in bytes of PLT relocations. */=0D
+#define DT_PLTGOT 3 /* Processor-dependent address. */=0D
+#define DT_HASH 4 /* Address of symbol hash table. */=0D
+#define DT_STRTAB 5 /* Address of string table. */=0D
+#define DT_SYMTAB 6 /* Address of symbol table. */=0D
+#define DT_RELA 7 /* Address of ElfNN_Rela relocations. */=0D
+#define DT_RELASZ 8 /* Total size of ElfNN_Rela relocations. */=0D
+#define DT_RELAENT 9 /* Size of each ElfNN_Rela relocation entry. */=0D
+#define DT_STRSZ 10 /* Size of string table. */=0D
+#define DT_SYMENT 11 /* Size of each symbol table entry. */=0D
+#define DT_INIT 12 /* Address of initialization function. */=0D
+#define DT_FINI 13 /* Address of finalization function. */=0D
+#define DT_SONAME 14 /* String table offset of shared object=0D
+ name. */=0D
+#define DT_RPATH 15 /* String table offset of library path. [sup] */=0D
+#define DT_SYMBOLIC 16 /* Indicates "symbolic" linking. [sup] */=0D
+#define DT_REL 17 /* Address of ElfNN_Rel relocations. */=0D
+#define DT_RELSZ 18 /* Total size of ElfNN_Rel relocations. */=0D
+#define DT_RELENT 19 /* Size of each ElfNN_Rel relocation. */=0D
+#define DT_PLTREL 20 /* Type of relocation used for PLT. */=0D
+#define DT_DEBUG 21 /* Reserved (not used). */=0D
+#define DT_TEXTREL 22 /* Indicates there may be relocations in=0D
+ non-writable segments. [sup] */=0D
+#define DT_JMPREL 23 /* Address of PLT relocations. */=0D
+#define DT_BIND_NOW 24 /* [sup] */=0D
+#define DT_INIT_ARRAY 25 /* Address of the array of pointers to=0D
+ initialization functions */=0D
+#define DT_FINI_ARRAY 26 /* Address of the array of pointers to=0D
+ termination functions */=0D
+#define DT_INIT_ARRAYSZ 27 /* Size in bytes of the array of=0D
+ initialization functions. */=0D
+#define DT_FINI_ARRAYSZ 28 /* Size in bytes of the array of=0D
+ terminationfunctions. */=0D
+#define DT_RUNPATH 29 /* String table offset of a null-terminated=0D
+ library search path string. */=0D
+#define DT_FLAGS 30 /* Object specific flag values. */=0D
+#define DT_ENCODING 32 /* Values greater than or equal to DT_ENCODING=0D
+ and less than DT_LOOS follow the rules for=0D
+ the interpretation of the d_un union=0D
+ as follows: even =3D=3D 'd_ptr', even =3D=3D 'd_val'=0D
+ or none */=0D
+#define DT_PREINIT_ARRAY 32 /* Address of the array of pointers to=0D
+ pre-initialization functions. */=0D
+#define DT_PREINIT_ARRAYSZ 33 /* Size in bytes of the array of=0D
+ pre-initialization functions. */=0D
+#define DT_MAXPOSTAGS 34 /* number of positive tags */=0D
+#define DT_LOOS 0x6000000d /* First OS-specific */=0D
+#define DT_SUNW_AUXILIARY 0x6000000d /* symbol auxiliary name */=0D
+#define DT_SUNW_RTLDINF 0x6000000e /* ld.so.1 info (private) */=0D
+#define DT_SUNW_FILTER 0x6000000f /* symbol filter name */=0D
+#define DT_SUNW_CAP 0x60000010 /* hardware/software */=0D
+#define DT_HIOS 0x6ffff000 /* Last OS-specific */=0D
+=0D
+/*=0D
+ * DT_* entries which fall between DT_VALRNGHI & DT_VALRNGLO use the=0D
+ * Dyn.d_un.d_val field of the Elf*_Dyn structure.=0D
+ */=0D
+#define DT_VALRNGLO 0x6ffffd00=0D
+#define DT_CHECKSUM 0x6ffffdf8 /* elf checksum */=0D
+#define DT_PLTPADSZ 0x6ffffdf9 /* pltpadding size */=0D
+#define DT_MOVEENT 0x6ffffdfa /* move table entry size */=0D
+#define DT_MOVESZ 0x6ffffdfb /* move table size */=0D
+#define DT_FEATURE_1 0x6ffffdfc /* feature holder */=0D
+#define DT_POSFLAG_1 0x6ffffdfd /* flags for DT_* entries, effecting */=
=0D
+ /* the following DT_* entry. */=0D
+ /* See DF_P1_* definitions */=0D
+#define DT_SYMINSZ 0x6ffffdfe /* syminfo table size (in bytes) */=0D
+#define DT_SYMINENT 0x6ffffdff /* syminfo entry size (in bytes) */=0D
+#define DT_VALRNGHI 0x6ffffdff=0D
+=0D
+/*=0D
+ * DT_* entries which fall between DT_ADDRRNGHI & DT_ADDRRNGLO use the=0D
+ * Dyn.d_un.d_ptr field of the Elf*_Dyn structure.=0D
+ *=0D
+ * If any adjustment is made to the ELF object after it has been=0D
+ * built, these entries will need to be adjusted.=0D
+ */=0D
+#define DT_ADDRRNGLO 0x6ffffe00=0D
+#define DT_CONFIG 0x6ffffefa /* configuration information */=0D
+#define DT_DEPAUDIT 0x6ffffefb /* dependency auditing */=0D
+#define DT_AUDIT 0x6ffffefc /* object auditing */=0D
+#define DT_PLTPAD 0x6ffffefd /* pltpadding (sparcv9) */=0D
+#define DT_MOVETAB 0x6ffffefe /* move table */=0D
+#define DT_SYMINFO 0x6ffffeff /* syminfo table */=0D
+#define DT_ADDRRNGHI 0x6ffffeff=0D
+=0D
+#define DT_VERSYM 0x6ffffff0 /* Address of versym section. */=0D
+#define DT_RELACOUNT 0x6ffffff9 /* number of RELATIVE relocations */=0D
+#define DT_RELCOUNT 0x6ffffffa /* number of RELATIVE relocations */=0D
+#define DT_FLAGS_1 0x6ffffffb /* state flags - see DF_1_* defs */=0D
+#define DT_VERDEF 0x6ffffffc /* Address of verdef section. */=0D
+#define DT_VERDEFNUM 0x6ffffffd /* Number of elems in verdef section */=
=0D
+#define DT_VERNEED 0x6ffffffe /* Address of verneed section. */=0D
+#define DT_VERNEEDNUM 0x6fffffff /* Number of elems in verneed section =
*/=0D
+=0D
+#define DT_LOPROC 0x70000000 /* First processor-specific type. */=0D
+#define DT_DEPRECATED_SPARC_REGISTER 0x7000001=0D
+#define DT_AUXILIARY 0x7ffffffd /* shared library auxiliary name */=0D
+#define DT_USED 0x7ffffffe /* ignored - same as needed */=0D
+#define DT_FILTER 0x7fffffff /* shared library filter name */=0D
+#define DT_HIPROC 0x7fffffff /* Last processor-specific type. */=0D
+=0D
+/* Values for DT_FLAGS */=0D
+#define DF_ORIGIN 0x0001 /* Indicates that the object being loaded may=
=0D
+ make reference to the $ORIGIN substitution=0D
+ string */=0D
+#define DF_SYMBOLIC 0x0002 /* Indicates "symbolic" linking. */=0D
+#define DF_TEXTREL 0x0004 /* Indicates there may be relocations in=0D
+ non-writable segments. */=0D
+#define DF_BIND_NOW 0x0008 /* Indicates that the dynamic linker should=
=0D
+ process all relocations for the object=0D
+ containing this entry before transferring=0D
+ control to the program. */=0D
+#define DF_STATIC_TLS 0x0010 /* Indicates that the shared object or=0D
+ executable contains code using a static=0D
+ thread-local storage scheme. */=0D
+=0D
+/* Values for n_type. Used in core files. */=0D
+#define NT_PRSTATUS 1 /* Process status. */=0D
+#define NT_FPREGSET 2 /* Floating point registers. */=0D
+#define NT_PRPSINFO 3 /* Process state info. */=0D
+=0D
+/* Symbol Binding - ELFNN_ST_BIND - st_info */=0D
+#define STB_LOCAL 0 /* Local symbol */=0D
+#define STB_GLOBAL 1 /* Global symbol */=0D
+#define STB_WEAK 2 /* like global - lower precedence */=0D
+#define STB_LOOS 10 /* Reserved range for operating system */=0D
+#define STB_HIOS 12 /* specific semantics. */=0D
+#define STB_LOPROC 13 /* reserved range for processor */=0D
+#define STB_HIPROC 15 /* specific semantics. */=0D
+=0D
+/* Symbol type - ELFNN_ST_TYPE - st_info */=0D
+#define STT_NOTYPE 0 /* Unspecified type. */=0D
+#define STT_OBJECT 1 /* Data object. */=0D
+#define STT_FUNC 2 /* Function. */=0D
+#define STT_SECTION 3 /* Section. */=0D
+#define STT_FILE 4 /* Source file. */=0D
+#define STT_COMMON 5 /* Uninitialized common block. */=0D
+#define STT_TLS 6 /* TLS object. */=0D
+#define STT_NUM 7=0D
+#define STT_LOOS 10 /* Reserved range for operating system */=0D
+#define STT_HIOS 12 /* specific semantics. */=0D
+#define STT_LOPROC 13 /* reserved range for processor */=0D
+#define STT_HIPROC 15 /* specific semantics. */=0D
+=0D
+/* Symbol visibility - ELFNN_ST_VISIBILITY - st_other */=0D
+#define STV_DEFAULT 0x0 /* Default visibility (see binding). */=0D
+#define STV_INTERNAL 0x1 /* Special meaning in relocatable objects. */=0D
+#define STV_HIDDEN 0x2 /* Not visible. */=0D
+#define STV_PROTECTED 0x3 /* Visible but not preemptible. */=0D
+=0D
+/* Special symbol table indexes. */=0D
+#define STN_UNDEF 0 /* Undefined symbol index. */=0D
+=0D
+/* Symbol versioning flags. */=0D
+#define VER_DEF_CURRENT 1=0D
+#define VER_DEF_IDX(x) VER_NDX(x)=0D
+=0D
+#define VER_FLG_BASE 0x01=0D
+#define VER_FLG_WEAK 0x02=0D
+=0D
+#define VER_NEED_CURRENT 1=0D
+#define VER_NEED_WEAK (1u << 15)=0D
+#define VER_NEED_HIDDEN VER_NDX_HIDDEN=0D
+#define VER_NEED_IDX(x) VER_NDX(x)=0D
+=0D
+#define VER_NDX_LOCAL 0=0D
+#define VER_NDX_GLOBAL 1=0D
+#define VER_NDX_GIVEN 2=0D
+=0D
+#define VER_NDX_HIDDEN (1u << 15)=0D
+#define VER_NDX(x) ((x) & ~(1u << 15))=0D
+=0D
+#define CA_SUNW_NULL 0=0D
+#define CA_SUNW_HW_1 1 /* first hardware capabilities entry */=0D
+#define CA_SUNW_SF_1 2 /* first software capabilities entry */=0D
+=0D
+/*=0D
+ * Syminfo flag values=0D
+ */=0D
+#define SYMINFO_FLG_DIRECT 0x0001 /* symbol ref has direct association =
*/=0D
+ /* to object containing defn. */=0D
+#define SYMINFO_FLG_PASSTHRU 0x0002 /* ignored - see SYMINFO_FLG_FILTER=
*/=0D
+#define SYMINFO_FLG_COPY 0x0004 /* symbol is a copy-reloc */=0D
+#define SYMINFO_FLG_LAZYLOAD 0x0008 /* object containing defn should be=
*/=0D
+ /* lazily-loaded */=0D
+#define SYMINFO_FLG_DIRECTBIND 0x0010 /* ref should be bound directly t=
o */=0D
+ /* object containing defn. */=0D
+#define SYMINFO_FLG_NOEXTDIRECT 0x0020 /* don't let an external referen=
ce */=0D
+ /* directly bind to this symbol */=0D
+#define SYMINFO_FLG_FILTER 0x0002 /* symbol ref is associated to a */=0D
+#define SYMINFO_FLG_AUXILIARY 0x0040 /* standard or auxiliary filter =
*/=0D
+=0D
+/*=0D
+ * Syminfo.si_boundto values.=0D
+ */=0D
+#define SYMINFO_BT_SELF 0xffff /* symbol bound to self */=0D
+#define SYMINFO_BT_PARENT 0xfffe /* symbol bound to parent */=0D
+#define SYMINFO_BT_NONE 0xfffd /* no special symbol binding */=0D
+#define SYMINFO_BT_EXTERN 0xfffc /* symbol defined as external */=0D
+#define SYMINFO_BT_LOWRESERVE 0xff00 /* beginning of reserved entries *=
/=0D
+=0D
+/*=0D
+ * Syminfo version values.=0D
+ */=0D
+#define SYMINFO_NONE 0 /* Syminfo version */=0D
+#define SYMINFO_CURRENT 1=0D
+#define SYMINFO_NUM 2=0D
+=0D
+/*=0D
+ * Relocation types.=0D
+ *=0D
+ * All machine architectures are defined here to allow tools on one to=0D
+ * handle others.=0D
+ */=0D
+=0D
+#define R_386_NONE 0 /* No relocation. */=0D
+#define R_386_32 1 /* Add symbol value. */=0D
+#define R_386_PC32 2 /* Add PC-relative symbol value. */=0D
+#define R_386_GOT32 3 /* Add PC-relative GOT offset. */=0D
+#define R_386_PLT32 4 /* Add PC-relative PLT offset. */=0D
+#define R_386_COPY 5 /* Copy data from shared object. */=0D
+#define R_386_GLOB_DAT 6 /* Set GOT entry to data address. */=0D
+#define R_386_JMP_SLOT 7 /* Set GOT entry to code address. */=0D
+#define R_386_RELATIVE 8 /* Add load address of shared object. */=0D
+#define R_386_GOTOFF 9 /* Add GOT-relative symbol address. */=0D
+#define R_386_GOTPC 10 /* Add PC-relative GOT table address. */=0D
+#define R_386_TLS_TPOFF 14 /* Negative offset in static TLS block */=
=0D
+#define R_386_TLS_IE 15 /* Absolute address of GOT for -ve static TLS=
*/=0D
+#define R_386_TLS_GOTIE 16 /* GOT entry for negative static TLS block=
*/=0D
+#define R_386_TLS_LE 17 /* Negative offset relative to static TLS */=
=0D
+#define R_386_TLS_GD 18 /* 32 bit offset to GOT (index,off) pair */=0D
+#define R_386_TLS_LDM 19 /* 32 bit offset to GOT (index,zero) pair */=
=0D
+#define R_386_TLS_GD_32 24 /* 32 bit offset to GOT (index,off) pair *=
/=0D
+#define R_386_TLS_GD_PUSH 25 /* pushl instruction for Sun ABI GD sequen=
ce */=0D
+#define R_386_TLS_GD_CALL 26 /* call instruction for Sun ABI GD sequenc=
e */=0D
+#define R_386_TLS_GD_POP 27 /* popl instruction for Sun ABI GD sequence=
*/=0D
+#define R_386_TLS_LDM_32 28 /* 32 bit offset to GOT (index,zero) pair *=
/=0D
+#define R_386_TLS_LDM_PUSH 29 /* pushl instruction for Sun ABI LD seque=
nce */=0D
+#define R_386_TLS_LDM_CALL 30 /* call instruction for Sun ABI LD sequen=
ce */=0D
+#define R_386_TLS_LDM_POP 31 /* popl instruction for Sun ABI LD sequenc=
e */=0D
+#define R_386_TLS_LDO_32 32 /* 32 bit offset from start of TLS block */=
=0D
+#define R_386_TLS_IE_32 33 /* 32 bit offset to GOT static TLS offset =
entry */=0D
+#define R_386_TLS_LE_32 34 /* 32 bit offset within static TLS block *=
/=0D
+#define R_386_TLS_DTPMOD32 35 /* GOT entry containing TLS index */=0D
+#define R_386_TLS_DTPOFF32 36 /* GOT entry containing TLS offset */=0D
+#define R_386_TLS_TPOFF32 37 /* GOT entry of -ve static TLS offset */=0D
+=0D
+/* Null relocation */=0D
+#define R_AARCH64_NONE 256 /* No relocation */=0D
+/* Static AArch64 relocations */=0D
+ /* Static data relocations */=0D
+#define R_AARCH64_ABS64 257 /* S + A */=0D
+#define R_AARCH64_ABS32 258 /* S + A */=0D
+#define R_AARCH64_ABS16 259 /* S + A */=0D
+#define R_AARCH64_PREL64 260 /* S + A - P */=0D
+#define R_AARCH64_PREL32 261 /* S + A - P */=0D
+#define R_AARCH64_PREL16 262 /* S + A - P */=0D
+ /* Group relocations to create a 16, 32, 48, or 64 bit unsigned data valu=
e or address inline */=0D
+#define R_AARCH64_MOVW_UABS_G0 263 /* S + A */=0D
+#define R_AARCH64_MOVW_UABS_G0_NC 264 /* S + A */=0D
+#define R_AARCH64_MOVW_UABS_G1 265 /* S + A */=0D
+#define R_AARCH64_MOVW_UABS_G1_NC 266 /* S + A */=0D
+#define R_AARCH64_MOVW_UABS_G2 267 /* S + A */=0D
+#define R_AARCH64_MOVW_UABS_G2_NC 268 /* S + A */=0D
+#define R_AARCH64_MOVW_UABS_G3 269 /* S + A */=0D
+ /* Group relocations to create a 16, 32, 48, or 64 bit signed data or off=
set value inline */=0D
+#define R_AARCH64_MOVW_SABS_G0 270 /* S + A */=0D
+#define R_AARCH64_MOVW_SABS_G1 271 /* S + A */=0D
+#define R_AARCH64_MOVW_SABS_G2 272 /* S + A */=0D
+ /* Relocations to generate 19, 21 and 33 bit PC-relative addresses */=0D
+#define R_AARCH64_LD_PREL_LO19 273 /* S + A - P */=0D
+#define R_AARCH64_ADR_PREL_LO21 274 /* S + A - P */=0D
+#define R_AARCH64_ADR_PREL_PG_HI21 275 /* Page(S+A) - Page(P) */=0D
+#define R_AARCH64_ADR_PREL_PG_HI21_NC 276 /* Page(S+A) - Page(P) */=0D
+#define R_AARCH64_ADD_ABS_LO12_NC 277 /* S + A */=0D
+#define R_AARCH64_LDST8_ABS_LO12_NC 278 /* S + A */=0D
+#define R_AARCH64_LDST16_ABS_LO12_NC 284 /* S + A */=0D
+#define R_AARCH64_LDST32_ABS_LO12_NC 285 /* S + A */=0D
+#define R_AARCH64_LDST64_ABS_LO12_NC 286 /* S + A */=0D
+#define R_AARCH64_LDST128_ABS_LO12_NC 299 /* S + A */=0D
+ /* Relocations for control-flow instructions - all offsets are a multiple=
of 4 */=0D
+#define R_AARCH64_TSTBR14 279 /* S+A-P */=0D
+#define R_AARCH64_CONDBR19 280 /* S+A-P */=0D
+#define R_AARCH64_JUMP26 282 /* S+A-P */=0D
+#define R_AARCH64_CALL26 283 /* S+A-P */=0D
+ /* Group relocations to create a 16, 32, 48, or 64 bit PC-relative offset=
inline */=0D
+#define R_AARCH64_MOVW_PREL_G0 287 /* S+A-P */=0D
+#define R_AARCH64_MOVW_PREL_G0_NC 288 /* S+A-P */=0D
+#define R_AARCH64_MOVW_PREL_G1 289 /* S+A-P */=0D
+#define R_AARCH64_MOVW_PREL_G1_NC 290 /* S+A-P */=0D
+#define R_AARCH64_MOVW_PREL_G2 291 /* S+A-P */=0D
+#define R_AARCH64_MOVW_PREL_G2_NC 292 /* S+A-P */=0D
+#define R_AARCH64_MOVW_PREL_G3 293 /* S+A-P */=0D
+ /* Group relocations to create a 16, 32, 48, or 64 bit GOT-relative offse=
ts inline */=0D
+#define R_AARCH64_MOVW_GOTOFF_G0 300 /* G(S)-GOT */=0D
+#define R_AARCH64_MOVW_GOTOFF_G0_NC 301 /* G(S)-GOT */=0D
+#define R_AARCH64_MOVW_GOTOFF_G1 302 /* G(S)-GOT */=0D
+#define R_AARCH64_MOVW_GOTOFF_G1_NC 303 /* G(S)-GOT */=0D
+#define R_AARCH64_MOVW_GOTOFF_G2 304 /* G(S)-GOT */=0D
+#define R_AARCH64_MOVW_GOTOFF_G2_NC 305 /* G(S)-GOT */=0D
+#define R_AARCH64_MOVW_GOTOFF_G3 306 /* G(S)-GOT */=0D
+ /* GOT-relative data relocations */=0D
+#define R_AARCH64_GOTREL64 307 /* S+A-GOT */=0D
+#define R_AARCH64_GOTREL32 308 /* S+A-GOT */=0D
+ /* GOT-relative instruction relocations */=0D
+#define R_AARCH64_GOT_LD_PREL19 309 /* G(S)-P */=0D
+#define R_AARCH64_LD64_GOTOFF_LO15 310 /* G(S)-GOT */=0D
+#define R_AARCH64_ADR_GOT_PAGE 311 /* Page(G(S))-Page(P) */=0D
+#define R_AARCH64_LD64_GOT_LO12_NC 312 /* G(S) */=0D
+#define R_AARCH64_LD64_GOTPAGE_LO15 313 /* G(S)-Page(GOT) */=0D
+/* Relocations for thread-local storage */=0D
+ /* General Dynamic TLS relocations */=0D
+#define R_AARCH64_TLSGD_ADR_PREL21 512 /* G(TLSIDX(S+A)) - P */=0D
+#define R_AARCH64_TLSGD_ADR_PAGE21 513 /* Page(G(TLSIDX(S+A))) - Page=
(P) */=0D
+#define R_AARCH64_TLSGD_ADD_LO12_NC 514 /* G(TLSIDX(S+A)) */=0D
+#define R_AARCH64_TLSGD_MOVW_G1 515 /* G(TLSIDX(S+A)) - GOT */=0D
+#define R_AARCH64_TLSGD_MOVW_G0_NC 516 /* G(TLSIDX(S+A)) - GOT */=0D
+ /* Local Dynamic TLS relocations */=0D
+#define R_AARCH64_TLSLD_ADR_PREL21 517 /* G(LDM(S))) - P */=0D
+#define R_AARCH64_TLSLD_ADR_PAGE21 518 /* Page(G(LDM(S)))-Page(P) */=
=0D
+#define R_AARCH64_TLSLD_ADD_LO12_NC 519 /* G(LDM(S)) */=0D
+#define R_AARCH64_TLSLD_MOVW_G1 520 /* G(LDM(S)) - GOT */=0D
+#define R_AARCH64_TLSLD_MOVW_G0_NC 521 /* G(LDM(S)) - GOT */=0D
+#define R_AARCH64_TLSLD_LD_PREL19 522 /* G(LDM(S)) - P */=0D
+#define R_AARCH64_TLSLD_MOVW_DTPREL_G2 523 /* DTPREL(S+A) */=0D
+#define R_AARCH64_TLSLD_MOVW_DTPREL_G1 524 /* DTPREL(S+A) */=0D
+#define R_AARCH64_TLSLD_MOVW_DTPREL_G1_NC 525 /* DTPREL(S+A) */=0D
+#define R_AARCH64_TLSLD_MOVW_DTPREL_G0 526 /* DTPREL(S+A) */=0D
+#define R_AARCH64_TLSLD_MOVW_DTPREL_G0_NC 527 /* DTPREL(S+A) */=0D
+#define R_AARCH64_TLSLD_ADD_DTPREL_HI12 528 /* DTPREL(S+A) */=0D
+#define R_AARCH64_TLSLD_ADD_DTPREL_LO12 529 /* DTPREL(S+A) */=0D
+#define R_AARCH64_TLSLD_ADD_DTPREL_LO12_NC 530 /* DTPREL(S+A) */=0D
+#define R_AARCH64_TLSLD_LDST8_DTPREL_LO12 531 /* DTPREL(S+A) */=0D
+#define R_AARCH64_TLSLD_LDST8_DTPREL_LO12_NC 532 /* DTPREL(S+A) */=0D
+#define R_AARCH64_TLSLD_LDST16_DTPREL_LO12 533 /* DTPREL(S+A) */=0D
+#define R_AARCH64_TLSLD_LDST16_DTPREL_LO12_NC 534 /* DTPREL(S+A) */=0D
+#define R_AARCH64_TLSLD_LDST32_DTPREL_LO12 535 /* DTPREL(S+A) */=0D
+#define R_AARCH64_TLSLD_LDST32_DTPREL_LO12_NC 536 /* DTPREL(S+A) */=0D
+#define R_AARCH64_TLSLD_LDST64_DTPREL_LO12 537 /* DTPREL(S+A) */=0D
+#define R_AARCH64_TLSLD_LDST64_DTPREL_LO12_NC 538 /* DTPREL(S+A) */=0D
+ /* Initial Exec TLS relocations */=0D
+#define R_AARCH64_TLSIE_MOVW_GOTTPREL_G1 539 /* G(TPREL(S+A)) - GOT */=
=0D
+#define R_AARCH64_TLSIE_MOVW_GOTTPREL_G0_NC 540 /* G(TPREL(S+A)) - GOT =
*/=0D
+#define R_AARCH64_TLSIE_ADR_GOTTPREL_PAGE21 541 /* Page(G(TPREL(S+A))) =
- Page(P) */=0D
+#define R_AARCH64_TLSIE_LD64_GOTTPREL_LO12_NC 542 /* G(TPREL(S+A)) */=0D
+#define R_AARCH64_TLSIE_LD_GOTTPREL_PREL19 543 /* G(TPREL(S+A)) - P */=
=0D
+ /* Local Exec TLS relocations */=0D
+#define R_AARCH64_TLSLE_MOVW_TPREL_G2 544 /* TPREL(S+A) */=0D
+#define R_AARCH64_TLSLE_MOVW_TPREL_G1 545 /* TPREL(S+A) */=0D
+#define R_AARCH64_TLSLE_MOVW_TPREL_G1_NC 546 /* TPREL(S+A) */=0D
+#define R_AARCH64_TLSLE_MOVW_TPREL_G0 547 /* TPREL(S+A) */=0D
+#define R_AARCH64_TLSLE_MOVW_TPREL_G0_NC 548 /* TPREL(S+A) */=0D
+#define R_AARCH64_TLSLE_ADD_TPREL_HI12 549 /* TPREL(S+A) */=0D
+#define R_AARCH64_TLSLE_ADD_TPREL_LO12 550 /* TPREL(S+A) */=0D
+#define R_AARCH64_TLSLE_ADD_TPREL_LO12_NC 551 /* TPREL(S+A) */=0D
+#define R_AARCH64_TLSLE_LDST8_TPREL_LO12 552 /* TPREL(S+A) */=0D
+#define R_AARCH64_TLSLE_LDST8_TPREL_LO12_NC 553 /* TPREL(S+A) */=0D
+#define R_AARCH64_TLSLE_LDST16_TPREL_LO12 554 /* TPREL(S+A) */=0D
+#define R_AARCH64_TLSLE_LDST16_TPREL_LO12_NC 555 /* TPREL(S+A) */=0D
+#define R_AARCH64_TLSLE_LDST32_TPREL_LO12 556 /* TPREL(S+A) */=0D
+#define R_AARCH64_TLSLE_LDST32_TPREL_LO12_NC 557 /* TPREL(S+A) */=0D
+#define R_AARCH64_TLSLE_LDST64_TPREL_LO12 558 /* TPREL(S+A) */=0D
+#define R_AARCH64_TLSLE_LDST64_TPREL_LO12_NC 559 /* TPREL(S+A) */=0D
+/* Dynamic relocations */=0D
+ /* Dynamic relocations */=0D
+#define R_AARCH64_COPY 1024=0D
+#define R_AARCH64_GLOB_DAT 1025 /* S + A */=0D
+#define R_AARCH64_JUMP_SLOT 1026 /* S + A */=0D
+#define R_AARCH64_RELATIVE 1027 /* Delta(S) + A , Delta(P) + A */=0D
+#define R_AARCH64_TLS_DTPREL64 1028 /* DTPREL(S+A) */=0D
+#define R_AARCH64_TLS_DTPMOD64 1029 /* LDM(S) */=0D
+#define R_AARCH64_TLS_TPREL64 1030 /* TPREL(S+A) */=0D
+#define R_AARCH64_TLS_DTPREL32 1031 /* DTPREL(S+A) */=0D
+#define R_AARCH64_TLS_DTPMOD32 1032 /* LDM(S) */=0D
+#define R_AARCH64_TLS_TPREL32 1033 /* DTPREL(S+A) */=0D
+=0D
+#define R_ALPHA_NONE 0 /* No reloc */=0D
+#define R_ALPHA_REFLONG 1 /* Direct 32 bit */=0D
+#define R_ALPHA_REFQUAD 2 /* Direct 64 bit */=0D
+#define R_ALPHA_GPREL32 3 /* GP relative 32 bit */=0D
+#define R_ALPHA_LITERAL 4 /* GP relative 16 bit w/optimization */=0D
+#define R_ALPHA_LITUSE 5 /* Optimization hint for LITERAL */=0D
+#define R_ALPHA_GPDISP 6 /* Add displacement to GP */=0D
+#define R_ALPHA_BRADDR 7 /* PC+4 relative 23 bit shifted */=0D
+#define R_ALPHA_HINT 8 /* PC+4 relative 16 bit shifted */=0D
+#define R_ALPHA_SREL16 9 /* PC relative 16 bit */=0D
+#define R_ALPHA_SREL32 10 /* PC relative 32 bit */=0D
+#define R_ALPHA_SREL64 11 /* PC relative 64 bit */=0D
+#define R_ALPHA_OP_PUSH 12 /* OP stack push */=0D
+#define R_ALPHA_OP_STORE 13 /* OP stack pop and store */=0D
+#define R_ALPHA_OP_PSUB 14 /* OP stack subtract */=0D
+#define R_ALPHA_OP_PRSHIFT 15 /* OP stack right shift */=0D
+#define R_ALPHA_GPVALUE 16=0D
+#define R_ALPHA_GPRELHIGH 17=0D
+#define R_ALPHA_GPRELLOW 18=0D
+#define R_ALPHA_IMMED_GP_16 19=0D
+#define R_ALPHA_IMMED_GP_HI32 20=0D
+#define R_ALPHA_IMMED_SCN_HI32 21=0D
+#define R_ALPHA_IMMED_BR_HI32 22=0D
+#define R_ALPHA_IMMED_LO32 23=0D
+#define R_ALPHA_COPY 24 /* Copy symbol at runtime */=0D
+#define R_ALPHA_GLOB_DAT 25 /* Create GOT entry */=0D
+#define R_ALPHA_JMP_SLOT 26 /* Create PLT entry */=0D
+#define R_ALPHA_RELATIVE 27 /* Adjust by program base */=0D
+=0D
+#define R_ARM_NONE 0 /* No relocation. */=0D
+#define R_ARM_PC24 1=0D
+#define R_ARM_ABS32 2=0D
+#define R_ARM_REL32 3=0D
+#define R_ARM_PC13 4=0D
+#define R_ARM_ABS16 5=0D
+#define R_ARM_ABS12 6=0D
+#define R_ARM_THM_ABS5 7=0D
+#define R_ARM_ABS8 8=0D
+#define R_ARM_SBREL32 9=0D
+#define R_ARM_THM_PC22 10=0D
+#define R_ARM_THM_PC8 11=0D
+#define R_ARM_AMP_VCALL9 12=0D
+#define R_ARM_SWI24 13=0D
+#define R_ARM_THM_SWI8 14=0D
+#define R_ARM_XPC25 15=0D
+#define R_ARM_THM_XPC22 16=0D
+#define R_ARM_COPY 20 /* Copy data from shared object. */=0D
+#define R_ARM_GLOB_DAT 21 /* Set GOT entry to data address. */=0D
+#define R_ARM_JUMP_SLOT 22 /* Set GOT entry to code address. */=0D
+#define R_ARM_RELATIVE 23 /* Add load address of shared object. */=0D
+#define R_ARM_GOTOFF 24 /* Add GOT-relative symbol address. */=0D
+#define R_ARM_GOTPC 25 /* Add PC-relative GOT table address. */=0D
+#define R_ARM_GOT32 26 /* Add PC-relative GOT offset. */=0D
+#define R_ARM_PLT32 27 /* Add PC-relative PLT offset. */=0D
+#define R_ARM_CALL 28=0D
+#define R_ARM_JMP24 29=0D
+#define R_ARM_THM_MOVW_ABS_NC 47=0D
+#define R_ARM_THM_MOVT_ABS 48=0D
+=0D
+// Block of PC-relative relocations added to work around gcc putting=0D
+// object relocations in static executables.=0D
+#define R_ARM_THM_JUMP24 30=0D
+#define R_ARM_PREL31 42=0D
+#define R_ARM_MOVW_PREL_NC 45=0D
+#define R_ARM_MOVT_PREL 46=0D
+#define R_ARM_THM_MOVW_PREL_NC 49=0D
+#define R_ARM_THM_MOVT_PREL 50=0D
+#define R_ARM_THM_JMP6 52=0D
+#define R_ARM_THM_ALU_PREL_11_0 53=0D
+#define R_ARM_THM_PC12 54=0D
+#define R_ARM_REL32_NOI 56=0D
+#define R_ARM_ALU_PC_G0_NC 57=0D
+#define R_ARM_ALU_PC_G0 58=0D
+#define R_ARM_ALU_PC_G1_NC 59=0D
+#define R_ARM_ALU_PC_G1 60=0D
+#define R_ARM_ALU_PC_G2 61=0D
+#define R_ARM_LDR_PC_G1 62=0D
+#define R_ARM_LDR_PC_G2 63=0D
+#define R_ARM_LDRS_PC_G0 64=0D
+#define R_ARM_LDRS_PC_G1 65=0D
+#define R_ARM_LDRS_PC_G2 66=0D
+#define R_ARM_LDC_PC_G0 67=0D
+#define R_ARM_LDC_PC_G1 68=0D
+#define R_ARM_LDC_PC_G2 69=0D
+#define R_ARM_GOT_PREL 96=0D
+#define R_ARM_THM_JUMP11 102=0D
+#define R_ARM_THM_JUMP8 103=0D
+#define R_ARM_TLS_GD32 104=0D
+#define R_ARM_TLS_LDM32 105=0D
+#define R_ARM_TLS_IE32 107=0D
+=0D
+#define R_ARM_THM_JUMP19 51=0D
+#define R_ARM_GNU_VTENTRY 100=0D
+#define R_ARM_GNU_VTINHERIT 101=0D
+#define R_ARM_RSBREL32 250=0D
+#define R_ARM_THM_RPC22 251=0D
+#define R_ARM_RREL32 252=0D
+#define R_ARM_RABS32 253=0D
+#define R_ARM_RPC24 254=0D
+#define R_ARM_RBASE 255=0D
+=0D
+#define R_PPC_NONE 0 /* No relocation. */=0D
+#define R_PPC_ADDR32 1=0D
+#define R_PPC_ADDR24 2=0D
+#define R_PPC_ADDR16 3=0D
+#define R_PPC_ADDR16_LO 4=0D
+#define R_PPC_ADDR16_HI 5=0D
+#define R_PPC_ADDR16_HA 6=0D
+#define R_PPC_ADDR14 7=0D
+#define R_PPC_ADDR14_BRTAKEN 8=0D
+#define R_PPC_ADDR14_BRNTAKEN 9=0D
+#define R_PPC_REL24 10=0D
+#define R_PPC_REL14 11=0D
+#define R_PPC_REL14_BRTAKEN 12=0D
+#define R_PPC_REL14_BRNTAKEN 13=0D
+#define R_PPC_GOT16 14=0D
+#define R_PPC_GOT16_LO 15=0D
+#define R_PPC_GOT16_HI 16=0D
+#define R_PPC_GOT16_HA 17=0D
+#define R_PPC_PLTREL24 18=0D
+#define R_PPC_COPY 19=0D
+#define R_PPC_GLOB_DAT 20=0D
+#define R_PPC_JMP_SLOT 21=0D
+#define R_PPC_RELATIVE 22=0D
+#define R_PPC_LOCAL24PC 23=0D
+#define R_PPC_UADDR32 24=0D
+#define R_PPC_UADDR16 25=0D
+#define R_PPC_REL32 26=0D
+#define R_PPC_PLT32 27=0D
+#define R_PPC_PLTREL32 28=0D
+#define R_PPC_PLT16_LO 29=0D
+#define R_PPC_PLT16_HI 30=0D
+#define R_PPC_PLT16_HA 31=0D
+#define R_PPC_SDAREL16 32=0D
+#define R_PPC_SECTOFF 33=0D
+#define R_PPC_SECTOFF_LO 34=0D
+#define R_PPC_SECTOFF_HI 35=0D
+#define R_PPC_SECTOFF_HA 36=0D
+=0D
+/*=0D
+ * TLS relocations=0D
+ */=0D
+#define R_PPC_TLS 67=0D
+#define R_PPC_DTPMOD32 68=0D
+#define R_PPC_TPREL16 69=0D
+#define R_PPC_TPREL16_LO 70=0D
+#define R_PPC_TPREL16_HI 71=0D
+#define R_PPC_TPREL16_HA 72=0D
+#define R_PPC_TPREL32 73=0D
+#define R_PPC_DTPREL16 74=0D
+#define R_PPC_DTPREL16_LO 75=0D
+#define R_PPC_DTPREL16_HI 76=0D
+#define R_PPC_DTPREL16_HA 77=0D
+#define R_PPC_DTPREL32 78=0D
+#define R_PPC_GOT_TLSGD16 79=0D
+#define R_PPC_GOT_TLSGD16_LO 80=0D
+#define R_PPC_GOT_TLSGD16_HI 81=0D
+#define R_PPC_GOT_TLSGD16_HA 82=0D
+#define R_PPC_GOT_TLSLD16 83=0D
+#define R_PPC_GOT_TLSLD16_LO 84=0D
+#define R_PPC_GOT_TLSLD16_HI 85=0D
+#define R_PPC_GOT_TLSLD16_HA 86=0D
+#define R_PPC_GOT_TPREL16 87=0D
+#define R_PPC_GOT_TPREL16_LO 88=0D
+#define R_PPC_GOT_TPREL16_HI 89=0D
+#define R_PPC_GOT_TPREL16_HA 90=0D
+=0D
+/*=0D
+ * The remaining relocs are from the Embedded ELF ABI, and are not in the=
=0D
+ * SVR4 ELF ABI.=0D
+ */=0D
+=0D
+#define R_PPC_EMB_NADDR32 101=0D
+#define R_PPC_EMB_NADDR16 102=0D
+#define R_PPC_EMB_NADDR16_LO 103=0D
+#define R_PPC_EMB_NADDR16_HI 104=0D
+#define R_PPC_EMB_NADDR16_HA 105=0D
+#define R_PPC_EMB_SDAI16 106=0D
+#define R_PPC_EMB_SDA2I16 107=0D
+#define R_PPC_EMB_SDA2REL 108=0D
+#define R_PPC_EMB_SDA21 109=0D
+#define R_PPC_EMB_MRKREF 110=0D
+#define R_PPC_EMB_RELSEC16 111=0D
+#define R_PPC_EMB_RELST_LO 112=0D
+#define R_PPC_EMB_RELST_HI 113=0D
+#define R_PPC_EMB_RELST_HA 114=0D
+#define R_PPC_EMB_BIT_FLD 115=0D
+#define R_PPC_EMB_RELSDA 116=0D
+=0D
+#define R_SPARC_NONE 0=0D
+#define R_SPARC_8 1=0D
+#define R_SPARC_16 2=0D
+#define R_SPARC_32 3=0D
+#define R_SPARC_DISP8 4=0D
+#define R_SPARC_DISP16 5=0D
+#define R_SPARC_DISP32 6=0D
+#define R_SPARC_WDISP30 7=0D
+#define R_SPARC_WDISP22 8=0D
+#define R_SPARC_HI22 9=0D
+#define R_SPARC_22 10=0D
+#define R_SPARC_13 11=0D
+#define R_SPARC_LO10 12=0D
+#define R_SPARC_GOT10 13=0D
+#define R_SPARC_GOT13 14=0D
+#define R_SPARC_GOT22 15=0D
+#define R_SPARC_PC10 16=0D
+#define R_SPARC_PC22 17=0D
+#define R_SPARC_WPLT30 18=0D
+#define R_SPARC_COPY 19=0D
+#define R_SPARC_GLOB_DAT 20=0D
+#define R_SPARC_JMP_SLOT 21=0D
+#define R_SPARC_RELATIVE 22=0D
+#define R_SPARC_UA32 23=0D
+#define R_SPARC_PLT32 24=0D
+#define R_SPARC_HIPLT22 25=0D
+#define R_SPARC_LOPLT10 26=0D
+#define R_SPARC_PCPLT32 27=0D
+#define R_SPARC_PCPLT22 28=0D
+#define R_SPARC_PCPLT10 29=0D
+#define R_SPARC_10 30=0D
+#define R_SPARC_11 31=0D
+#define R_SPARC_64 32=0D
+#define R_SPARC_OLO10 33=0D
+#define R_SPARC_HH22 34=0D
+#define R_SPARC_HM10 35=0D
+#define R_SPARC_LM22 36=0D
+#define R_SPARC_PC_HH22 37=0D
+#define R_SPARC_PC_HM10 38=0D
+#define R_SPARC_PC_LM22 39=0D
+#define R_SPARC_WDISP16 40=0D
+#define R_SPARC_WDISP19 41=0D
+#define R_SPARC_GLOB_JMP 42=0D
+#define R_SPARC_7 43=0D
+#define R_SPARC_5 44=0D
+#define R_SPARC_6 45=0D
+#define R_SPARC_DISP64 46=0D
+#define R_SPARC_PLT64 47=0D
+#define R_SPARC_HIX22 48=0D
+#define R_SPARC_LOX10 49=0D
+#define R_SPARC_H44 50=0D
+#define R_SPARC_M44 51=0D
+#define R_SPARC_L44 52=0D
+#define R_SPARC_REGISTER 53=0D
+#define R_SPARC_UA64 54=0D
+#define R_SPARC_UA16 55=0D
+#define R_SPARC_TLS_GD_HI22 56=0D
+#define R_SPARC_TLS_GD_LO10 57=0D
+#define R_SPARC_TLS_GD_ADD 58=0D
+#define R_SPARC_TLS_GD_CALL 59=0D
+#define R_SPARC_TLS_LDM_HI22 60=0D
+#define R_SPARC_TLS_LDM_LO10 61=0D
+#define R_SPARC_TLS_LDM_ADD 62=0D
+#define R_SPARC_TLS_LDM_CALL 63=0D
+#define R_SPARC_TLS_LDO_HIX22 64=0D
+#define R_SPARC_TLS_LDO_LOX10 65=0D
+#define R_SPARC_TLS_LDO_ADD 66=0D
+#define R_SPARC_TLS_IE_HI22 67=0D
+#define R_SPARC_TLS_IE_LO10 68=0D
+#define R_SPARC_TLS_IE_LD 69=0D
+#define R_SPARC_TLS_IE_LDX 70=0D
+#define R_SPARC_TLS_IE_ADD 71=0D
+#define R_SPARC_TLS_LE_HIX22 72=0D
+#define R_SPARC_TLS_LE_LOX10 73=0D
+#define R_SPARC_TLS_DTPMOD32 74=0D
+#define R_SPARC_TLS_DTPMOD64 75=0D
+#define R_SPARC_TLS_DTPOFF32 76=0D
+#define R_SPARC_TLS_DTPOFF64 77=0D
+#define R_SPARC_TLS_TPOFF32 78=0D
+#define R_SPARC_TLS_TPOFF64 79=0D
+=0D
+#define R_X86_64_NONE 0 /* No relocation. */=0D
+#define R_X86_64_64 1 /* Add 64 bit symbol value. */=0D
+#define R_X86_64_PC32 2 /* PC-relative 32 bit signed sym value. */=0D
+#define R_X86_64_GOT32 3 /* PC-relative 32 bit GOT offset. */=0D
+#define R_X86_64_PLT32 4 /* PC-relative 32 bit PLT offset. */=0D
+#define R_X86_64_COPY 5 /* Copy data from shared object. */=0D
+#define R_X86_64_GLOB_DAT 6 /* Set GOT entry to data address. */=0D
+#define R_X86_64_JMP_SLOT 7 /* Set GOT entry to code address. */=0D
+#define R_X86_64_RELATIVE 8 /* Add load address of shared object. */=0D
+#define R_X86_64_GOTPCREL 9 /* Add 32 bit signed pcrel offset to GOT. *=
/=0D
+#define R_X86_64_32 10 /* Add 32 bit zero extended symbol value */=0D
+#define R_X86_64_32S 11 /* Add 32 bit sign extended symbol value */=0D
+#define R_X86_64_16 12 /* Add 16 bit zero extended symbol value */=0D
+#define R_X86_64_PC16 13 /* Add 16 bit signed extended pc relative sy=
mbol value */=0D
+#define R_X86_64_8 14 /* Add 8 bit zero extended symbol value */=0D
+#define R_X86_64_PC8 15 /* Add 8 bit signed extended pc relative symb=
ol value */=0D
+#define R_X86_64_DTPMOD64 16 /* ID of module containing symbol */=0D
+#define R_X86_64_DTPOFF64 17 /* Offset in TLS block */=0D
+#define R_X86_64_TPOFF64 18 /* Offset in static TLS block */=0D
+#define R_X86_64_TLSGD 19 /* PC relative offset to GD GOT entry */=0D
+#define R_X86_64_TLSLD 20 /* PC relative offset to LD GOT entry */=0D
+#define R_X86_64_DTPOFF32 21 /* Offset in TLS block */=0D
+#define R_X86_64_GOTTPOFF 22 /* PC relative offset to IE GOT entry */=0D
+#define R_X86_64_TPOFF32 23 /* Offset in static TLS block */=0D
+#define R_X86_64_PC64 24 /* PC relative 64 bit */=0D
+#define R_X86_64_GOTOFF64 25 /* 64 bit offset to GOT */=0D
+#define R_X86_64_GOTPC3 26 /* 32 bit signed pc relative offset to GOT *=
/=0D
+#define R_X86_64_GOT64 27 /* 64-bit GOT entry offset */=0D
+#define R_X86_64_GOTPCREL64 28 /* 64-bit PC relative offset to GOT entr=
y */=0D
+#define R_X86_64_GOTPC64 29 /* 64-bit PC relative offset to GOT */=0D
+#define R_X86_64_GOTPLT64 30 /* like GOT64, says PLT entry needed */=0D
+#define R_X86_64_PLTOFF64 31 /* 64-bit GOT relative offset to PLT entry=
*/=0D
+#define R_X86_64_SIZE32 32 /* Size of symbol plus 32-bit addend */=0D
+#define R_X86_64_SIZE64 33 /* Size of symbol plus 64-bit addend */=0D
+#define R_X86_64_GOTPC32_TLSDESC 34 /* GOT offset for TLS descriptor. *=
/=0D
+#define R_X86_64_TLSDESC_CALL 35 /* Marker for call through TLS descrip=
tor. */=0D
+#define R_X86_64_TLSDESC 36 /* TLS descriptor. */=0D
+#define R_X86_64_IRELATIVE 37 /* Adjust indirectly by program base */=0D
+#define R_X86_64_RELATIVE64 38 /* 64-bit adjust by program base */=0D
+#define R_X86_64_GOTPCRELX 41 /* Load from 32 bit signed pc relative of=
fset to GOT entry without REX prefix, relaxable. */=0D
+#define R_X86_64_REX_GOTPCRELX 42 /* Load from 32 bit signed pc relativ=
e offset to GOT entry with REX prefix, relaxable. */=0D
+=0D
+=0D
+#endif /* !_SYS_ELF_COMMON_H_ */=0D
diff --git a/UefiPayloadPkg/PayloadLoaderPeim/ElfLib/ElfLib.c b/UefiPayload=
Pkg/PayloadLoaderPeim/ElfLib/ElfLib.c
new file mode 100644
index 0000000000..531b3486d2
--- /dev/null
+++ b/UefiPayloadPkg/PayloadLoaderPeim/ElfLib/ElfLib.c
@@ -0,0 +1,473 @@
+/** @file=0D
+ ELF library=0D
+=0D
+ Copyright (c) 2019 - 2021, Intel Corporation. All rights reserved.<BR>=0D
+ SPDX-License-Identifier: BSD-2-Clause-Patent=0D
+=0D
+**/=0D
+=0D
+#include "ElfLibInternal.h"=0D
+=0D
+/**=0D
+ Check if the ELF image is valid.=0D
+=0D
+ @param[in] ImageBase Memory address of an image.=0D
+=0D
+ @retval TRUE if valid.=0D
+=0D
+**/=0D
+BOOLEAN=0D
+IsElfFormat (=0D
+ IN CONST UINT8 *ImageBase=0D
+ )=0D
+{=0D
+ Elf32_Ehdr *Elf32Hdr;=0D
+ Elf64_Ehdr *Elf64Hdr;=0D
+=0D
+ ASSERT (ImageBase !=3D NULL);=0D
+=0D
+ Elf32Hdr =3D (Elf32_Ehdr *)ImageBase;=0D
+=0D
+ //=0D
+ // Start with correct signature "\7fELF"=0D
+ //=0D
+ if ((Elf32Hdr->e_ident[EI_MAG0] !=3D ELFMAG0) ||=0D
+ (Elf32Hdr->e_ident[EI_MAG1] !=3D ELFMAG1) ||=0D
+ (Elf32Hdr->e_ident[EI_MAG1] !=3D ELFMAG1) ||=0D
+ (Elf32Hdr->e_ident[EI_MAG2] !=3D ELFMAG2)=0D
+ ) {=0D
+ return FALSE;=0D
+ }=0D
+=0D
+ //=0D
+ // Support little-endian only=0D
+ //=0D
+ if (Elf32Hdr->e_ident[EI_DATA] !=3D ELFDATA2LSB) {=0D
+ return FALSE;=0D
+ }=0D
+=0D
+ //=0D
+ // Check 32/64-bit architecture=0D
+ //=0D
+ if (Elf32Hdr->e_ident[EI_CLASS] =3D=3D ELFCLASS64) {=0D
+ Elf64Hdr =3D (Elf64_Ehdr *)Elf32Hdr;=0D
+ Elf32Hdr =3D NULL;=0D
+ } else if (Elf32Hdr->e_ident[EI_CLASS] =3D=3D ELFCLASS32) {=0D
+ Elf64Hdr =3D NULL;=0D
+ } else {=0D
+ return FALSE;=0D
+ }=0D
+=0D
+ if (Elf64Hdr !=3D NULL) {=0D
+ //=0D
+ // Support intel architecture only for now=0D
+ //=0D
+ if (Elf64Hdr->e_machine !=3D EM_X86_64) {=0D
+ return FALSE;=0D
+ }=0D
+=0D
+ //=0D
+ // Support ELF types: EXEC (Executable file), DYN (Shared object file=
)=0D
+ //=0D
+ if ((Elf64Hdr->e_type !=3D ET_EXEC) && (Elf64Hdr->e_type !=3D ET_DYN))=
{=0D
+ return FALSE;=0D
+ }=0D
+=0D
+ //=0D
+ // Support current ELF version only=0D
+ //=0D
+ if (Elf64Hdr->e_version !=3D EV_CURRENT) {=0D
+ return FALSE;=0D
+ }=0D
+ } else {=0D
+ //=0D
+ // Support intel architecture only for now=0D
+ //=0D
+ if (Elf32Hdr->e_machine !=3D EM_386) {=0D
+ return FALSE;=0D
+ }=0D
+=0D
+ //=0D
+ // Support ELF types: EXEC (Executable file), DYN (Shared object file=
)=0D
+ //=0D
+ if ((Elf32Hdr->e_type !=3D ET_EXEC) && (Elf32Hdr->e_type !=3D ET_DYN))=
{=0D
+ return FALSE;=0D
+ }=0D
+=0D
+ //=0D
+ // Support current ELF version only=0D
+ //=0D
+ if (Elf32Hdr->e_version !=3D EV_CURRENT) {=0D
+ return FALSE;=0D
+ }=0D
+ }=0D
+ return TRUE;=0D
+}=0D
+=0D
+/**=0D
+ Calculate a ELF file size.=0D
+=0D
+ @param[in] ElfCt ELF image context pointer.=0D
+ @param[out] FileSize Return the file size.=0D
+=0D
+ @retval EFI_INVALID_PARAMETER ElfCt or SecPos is NULL.=0D
+ @retval EFI_NOT_FOUND Could not find the section.=0D
+ @retval EFI_SUCCESS Section posistion was filled successfull=
y.=0D
+**/=0D
+EFI_STATUS=0D
+CalculateElfFileSize (=0D
+ IN ELF_IMAGE_CONTEXT *ElfCt,=0D
+ OUT UINTN *FileSize=0D
+ )=0D
+{=0D
+ EFI_STATUS Status;=0D
+ UINTN FileSize1;=0D
+ UINTN FileSize2;=0D
+ Elf32_Ehdr *Elf32Hdr;=0D
+ Elf64_Ehdr *Elf64Hdr;=0D
+ UINTN Offset;=0D
+ UINTN Size;=0D
+=0D
+ if ((ElfCt =3D=3D NULL) || (FileSize =3D=3D NULL)) {=0D
+ return EFI_INVALID_PARAMETER;=0D
+ }=0D
+=0D
+ // Use last section as end of file=0D
+ Status =3D GetElfSectionPos (ElfCt, ElfCt->ShNum - 1, &Offset, &Size);=0D
+ if (EFI_ERROR(Status)) {=0D
+ return EFI_UNSUPPORTED;=0D
+ }=0D
+ FileSize1 =3D Offset + Size;=0D
+=0D
+ // Use end of section header as end of file=0D
+ FileSize2 =3D 0;=0D
+ if (ElfCt->EiClass =3D=3D ELFCLASS32) {=0D
+ Elf32Hdr =3D (Elf32_Ehdr *)ElfCt->FileBase;=0D
+ FileSize2 =3D Elf32Hdr->e_shoff + Elf32Hdr->e_shentsize * Elf32Hdr->e_=
shnum;=0D
+ } else if (ElfCt->EiClass =3D=3D ELFCLASS64) {=0D
+ Elf64Hdr =3D (Elf64_Ehdr *)ElfCt->FileBase;=0D
+ FileSize2 =3D (UINTN)(Elf64Hdr->e_shoff + Elf64Hdr->e_shentsize * Elf6=
4Hdr->e_shnum);=0D
+ }=0D
+=0D
+ *FileSize =3D MAX(FileSize1, FileSize2);=0D
+=0D
+ return EFI_SUCCESS;=0D
+}=0D
+=0D
+/**=0D
+ Get a ELF program segment loading info.=0D
+=0D
+ @param[in] ImageBase Image base.=0D
+ @param[in] EiClass ELF class.=0D
+ @param[in] Index ELF segment index.=0D
+ @param[out] SegInfo The pointer to the segment info.=0D
+=0D
+ @retval EFI_INVALID_PARAMETER ElfCt or SecPos is NULL.=0D
+ @retval EFI_NOT_FOUND Could not find the section.=0D
+ @retval EFI_SUCCESS Section posistion was filled successfull=
y.=0D
+**/=0D
+EFI_STATUS=0D
+GetElfSegmentInfo (=0D
+ IN UINT8 *ImageBase,=0D
+ IN UINT32 EiClass,=0D
+ IN UINT32 Index,=0D
+ OUT SEGMENT_INFO *SegInfo=0D
+ )=0D
+{=0D
+ Elf32_Phdr *Elf32Phdr;=0D
+ Elf64_Phdr *Elf64Phdr;=0D
+=0D
+ if ((ImageBase =3D=3D NULL) || (SegInfo =3D=3D NULL)) {=0D
+ return EFI_INVALID_PARAMETER;=0D
+ }=0D
+=0D
+ if (EiClass =3D=3D ELFCLASS32) {=0D
+ Elf32Phdr =3D GetElf32SegmentByIndex (ImageBase, Index);=0D
+ if (Elf32Phdr !=3D NULL) {=0D
+ SegInfo->PtType =3D Elf32Phdr->p_type;=0D
+ SegInfo->Offset =3D Elf32Phdr->p_offset;=0D
+ SegInfo->Length =3D Elf32Phdr->p_filesz;=0D
+ SegInfo->MemLen =3D Elf32Phdr->p_memsz;=0D
+ SegInfo->MemAddr =3D Elf32Phdr->p_paddr;=0D
+ SegInfo->Alignment =3D Elf32Phdr->p_align;=0D
+ return EFI_SUCCESS;=0D
+ }=0D
+ } else if (EiClass =3D=3D ELFCLASS64) {=0D
+ Elf64Phdr =3D GetElf64SegmentByIndex (ImageBase, Index);=0D
+ if (Elf64Phdr !=3D NULL) {=0D
+ SegInfo->PtType =3D Elf64Phdr->p_type;=0D
+ SegInfo->Offset =3D (UINTN)Elf64Phdr->p_offset;=0D
+ SegInfo->Length =3D (UINTN)Elf64Phdr->p_filesz;=0D
+ SegInfo->MemLen =3D (UINTN)Elf64Phdr->p_memsz;=0D
+ SegInfo->MemAddr =3D (UINTN)Elf64Phdr->p_paddr;=0D
+ SegInfo->Alignment =3D (UINTN)Elf64Phdr->p_align;=0D
+ return EFI_SUCCESS;=0D
+ }=0D
+ }=0D
+=0D
+ return EFI_NOT_FOUND;=0D
+}=0D
+=0D
+/**=0D
+ Parse the ELF image info.=0D
+=0D
+ On return, all fields in ElfCt are updated except ImageAddress.=0D
+=0D
+ @param[in] ImageBase Memory address of an image.=0D
+ @param[out] ElfCt The EFL image context pointer.=0D
+=0D
+ @retval EFI_INVALID_PARAMETER Input parameters are not valid.=0D
+ @retval EFI_UNSUPPORTED Unsupported binary type.=0D
+ @retval EFI_LOAD_ERROR ELF binary loading error.=0D
+ @retval EFI_SUCCESS ELF binary is loaded successfully.=0D
+**/=0D
+EFI_STATUS=0D
+EFIAPI=0D
+ParseElfImage (=0D
+ IN VOID *ImageBase,=0D
+ OUT ELF_IMAGE_CONTEXT *ElfCt=0D
+ )=0D
+{=0D
+ Elf32_Ehdr *Elf32Hdr;=0D
+ Elf64_Ehdr *Elf64Hdr;=0D
+ Elf32_Shdr *Elf32Shdr;=0D
+ Elf64_Shdr *Elf64Shdr;=0D
+ EFI_STATUS Status;=0D
+ UINT32 Index;=0D
+ SEGMENT_INFO SegInfo;=0D
+ UINTN End;=0D
+ UINTN Base;=0D
+=0D
+ if (ElfCt =3D=3D NULL) {=0D
+ return EFI_INVALID_PARAMETER;=0D
+ }=0D
+ ZeroMem (ElfCt, sizeof(ELF_IMAGE_CONTEXT));=0D
+=0D
+ if (ImageBase =3D=3D NULL) {=0D
+ return (ElfCt->ParseStatus =3D EFI_INVALID_PARAMETER);=0D
+ }=0D
+=0D
+ ElfCt->FileBase =3D (UINT8 *)ImageBase;=0D
+ if (!IsElfFormat (ElfCt->FileBase)) {=0D
+ return (ElfCt->ParseStatus =3D EFI_UNSUPPORTED);=0D
+ }=0D
+=0D
+ Elf32Hdr =3D (Elf32_Ehdr *)ElfCt->FileBase;=0D
+ ElfCt->EiClass =3D Elf32Hdr->e_ident[EI_CLASS];=0D
+ if (ElfCt->EiClass =3D=3D ELFCLASS32) {=0D
+ if ((Elf32Hdr->e_type !=3D ET_EXEC) && (Elf32Hdr->e_type !=3D ET_DYN))=
{=0D
+ return (ElfCt->ParseStatus =3D EFI_UNSUPPORTED);=0D
+ }=0D
+ Elf32Shdr =3D (Elf32_Shdr *)GetElf32SectionByIndex (ElfCt->FileBase, E=
lf32Hdr->e_shstrndx);=0D
+ if (Elf32Shdr =3D=3D NULL) {=0D
+ return (ElfCt->ParseStatus =3D EFI_UNSUPPORTED);=0D
+ }=0D
+ ElfCt->EntryPoint =3D (UINTN)Elf32Hdr->e_entry;=0D
+ ElfCt->ShNum =3D Elf32Hdr->e_shnum;=0D
+ ElfCt->PhNum =3D Elf32Hdr->e_phnum;=0D
+ ElfCt->ShStrLen =3D Elf32Shdr->sh_size;=0D
+ ElfCt->ShStrOff =3D Elf32Shdr->sh_offset;=0D
+ } else {=0D
+ Elf64Hdr =3D (Elf64_Ehdr *)Elf32Hdr;=0D
+ if ((Elf64Hdr->e_type !=3D ET_EXEC) && (Elf64Hdr->e_type !=3D ET_DYN))=
{=0D
+ return (ElfCt->ParseStatus =3D EFI_UNSUPPORTED);=0D
+ }=0D
+ Elf64Shdr =3D (Elf64_Shdr *)GetElf64SectionByIndex (ElfCt->FileBase, E=
lf64Hdr->e_shstrndx);=0D
+ if (Elf64Shdr =3D=3D NULL) {=0D
+ return (ElfCt->ParseStatus =3D EFI_UNSUPPORTED);=0D
+ }=0D
+ ElfCt->EntryPoint =3D (UINTN)Elf64Hdr->e_entry;=0D
+ ElfCt->ShNum =3D Elf64Hdr->e_shnum;=0D
+ ElfCt->PhNum =3D Elf64Hdr->e_phnum;=0D
+ ElfCt->ShStrLen =3D (UINT32)Elf64Shdr->sh_size;=0D
+ ElfCt->ShStrOff =3D (UINT32)Elf64Shdr->sh_offset;=0D
+ }=0D
+=0D
+ //=0D
+ // Get the preferred image base and required memory size when loaded to =
new location.=0D
+ //=0D
+ End =3D 0;=0D
+ Base =3D MAX_UINT32;=0D
+ ElfCt->ReloadRequired =3D FALSE;=0D
+ for (Index =3D 0; Index < ElfCt->PhNum; Index++) {=0D
+ Status =3D GetElfSegmentInfo (ElfCt->FileBase, ElfCt->EiClass, Index, =
&SegInfo);=0D
+ ASSERT_EFI_ERROR (Status);=0D
+=0D
+ if (SegInfo.PtType !=3D PT_LOAD) {=0D
+ continue;=0D
+ }=0D
+=0D
+ if (SegInfo.MemLen !=3D SegInfo.Length) {=0D
+ //=0D
+ // Not enough space to execute at current location.=0D
+ //=0D
+ ElfCt->ReloadRequired =3D TRUE;=0D
+ }=0D
+=0D
+ if (Base > (SegInfo.MemAddr & ~(EFI_PAGE_SIZE - 1))) {=0D
+ Base =3D SegInfo.MemAddr & ~(EFI_PAGE_SIZE - 1);=0D
+ }=0D
+ if (End < ALIGN_VALUE (SegInfo.MemAddr + SegInfo.MemLen, EFI_PAGE_SIZE=
) - 1) {=0D
+ End =3D ALIGN_VALUE (SegInfo.MemAddr + SegInfo.MemLen, EFI_PAGE_SIZE=
) - 1;=0D
+ }=0D
+ }=0D
+ //=0D
+ // 0 - MAX_UINT32 + 1 equals to 0.=0D
+ //=0D
+ ElfCt->ImageSize =3D End - Base + 1;=0D
+ ElfCt->PreferredImageAddress =3D (VOID *) Base;=0D
+=0D
+ CalculateElfFileSize (ElfCt, &ElfCt->FileSize);=0D
+ return (ElfCt->ParseStatus =3D EFI_SUCCESS);;=0D
+}=0D
+=0D
+/**=0D
+ Load the ELF image to Context.ImageAddress.=0D
+=0D
+ Context should be initialized by ParseElfImage().=0D
+ Caller should set Context.ImageAddress to a proper value, either pointin=
g to=0D
+ a new allocated memory whose size equal to Context.ImageSize, or pointin=
g=0D
+ to Context.PreferredImageAddress.=0D
+=0D
+ @param[in] ElfCt ELF image context pointer.=0D
+=0D
+ @retval EFI_INVALID_PARAMETER Input parameters are not valid.=0D
+ @retval EFI_UNSUPPORTED Unsupported binary type.=0D
+ @retval EFI_LOAD_ERROR ELF binary loading error.=0D
+ @retval EFI_SUCCESS ELF binary is loaded successfully.=0D
+**/=0D
+EFI_STATUS=0D
+EFIAPI=0D
+LoadElfImage (=0D
+ IN ELF_IMAGE_CONTEXT *ElfCt=0D
+ )=0D
+{=0D
+ EFI_STATUS Status;=0D
+=0D
+ if (ElfCt =3D=3D NULL) {=0D
+ return EFI_INVALID_PARAMETER;=0D
+ }=0D
+=0D
+ if (EFI_ERROR (ElfCt->ParseStatus)) {=0D
+ return ElfCt->ParseStatus;=0D
+ }=0D
+=0D
+ if (ElfCt->ImageAddress =3D=3D NULL) {=0D
+ return EFI_INVALID_PARAMETER;=0D
+ }=0D
+=0D
+ Status =3D EFI_UNSUPPORTED;=0D
+ if (ElfCt->EiClass =3D=3D ELFCLASS32) {=0D
+ Status =3D LoadElf32Image (ElfCt);=0D
+ } else if (ElfCt->EiClass =3D=3D ELFCLASS64) {=0D
+ Status =3D LoadElf64Image (ElfCt);=0D
+ }=0D
+=0D
+ return Status;=0D
+}=0D
+=0D
+=0D
+/**=0D
+ Get a ELF section name from its index.=0D
+=0D
+ @param[in] ElfCt ELF image context pointer.=0D
+ @param[in] SectionIndex ELF section index.=0D
+ @param[out] SectionName The pointer to the section name.=0D
+=0D
+ @retval EFI_INVALID_PARAMETER ElfCt or SecName is NULL.=0D
+ @retval EFI_NOT_FOUND Could not find the section.=0D
+ @retval EFI_SUCCESS Section name was filled successfully.=0D
+**/=0D
+EFI_STATUS=0D
+EFIAPI=0D
+GetElfSectionName (=0D
+ IN ELF_IMAGE_CONTEXT *ElfCt,=0D
+ IN UINT32 SectionIndex,=0D
+ OUT CHAR8 **SectionName=0D
+ )=0D
+{=0D
+ Elf32_Shdr *Elf32Shdr;=0D
+ Elf64_Shdr *Elf64Shdr;=0D
+ CHAR8 *Name;=0D
+=0D
+ if ((ElfCt =3D=3D NULL) || (SectionName =3D=3D NULL)) {=0D
+ return EFI_INVALID_PARAMETER;=0D
+ }=0D
+=0D
+ if (EFI_ERROR (ElfCt->ParseStatus)) {=0D
+ return ElfCt->ParseStatus;=0D
+ }=0D
+=0D
+ Name =3D NULL;=0D
+ if (ElfCt->EiClass =3D=3D ELFCLASS32) {=0D
+ Elf32Shdr =3D GetElf32SectionByIndex (ElfCt->FileBase, SectionIndex);=
=0D
+ if ((Elf32Shdr !=3D NULL) && (Elf32Shdr->sh_name < ElfCt->ShStrLen)) {=
=0D
+ Name =3D (CHAR8 *)(ElfCt->FileBase + ElfCt->ShStrOff + Elf32Shdr->sh=
_name);=0D
+ }=0D
+ } else if (ElfCt->EiClass =3D=3D ELFCLASS64) {=0D
+ Elf64Shdr =3D GetElf64SectionByIndex (ElfCt->FileBase, SectionIndex);=
=0D
+ if ((Elf64Shdr !=3D NULL) && (Elf64Shdr->sh_name < ElfCt->ShStrLen)) {=
=0D
+ Name =3D (CHAR8 *)(ElfCt->FileBase + ElfCt->ShStrOff + Elf64Shdr->sh=
_name);=0D
+ }=0D
+ }=0D
+=0D
+ if (Name =3D=3D NULL) {=0D
+ return EFI_NOT_FOUND;=0D
+ }=0D
+=0D
+ *SectionName =3D Name;=0D
+ return EFI_SUCCESS;=0D
+}=0D
+=0D
+=0D
+/**=0D
+ Get the offset and size of x-th ELF section.=0D
+=0D
+ @param[in] ElfCt ELF image context pointer.=0D
+ @param[in] Index ELF section index.=0D
+ @param[out] Offset Return the offset of the specific sectio=
n.=0D
+ @param[out] Size Return the size of the specific section.=
=0D
+=0D
+ @retval EFI_INVALID_PARAMETER ImageBase, Offset or Size is NULL.=0D
+ @retval EFI_INVALID_PARAMETER EiClass doesn't equal to ELFCLASS32 or E=
LFCLASS64.=0D
+ @retval EFI_NOT_FOUND Could not find the section.=0D
+ @retval EFI_SUCCESS Offset and Size are returned.=0D
+**/=0D
+EFI_STATUS=0D
+EFIAPI=0D
+GetElfSectionPos (=0D
+ IN ELF_IMAGE_CONTEXT *ElfCt,=0D
+ IN UINT32 Index,=0D
+ OUT UINTN *Offset,=0D
+ OUT UINTN *Size=0D
+ )=0D
+{=0D
+ Elf32_Shdr *Elf32Shdr;=0D
+ Elf64_Shdr *Elf64Shdr;=0D
+=0D
+ if ((ElfCt =3D=3D NULL) || (Offset =3D=3D NULL) || (Size =3D=3D NULL)) {=
=0D
+ return EFI_INVALID_PARAMETER;=0D
+ }=0D
+=0D
+ if (EFI_ERROR (ElfCt->ParseStatus)) {=0D
+ return ElfCt->ParseStatus;=0D
+ }=0D
+=0D
+ if (ElfCt->EiClass =3D=3D ELFCLASS32) {=0D
+ Elf32Shdr =3D GetElf32SectionByIndex (ElfCt->FileBase, Index);=0D
+ if (Elf32Shdr !=3D NULL) {=0D
+ *Offset =3D (UINTN)Elf32Shdr->sh_offset;=0D
+ *Size =3D (UINTN)Elf32Shdr->sh_size;=0D
+ return EFI_SUCCESS;=0D
+ }=0D
+ } else if (ElfCt->EiClass =3D=3D ELFCLASS64) {=0D
+ Elf64Shdr =3D GetElf64SectionByIndex (ElfCt->FileBase, Index);=0D
+ if (Elf64Shdr !=3D NULL) {=0D
+ *Offset =3D (UINTN)Elf64Shdr->sh_offset;=0D
+ *Size =3D (UINTN)Elf64Shdr->sh_size;=0D
+ return EFI_SUCCESS;=0D
+ }=0D
+ }=0D
+=0D
+ return EFI_NOT_FOUND;=0D
+}=0D
diff --git a/UefiPayloadPkg/PayloadLoaderPeim/ElfLib/ElfLibInternal.h b/Uef=
iPayloadPkg/PayloadLoaderPeim/ElfLib/ElfLibInternal.h
new file mode 100644
index 0000000000..3c782807e2
--- /dev/null
+++ b/UefiPayloadPkg/PayloadLoaderPeim/ElfLib/ElfLibInternal.h
@@ -0,0 +1,109 @@
+/** @file=0D
+ ELF library=0D
+=0D
+ Copyright (c) 2019 - 2021, Intel Corporation. All rights reserved.<BR>=0D
+ SPDX-License-Identifier: BSD-2-Clause-Patent=0D
+=0D
+**/=0D
+=0D
+#ifndef EFI_LIB_INTERNAL_H_=0D
+#define EFI_LIB_INTERNAL_H_=0D
+=0D
+#include <Library/BaseLib.h>=0D
+#include <Library/DebugLib.h>=0D
+#include <Library/BaseMemoryLib.h>=0D
+#include "ElfLib.h"=0D
+#include "ElfCommon.h"=0D
+#include "Elf32.h"=0D
+#include "Elf64.h"=0D
+=0D
+#define ELF_NEXT_ENTRY(EntryType, Current, EntrySize) \=0D
+ ((EntryType *) ((UINT8 *)Current + EntrySize))=0D
+=0D
+=0D
+/**=0D
+ Return the section header specified by Index.=0D
+=0D
+ @param ImageBase The image base.=0D
+ @param Index The section index.=0D
+=0D
+ @return Pointer to the section header.=0D
+**/=0D
+Elf32_Shdr *=0D
+GetElf32SectionByIndex (=0D
+ IN UINT8 *ImageBase,=0D
+ IN UINT32 Index=0D
+ );=0D
+=0D
+/**=0D
+ Return the section header specified by Index.=0D
+=0D
+ @param ImageBase The image base.=0D
+ @param Index The section index.=0D
+=0D
+ @return Pointer to the section header.=0D
+**/=0D
+Elf64_Shdr *=0D
+GetElf64SectionByIndex (=0D
+ IN UINT8 *ImageBase,=0D
+ IN UINT32 Index=0D
+ );=0D
+=0D
+/**=0D
+ Return the segment header specified by Index.=0D
+=0D
+ @param ImageBase The image base.=0D
+ @param Index The segment index.=0D
+=0D
+ @return Pointer to the segment header.=0D
+**/=0D
+Elf32_Phdr *=0D
+GetElf32SegmentByIndex (=0D
+ IN UINT8 *ImageBase,=0D
+ IN UINT32 Index=0D
+ );=0D
+=0D
+/**=0D
+ Return the segment header specified by Index.=0D
+=0D
+ @param ImageBase The image base.=0D
+ @param Index The segment index.=0D
+=0D
+ @return Pointer to the segment header.=0D
+**/=0D
+Elf64_Phdr *=0D
+GetElf64SegmentByIndex (=0D
+ IN UINT8 *ImageBase,=0D
+ IN UINT32 Index=0D
+ );=0D
+=0D
+/**=0D
+ Load ELF image which has 32-bit architecture=0D
+=0D
+ @param[in] ElfCt ELF image context pointer.=0D
+=0D
+ @retval EFI_SUCCESS ELF binary is loaded successfully.=0D
+ @retval Others Loading ELF binary fails.=0D
+=0D
+**/=0D
+EFI_STATUS=0D
+LoadElf32Image (=0D
+ IN ELF_IMAGE_CONTEXT *ElfCt=0D
+ );=0D
+=0D
+/**=0D
+ Load ELF image which has 64-bit architecture=0D
+=0D
+ @param[in] ImageBase Memory address of an image.=0D
+ @param[out] EntryPoint The entry point of loaded ELF image.=0D
+=0D
+ @retval EFI_SUCCESS ELF binary is loaded successfully.=0D
+ @retval Others Loading ELF binary fails.=0D
+=0D
+**/=0D
+EFI_STATUS=0D
+LoadElf64Image (=0D
+ IN ELF_IMAGE_CONTEXT *ElfCt=0D
+ );=0D
+=0D
+#endif=0D
diff --git a/UefiPayloadPkg/PayloadLoaderPeim/PayloadLoaderPeim.c b/UefiPay=
loadPkg/PayloadLoaderPeim/PayloadLoaderPeim.c
new file mode 100644
index 0000000000..44639f9fd2
--- /dev/null
+++ b/UefiPayloadPkg/PayloadLoaderPeim/PayloadLoaderPeim.c
@@ -0,0 +1,187 @@
+/** @file=0D
+ ELF Load Image Support=0D
+=0D
+Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>=0D
+SPDX-License-Identifier: BSD-2-Clause-Patent=0D
+=0D
+**/=0D
+=0D
+#include <PiPei.h>=0D
+#include <UniversalPayload/UniversalPayload.h>=0D
+#include <UniversalPayload/ExtraData.h>=0D
+=0D
+#include <Ppi/LoadFile.h>=0D
+=0D
+#include <Library/DebugLib.h>=0D
+#include <Library/HobLib.h>=0D
+#include <Library/PeiServicesLib.h>=0D
+#include <Library/MemoryAllocationLib.h>=0D
+#include <Library/BaseMemoryLib.h>=0D
+=0D
+#include "ElfLib.h"=0D
+=0D
+/**=0D
+ The wrapper function of PeiLoadImageLoadImage().=0D
+=0D
+ @param This - Pointer to EFI_PEI_LOAD_FILE_PPI.=0D
+ @param FileHandle - Pointer to the FFS file header of the image.=0D
+ @param ImageAddressArg - Pointer to PE/TE image.=0D
+ @param ImageSizeArg - Size of PE/TE image.=0D
+ @param EntryPoint - Pointer to entry point of specified image file =
for output.=0D
+ @param AuthenticationState - Pointer to attestation authentication state=
of image.=0D
+=0D
+ @return Status of PeiLoadImageLoadImage().=0D
+=0D
+**/=0D
+EFI_STATUS=0D
+EFIAPI=0D
+PeiLoadFileLoadPayload (=0D
+ IN CONST EFI_PEI_LOAD_FILE_PPI *This,=0D
+ IN EFI_PEI_FILE_HANDLE FileHandle,=0D
+ OUT EFI_PHYSICAL_ADDRESS *ImageAddressArg, OPTIONAL=0D
+ OUT UINT64 *ImageSizeArg, OPTIONAL=0D
+ OUT EFI_PHYSICAL_ADDRESS *EntryPoint,=0D
+ OUT UINT32 *AuthenticationState=0D
+ )=0D
+{=0D
+ EFI_STATUS Status;=0D
+ VOID *Elf;=0D
+ PLD_EXTRA_DATA *ExtraData;=0D
+ ELF_IMAGE_CONTEXT Context;=0D
+ PLD_INFO_HEADER *PldInfo;=0D
+ UINT32 Index;=0D
+ UINT16 ExtraDataIndex;=0D
+ CHAR8 *SectionName;=0D
+ UINTN Offset;=0D
+ UINTN Size;=0D
+ UINT32 ExtraDataCount;=0D
+ UINTN Instance;=0D
+=0D
+ //=0D
+ // ELF is added to file as RAW section for EDKII bootloader.=0D
+ // But RAW section might be added by build tool before the ELF RAW secti=
on when alignment is specified for ELF RAW section.=0D
+ // Below loop skips the RAW section that doesn't contain valid ELF image=
.=0D
+ //=0D
+ Instance =3D 0;=0D
+ do {=0D
+ Status =3D PeiServicesFfsFindSectionData3 (EFI_SECTION_RAW, Instance++=
, FileHandle, &Elf, AuthenticationState);=0D
+ if (EFI_ERROR (Status)) {=0D
+ return Status;=0D
+ }=0D
+=0D
+ ZeroMem (&Context, sizeof (Context));=0D
+ Status =3D ParseElfImage (Elf, &Context);=0D
+ } while (EFI_ERROR (Status));=0D
+=0D
+ DEBUG ((=0D
+ DEBUG_INFO, "Payload File Size: 0x%08X, Mem Size: 0x%08x, Reload: %d\n=
",=0D
+ Context.FileSize, Context.ImageSize, Context.ReloadRequired=0D
+ ));=0D
+=0D
+ //=0D
+ // Get PLD_INFO and number of additional PLD sections.=0D
+ //=0D
+ PldInfo =3D NULL;=0D
+ ExtraDataCount =3D 0;=0D
+ for (Index =3D 0; Index < Context.ShNum; Index++) {=0D
+ Status =3D GetElfSectionName (&Context, Index, &SectionName);=0D
+ if (EFI_ERROR(Status)) {=0D
+ continue;=0D
+ }=0D
+ DEBUG ((DEBUG_INFO, "Payload Section[%d]: %a\n", Index, SectionName));=
=0D
+ if (AsciiStrCmp(SectionName, PLD_INFO_SEC_NAME) =3D=3D 0) {=0D
+ Status =3D GetElfSectionPos (&Context, Index, &Offset, &Size);=0D
+ if (!EFI_ERROR(Status)) {=0D
+ PldInfo =3D (PLD_INFO_HEADER *)(Context.FileBase + Offset);=0D
+ }=0D
+ } else if (AsciiStrnCmp(SectionName, PLD_EXTRA_SEC_NAME_PREFIX, PLD_EX=
TRA_SEC_NAME_PREFIX_LENGTH) =3D=3D 0) {=0D
+ Status =3D GetElfSectionPos (&Context, Index, &Offset, &Size);=0D
+ if (!EFI_ERROR (Status)) {=0D
+ ExtraDataCount++;=0D
+ }=0D
+ }=0D
+ }=0D
+=0D
+ //=0D
+ // Report the additional PLD sections through HOB.=0D
+ //=0D
+ ExtraData =3D BuildGuidHob (=0D
+ &gPldExtraDataGuid,=0D
+ sizeof (PLD_EXTRA_DATA) + ExtraDataCount * sizeof (PLD_EXTR=
A_DATA_ENTRY)=0D
+ );=0D
+ ExtraData->Count =3D ExtraDataCount;=0D
+ if (ExtraDataCount !=3D 0) {=0D
+ for (ExtraDataIndex =3D 0, Index =3D 0; Index < Context.ShNum; Index++=
) {=0D
+ Status =3D GetElfSectionName (&Context, Index, &SectionName);=0D
+ if (EFI_ERROR(Status)) {=0D
+ continue;=0D
+ }=0D
+ if (AsciiStrnCmp(SectionName, PLD_EXTRA_SEC_NAME_PREFIX, PLD_EXTRA_S=
EC_NAME_PREFIX_LENGTH) =3D=3D 0) {=0D
+ Status =3D GetElfSectionPos (&Context, Index, &Offset, &Size);=0D
+ if (!EFI_ERROR (Status)) {=0D
+ ASSERT (ExtraDataIndex < ExtraDataCount);=0D
+ AsciiStrCpyS (=0D
+ ExtraData->Entry[ExtraDataIndex].Identifier,=0D
+ sizeof(ExtraData->Entry[ExtraDataIndex].Identifier),=0D
+ SectionName + PLD_EXTRA_SEC_NAME_PREFIX_LENGTH=0D
+ );=0D
+ ExtraData->Entry[ExtraDataIndex].Base =3D (UINTN)(Context.FileBa=
se + Offset);=0D
+ ExtraData->Entry[ExtraDataIndex].Size =3D Size;=0D
+ ExtraDataIndex++;=0D
+ }=0D
+ }=0D
+ }=0D
+ }=0D
+=0D
+ if (Context.ReloadRequired || Context.PreferredImageAddress !=3D Context=
.FileBase) {=0D
+ Context.ImageAddress =3D AllocatePages (EFI_SIZE_TO_PAGES (Context.Ima=
geSize));=0D
+ } else {=0D
+ Context.ImageAddress =3D Context.FileBase;=0D
+ }=0D
+=0D
+ //=0D
+ // Load ELF into the required base=0D
+ //=0D
+ Status =3D LoadElfImage (&Context);=0D
+ if (!EFI_ERROR(Status)) {=0D
+ *ImageAddressArg =3D (UINTN) Context.ImageAddress;=0D
+ *EntryPoint =3D Context.EntryPoint;=0D
+ *ImageSizeArg =3D Context.ImageSize;=0D
+ }=0D
+ return Status;=0D
+}=0D
+=0D
+=0D
+EFI_PEI_LOAD_FILE_PPI mPeiLoadFilePpi =3D {=0D
+ PeiLoadFileLoadPayload=0D
+};=0D
+=0D
+=0D
+EFI_PEI_PPI_DESCRIPTOR gPpiLoadFilePpiList =3D {=0D
+ (EFI_PEI_PPI_DESCRIPTOR_PPI | EFI_PEI_PPI_DESCRIPTOR_TERMINATE_LIST),=0D
+ &gEfiPeiLoadFilePpiGuid,=0D
+ &mPeiLoadFilePpi=0D
+};=0D
+/**=0D
+=0D
+ Install Pei Load File PPI.=0D
+=0D
+ @param FileHandle Handle of the file being invoked.=0D
+ @param PeiServices Describes the list of possible PEI Services.=0D
+=0D
+ @retval EFI_SUCESS The entry point executes successfully.=0D
+ @retval Others Some error occurs during the execution of this funct=
ion.=0D
+=0D
+**/=0D
+EFI_STATUS=0D
+EFIAPI=0D
+InitializePayloadLoaderPeim (=0D
+ IN EFI_PEI_FILE_HANDLE FileHandle,=0D
+ IN CONST EFI_PEI_SERVICES **PeiServices=0D
+ )=0D
+{=0D
+ EFI_STATUS Status;=0D
+ Status =3D PeiServicesInstallPpi (&gPpiLoadFilePpiList);=0D
+=0D
+ return Status;=0D
+}=0D
diff --git a/UefiPayloadPkg/PayloadLoaderPeim/PayloadLoaderPeim.inf b/UefiP=
ayloadPkg/PayloadLoaderPeim/PayloadLoaderPeim.inf
new file mode 100644
index 0000000000..c45f3ecf2d
--- /dev/null
+++ b/UefiPayloadPkg/PayloadLoaderPeim/PayloadLoaderPeim.inf
@@ -0,0 +1,59 @@
+## @file=0D
+# Produce LoadFile PPI for ELF loading.=0D
+#=0D
+# Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>=0D
+#=0D
+# SPDX-License-Identifier: BSD-2-Clause-Patent=0D
+#=0D
+##=0D
+=0D
+[Defines]=0D
+ INF_VERSION =3D 0x00010005=0D
+ BASE_NAME =3D ElfLoaderPeim=0D
+ FILE_GUID =3D D071A3B4-3EC1-40C5-BEF8-D0BD4A2446F0=
=0D
+ MODULE_TYPE =3D PEIM=0D
+ VERSION_STRING =3D 1.0=0D
+=0D
+ ENTRY_POINT =3D InitializePayloadLoaderPeim=0D
+=0D
+#=0D
+# The following information is for reference only and not required by the =
build tools.=0D
+#=0D
+# VALID_ARCHITECTURES =3D IA32 X64=0D
+#=0D
+=0D
+[Sources]=0D
+ PayloadLoaderPeim.c=0D
+ ElfLib.h=0D
+ ElfLib/ElfLibInternal.h=0D
+ ElfLib/ElfCommon.h=0D
+ ElfLib/Elf32.h=0D
+ ElfLib/Elf64.h=0D
+ ElfLib/ElfLibInternal.h=0D
+ ElfLib/ElfLib.c=0D
+ ElfLib/Elf32Lib.c=0D
+ ElfLib/Elf64Lib.c=0D
+=0D
+[Packages]=0D
+ MdePkg/MdePkg.dec=0D
+ MdeModulePkg/MdeModulePkg.dec=0D
+ UefiPayloadPkg/UefiPayloadPkg.dec=0D
+=0D
+[LibraryClasses]=0D
+ PcdLib=0D
+ MemoryAllocationLib=0D
+ BaseMemoryLib=0D
+ PeiServicesLib=0D
+ HobLib=0D
+ BaseLib=0D
+ PeimEntryPoint=0D
+ DebugLib=0D
+=0D
+[Ppis]=0D
+ gEfiPeiLoadFilePpiGuid ## PRODUCES=0D
+=0D
+[Guids]=0D
+ gPldExtraDataGuid ## PRODUCES=0D
+=0D
+[Depex]=0D
+ TRUE
\ No newline at end of file
--=20
2.31.1.windows.1


Guo Dong
 

Reviewed-by: Guo Dong <guo.dong@...>

-----Original Message-----
From: Ni, Ray <ray.ni@...>
Sent: Wednesday, June 2, 2021 11:23 PM
To: devel@edk2.groups.io
Cc: Ma, Maurice <maurice.ma@...>; Dong, Guo
<guo.dong@...>; You, Benjamin <benjamin.you@...>
Subject: [PATCH v2 2/3] UefiPayloadPkg: Add PayloadLoaderPeim which can
load ELF payload

Per universal payload spec, the payload is in ELF format.
The patch adds a payload loader that supports to load ELF image.

The location of extra data sections whose names start with "upld."
is stored in PLD_EXTRA_DATA HOB.

Signed-off-by: Maurice Ma <maurice.ma@...>
Signed-off-by: Ray Ni <ray.ni@...>
Cc: Maurice Ma <maurice.ma@...>
Cc: Guo Dong <guo.dong@...>
Cc: Benjamin You <benjamin.you@...>
---
UefiPayloadPkg/PayloadLoaderPeim/ElfLib.h | 122 +++
.../PayloadLoaderPeim/ElfLib/Elf32.h | 252 +++++
.../PayloadLoaderPeim/ElfLib/Elf32Lib.c | 451 ++++++++
.../PayloadLoaderPeim/ElfLib/Elf64.h | 254 +++++
.../PayloadLoaderPeim/ElfLib/Elf64Lib.c | 460 ++++++++
.../PayloadLoaderPeim/ElfLib/ElfCommon.h | 983 ++++++++++++++++++
.../PayloadLoaderPeim/ElfLib/ElfLib.c | 473 +++++++++
.../PayloadLoaderPeim/ElfLib/ElfLibInternal.h | 109 ++
.../PayloadLoaderPeim/PayloadLoaderPeim.c | 187 ++++
.../PayloadLoaderPeim/PayloadLoaderPeim.inf | 59 ++
10 files changed, 3350 insertions(+)
create mode 100644 UefiPayloadPkg/PayloadLoaderPeim/ElfLib.h
create mode 100644 UefiPayloadPkg/PayloadLoaderPeim/ElfLib/Elf32.h
create mode 100644 UefiPayloadPkg/PayloadLoaderPeim/ElfLib/Elf32Lib.c
create mode 100644 UefiPayloadPkg/PayloadLoaderPeim/ElfLib/Elf64.h
create mode 100644 UefiPayloadPkg/PayloadLoaderPeim/ElfLib/Elf64Lib.c
create mode 100644
UefiPayloadPkg/PayloadLoaderPeim/ElfLib/ElfCommon.h
create mode 100644 UefiPayloadPkg/PayloadLoaderPeim/ElfLib/ElfLib.c
create mode 100644
UefiPayloadPkg/PayloadLoaderPeim/ElfLib/ElfLibInternal.h
create mode 100644
UefiPayloadPkg/PayloadLoaderPeim/PayloadLoaderPeim.c
create mode 100644
UefiPayloadPkg/PayloadLoaderPeim/PayloadLoaderPeim.inf

diff --git a/UefiPayloadPkg/PayloadLoaderPeim/ElfLib.h
b/UefiPayloadPkg/PayloadLoaderPeim/ElfLib.h
new file mode 100644
index 0000000000..9cfc2912cf
--- /dev/null
+++ b/UefiPayloadPkg/PayloadLoaderPeim/ElfLib.h
@@ -0,0 +1,122 @@
+/** @file

+ ELF library

+

+ Copyright (c) 2018 - 2021, Intel Corporation. All rights reserved.<BR>

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

+

+**/

+

+#ifndef ELF_LIB_H_

+#define ELF_LIB_H_

+

+#include <PiPei.h>

+

+#define ELF_CLASS32 1

+#define ELF_CLASS64 2

+

+#define ELF_PT_LOAD 1

+

+typedef struct {

+ RETURN_STATUS ParseStatus; ///< Return the status after
ParseElfImage().

+ UINT8 *FileBase; ///< The source location in memory.

+ UINTN FileSize; ///< The size including sections that don't
require loading.

+ UINT8 *PreferredImageAddress; ///< The preferred image to be
loaded. No relocation is needed if loaded to this address.

+ BOOLEAN ReloadRequired; ///< The image needs a new memory
location for running.

+ UINT8 *ImageAddress; ///< The destination memory address set
by caller.

+ UINTN ImageSize; ///< The memory size for loading and
execution.

+ UINT32 EiClass;

+ UINT32 ShNum;

+ UINT32 PhNum;

+ UINTN ShStrOff;

+ UINTN ShStrLen;

+ UINTN EntryPoint; ///< Return the actual entry point after
LoadElfImage().

+} ELF_IMAGE_CONTEXT;

+

+

+typedef struct {

+ UINT32 PtType;

+ UINTN Offset;

+ UINTN Length;

+ UINTN MemLen;

+ UINTN MemAddr;

+ UINTN Alignment;

+} SEGMENT_INFO;

+

+/**

+ Parse the ELF image info.

+

+ @param[in] ImageBase Memory address of an image.

+ @param[out] ElfCt The EFL image context pointer.

+

+ @retval EFI_INVALID_PARAMETER Input parameters are not valid.

+ @retval EFI_UNSUPPORTED Unsupported binary type.

+ @retval EFI_LOAD_ERROR ELF binary loading error.

+ @retval EFI_SUCCESS ELF binary is loaded successfully.

+**/

+EFI_STATUS

+EFIAPI

+ParseElfImage (

+ IN VOID *ImageBase,

+ OUT ELF_IMAGE_CONTEXT *ElfCt

+ );

+

+/**

+ Load the ELF segments to specified address in ELF header.

+

+ This function loads ELF image segments into memory address specified

+ in ELF program header.

+

+ @param[in] ElfCt ELF image context pointer.

+

+ @retval EFI_INVALID_PARAMETER Input parameters are not valid.

+ @retval EFI_UNSUPPORTED Unsupported binary type.

+ @retval EFI_LOAD_ERROR ELF binary loading error.

+ @retval EFI_SUCCESS ELF binary is loaded successfully.

+**/

+EFI_STATUS

+EFIAPI

+LoadElfImage (

+ IN ELF_IMAGE_CONTEXT *ElfCt

+ );

+

+/**

+ Get a ELF section name from its index.

+

+ @param[in] ElfCt ELF image context pointer.

+ @param[in] SectionIndex ELF section index.

+ @param[out] SectionName The pointer to the section name.

+

+ @retval EFI_INVALID_PARAMETER ElfCt or SecName is NULL.

+ @retval EFI_NOT_FOUND Could not find the section.

+ @retval EFI_SUCCESS Section name was filled successfully.

+**/

+EFI_STATUS

+EFIAPI

+GetElfSectionName (

+ IN ELF_IMAGE_CONTEXT *ElfCt,

+ IN UINT32 SectionIndex,

+ OUT CHAR8 **SectionName

+ );

+

+/**

+ Get the offset and size of x-th ELF section.

+

+ @param[in] ElfCt ELF image context pointer.

+ @param[in] Index ELF section index.

+ @param[out] Offset Return the offset of the specific section.

+ @param[out] Size Return the size of the specific section.

+

+ @retval EFI_INVALID_PARAMETER ImageBase, Offset or Size is NULL.

+ @retval EFI_INVALID_PARAMETER EiClass doesn't equal to ELFCLASS32 or
ELFCLASS64.

+ @retval EFI_NOT_FOUND Could not find the section.

+ @retval EFI_SUCCESS Offset and Size are returned.

+**/

+EFI_STATUS

+EFIAPI

+GetElfSectionPos (

+ IN ELF_IMAGE_CONTEXT *ElfCt,

+ IN UINT32 Index,

+ OUT UINTN *Offset,

+ OUT UINTN *Size

+ );

+#endif /* ELF_LIB_H_ */

diff --git a/UefiPayloadPkg/PayloadLoaderPeim/ElfLib/Elf32.h
b/UefiPayloadPkg/PayloadLoaderPeim/ElfLib/Elf32.h
new file mode 100644
index 0000000000..ebed5f00c3
--- /dev/null
+++ b/UefiPayloadPkg/PayloadLoaderPeim/ElfLib/Elf32.h
@@ -0,0 +1,252 @@
+/** @file

+Ported ELF include files from FreeBSD

+

+Copyright (c) 2009 - 2010, Apple Inc. All rights reserved.<BR>

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

+

+

+**/

+/*-

+ * Copyright (c) 1996-1998 John D. Polstra.

+ * All rights reserved.

+ *

+ * Redistribution and use in source and binary forms, with or without

+ * modification, are permitted provided that the following conditions

+ * are met:

+ * 1. Redistributions of source code must retain the above copyright

+ * notice, this list of conditions and the following disclaimer.

+ * 2. Redistributions in binary form must reproduce the above copyright

+ * notice, this list of conditions and the following disclaimer in the

+ * documentation and/or other materials provided with the distribution.

+ *

+ * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS
IS'' AND

+ * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
TO, THE

+ * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
PARTICULAR PURPOSE

+ * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS
BE LIABLE

+ * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
CONSEQUENTIAL

+ * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
SUBSTITUTE GOODS

+ * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
INTERRUPTION)

+ * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
CONTRACT, STRICT

+ * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
IN ANY WAY

+ * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
POSSIBILITY OF

+ * SUCH DAMAGE.

+ *

+ * $FreeBSD: src/sys/sys/elf32.h,v 1.8.14.2 2007/12/03 21:30:36 marius Exp $

+ */

+

+#ifndef _SYS_ELF32_H_

+#define _SYS_ELF32_H_ 1

+

+

+/*

+ * ELF definitions common to all 32-bit architectures.

+ */

+

+typedef UINT32 Elf32_Addr;

+typedef UINT16 Elf32_Half;

+typedef UINT32 Elf32_Off;

+typedef INT32 Elf32_Sword;

+typedef UINT32 Elf32_Word;

+typedef UINT64 Elf32_Lword;

+

+typedef Elf32_Word Elf32_Hashelt;

+

+/* Non-standard class-dependent datatype used for abstraction. */

+typedef Elf32_Word Elf32_Size;

+typedef Elf32_Sword Elf32_Ssize;

+

+/*

+ * ELF header.

+ */

+

+typedef struct {

+ unsigned char e_ident[EI_NIDENT]; /* File identification. */

+ Elf32_Half e_type; /* File type. */

+ Elf32_Half e_machine; /* Machine architecture. */

+ Elf32_Word e_version; /* ELF format version. */

+ Elf32_Addr e_entry; /* Entry point. */

+ Elf32_Off e_phoff; /* Program header file offset. */

+ Elf32_Off e_shoff; /* Section header file offset. */

+ Elf32_Word e_flags; /* Architecture-specific flags. */

+ Elf32_Half e_ehsize; /* Size of ELF header in bytes. */

+ Elf32_Half e_phentsize; /* Size of program header entry. */

+ Elf32_Half e_phnum; /* Number of program header entries. */

+ Elf32_Half e_shentsize; /* Size of section header entry. */

+ Elf32_Half e_shnum; /* Number of section header entries. */

+ Elf32_Half e_shstrndx; /* Section name strings section. */

+} Elf32_Ehdr;

+

+/*

+ * Section header.

+ */

+

+typedef struct {

+ Elf32_Word sh_name; /* Section name (index into the

+ section header string table). */

+ Elf32_Word sh_type; /* Section type. */

+ Elf32_Word sh_flags; /* Section flags. */

+ Elf32_Addr sh_addr; /* Address in memory image. */

+ Elf32_Off sh_offset; /* Offset in file. */

+ Elf32_Word sh_size; /* Size in bytes. */

+ Elf32_Word sh_link; /* Index of a related section. */

+ Elf32_Word sh_info; /* Depends on section type. */

+ Elf32_Word sh_addralign; /* Alignment in bytes. */

+ Elf32_Word sh_entsize; /* Size of each entry in section. */

+} Elf32_Shdr;

+

+/*

+ * Program header.

+ */

+

+typedef struct {

+ Elf32_Word p_type; /* Entry type. */

+ Elf32_Off p_offset; /* File offset of contents. */

+ Elf32_Addr p_vaddr; /* Virtual address in memory image. */

+ Elf32_Addr p_paddr; /* Physical address (not used). */

+ Elf32_Word p_filesz; /* Size of contents in file. */

+ Elf32_Word p_memsz; /* Size of contents in memory. */

+ Elf32_Word p_flags; /* Access permission flags. */

+ Elf32_Word p_align; /* Alignment in memory and file. */

+} Elf32_Phdr;

+

+/*

+ * Dynamic structure. The ".dynamic" section contains an array of them.

+ */

+

+typedef struct {

+ Elf32_Sword d_tag; /* Entry type. */

+ union {

+ Elf32_Word d_val; /* Integer value. */

+ Elf32_Addr d_ptr; /* Address value. */

+ } d_un;

+} Elf32_Dyn;

+

+/*

+ * Relocation entries.

+ */

+

+/* Relocations that don't need an addend field. */

+typedef struct {

+ Elf32_Addr r_offset; /* Location to be relocated. */

+ Elf32_Word r_info; /* Relocation type and symbol index. */

+} Elf32_Rel;

+

+/* Relocations that need an addend field. */

+typedef struct {

+ Elf32_Addr r_offset; /* Location to be relocated. */

+ Elf32_Word r_info; /* Relocation type and symbol index. */

+ Elf32_Sword r_addend; /* Addend. */

+} Elf32_Rela;

+

+/* Macros for accessing the fields of r_info. */

+#define ELF32_R_SYM(info) ((info) >> 8)

+#define ELF32_R_TYPE(info) ((unsigned char)(info))

+

+/* Macro for constructing r_info from field values. */

+#define ELF32_R_INFO(sym, type) (((sym) << 8) + (unsigned char)(type))

+

+/*

+ * Note entry header

+ */

+typedef Elf_Note Elf32_Nhdr;

+

+/*

+ * Move entry

+ */

+typedef struct {

+ Elf32_Lword m_value; /* symbol value */

+ Elf32_Word m_info; /* size + index */

+ Elf32_Word m_poffset; /* symbol offset */

+ Elf32_Half m_repeat; /* repeat count */

+ Elf32_Half m_stride; /* stride info */

+} Elf32_Move;

+

+/*

+ * The macros compose and decompose values for Move.r_info

+ *

+ * sym = ELF32_M_SYM(M.m_info)

+ * size = ELF32_M_SIZE(M.m_info)

+ * M.m_info = ELF32_M_INFO(sym, size)

+ */

+#define ELF32_M_SYM(info) ((info)>>8)

+#define ELF32_M_SIZE(info) ((unsigned char)(info))

+#define ELF32_M_INFO(sym, size) (((sym)<<8)+(unsigned char)(size))

+

+/*

+ * Hardware/Software capabilities entry

+ */

+typedef struct {

+ Elf32_Word c_tag; /* how to interpret value */

+ union {

+ Elf32_Word c_val;

+ Elf32_Addr c_ptr;

+ } c_un;

+} Elf32_Cap;

+

+/*

+ * Symbol table entries.

+ */

+

+typedef struct {

+ Elf32_Word st_name; /* String table index of name. */

+ Elf32_Addr st_value; /* Symbol value. */

+ Elf32_Word st_size; /* Size of associated object. */

+ unsigned char st_info; /* Type and binding information. */

+ unsigned char st_other; /* Reserved (not used). */

+ Elf32_Half st_shndx; /* Section index of symbol. */

+} Elf32_Sym;

+

+/* Macros for accessing the fields of st_info. */

+#define ELF32_ST_BIND(info) ((info) >> 4)

+#define ELF32_ST_TYPE(info) ((info) & 0xf)

+

+/* Macro for constructing st_info from field values. */

+#define ELF32_ST_INFO(bind, type) (((bind) << 4) + ((type) & 0xf))

+

+/* Macro for accessing the fields of st_other. */

+#define ELF32_ST_VISIBILITY(oth) ((oth) & 0x3)

+

+/* Structures used by Sun & GNU symbol versioning. */

+typedef struct

+{

+ Elf32_Half vd_version;

+ Elf32_Half vd_flags;

+ Elf32_Half vd_ndx;

+ Elf32_Half vd_cnt;

+ Elf32_Word vd_hash;

+ Elf32_Word vd_aux;

+ Elf32_Word vd_next;

+} Elf32_Verdef;

+

+typedef struct

+{

+ Elf32_Word vda_name;

+ Elf32_Word vda_next;

+} Elf32_Verdaux;

+

+typedef struct

+{

+ Elf32_Half vn_version;

+ Elf32_Half vn_cnt;

+ Elf32_Word vn_file;

+ Elf32_Word vn_aux;

+ Elf32_Word vn_next;

+} Elf32_Verneed;

+

+typedef struct

+{

+ Elf32_Word vna_hash;

+ Elf32_Half vna_flags;

+ Elf32_Half vna_other;

+ Elf32_Word vna_name;

+ Elf32_Word vna_next;

+} Elf32_Vernaux;

+

+typedef Elf32_Half Elf32_Versym;

+

+typedef struct {

+ Elf32_Half si_boundto; /* direct bindings - symbol bound to */

+ Elf32_Half si_flags; /* per symbol flags */

+} Elf32_Syminfo;

+

+#endif /* !_SYS_ELF32_H_ */

diff --git a/UefiPayloadPkg/PayloadLoaderPeim/ElfLib/Elf32Lib.c
b/UefiPayloadPkg/PayloadLoaderPeim/ElfLib/Elf32Lib.c
new file mode 100644
index 0000000000..3fa100ce4a
--- /dev/null
+++ b/UefiPayloadPkg/PayloadLoaderPeim/ElfLib/Elf32Lib.c
@@ -0,0 +1,451 @@
+/** @file

+ ELF library

+

+ Copyright (c) 2019 - 2021, Intel Corporation. All rights reserved.<BR>

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

+

+**/

+

+#include "ElfLibInternal.h"

+

+/**

+ Return the section header specified by Index.

+

+ @param ImageBase The image base.

+ @param Index The section index.

+

+ @return Pointer to the section header.

+**/

+Elf32_Shdr *

+GetElf32SectionByIndex (

+ IN UINT8 *ImageBase,

+ IN UINT32 Index

+ )

+{

+ Elf32_Ehdr *Ehdr;

+

+ Ehdr = (Elf32_Ehdr *)ImageBase;

+ if (Index >= Ehdr->e_shnum) {

+ return NULL;

+ }

+

+ return (Elf32_Shdr *)(ImageBase + Ehdr->e_shoff + Index * Ehdr-
e_shentsize);
+}

+

+/**

+ Return the segment header specified by Index.

+

+ @param ImageBase The image base.

+ @param Index The segment index.

+

+ @return Pointer to the segment header.

+**/

+Elf32_Phdr *

+GetElf32SegmentByIndex (

+ IN UINT8 *ImageBase,

+ IN UINT32 Index

+ )

+{

+ Elf32_Ehdr *Ehdr;

+

+ Ehdr = (Elf32_Ehdr *)ImageBase;

+ if (Index >= Ehdr->e_phnum) {

+ return NULL;

+ }

+

+ return (Elf32_Phdr *)(ImageBase + Ehdr->e_phoff + Index * Ehdr-
e_phentsize);
+}

+

+/**

+ Return the section header specified by the range.

+

+ @param ImageBase The image base.

+ @param Offset The section offset.

+ @param Size The section size.

+

+ @return Pointer to the section header.

+**/

+Elf32_Shdr *

+GetElf32SectionByRange (

+ IN UINT8 *ImageBase,

+ IN UINT32 Offset,

+ IN UINT32 Size

+ )

+{

+ UINT32 Index;

+ Elf32_Ehdr *Ehdr;

+ Elf32_Shdr *Shdr;

+

+ Ehdr = (Elf32_Ehdr *)ImageBase;

+

+ Shdr = (Elf32_Shdr *) (ImageBase + Ehdr->e_shoff);

+ for (Index = 0; Index < Ehdr->e_shnum; Index++) {

+ if ((Shdr->sh_offset == Offset) && (Shdr->sh_size == Size)) {

+ return Shdr;

+ }

+ Shdr = ELF_NEXT_ENTRY (Elf32_Shdr, Shdr, Ehdr->e_shentsize);

+ }

+ return NULL;

+}

+

+/**

+ Fix up the image based on the relocation entries.

+

+ @param Rela Relocation entries.

+ @param RelaSize Total size of relocation entries.

+ @param RelaEntrySize Relocation entry size.

+ @param RelaType Type of relocation entry.

+ @param Delta The delta between preferred image base and the
actual image base.

+ @param DynamicLinking TRUE when fixing up according to dynamic
relocation.

+

+ @retval EFI_SUCCESS The image fix up is processed successfully.

+**/

+EFI_STATUS

+ProcessRelocation32 (

+ IN Elf32_Rela *Rela,

+ IN UINT32 RelaSize,

+ IN UINT32 RelaEntrySize,

+ IN UINT32 RelaType,

+ IN INTN Delta,

+ IN BOOLEAN DynamicLinking

+ )

+{

+ UINTN Index;

+ UINT32 *Ptr;

+ UINT32 Type;

+

+ for ( Index = 0

+ ; RelaEntrySize * Index < RelaSize

+ ; Index++, Rela = ELF_NEXT_ENTRY (Elf32_Rela, Rela, RelaEntrySize)

+ ) {

+ //

+ // r_offset is the virtual address of the storage unit affected by the
relocation.

+ //

+ Ptr = (UINT32 *)(UINTN)(Rela->r_offset + Delta);

+ Type = ELF32_R_TYPE(Rela->r_info);

+ switch (Type) {

+ case R_386_NONE:

+ case R_386_PC32:

+ //

+ // No fixup entry required.

+ //

+ break;

+

+ case R_386_32:

+ if (DynamicLinking) {

+ //

+ // Dynamic section doesn't contain entries of this type.

+ //

+ DEBUG ((DEBUG_INFO, "Unsupported relocation type %02X\n",
Type));

+ ASSERT (FALSE);

+ } else {

+ *Ptr += (UINT32) Delta;

+ }

+ break;

+

+ case R_386_RELATIVE:

+ if (DynamicLinking) {

+ //

+ // A: Represents the addend used to compute the value of the
relocatable field.

+ // B: Represents the base address at which a shared object has been
loaded into memory during execution.

+ // Generally, a shared object is built with a 0 base virtual address, but
the execution address will be different.

+ //

+ // B (Base Address) in ELF spec is slightly different:

+ // An executable or shared object file's base address (on platforms
that support the concept) is calculated during

+ // execution from three values: the virtual memory load address, the
maximum page size, and the lowest virtual address

+ // of a program's loadable segment. To compute the base address,
one determines the memory address associated with the

+ // lowest p_vaddr value for a PT_LOAD segment. This address is
truncated to the nearest multiple of the maximum page size.

+ // The corresponding p_vaddr value itself is also truncated to the
nearest multiple of the maximum page size.

+ //

+ // *** The base address is the difference between the truncated
memory address and the truncated p_vaddr value. ***

+ //

+ // Delta in this function is B.

+ //

+ // Calculation: B + A

+ //

+ if (RelaType == SHT_RELA) {

+ ASSERT (*Ptr == 0);

+ *Ptr = (UINT32) Delta + Rela->r_addend;

+ } else {

+ //

+ // A is stored in the field of relocation for REL type.

+ //

+ *Ptr = (UINT32) Delta + *Ptr;

+ }

+ } else {

+ //

+ // non-Dynamic section doesn't contain entries of this type.

+ //

+ DEBUG ((DEBUG_INFO, "Unsupported relocation type %02X\n",
Type));

+ ASSERT (FALSE);

+ }

+ break;

+

+ default:

+ DEBUG ((DEBUG_INFO, "Unsupported relocation type %02X\n", Type));

+ }

+ }

+ return EFI_SUCCESS;

+}

+

+/**

+ Relocate the DYN type image.

+

+ @param ElfCt Point to image context.

+

+ @retval EFI_SUCCESS The relocation succeeds.

+ @retval EFI_UNSUPPORTED The image doesn't contain a dynamic section.

+**/

+EFI_STATUS

+RelocateElf32Dynamic (

+ IN ELF_IMAGE_CONTEXT *ElfCt

+ )

+{

+ UINT32 Index;

+ Elf32_Phdr *Phdr;

+ Elf32_Shdr *DynShdr;

+ Elf32_Shdr *RelShdr;

+ Elf32_Dyn *Dyn;

+ UINT32 RelaOffset;

+ UINT32 RelaCount;

+ UINT32 RelaSize;

+ UINT32 RelaEntrySize;

+ UINT32 RelaType;

+

+ //

+ // 1. Locate the dynamic section.

+ //

+ // If an object file participates in dynamic linking, its program header table

+ // will have an element of type PT_DYNAMIC.

+ // This ``segment'' contains the .dynamic section. A special symbol,
_DYNAMIC,

+ // labels the section, which contains an array of Elf32_Dyn or Elf64_Dyn.

+ //

+ DynShdr = NULL;

+ for (Index = 0; Index < ElfCt->PhNum; Index++) {

+ Phdr = GetElf32SegmentByIndex (ElfCt->FileBase, Index);

+ ASSERT (Phdr != NULL);

+ if (Phdr->p_type == PT_DYNAMIC) {

+ //

+ // Verify the existence of the dynamic section.

+ //

+ DynShdr = GetElf32SectionByRange (ElfCt->FileBase, Phdr->p_offset,
Phdr->p_filesz);

+ break;

+ }

+ }

+

+ //

+ // It's abnormal a DYN ELF doesn't contain a dynamic section.

+ //

+ ASSERT (DynShdr != NULL);

+ if (DynShdr == NULL) {

+ return EFI_UNSUPPORTED;

+ }

+ ASSERT (DynShdr->sh_type == SHT_DYNAMIC);

+ ASSERT (DynShdr->sh_entsize >= sizeof (*Dyn));

+

+ //

+ // 2. Locate the relocation section from the dynamic section.

+ //

+ RelaOffset = MAX_UINT32;

+ RelaSize = 0;

+ RelaCount = 0;

+ RelaEntrySize = 0;

+ RelaType = 0;

+ for ( Index = 0, Dyn = (Elf32_Dyn *) (ElfCt->FileBase + DynShdr->sh_offset)

+ ; Index < DynShdr->sh_size / DynShdr->sh_entsize

+ ; Index++, Dyn = ELF_NEXT_ENTRY (Elf32_Dyn, Dyn, DynShdr-
sh_entsize)
+ ) {

+ switch (Dyn->d_tag) {

+ case DT_RELA:

+ case DT_REL:

+ //

+ // DT_REL represent program virtual addresses.

+ // A file's virtual addresses might not match the memory virtual
addresses during execution.

+ // When interpreting addresses contained in the dynamic structure, the
dynamic linker computes actual addresses,

+ // based on the original file value and the memory base address.

+ // For consistency, files do not contain relocation entries to ``correct''
addresses in the dynamic structure.

+ //

+ RelaOffset = Dyn->d_un.d_ptr - (UINT32) (UINTN) ElfCt-
PreferredImageAddress;
+ RelaType = (Dyn->d_tag == DT_RELA) ? SHT_RELA: SHT_REL;

+ break;

+ case DT_RELACOUNT:

+ case DT_RELCOUNT:

+ RelaCount = Dyn->d_un.d_val;

+ break;

+ case DT_RELENT:

+ case DT_RELAENT:

+ RelaEntrySize = Dyn->d_un.d_val;

+ break;

+ case DT_RELSZ:

+ case DT_RELASZ:

+ RelaSize = Dyn->d_un.d_val;

+ break;

+ default:

+ break;

+ }

+ }

+

+ if (RelaOffset == MAX_UINT64) {

+ ASSERT (RelaCount == 0);

+ ASSERT (RelaEntrySize == 0);

+ ASSERT (RelaSize == 0);

+ //

+ // It's fine that a DYN ELF doesn't contain relocation section.

+ //

+ return EFI_SUCCESS;

+ }

+

+ //

+ // Verify the existence of the relocation section.

+ //

+ RelShdr = GetElf32SectionByRange (ElfCt->FileBase, RelaOffset, RelaSize);

+ ASSERT (RelShdr != NULL);

+ if (RelShdr == NULL) {

+ return EFI_UNSUPPORTED;

+ }

+ ASSERT (RelShdr->sh_type == RelaType);

+ ASSERT (RelShdr->sh_entsize == RelaEntrySize);

+

+ //

+ // 3. Process the relocation section.

+ //

+ ProcessRelocation32 (

+ (Elf32_Rela *) (ElfCt->FileBase + RelShdr->sh_offset),

+ RelShdr->sh_size, RelShdr->sh_entsize, RelShdr->sh_type,

+ (UINTN) ElfCt->ImageAddress - (UINTN) ElfCt->PreferredImageAddress,

+ TRUE

+ );

+ return EFI_SUCCESS;

+}

+

+/**

+ Relocate all sections in a ELF image.

+

+ @param[in] ElfCt ELF image context pointer.

+

+ @retval EFI_UNSUPPORTED Relocation is not supported.

+ @retval EFI_SUCCESS ELF image was relocated successfully.

+**/

+EFI_STATUS

+RelocateElf32Sections (

+ IN ELF_IMAGE_CONTEXT *ElfCt

+ )

+{

+ EFI_STATUS Status;

+ Elf32_Ehdr *Ehdr;

+ Elf32_Shdr *RelShdr;

+ Elf32_Shdr *Shdr;

+ UINT32 Index;

+ UINTN Delta;

+

+ Ehdr = (Elf32_Ehdr *)ElfCt->FileBase;

+ if (Ehdr->e_machine != EM_386) {

+ return EFI_UNSUPPORTED;

+ }

+

+ Delta = (UINTN) ElfCt->ImageAddress - (UINTN) ElfCt-
PreferredImageAddress;
+ ElfCt->EntryPoint = (UINTN)(Ehdr->e_entry + Delta);

+

+ //

+ // 1. Relocate dynamic ELF using the relocation section pointed by dynamic
section

+ //

+ if (Ehdr->e_type == ET_DYN) {

+ DEBUG ((DEBUG_INFO, "DYN ELF: Relocate using dynamic sections...\n"));

+ Status = RelocateElf32Dynamic (ElfCt);

+ ASSERT_EFI_ERROR (Status);

+ return Status;

+ }

+

+ //

+ // 2. Executable ELF: Fix up the delta between actual image address and
preferred image address.

+ //

+ // Linker already fixed up EXEC ELF based on the preferred image address.

+ // A ELF loader in modern OS only loads it into the preferred image
address.

+ // The below relocation is unneeded in that case.

+ // But the ELF loader in firmware supports to load the image to a different
address.

+ // The below relocation is needed in this case.

+ //

+ DEBUG ((DEBUG_INFO, "EXEC ELF: Fix actual/preferred base address
delta ...\n"));

+ for ( Index = 0, RelShdr = (Elf32_Shdr *) (ElfCt->FileBase + Ehdr->e_shoff)

+ ; Index < Ehdr->e_shnum

+ ; Index++, RelShdr = ELF_NEXT_ENTRY (Elf32_Shdr, RelShdr, Ehdr-
e_shentsize)
+ ) {

+ if ((RelShdr->sh_type != SHT_REL) && (RelShdr->sh_type != SHT_RELA)) {

+ continue;

+ }

+ Shdr = GetElf32SectionByIndex (ElfCt->FileBase, RelShdr->sh_info);

+ if ((Shdr->sh_flags & SHF_ALLOC) == SHF_ALLOC) {

+ //

+ // Only fix up sections that occupy memory during process execution.

+ //

+ ProcessRelocation32 (

+ (Elf32_Rela *)((UINT8*)Ehdr + RelShdr->sh_offset),

+ RelShdr->sh_size, RelShdr->sh_entsize, RelShdr->sh_type,

+ Delta, FALSE

+ );

+ }

+ }

+

+ return EFI_SUCCESS;

+}

+

+/**

+ Load ELF image which has 32-bit architecture.

+

+ Caller should set Context.ImageAddress to a proper value, either pointing
to

+ a new allocated memory whose size equal to Context.ImageSize, or
pointing

+ to Context.PreferredImageAddress.

+

+ @param[in] ElfCt ELF image context pointer.

+

+ @retval EFI_SUCCESS ELF binary is loaded successfully.

+ @retval Others Loading ELF binary fails.

+

+**/

+EFI_STATUS

+LoadElf32Image (

+ IN ELF_IMAGE_CONTEXT *ElfCt

+ )

+{

+ Elf32_Ehdr *Ehdr;

+ Elf32_Phdr *Phdr;

+ UINT16 Index;

+ UINTN Delta;

+

+ ASSERT (ElfCt != NULL);

+

+ //

+ // Per the sprit of ELF, loading to memory only consumes info from
program headers.

+ //

+ Ehdr = (Elf32_Ehdr *)ElfCt->FileBase;

+

+ for ( Index = 0, Phdr = (Elf32_Phdr *)(ElfCt->FileBase + Ehdr->e_phoff)

+ ; Index < Ehdr->e_phnum

+ ; Index++, Phdr = ELF_NEXT_ENTRY (Elf32_Phdr, Phdr, Ehdr-
e_phentsize)
+ ) {

+ //

+ // Skip segments that don't require load (type tells, or size is 0)

+ //

+ if ((Phdr->p_type != PT_LOAD) ||

+ (Phdr->p_memsz == 0)) {

+ continue;

+ }

+

+ //

+ // The memory offset of segment relative to the image base

+ // Note: CopyMem() does nothing when the dst equals to src.

+ //

+ Delta = Phdr->p_paddr - (UINT32) (UINTN) ElfCt-
PreferredImageAddress;
+ CopyMem (ElfCt->ImageAddress + Delta, ElfCt->FileBase + Phdr-
p_offset, Phdr->p_filesz);
+ ZeroMem (ElfCt->ImageAddress + Delta + Phdr->p_filesz, Phdr-
p_memsz - Phdr->p_filesz);
+ }

+

+ //

+ // Relocate when new new image base is not the preferred image base.

+ //

+ if (ElfCt->ImageAddress != ElfCt->PreferredImageAddress) {

+ RelocateElf32Sections (ElfCt);

+ }

+

+ return EFI_SUCCESS;

+}

diff --git a/UefiPayloadPkg/PayloadLoaderPeim/ElfLib/Elf64.h
b/UefiPayloadPkg/PayloadLoaderPeim/ElfLib/Elf64.h
new file mode 100644
index 0000000000..d64dc64a6a
--- /dev/null
+++ b/UefiPayloadPkg/PayloadLoaderPeim/ElfLib/Elf64.h
@@ -0,0 +1,254 @@
+/** @file

+Ported ELF include files from FreeBSD

+

+Copyright (c) 2009 - 2010, Apple Inc. All rights reserved.<BR>

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

+

+**/

+/*-

+ * Copyright (c) 1996-1998 John D. Polstra.

+ * All rights reserved.

+ *

+ * Redistribution and use in source and binary forms, with or without

+ * modification, are permitted provided that the following conditions

+ * are met:

+ * 1. Redistributions of source code must retain the above copyright

+ * notice, this list of conditions and the following disclaimer.

+ * 2. Redistributions in binary form must reproduce the above copyright

+ * notice, this list of conditions and the following disclaimer in the

+ * documentation and/or other materials provided with the distribution.

+ *

+ * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS
IS'' AND

+ * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
TO, THE

+ * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
PARTICULAR PURPOSE

+ * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS
BE LIABLE

+ * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
CONSEQUENTIAL

+ * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
SUBSTITUTE GOODS

+ * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
INTERRUPTION)

+ * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
CONTRACT, STRICT

+ * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
IN ANY WAY

+ * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
POSSIBILITY OF

+ * SUCH DAMAGE.

+ *

+ * $FreeBSD: src/sys/sys/elf64.h,v 1.10.14.2 2007/12/03 21:30:36 marius Exp
$

+ */

+

+#ifndef _SYS_ELF64_H_

+#define _SYS_ELF64_H_ 1

+

+

+/*

+ * ELF definitions common to all 64-bit architectures.

+ */

+

+typedef UINT64 Elf64_Addr;

+typedef UINT16 Elf64_Half;

+typedef UINT64 Elf64_Off;

+typedef INT32 Elf64_Sword;

+typedef INT64 Elf64_Sxword;

+typedef UINT32 Elf64_Word;

+typedef UINT64 Elf64_Lword;

+typedef UINT64 Elf64_Xword;

+

+/*

+ * Types of dynamic symbol hash table bucket and chain elements.

+ *

+ * This is inconsistent among 64 bit architectures, so a machine dependent

+ * typedef is required.

+ */

+

+typedef Elf64_Word Elf64_Hashelt;

+

+/* Non-standard class-dependent datatype used for abstraction. */

+typedef Elf64_Xword Elf64_Size;

+typedef Elf64_Sxword Elf64_Ssize;

+

+/*

+ * ELF header.

+ */

+

+typedef struct {

+ unsigned char e_ident[EI_NIDENT]; /* File identification. */

+ Elf64_Half e_type; /* File type. */

+ Elf64_Half e_machine; /* Machine architecture. */

+ Elf64_Word e_version; /* ELF format version. */

+ Elf64_Addr e_entry; /* Entry point. */

+ Elf64_Off e_phoff; /* Program header file offset. */

+ Elf64_Off e_shoff; /* Section header file offset. */

+ Elf64_Word e_flags; /* Architecture-specific flags. */

+ Elf64_Half e_ehsize; /* Size of ELF header in bytes. */

+ Elf64_Half e_phentsize; /* Size of program header entry. */

+ Elf64_Half e_phnum; /* Number of program header entries. */

+ Elf64_Half e_shentsize; /* Size of section header entry. */

+ Elf64_Half e_shnum; /* Number of section header entries. */

+ Elf64_Half e_shstrndx; /* Section name strings section. */

+} Elf64_Ehdr;

+

+/*

+ * Section header.

+ */

+

+typedef struct {

+ Elf64_Word sh_name; /* Section name (index into the

+ section header string table). */

+ Elf64_Word sh_type; /* Section type. */

+ Elf64_Xword sh_flags; /* Section flags. */

+ Elf64_Addr sh_addr; /* Address in memory image. */

+ Elf64_Off sh_offset; /* Offset in file. */

+ Elf64_Xword sh_size; /* Size in bytes. */

+ Elf64_Word sh_link; /* Index of a related section. */

+ Elf64_Word sh_info; /* Depends on section type. */

+ Elf64_Xword sh_addralign; /* Alignment in bytes. */

+ Elf64_Xword sh_entsize; /* Size of each entry in section. */

+} Elf64_Shdr;

+

+/*

+ * Program header.

+ */

+

+typedef struct {

+ Elf64_Word p_type; /* Entry type. */

+ Elf64_Word p_flags; /* Access permission flags. */

+ Elf64_Off p_offset; /* File offset of contents. */

+ Elf64_Addr p_vaddr; /* Virtual address in memory image. */

+ Elf64_Addr p_paddr; /* Physical address (not used). */

+ Elf64_Xword p_filesz; /* Size of contents in file. */

+ Elf64_Xword p_memsz; /* Size of contents in memory. */

+ Elf64_Xword p_align; /* Alignment in memory and file. */

+} Elf64_Phdr;

+

+/*

+ * Dynamic structure. The ".dynamic" section contains an array of them.

+ */

+

+typedef struct {

+ Elf64_Sxword d_tag; /* Entry type. */

+ union {

+ Elf64_Xword d_val; /* Integer value. */

+ Elf64_Addr d_ptr; /* Address value. */

+ } d_un;

+} Elf64_Dyn;

+

+/*

+ * Relocation entries.

+ */

+

+/* Relocations that don't need an addend field. */

+typedef struct {

+ Elf64_Addr r_offset; /* Location to be relocated. */

+ Elf64_Xword r_info; /* Relocation type and symbol index. */

+} Elf64_Rel;

+

+/* Relocations that need an addend field. */

+typedef struct {

+ Elf64_Addr r_offset; /* Location to be relocated. */

+ Elf64_Xword r_info; /* Relocation type and symbol index. */

+ Elf64_Sxword r_addend; /* Addend. */

+} Elf64_Rela;

+

+/* Macros for accessing the fields of r_info. */

+#define ELF64_R_SYM(info) ((UINT32) RShiftU64 ((info), 32))

+#define ELF64_R_TYPE(info) ((info) & 0xffffffffL)

+

+/* Macro for constructing r_info from field values. */

+#define ELF64_R_INFO(sym, type) (((sym) << 32) + ((type) & 0xffffffffL))

+

+#define ELF64_R_TYPE_DATA(info) (((Elf64_Xword)(info)<<32)>>40)

+#define ELF64_R_TYPE_ID(info) (((Elf64_Xword)(info)<<56)>>56)

+#define ELF64_R_TYPE_INFO(data, type) \

+ (((Elf64_Xword)(data)<<8)+(Elf64_Xword)(type))

+

+/*

+ * Note entry header

+ */

+typedef Elf_Note Elf64_Nhdr;

+

+/*

+ * Move entry

+ */

+typedef struct {

+ Elf64_Lword m_value; /* symbol value */

+ Elf64_Xword m_info; /* size + index */

+ Elf64_Xword m_poffset; /* symbol offset */

+ Elf64_Half m_repeat; /* repeat count */

+ Elf64_Half m_stride; /* stride info */

+} Elf64_Move;

+

+#define ELF64_M_SYM(info) ((info)>>8)

+#define ELF64_M_SIZE(info) ((unsigned char)(info))

+#define ELF64_M_INFO(sym, size) (((sym)<<8)+(unsigned char)(size))

+

+/*

+ * Hardware/Software capabilities entry

+ */

+typedef struct {

+ Elf64_Xword c_tag; /* how to interpret value */

+ union {

+ Elf64_Xword c_val;

+ Elf64_Addr c_ptr;

+ } c_un;

+} Elf64_Cap;

+

+/*

+ * Symbol table entries.

+ */

+

+typedef struct {

+ Elf64_Word st_name; /* String table index of name. */

+ unsigned char st_info; /* Type and binding information. */

+ unsigned char st_other; /* Reserved (not used). */

+ Elf64_Half st_shndx; /* Section index of symbol. */

+ Elf64_Addr st_value; /* Symbol value. */

+ Elf64_Xword st_size; /* Size of associated object. */

+} Elf64_Sym;

+

+/* Macros for accessing the fields of st_info. */

+#define ELF64_ST_BIND(info) ((info) >> 4)

+#define ELF64_ST_TYPE(info) ((info) & 0xf)

+

+/* Macro for constructing st_info from field values. */

+#define ELF64_ST_INFO(bind, type) (((bind) << 4) + ((type) & 0xf))

+

+/* Macro for accessing the fields of st_other. */

+#define ELF64_ST_VISIBILITY(oth) ((oth) & 0x3)

+

+/* Structures used by Sun & GNU-style symbol versioning. */

+typedef struct {

+ Elf64_Half vd_version;

+ Elf64_Half vd_flags;

+ Elf64_Half vd_ndx;

+ Elf64_Half vd_cnt;

+ Elf64_Word vd_hash;

+ Elf64_Word vd_aux;

+ Elf64_Word vd_next;

+} Elf64_Verdef;

+

+typedef struct {

+ Elf64_Word vda_name;

+ Elf64_Word vda_next;

+} Elf64_Verdaux;

+

+typedef struct {

+ Elf64_Half vn_version;

+ Elf64_Half vn_cnt;

+ Elf64_Word vn_file;

+ Elf64_Word vn_aux;

+ Elf64_Word vn_next;

+} Elf64_Verneed;

+

+typedef struct {

+ Elf64_Word vna_hash;

+ Elf64_Half vna_flags;

+ Elf64_Half vna_other;

+ Elf64_Word vna_name;

+ Elf64_Word vna_next;

+} Elf64_Vernaux;

+

+typedef Elf64_Half Elf64_Versym;

+

+typedef struct {

+ Elf64_Half si_boundto; /* direct bindings - symbol bound to */

+ Elf64_Half si_flags; /* per symbol flags */

+} Elf64_Syminfo;

+

+#endif /* !_SYS_ELF64_H_ */

diff --git a/UefiPayloadPkg/PayloadLoaderPeim/ElfLib/Elf64Lib.c
b/UefiPayloadPkg/PayloadLoaderPeim/ElfLib/Elf64Lib.c
new file mode 100644
index 0000000000..e364807007
--- /dev/null
+++ b/UefiPayloadPkg/PayloadLoaderPeim/ElfLib/Elf64Lib.c
@@ -0,0 +1,460 @@
+/** @file

+ ELF library

+

+ Copyright (c) 2019 - 2021, Intel Corporation. All rights reserved.<BR>

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

+

+**/

+

+#include "ElfLibInternal.h"

+

+/**

+ Return the section header specified by Index.

+

+ @param ImageBase The image base.

+ @param Index The section index.

+

+ @return Pointer to the section header.

+**/

+Elf64_Shdr *

+GetElf64SectionByIndex (

+ IN UINT8 *ImageBase,

+ IN UINT32 Index

+ )

+{

+ Elf64_Ehdr *Ehdr;

+

+ Ehdr = (Elf64_Ehdr *)ImageBase;

+ if (Index >= Ehdr->e_shnum) {

+ return NULL;

+ }

+

+ return (Elf64_Shdr *)(ImageBase + Ehdr->e_shoff + Index * Ehdr-
e_shentsize);
+}

+

+/**

+ Return the segment header specified by Index.

+

+ @param ImageBase The image base.

+ @param Index The segment index.

+

+ @return Pointer to the segment header.

+**/

+Elf64_Phdr *

+GetElf64SegmentByIndex (

+ IN UINT8 *ImageBase,

+ IN UINT32 Index

+ )

+{

+ Elf64_Ehdr *Ehdr;

+

+ Ehdr = (Elf64_Ehdr *)ImageBase;

+ if (Index >= Ehdr->e_phnum) {

+ return NULL;

+ }

+

+ return (Elf64_Phdr *)(ImageBase + Ehdr->e_phoff + Index * Ehdr-
e_phentsize);
+}

+

+/**

+ Return the section header specified by the range.

+

+ @param ImageBase The image base.

+ @param Offset The section offset.

+ @param Size The section size.

+

+ @return Pointer to the section header.

+**/

+Elf64_Shdr *

+GetElf64SectionByRange (

+ IN UINT8 *ImageBase,

+ IN UINT64 Offset,

+ IN UINT64 Size

+ )

+{

+ UINT32 Index;

+ Elf64_Ehdr *Ehdr;

+ Elf64_Shdr *Shdr;

+

+ Ehdr = (Elf64_Ehdr *)ImageBase;

+

+ Shdr = (Elf64_Shdr *) (ImageBase + Ehdr->e_shoff);

+ for (Index = 0; Index < Ehdr->e_shnum; Index++) {

+ if ((Shdr->sh_offset == Offset) && (Shdr->sh_size == Size)) {

+ return Shdr;

+ }

+ Shdr = ELF_NEXT_ENTRY (Elf64_Shdr, Shdr, Ehdr->e_shentsize);

+ }

+ return NULL;

+}

+

+/**

+ Fix up the image based on the relocation entries.

+

+ @param Rela Relocation entries.

+ @param RelaSize Total size of relocation entries.

+ @param RelaEntrySize Relocation entry size.

+ @param RelaType Type of relocation entry.

+ @param Delta The delta between preferred image base and the
actual image base.

+ @param DynamicLinking TRUE when fixing up according to dynamic
relocation.

+

+ @retval EFI_SUCCESS The image fix up is processed successfully.

+**/

+EFI_STATUS

+ProcessRelocation64 (

+ IN Elf64_Rela *Rela,

+ IN UINT64 RelaSize,

+ IN UINT64 RelaEntrySize,

+ IN UINT64 RelaType,

+ IN INTN Delta,

+ IN BOOLEAN DynamicLinking

+ )

+{

+ UINTN Index;

+ UINT64 *Ptr;

+ UINT32 Type;

+

+ for ( Index = 0

+ ; MultU64x64 (RelaEntrySize, Index) < RelaSize

+ ; Index++, Rela = ELF_NEXT_ENTRY (Elf64_Rela, Rela, RelaEntrySize)

+ ) {

+ //

+ // r_offset is the virtual address of the storage unit affected by the
relocation.

+ //

+ Ptr = (UINT64 *)(UINTN)(Rela->r_offset + Delta);

+ Type = ELF64_R_TYPE(Rela->r_info);

+ switch (Type) {

+ case R_X86_64_NONE:

+ case R_X86_64_PC32:

+ case R_X86_64_PLT32:

+ case R_X86_64_GOTPCREL:

+ case R_X86_64_GOTPCRELX:

+ case R_X86_64_REX_GOTPCRELX:

+ break;

+

+ case R_X86_64_64:

+ if (DynamicLinking) {

+ //

+ // Dynamic section doesn't contain entries of this type.

+ //

+ DEBUG ((DEBUG_INFO, "Unsupported relocation type %02X\n",
Type));

+ ASSERT (FALSE);

+ } else {

+ *Ptr += Delta;

+ }

+ break;

+

+ case R_X86_64_32:

+ //

+ // Dynamic section doesn't contain entries of this type.

+ //

+ DEBUG ((DEBUG_INFO, "Unsupported relocation type %02X\n", Type));

+ ASSERT (FALSE);

+ break;

+

+ case R_X86_64_RELATIVE:

+ if (DynamicLinking) {

+ //

+ // A: Represents the addend used to compute the value of the
relocatable field.

+ // B: Represents the base address at which a shared object has been
loaded into memory during execution.

+ // Generally, a shared object is built with a 0 base virtual address, but
the execution address will be different.

+ //

+ // B (Base Address) in ELF spec is slightly different:

+ // An executable or shared object file's base address (on platforms
that support the concept) is calculated during

+ // execution from three values: the virtual memory load address, the
maximum page size, and the lowest virtual address

+ // of a program's loadable segment. To compute the base address,
one determines the memory address associated with the

+ // lowest p_vaddr value for a PT_LOAD segment. This address is
truncated to the nearest multiple of the maximum page size.

+ // The corresponding p_vaddr value itself is also truncated to the
nearest multiple of the maximum page size.

+ //

+ // *** The base address is the difference between the truncated
memory address and the truncated p_vaddr value. ***

+ //

+ // Delta in this function is B.

+ //

+ // Calculation: B + A

+ //

+ if (RelaType == SHT_RELA) {

+ ASSERT (*Ptr == 0);

+ *Ptr = Delta + Rela->r_addend;

+ } else {

+ //

+ // A is stored in the field of relocation for REL type.

+ //

+ *Ptr = Delta + *Ptr;

+ }

+ } else {

+ //

+ // non-Dynamic section doesn't contain entries of this type.

+ //

+ DEBUG ((DEBUG_INFO, "Unsupported relocation type %02X\n",
Type));

+ ASSERT (FALSE);

+ }

+ break;

+

+ default:

+ DEBUG ((DEBUG_INFO, "Unsupported relocation type %02X\n", Type));

+ }

+ }

+ return EFI_SUCCESS;

+}

+

+/**

+ Relocate the DYN type image.

+

+ @param ElfCt Point to image context.

+

+ @retval EFI_SUCCESS The relocation succeeds.

+ @retval EFI_UNSUPPORTED The image doesn't contain a dynamic section.

+**/

+EFI_STATUS

+RelocateElf64Dynamic (

+ IN ELF_IMAGE_CONTEXT *ElfCt

+ )

+{

+ UINT32 Index;

+ Elf64_Phdr *Phdr;

+ Elf64_Shdr *DynShdr;

+ Elf64_Shdr *RelShdr;

+ Elf64_Dyn *Dyn;

+ UINT64 RelaOffset;

+ UINT64 RelaCount;

+ UINT64 RelaSize;

+ UINT64 RelaEntrySize;

+ UINT64 RelaType;

+

+ //

+ // 1. Locate the dynamic section.

+ //

+ // If an object file participates in dynamic linking, its program header table

+ // will have an element of type PT_DYNAMIC.

+ // This ``segment'' contains the .dynamic section. A special symbol,
_DYNAMIC,

+ // labels the section, which contains an array of Elf32_Dyn or Elf64_Dyn.

+ //

+ DynShdr = NULL;

+ for (Index = 0; Index < ElfCt->PhNum; Index++) {

+ Phdr = GetElf64SegmentByIndex (ElfCt->FileBase, Index);

+ ASSERT (Phdr != NULL);

+ if (Phdr->p_type == PT_DYNAMIC) {

+ //

+ // Verify the existence of the dynamic section.

+ //

+ DynShdr = GetElf64SectionByRange (ElfCt->FileBase, Phdr->p_offset,
Phdr->p_filesz);

+ break;

+ }

+ }

+

+ //

+ // It's abnormal a DYN ELF doesn't contain a dynamic section.

+ //

+ ASSERT (DynShdr != NULL);

+ if (DynShdr == NULL) {

+ return EFI_UNSUPPORTED;

+ }

+ ASSERT (DynShdr->sh_type == SHT_DYNAMIC);

+ ASSERT (DynShdr->sh_entsize >= sizeof (*Dyn));

+

+ //

+ // 2. Locate the relocation section from the dynamic section.

+ //

+ RelaOffset = MAX_UINT64;

+ RelaSize = 0;

+ RelaCount = 0;

+ RelaEntrySize = 0;

+ RelaType = 0;

+ for ( Index = 0, Dyn = (Elf64_Dyn *) (ElfCt->FileBase + DynShdr->sh_offset)

+ ; Index < DivU64x64Remainder (DynShdr->sh_size, DynShdr->sh_entsize,
NULL)

+ ; Index++, Dyn = ELF_NEXT_ENTRY (Elf64_Dyn, Dyn, DynShdr-
sh_entsize)
+ ) {

+ switch (Dyn->d_tag) {

+ case DT_RELA:

+ case DT_REL:

+ //

+ // DT_REL represent program virtual addresses.

+ // A file's virtual addresses might not match the memory virtual
addresses during execution.

+ // When interpreting addresses contained in the dynamic structure, the
dynamic linker computes actual addresses,

+ // based on the original file value and the memory base address.

+ // For consistency, files do not contain relocation entries to ``correct''
addresses in the dynamic structure.

+ //

+ RelaOffset = Dyn->d_un.d_ptr - (UINTN) ElfCt-
PreferredImageAddress;
+ RelaType = (Dyn->d_tag == DT_RELA) ? SHT_RELA: SHT_REL;

+ break;

+ case DT_RELACOUNT:

+ case DT_RELCOUNT:

+ RelaCount = Dyn->d_un.d_val;

+ break;

+ case DT_RELENT:

+ case DT_RELAENT:

+ RelaEntrySize = Dyn->d_un.d_val;

+ break;

+ case DT_RELSZ:

+ case DT_RELASZ:

+ RelaSize = Dyn->d_un.d_val;

+ break;

+ default:

+ break;

+ }

+ }

+

+ if (RelaOffset == MAX_UINT64) {

+ ASSERT (RelaCount == 0);

+ ASSERT (RelaEntrySize == 0);

+ ASSERT (RelaSize == 0);

+ //

+ // It's fine that a DYN ELF doesn't contain relocation section.

+ //

+ return EFI_SUCCESS;

+ }

+

+ //

+ // Verify the existence of the relocation section.

+ //

+ RelShdr = GetElf64SectionByRange (ElfCt->FileBase, RelaOffset, RelaSize);

+ ASSERT (RelShdr != NULL);

+ if (RelShdr == NULL) {

+ return EFI_UNSUPPORTED;

+ }

+ ASSERT (RelShdr->sh_type == RelaType);

+ ASSERT (RelShdr->sh_entsize == RelaEntrySize);

+

+ //

+ // 3. Process the relocation section.

+ //

+ ProcessRelocation64 (

+ (Elf64_Rela *) (ElfCt->FileBase + RelShdr->sh_offset),

+ RelShdr->sh_size, RelShdr->sh_entsize, RelShdr->sh_type,

+ (UINTN) ElfCt->ImageAddress - (UINTN) ElfCt->PreferredImageAddress,

+ TRUE

+ );

+ return EFI_SUCCESS;

+}

+

+/**

+ Relocate all sections in a ELF image.

+

+ @param[in] ElfCt ELF image context pointer.

+

+ @retval EFI_UNSUPPORTED Relocation is not supported.

+ @retval EFI_SUCCESS ELF image was relocated successfully.

+**/

+EFI_STATUS

+RelocateElf64Sections (

+ IN ELF_IMAGE_CONTEXT *ElfCt

+ )

+{

+ EFI_STATUS Status;

+ Elf64_Ehdr *Ehdr;

+ Elf64_Shdr *RelShdr;

+ Elf64_Shdr *Shdr;

+ UINT32 Index;

+ UINTN Delta;

+

+ Ehdr = (Elf64_Ehdr *)ElfCt->FileBase;

+ if (Ehdr->e_machine != EM_X86_64) {

+ return EFI_UNSUPPORTED;

+ }

+

+ Delta = (UINTN) ElfCt->ImageAddress - (UINTN) ElfCt-
PreferredImageAddress;
+ ElfCt->EntryPoint = (UINTN)(Ehdr->e_entry + Delta);

+

+ //

+ // 1. Relocate dynamic ELF using the relocation section pointed by dynamic
section

+ //

+ if (Ehdr->e_type == ET_DYN) {

+ DEBUG ((DEBUG_INFO, "DYN ELF: Relocate using dynamic sections...\n"));

+ Status = RelocateElf64Dynamic (ElfCt);

+ ASSERT_EFI_ERROR (Status);

+ return Status;

+ }

+

+ //

+ // 2. Executable ELF: Fix up the delta between actual image address and
preferred image address.

+ //

+ // Linker already fixed up EXEC ELF based on the preferred image address.

+ // A ELF loader in modern OS only loads it into the preferred image
address.

+ // The below relocation is unneeded in that case.

+ // But the ELF loader in firmware supports to load the image to a different
address.

+ // The below relocation is needed in this case.

+ //

+ DEBUG ((DEBUG_INFO, "EXEC ELF: Fix actual/preferred base address
delta ...\n"));

+ for ( Index = 0, RelShdr = (Elf64_Shdr *) (ElfCt->FileBase + Ehdr->e_shoff)

+ ; Index < Ehdr->e_shnum

+ ; Index++, RelShdr = ELF_NEXT_ENTRY (Elf64_Shdr, RelShdr, Ehdr-
e_shentsize)
+ ) {

+ if ((RelShdr->sh_type != SHT_REL) && (RelShdr->sh_type != SHT_RELA)) {

+ continue;

+ }

+ Shdr = GetElf64SectionByIndex (ElfCt->FileBase, RelShdr->sh_info);

+ if ((Shdr->sh_flags & SHF_ALLOC) == SHF_ALLOC) {

+ //

+ // Only fix up sections that occupy memory during process execution.

+ //

+ ProcessRelocation64 (

+ (Elf64_Rela *)((UINT8*)Ehdr + RelShdr->sh_offset),

+ RelShdr->sh_size, RelShdr->sh_entsize, RelShdr->sh_type,

+ Delta, FALSE

+ );

+ }

+ }

+

+ return EFI_SUCCESS;

+}

+

+/**

+ Load ELF image which has 64-bit architecture.

+

+ Caller should set Context.ImageAddress to a proper value, either pointing
to

+ a new allocated memory whose size equal to Context.ImageSize, or
pointing

+ to Context.PreferredImageAddress.

+

+ @param[in] ElfCt ELF image context pointer.

+

+ @retval EFI_SUCCESS ELF binary is loaded successfully.

+ @retval Others Loading ELF binary fails.

+

+**/

+EFI_STATUS

+LoadElf64Image (

+ IN ELF_IMAGE_CONTEXT *ElfCt

+ )

+{

+ Elf64_Ehdr *Ehdr;

+ Elf64_Phdr *Phdr;

+ UINT16 Index;

+ UINTN Delta;

+

+ ASSERT (ElfCt != NULL);

+

+ //

+ // Per the sprit of ELF, loading to memory only consumes info from
program headers.

+ //

+ Ehdr = (Elf64_Ehdr *)ElfCt->FileBase;

+

+ for ( Index = 0, Phdr = (Elf64_Phdr *)(ElfCt->FileBase + Ehdr->e_phoff)

+ ; Index < Ehdr->e_phnum

+ ; Index++, Phdr = ELF_NEXT_ENTRY (Elf64_Phdr, Phdr, Ehdr-
e_phentsize)
+ ) {

+ //

+ // Skip segments that don't require load (type tells, or size is 0)

+ //

+ if ((Phdr->p_type != PT_LOAD) ||

+ (Phdr->p_memsz == 0)) {

+ continue;

+ }

+

+ //

+ // The memory offset of segment relative to the image base

+ // Note: CopyMem() does nothing when the dst equals to src.

+ //

+ Delta = (UINTN) Phdr->p_paddr - (UINTN) ElfCt->PreferredImageAddress;

+ CopyMem (ElfCt->ImageAddress + Delta, ElfCt->FileBase + (UINTN) Phdr-
p_offset, (UINTN) Phdr->p_filesz);
+ ZeroMem (ElfCt->ImageAddress + Delta + (UINTN) Phdr->p_filesz,
(UINTN) (Phdr->p_memsz - Phdr->p_filesz));

+ }

+

+ //

+ // Relocate when new new image base is not the preferred image base.

+ //

+ if (ElfCt->ImageAddress != ElfCt->PreferredImageAddress) {

+ RelocateElf64Sections (ElfCt);

+ }

+

+ return EFI_SUCCESS;

+}

diff --git a/UefiPayloadPkg/PayloadLoaderPeim/ElfLib/ElfCommon.h
b/UefiPayloadPkg/PayloadLoaderPeim/ElfLib/ElfCommon.h
new file mode 100644
index 0000000000..15c9e33d3f
--- /dev/null
+++ b/UefiPayloadPkg/PayloadLoaderPeim/ElfLib/ElfCommon.h
@@ -0,0 +1,983 @@
+/** @file

+Ported ELF include files from FreeBSD

+

+Copyright (c) 2009 - 2010, Apple Inc. All rights reserved.<BR>

+Portions Copyright (c) 2011 - 2013, ARM Ltd. All rights reserved.<BR>

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

+

+

+**/

+/*-

+ * Copyright (c) 1998 John D. Polstra.

+ * All rights reserved.

+ *

+ * Redistribution and use in source and binary forms, with or without

+ * modification, are permitted provided that the following conditions

+ * are met:

+ * 1. Redistributions of source code must retain the above copyright

+ * notice, this list of conditions and the following disclaimer.

+ * 2. Redistributions in binary form must reproduce the above copyright

+ * notice, this list of conditions and the following disclaimer in the

+ * documentation and/or other materials provided with the distribution.

+ *

+ * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS
IS'' AND

+ * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
TO, THE

+ * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
PARTICULAR PURPOSE

+ * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS
BE LIABLE

+ * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
CONSEQUENTIAL

+ * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
SUBSTITUTE GOODS

+ * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
INTERRUPTION)

+ * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
CONTRACT, STRICT

+ * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
IN ANY WAY

+ * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
POSSIBILITY OF

+ * SUCH DAMAGE.

+ *

+ * $FreeBSD: src/sys/sys/elf_common.h,v 1.15.8.2 2007/12/03 21:30:36
marius Exp $

+ */

+

+#ifndef _SYS_ELF_COMMON_H_

+#define _SYS_ELF_COMMON_H_ 1

+

+/*

+ * ELF definitions that are independent of architecture or word size.

+ */

+

+/*

+ * Note header. The ".note" section contains an array of notes. Each

+ * begins with this header, aligned to a word boundary. Immediately

+ * following the note header is n_namesz bytes of name, padded to the

+ * next word boundary. Then comes n_descsz bytes of descriptor, again

+ * padded to a word boundary. The values of n_namesz and n_descsz do

+ * not include the padding.

+ */

+

+typedef struct {

+ UINT32 n_namesz; /* Length of name. */

+ UINT32 n_descsz; /* Length of descriptor. */

+ UINT32 n_type; /* Type of this note. */

+} Elf_Note;

+

+/* Indexes into the e_ident array. Keep synced with

+ http://www.sco.com/developers/gabi/latest/ch4.eheader.html */

+#define EI_MAG0 0 /* Magic number, byte 0. */

+#define EI_MAG1 1 /* Magic number, byte 1. */

+#define EI_MAG2 2 /* Magic number, byte 2. */

+#define EI_MAG3 3 /* Magic number, byte 3. */

+#define EI_CLASS 4 /* Class of machine. */

+#define EI_DATA 5 /* Data format. */

+#define EI_VERSION 6 /* ELF format version. */

+#define EI_OSABI 7 /* Operating system / ABI identification */

+#define EI_ABIVERSION 8 /* ABI version */

+#define OLD_EI_BRAND 8 /* Start of architecture identification. */

+#define EI_PAD 9 /* Start of padding (per SVR4 ABI). */

+#define EI_NIDENT 16 /* Size of e_ident array. */

+

+/* Values for the magic number bytes. */

+#define ELFMAG0 0x7f

+#define ELFMAG1 'E'

+#define ELFMAG2 'L'

+#define ELFMAG3 'F'

+#define ELFMAG "\177ELF" /* magic string */

+#define SELFMAG 4 /* magic string size */

+

+/* Values for e_ident[EI_VERSION] and e_version. */

+#define EV_NONE 0

+#define EV_CURRENT 1

+

+/* Values for e_ident[EI_CLASS]. */

+#define ELFCLASSNONE 0 /* Unknown class. */

+#define ELFCLASS32 1 /* 32-bit architecture. */

+#define ELFCLASS64 2 /* 64-bit architecture. */

+

+/* Values for e_ident[EI_DATA]. */

+#define ELFDATANONE 0 /* Unknown data format. */

+#define ELFDATA2LSB 1 /* 2's complement little-endian. */

+#define ELFDATA2MSB 2 /* 2's complement big-endian. */

+

+/* Values for e_ident[EI_OSABI]. */

+#define ELFOSABI_NONE 0 /* UNIX System V ABI */

+#define ELFOSABI_HPUX 1 /* HP-UX operating system */

+#define ELFOSABI_NETBSD 2 /* NetBSD */

+#define ELFOSABI_LINUX 3 /* GNU/Linux */

+#define ELFOSABI_HURD 4 /* GNU/Hurd */

+#define ELFOSABI_86OPEN 5 /* 86Open common IA32 ABI */

+#define ELFOSABI_SOLARIS 6 /* Solaris */

+#define ELFOSABI_AIX 7 /* AIX */

+#define ELFOSABI_IRIX 8 /* IRIX */

+#define ELFOSABI_FREEBSD 9 /* FreeBSD */

+#define ELFOSABI_TRU64 10 /* TRU64 UNIX */

+#define ELFOSABI_MODESTO 11 /* Novell Modesto */

+#define ELFOSABI_OPENBSD 12 /* OpenBSD */

+#define ELFOSABI_OPENVMS 13 /* Open VMS */

+#define ELFOSABI_NSK 14 /* HP Non-Stop Kernel */

+#define ELFOSABI_ARM 97 /* ARM */

+#define ELFOSABI_STANDALONE 255 /* Standalone (embedded)
application */

+

+#define ELFOSABI_SYSV ELFOSABI_NONE /* symbol used in old spec */

+#define ELFOSABI_MONTEREY ELFOSABI_AIX /* Monterey */

+

+/* e_ident */

+#define IS_ELF(ehdr) ((ehdr).e_ident[EI_MAG0] == ELFMAG0 && \

+ (ehdr).e_ident[EI_MAG1] == ELFMAG1 && \

+ (ehdr).e_ident[EI_MAG2] == ELFMAG2 && \

+ (ehdr).e_ident[EI_MAG3] == ELFMAG3)

+

+/* Values for e_type. */

+#define ET_NONE 0 /* Unknown type. */

+#define ET_REL 1 /* Relocatable. */

+#define ET_EXEC 2 /* Executable. */

+#define ET_DYN 3 /* Shared object. */

+#define ET_CORE 4 /* Core file. */

+#define ET_LOOS 0xfe00 /* First operating system specific. */

+#define ET_HIOS 0xfeff /* Last operating system-specific. */

+#define ET_LOPROC 0xff00 /* First processor-specific. */

+#define ET_HIPROC 0xffff /* Last processor-specific. */

+

+/* Values for e_machine. */

+#define EM_NONE 0 /* Unknown machine. */

+#define EM_M32 1 /* AT&T WE32100. */

+#define EM_SPARC 2 /* Sun SPARC. */

+#define EM_386 3 /* Intel i386. */

+#define EM_68K 4 /* Motorola 68000. */

+#define EM_88K 5 /* Motorola 88000. */

+#define EM_860 7 /* Intel i860. */

+#define EM_MIPS 8 /* MIPS R3000 Big-Endian only. */

+#define EM_S370 9 /* IBM System/370. */

+#define EM_MIPS_RS3_LE 10 /* MIPS R3000 Little-Endian. */

+#define EM_PARISC 15 /* HP PA-RISC. */

+#define EM_VPP500 17 /* Fujitsu VPP500. */

+#define EM_SPARC32PLUS 18 /* SPARC v8plus. */

+#define EM_960 19 /* Intel 80960. */

+#define EM_PPC 20 /* PowerPC 32-bit. */

+#define EM_PPC64 21 /* PowerPC 64-bit. */

+#define EM_S390 22 /* IBM System/390. */

+#define EM_V800 36 /* NEC V800. */

+#define EM_FR20 37 /* Fujitsu FR20. */

+#define EM_RH32 38 /* TRW RH-32. */

+#define EM_RCE 39 /* Motorola RCE. */

+#define EM_ARM 40 /* ARM. */

+#define EM_SH 42 /* Hitachi SH. */

+#define EM_SPARCV9 43 /* SPARC v9 64-bit. */

+#define EM_TRICORE 44 /* Siemens TriCore embedded processor. */

+#define EM_ARC 45 /* Argonaut RISC Core. */

+#define EM_H8_300 46 /* Hitachi H8/300. */

+#define EM_H8_300H 47 /* Hitachi H8/300H. */

+#define EM_H8S 48 /* Hitachi H8S. */

+#define EM_H8_500 49 /* Hitachi H8/500. */

+#define EM_MIPS_X 51 /* Stanford MIPS-X. */

+#define EM_COLDFIRE 52 /* Motorola ColdFire. */

+#define EM_68HC12 53 /* Motorola M68HC12. */

+#define EM_MMA 54 /* Fujitsu MMA. */

+#define EM_PCP 55 /* Siemens PCP. */

+#define EM_NCPU 56 /* Sony nCPU. */

+#define EM_NDR1 57 /* Denso NDR1 microprocessor. */

+#define EM_STARCORE 58 /* Motorola Star*Core processor. */

+#define EM_ME16 59 /* Toyota ME16 processor. */

+#define EM_ST100 60 /* STMicroelectronics ST100 processor. */

+#define EM_TINYJ 61 /* Advanced Logic Corp. TinyJ processor. */

+#define EM_X86_64 62 /* Advanced Micro Devices x86-64 */

+#define EM_AMD64 EM_X86_64 /* Advanced Micro Devices x86-64
(compat) */

+#define EM_AARCH64 183 /* ARM 64bit Architecture */

+

+/* Non-standard or deprecated. */

+#define EM_486 6 /* Intel i486. */

+#define EM_MIPS_RS4_BE 10 /* MIPS R4000 Big-Endian */

+#define EM_ALPHA_STD 41 /* Digital Alpha (standard value). */

+#define EM_ALPHA 0x9026 /* Alpha (written in the absence of an ABI) */

+

+/* Special section indexes. */

+#define SHN_UNDEF 0 /* Undefined, missing, irrelevant. */

+#define SHN_LORESERVE 0xff00 /* First of reserved range. */

+#define SHN_LOPROC 0xff00 /* First processor-specific. */

+#define SHN_HIPROC 0xff1f /* Last processor-specific. */

+#define SHN_LOOS 0xff20 /* First operating system-specific. */

+#define SHN_HIOS 0xff3f /* Last operating system-specific. */

+#define SHN_ABS 0xfff1 /* Absolute values. */

+#define SHN_COMMON 0xfff2 /* Common data. */

+#define SHN_XINDEX 0xffff /* Escape -- index stored elsewhere. */

+#define SHN_HIRESERVE 0xffff /* Last of reserved range. */

+

+/* sh_type */

+#define SHT_NULL 0 /* inactive */

+#define SHT_PROGBITS 1 /* program defined information */

+#define SHT_SYMTAB 2 /* symbol table section */

+#define SHT_STRTAB 3 /* string table section */

+#define SHT_RELA 4 /* relocation section with addends */

+#define SHT_HASH 5 /* symbol hash table section */

+#define SHT_DYNAMIC 6 /* dynamic section */

+#define SHT_NOTE 7 /* note section */

+#define SHT_NOBITS 8 /* no space section */

+#define SHT_REL 9 /* relocation section - no addends */

+#define SHT_SHLIB 10 /* reserved - purpose unknown */

+#define SHT_DYNSYM 11 /* dynamic symbol table section */

+#define SHT_INIT_ARRAY 14 /* Initialization function pointers. */

+#define SHT_FINI_ARRAY 15 /* Termination function pointers. */

+#define SHT_PREINIT_ARRAY 16 /* Pre-initialization function ptrs. */

+#define SHT_GROUP 17 /* Section group. */

+#define SHT_SYMTAB_SHNDX 18 /* Section indexes (see SHN_XINDEX). */

+#define SHT_LOOS 0x60000000 /* First of OS specific semantics */

+#define SHT_LOSUNW 0x6ffffff4

+#define SHT_SUNW_dof 0x6ffffff4

+#define SHT_SUNW_cap 0x6ffffff5

+#define SHT_SUNW_SIGNATURE 0x6ffffff6

+#define SHT_SUNW_ANNOTATE 0x6ffffff7

+#define SHT_SUNW_DEBUGSTR 0x6ffffff8

+#define SHT_SUNW_DEBUG 0x6ffffff9

+#define SHT_SUNW_move 0x6ffffffa

+#define SHT_SUNW_COMDAT 0x6ffffffb

+#define SHT_SUNW_syminfo 0x6ffffffc

+#define SHT_SUNW_verdef 0x6ffffffd

+#define SHT_GNU_verdef 0x6ffffffd /* Symbol versions provided */

+#define SHT_SUNW_verneed 0x6ffffffe

+#define SHT_GNU_verneed 0x6ffffffe /* Symbol versions required */

+#define SHT_SUNW_versym 0x6fffffff

+#define SHT_GNU_versym 0x6fffffff /* Symbol version table */

+#define SHT_HISUNW 0x6fffffff

+#define SHT_HIOS 0x6fffffff /* Last of OS specific semantics */

+#define SHT_LOPROC 0x70000000 /* reserved range for processor */

+#define SHT_AMD64_UNWIND 0x70000001 /* unwind information */

+#define SHT_HIPROC 0x7fffffff /* specific section header types */

+#define SHT_LOUSER 0x80000000 /* reserved range for application */

+#define SHT_HIUSER 0xffffffff /* specific indexes */

+

+/* Flags for sh_flags. */

+#define SHF_WRITE 0x1 /* Section contains writable data. */

+#define SHF_ALLOC 0x2 /* Section occupies memory. */

+#define SHF_EXECINSTR 0x4 /* Section contains instructions. */

+#define SHF_MERGE 0x10 /* Section may be merged. */

+#define SHF_STRINGS 0x20 /* Section contains strings. */

+#define SHF_INFO_LINK 0x40 /* sh_info holds section index. */

+#define SHF_LINK_ORDER 0x80 /* Special ordering requirements. */

+#define SHF_OS_NONCONFORMING 0x100 /* OS-specific processing
required. */

+#define SHF_GROUP 0x200 /* Member of section group. */

+#define SHF_TLS 0x400 /* Section contains TLS data. */

+#define SHF_MASKOS 0x0ff00000 /* OS-specific semantics. */

+#define SHF_MASKPROC 0xf0000000 /* Processor-specific semantics. */

+

+/* Values for p_type. */

+#define PT_NULL 0 /* Unused entry. */

+#define PT_LOAD 1 /* Loadable segment. */

+#define PT_DYNAMIC 2 /* Dynamic linking information segment. */

+#define PT_INTERP 3 /* Pathname of interpreter. */

+#define PT_NOTE 4 /* Auxiliary information. */

+#define PT_SHLIB 5 /* Reserved (not used). */

+#define PT_PHDR 6 /* Location of program header itself. */

+#define PT_TLS 7 /* Thread local storage segment */

+#define PT_LOOS 0x60000000 /* First OS-specific. */

+#define PT_SUNW_UNWIND 0x6464e550 /* amd64 UNWIND program
header */

+#define PT_GNU_EH_FRAME 0x6474e550

+#define PT_LOSUNW 0x6ffffffa

+#define PT_SUNWBSS 0x6ffffffa /* Sun Specific segment */

+#define PT_SUNWSTACK 0x6ffffffb /* describes the stack segment */

+#define PT_SUNWDTRACE 0x6ffffffc /* private */

+#define PT_SUNWCAP 0x6ffffffd /* hard/soft capabilities segment */

+#define PT_HISUNW 0x6fffffff

+#define PT_HIOS 0x6fffffff /* Last OS-specific. */

+#define PT_LOPROC 0x70000000 /* First processor-specific type. */

+#define PT_HIPROC 0x7fffffff /* Last processor-specific type. */

+

+/* Values for p_flags. */

+#define PF_X 0x1 /* Executable. */

+#define PF_W 0x2 /* Writable. */

+#define PF_R 0x4 /* Readable. */

+#define PF_MASKOS 0x0ff00000 /* Operating system-specific. */

+#define PF_MASKPROC 0xf0000000 /* Processor-specific. */

+

+/* Extended program header index. */

+#define PN_XNUM 0xffff

+

+/* Values for d_tag. */

+#define DT_NULL 0 /* Terminating entry. */

+#define DT_NEEDED 1 /* String table offset of a needed shared

+ library. */

+#define DT_PLTRELSZ 2 /* Total size in bytes of PLT relocations. */

+#define DT_PLTGOT 3 /* Processor-dependent address. */

+#define DT_HASH 4 /* Address of symbol hash table. */

+#define DT_STRTAB 5 /* Address of string table. */

+#define DT_SYMTAB 6 /* Address of symbol table. */

+#define DT_RELA 7 /* Address of ElfNN_Rela relocations. */

+#define DT_RELASZ 8 /* Total size of ElfNN_Rela relocations. */

+#define DT_RELAENT 9 /* Size of each ElfNN_Rela relocation entry. */

+#define DT_STRSZ 10 /* Size of string table. */

+#define DT_SYMENT 11 /* Size of each symbol table entry. */

+#define DT_INIT 12 /* Address of initialization function. */

+#define DT_FINI 13 /* Address of finalization function. */

+#define DT_SONAME 14 /* String table offset of shared object

+ name. */

+#define DT_RPATH 15 /* String table offset of library path. [sup] */

+#define DT_SYMBOLIC 16 /* Indicates "symbolic" linking. [sup] */

+#define DT_REL 17 /* Address of ElfNN_Rel relocations. */

+#define DT_RELSZ 18 /* Total size of ElfNN_Rel relocations. */

+#define DT_RELENT 19 /* Size of each ElfNN_Rel relocation. */

+#define DT_PLTREL 20 /* Type of relocation used for PLT. */

+#define DT_DEBUG 21 /* Reserved (not used). */

+#define DT_TEXTREL 22 /* Indicates there may be relocations in

+ non-writable segments. [sup] */

+#define DT_JMPREL 23 /* Address of PLT relocations. */

+#define DT_BIND_NOW 24 /* [sup] */

+#define DT_INIT_ARRAY 25 /* Address of the array of pointers to

+ initialization functions */

+#define DT_FINI_ARRAY 26 /* Address of the array of pointers to

+ termination functions */

+#define DT_INIT_ARRAYSZ 27 /* Size in bytes of the array of

+ initialization functions. */

+#define DT_FINI_ARRAYSZ 28 /* Size in bytes of the array of

+ terminationfunctions. */

+#define DT_RUNPATH 29 /* String table offset of a null-terminated

+ library search path string. */

+#define DT_FLAGS 30 /* Object specific flag values. */

+#define DT_ENCODING 32 /* Values greater than or equal to
DT_ENCODING

+ and less than DT_LOOS follow the rules for

+ the interpretation of the d_un union

+ as follows: even == 'd_ptr', even == 'd_val'

+ or none */

+#define DT_PREINIT_ARRAY 32 /* Address of the array of pointers to

+ pre-initialization functions. */

+#define DT_PREINIT_ARRAYSZ 33 /* Size in bytes of the array of

+ pre-initialization functions. */

+#define DT_MAXPOSTAGS 34 /* number of positive tags */

+#define DT_LOOS 0x6000000d /* First OS-specific */

+#define DT_SUNW_AUXILIARY 0x6000000d /* symbol auxiliary name */

+#define DT_SUNW_RTLDINF 0x6000000e /* ld.so.1 info (private) */

+#define DT_SUNW_FILTER 0x6000000f /* symbol filter name */

+#define DT_SUNW_CAP 0x60000010 /* hardware/software */

+#define DT_HIOS 0x6ffff000 /* Last OS-specific */

+

+/*

+ * DT_* entries which fall between DT_VALRNGHI & DT_VALRNGLO use the

+ * Dyn.d_un.d_val field of the Elf*_Dyn structure.

+ */

+#define DT_VALRNGLO 0x6ffffd00

+#define DT_CHECKSUM 0x6ffffdf8 /* elf checksum */

+#define DT_PLTPADSZ 0x6ffffdf9 /* pltpadding size */

+#define DT_MOVEENT 0x6ffffdfa /* move table entry size */

+#define DT_MOVESZ 0x6ffffdfb /* move table size */

+#define DT_FEATURE_1 0x6ffffdfc /* feature holder */

+#define DT_POSFLAG_1 0x6ffffdfd /* flags for DT_* entries, effecting */

+ /* the following DT_* entry. */

+ /* See DF_P1_* definitions */

+#define DT_SYMINSZ 0x6ffffdfe /* syminfo table size (in bytes) */

+#define DT_SYMINENT 0x6ffffdff /* syminfo entry size (in bytes) */

+#define DT_VALRNGHI 0x6ffffdff

+

+/*

+ * DT_* entries which fall between DT_ADDRRNGHI & DT_ADDRRNGLO use
the

+ * Dyn.d_un.d_ptr field of the Elf*_Dyn structure.

+ *

+ * If any adjustment is made to the ELF object after it has been

+ * built, these entries will need to be adjusted.

+ */

+#define DT_ADDRRNGLO 0x6ffffe00

+#define DT_CONFIG 0x6ffffefa /* configuration information */

+#define DT_DEPAUDIT 0x6ffffefb /* dependency auditing */

+#define DT_AUDIT 0x6ffffefc /* object auditing */

+#define DT_PLTPAD 0x6ffffefd /* pltpadding (sparcv9) */

+#define DT_MOVETAB 0x6ffffefe /* move table */

+#define DT_SYMINFO 0x6ffffeff /* syminfo table */

+#define DT_ADDRRNGHI 0x6ffffeff

+

+#define DT_VERSYM 0x6ffffff0 /* Address of versym section. */

+#define DT_RELACOUNT 0x6ffffff9 /* number of RELATIVE relocations */

+#define DT_RELCOUNT 0x6ffffffa /* number of RELATIVE relocations */

+#define DT_FLAGS_1 0x6ffffffb /* state flags - see DF_1_* defs */

+#define DT_VERDEF 0x6ffffffc /* Address of verdef section. */

+#define DT_VERDEFNUM 0x6ffffffd /* Number of elems in verdef section
*/

+#define DT_VERNEED 0x6ffffffe /* Address of verneed section. */

+#define DT_VERNEEDNUM 0x6fffffff /* Number of elems in verneed
section */

+

+#define DT_LOPROC 0x70000000 /* First processor-specific type. */

+#define DT_DEPRECATED_SPARC_REGISTER 0x7000001

+#define DT_AUXILIARY 0x7ffffffd /* shared library auxiliary name */

+#define DT_USED 0x7ffffffe /* ignored - same as needed */

+#define DT_FILTER 0x7fffffff /* shared library filter name */

+#define DT_HIPROC 0x7fffffff /* Last processor-specific type. */

+

+/* Values for DT_FLAGS */

+#define DF_ORIGIN 0x0001 /* Indicates that the object being loaded may

+ make reference to the $ORIGIN substitution

+ string */

+#define DF_SYMBOLIC 0x0002 /* Indicates "symbolic" linking. */

+#define DF_TEXTREL 0x0004 /* Indicates there may be relocations in

+ non-writable segments. */

+#define DF_BIND_NOW 0x0008 /* Indicates that the dynamic linker
should

+ process all relocations for the object

+ containing this entry before transferring

+ control to the program. */

+#define DF_STATIC_TLS 0x0010 /* Indicates that the shared object or

+ executable contains code using a static

+ thread-local storage scheme. */

+

+/* Values for n_type. Used in core files. */

+#define NT_PRSTATUS 1 /* Process status. */

+#define NT_FPREGSET 2 /* Floating point registers. */

+#define NT_PRPSINFO 3 /* Process state info. */

+

+/* Symbol Binding - ELFNN_ST_BIND - st_info */

+#define STB_LOCAL 0 /* Local symbol */

+#define STB_GLOBAL 1 /* Global symbol */

+#define STB_WEAK 2 /* like global - lower precedence */

+#define STB_LOOS 10 /* Reserved range for operating system */

+#define STB_HIOS 12 /* specific semantics. */

+#define STB_LOPROC 13 /* reserved range for processor */

+#define STB_HIPROC 15 /* specific semantics. */

+

+/* Symbol type - ELFNN_ST_TYPE - st_info */

+#define STT_NOTYPE 0 /* Unspecified type. */

+#define STT_OBJECT 1 /* Data object. */

+#define STT_FUNC 2 /* Function. */

+#define STT_SECTION 3 /* Section. */

+#define STT_FILE 4 /* Source file. */

+#define STT_COMMON 5 /* Uninitialized common block. */

+#define STT_TLS 6 /* TLS object. */

+#define STT_NUM 7

+#define STT_LOOS 10 /* Reserved range for operating system */

+#define STT_HIOS 12 /* specific semantics. */

+#define STT_LOPROC 13 /* reserved range for processor */

+#define STT_HIPROC 15 /* specific semantics. */

+

+/* Symbol visibility - ELFNN_ST_VISIBILITY - st_other */

+#define STV_DEFAULT 0x0 /* Default visibility (see binding). */

+#define STV_INTERNAL 0x1 /* Special meaning in relocatable objects. */

+#define STV_HIDDEN 0x2 /* Not visible. */

+#define STV_PROTECTED 0x3 /* Visible but not preemptible. */

+

+/* Special symbol table indexes. */

+#define STN_UNDEF 0 /* Undefined symbol index. */

+

+/* Symbol versioning flags. */

+#define VER_DEF_CURRENT 1

+#define VER_DEF_IDX(x) VER_NDX(x)

+

+#define VER_FLG_BASE 0x01

+#define VER_FLG_WEAK 0x02

+

+#define VER_NEED_CURRENT 1

+#define VER_NEED_WEAK (1u << 15)

+#define VER_NEED_HIDDEN VER_NDX_HIDDEN

+#define VER_NEED_IDX(x) VER_NDX(x)

+

+#define VER_NDX_LOCAL 0

+#define VER_NDX_GLOBAL 1

+#define VER_NDX_GIVEN 2

+

+#define VER_NDX_HIDDEN (1u << 15)

+#define VER_NDX(x) ((x) & ~(1u << 15))

+

+#define CA_SUNW_NULL 0

+#define CA_SUNW_HW_1 1 /* first hardware capabilities entry */

+#define CA_SUNW_SF_1 2 /* first software capabilities entry */

+

+/*

+ * Syminfo flag values

+ */

+#define SYMINFO_FLG_DIRECT 0x0001 /* symbol ref has direct association
*/

+ /* to object containing defn. */

+#define SYMINFO_FLG_PASSTHRU 0x0002 /* ignored - see
SYMINFO_FLG_FILTER */

+#define SYMINFO_FLG_COPY 0x0004 /* symbol is a copy-reloc */

+#define SYMINFO_FLG_LAZYLOAD 0x0008 /* object containing defn
should be */

+ /* lazily-loaded */

+#define SYMINFO_FLG_DIRECTBIND 0x0010 /* ref should be bound
directly to */

+ /* object containing defn. */

+#define SYMINFO_FLG_NOEXTDIRECT 0x0020 /* don't let an external
reference */

+ /* directly bind to this symbol */

+#define SYMINFO_FLG_FILTER 0x0002 /* symbol ref is associated to a */

+#define SYMINFO_FLG_AUXILIARY 0x0040 /* standard or auxiliary filter
*/

+

+/*

+ * Syminfo.si_boundto values.

+ */

+#define SYMINFO_BT_SELF 0xffff /* symbol bound to self */

+#define SYMINFO_BT_PARENT 0xfffe /* symbol bound to parent */

+#define SYMINFO_BT_NONE 0xfffd /* no special symbol binding */

+#define SYMINFO_BT_EXTERN 0xfffc /* symbol defined as external */

+#define SYMINFO_BT_LOWRESERVE 0xff00 /* beginning of reserved
entries */

+

+/*

+ * Syminfo version values.

+ */

+#define SYMINFO_NONE 0 /* Syminfo version */

+#define SYMINFO_CURRENT 1

+#define SYMINFO_NUM 2

+

+/*

+ * Relocation types.

+ *

+ * All machine architectures are defined here to allow tools on one to

+ * handle others.

+ */

+

+#define R_386_NONE 0 /* No relocation. */

+#define R_386_32 1 /* Add symbol value. */

+#define R_386_PC32 2 /* Add PC-relative symbol value. */

+#define R_386_GOT32 3 /* Add PC-relative GOT offset. */

+#define R_386_PLT32 4 /* Add PC-relative PLT offset. */

+#define R_386_COPY 5 /* Copy data from shared object. */

+#define R_386_GLOB_DAT 6 /* Set GOT entry to data address. */

+#define R_386_JMP_SLOT 7 /* Set GOT entry to code address. */

+#define R_386_RELATIVE 8 /* Add load address of shared object. */

+#define R_386_GOTOFF 9 /* Add GOT-relative symbol address. */

+#define R_386_GOTPC 10 /* Add PC-relative GOT table address. */

+#define R_386_TLS_TPOFF 14 /* Negative offset in static TLS block */

+#define R_386_TLS_IE 15 /* Absolute address of GOT for -ve static TLS */

+#define R_386_TLS_GOTIE 16 /* GOT entry for negative static TLS block
*/

+#define R_386_TLS_LE 17 /* Negative offset relative to static TLS */

+#define R_386_TLS_GD 18 /* 32 bit offset to GOT (index,off) pair */

+#define R_386_TLS_LDM 19 /* 32 bit offset to GOT (index,zero) pair */

+#define R_386_TLS_GD_32 24 /* 32 bit offset to GOT (index,off) pair */

+#define R_386_TLS_GD_PUSH 25 /* pushl instruction for Sun ABI GD
sequence */

+#define R_386_TLS_GD_CALL 26 /* call instruction for Sun ABI GD
sequence */

+#define R_386_TLS_GD_POP 27 /* popl instruction for Sun ABI GD
sequence */

+#define R_386_TLS_LDM_32 28 /* 32 bit offset to GOT (index,zero) pair */

+#define R_386_TLS_LDM_PUSH 29 /* pushl instruction for Sun ABI LD
sequence */

+#define R_386_TLS_LDM_CALL 30 /* call instruction for Sun ABI LD
sequence */

+#define R_386_TLS_LDM_POP 31 /* popl instruction for Sun ABI LD
sequence */

+#define R_386_TLS_LDO_32 32 /* 32 bit offset from start of TLS block */

+#define R_386_TLS_IE_32 33 /* 32 bit offset to GOT static TLS offset entry
*/

+#define R_386_TLS_LE_32 34 /* 32 bit offset within static TLS block */

+#define R_386_TLS_DTPMOD32 35 /* GOT entry containing TLS index */

+#define R_386_TLS_DTPOFF32 36 /* GOT entry containing TLS offset */

+#define R_386_TLS_TPOFF32 37 /* GOT entry of -ve static TLS offset */

+

+/* Null relocation */

+#define R_AARCH64_NONE 256 /* No relocation */

+/* Static AArch64 relocations */

+ /* Static data relocations */

+#define R_AARCH64_ABS64 257 /* S + A */

+#define R_AARCH64_ABS32 258 /* S + A */

+#define R_AARCH64_ABS16 259 /* S + A */

+#define R_AARCH64_PREL64 260 /* S + A - P */

+#define R_AARCH64_PREL32 261 /* S + A - P */

+#define R_AARCH64_PREL16 262 /* S + A - P */

+ /* Group relocations to create a 16, 32, 48, or 64 bit unsigned data value or
address inline */

+#define R_AARCH64_MOVW_UABS_G0 263 /* S + A */

+#define R_AARCH64_MOVW_UABS_G0_NC 264 /* S + A */

+#define R_AARCH64_MOVW_UABS_G1 265 /* S + A */

+#define R_AARCH64_MOVW_UABS_G1_NC 266 /* S + A */

+#define R_AARCH64_MOVW_UABS_G2 267 /* S + A */

+#define R_AARCH64_MOVW_UABS_G2_NC 268 /* S + A */

+#define R_AARCH64_MOVW_UABS_G3 269 /* S + A */

+ /* Group relocations to create a 16, 32, 48, or 64 bit signed data or offset
value inline */

+#define R_AARCH64_MOVW_SABS_G0 270 /* S + A */

+#define R_AARCH64_MOVW_SABS_G1 271 /* S + A */

+#define R_AARCH64_MOVW_SABS_G2 272 /* S + A */

+ /* Relocations to generate 19, 21 and 33 bit PC-relative addresses */

+#define R_AARCH64_LD_PREL_LO19 273 /* S + A - P */

+#define R_AARCH64_ADR_PREL_LO21 274 /* S + A - P */

+#define R_AARCH64_ADR_PREL_PG_HI21 275 /* Page(S+A) - Page(P) */

+#define R_AARCH64_ADR_PREL_PG_HI21_NC 276 /* Page(S+A) - Page(P)
*/

+#define R_AARCH64_ADD_ABS_LO12_NC 277 /* S + A */

+#define R_AARCH64_LDST8_ABS_LO12_NC 278 /* S + A */

+#define R_AARCH64_LDST16_ABS_LO12_NC 284 /* S + A */

+#define R_AARCH64_LDST32_ABS_LO12_NC 285 /* S + A */

+#define R_AARCH64_LDST64_ABS_LO12_NC 286 /* S + A */

+#define R_AARCH64_LDST128_ABS_LO12_NC 299 /* S + A */

+ /* Relocations for control-flow instructions - all offsets are a multiple of 4 */

+#define R_AARCH64_TSTBR14 279 /* S+A-P */

+#define R_AARCH64_CONDBR19 280 /* S+A-P */

+#define R_AARCH64_JUMP26 282 /* S+A-P */

+#define R_AARCH64_CALL26 283 /* S+A-P */

+ /* Group relocations to create a 16, 32, 48, or 64 bit PC-relative offset inline
*/

+#define R_AARCH64_MOVW_PREL_G0 287 /* S+A-P */

+#define R_AARCH64_MOVW_PREL_G0_NC 288 /* S+A-P */

+#define R_AARCH64_MOVW_PREL_G1 289 /* S+A-P */

+#define R_AARCH64_MOVW_PREL_G1_NC 290 /* S+A-P */

+#define R_AARCH64_MOVW_PREL_G2 291 /* S+A-P */

+#define R_AARCH64_MOVW_PREL_G2_NC 292 /* S+A-P */

+#define R_AARCH64_MOVW_PREL_G3 293 /* S+A-P */

+ /* Group relocations to create a 16, 32, 48, or 64 bit GOT-relative offsets
inline */

+#define R_AARCH64_MOVW_GOTOFF_G0 300 /* G(S)-GOT */

+#define R_AARCH64_MOVW_GOTOFF_G0_NC 301 /* G(S)-GOT */

+#define R_AARCH64_MOVW_GOTOFF_G1 302 /* G(S)-GOT */

+#define R_AARCH64_MOVW_GOTOFF_G1_NC 303 /* G(S)-GOT */

+#define R_AARCH64_MOVW_GOTOFF_G2 304 /* G(S)-GOT */

+#define R_AARCH64_MOVW_GOTOFF_G2_NC 305 /* G(S)-GOT */

+#define R_AARCH64_MOVW_GOTOFF_G3 306 /* G(S)-GOT */

+ /* GOT-relative data relocations */

+#define R_AARCH64_GOTREL64 307 /* S+A-GOT */

+#define R_AARCH64_GOTREL32 308 /* S+A-GOT */

+ /* GOT-relative instruction relocations */

+#define R_AARCH64_GOT_LD_PREL19 309 /* G(S)-P */

+#define R_AARCH64_LD64_GOTOFF_LO15 310 /* G(S)-GOT */

+#define R_AARCH64_ADR_GOT_PAGE 311 /* Page(G(S))-Page(P) */

+#define R_AARCH64_LD64_GOT_LO12_NC 312 /* G(S) */

+#define R_AARCH64_LD64_GOTPAGE_LO15 313 /* G(S)-Page(GOT) */

+/* Relocations for thread-local storage */

+ /* General Dynamic TLS relocations */

+#define R_AARCH64_TLSGD_ADR_PREL21 512 /* G(TLSIDX(S+A)) - P */

+#define R_AARCH64_TLSGD_ADR_PAGE21 513 /* Page(G(TLSIDX(S+A)))
- Page(P) */

+#define R_AARCH64_TLSGD_ADD_LO12_NC 514 /* G(TLSIDX(S+A)) */

+#define R_AARCH64_TLSGD_MOVW_G1 515 /* G(TLSIDX(S+A)) - GOT
*/

+#define R_AARCH64_TLSGD_MOVW_G0_NC 516 /* G(TLSIDX(S+A)) -
GOT */

+ /* Local Dynamic TLS relocations */

+#define R_AARCH64_TLSLD_ADR_PREL21 517 /* G(LDM(S))) - P */

+#define R_AARCH64_TLSLD_ADR_PAGE21 518 /* Page(G(LDM(S)))-
Page(P) */

+#define R_AARCH64_TLSLD_ADD_LO12_NC 519 /* G(LDM(S)) */

+#define R_AARCH64_TLSLD_MOVW_G1 520 /* G(LDM(S)) - GOT */

+#define R_AARCH64_TLSLD_MOVW_G0_NC 521 /* G(LDM(S)) - GOT */

+#define R_AARCH64_TLSLD_LD_PREL19 522 /* G(LDM(S)) - P */

+#define R_AARCH64_TLSLD_MOVW_DTPREL_G2 523 /* DTPREL(S+A) */

+#define R_AARCH64_TLSLD_MOVW_DTPREL_G1 524 /* DTPREL(S+A) */

+#define R_AARCH64_TLSLD_MOVW_DTPREL_G1_NC 525 /* DTPREL(S+A)
*/

+#define R_AARCH64_TLSLD_MOVW_DTPREL_G0 526 /* DTPREL(S+A) */

+#define R_AARCH64_TLSLD_MOVW_DTPREL_G0_NC 527 /* DTPREL(S+A)
*/

+#define R_AARCH64_TLSLD_ADD_DTPREL_HI12 528 /* DTPREL(S+A) */

+#define R_AARCH64_TLSLD_ADD_DTPREL_LO12 529 /* DTPREL(S+A) */

+#define R_AARCH64_TLSLD_ADD_DTPREL_LO12_NC 530 /* DTPREL(S+A)
*/

+#define R_AARCH64_TLSLD_LDST8_DTPREL_LO12 531 /* DTPREL(S+A) */

+#define R_AARCH64_TLSLD_LDST8_DTPREL_LO12_NC 532 /* DTPREL(S+A)
*/

+#define R_AARCH64_TLSLD_LDST16_DTPREL_LO12 533 /* DTPREL(S+A) */

+#define R_AARCH64_TLSLD_LDST16_DTPREL_LO12_NC 534 /* DTPREL(S+A)
*/

+#define R_AARCH64_TLSLD_LDST32_DTPREL_LO12 535 /* DTPREL(S+A) */

+#define R_AARCH64_TLSLD_LDST32_DTPREL_LO12_NC 536 /* DTPREL(S+A)
*/

+#define R_AARCH64_TLSLD_LDST64_DTPREL_LO12 537 /* DTPREL(S+A) */

+#define R_AARCH64_TLSLD_LDST64_DTPREL_LO12_NC 538 /* DTPREL(S+A)
*/

+ /* Initial Exec TLS relocations */

+#define R_AARCH64_TLSIE_MOVW_GOTTPREL_G1 539 /* G(TPREL(S+A))
- GOT */

+#define R_AARCH64_TLSIE_MOVW_GOTTPREL_G0_NC 540 /*
G(TPREL(S+A)) - GOT */

+#define R_AARCH64_TLSIE_ADR_GOTTPREL_PAGE21 541 /*
Page(G(TPREL(S+A))) - Page(P) */

+#define R_AARCH64_TLSIE_LD64_GOTTPREL_LO12_NC 542 /*
G(TPREL(S+A)) */

+#define R_AARCH64_TLSIE_LD_GOTTPREL_PREL19 543 /* G(TPREL(S+A)) -
P */

+ /* Local Exec TLS relocations */

+#define R_AARCH64_TLSLE_MOVW_TPREL_G2 544 /* TPREL(S+A) */

+#define R_AARCH64_TLSLE_MOVW_TPREL_G1 545 /* TPREL(S+A) */

+#define R_AARCH64_TLSLE_MOVW_TPREL_G1_NC 546 /* TPREL(S+A) */

+#define R_AARCH64_TLSLE_MOVW_TPREL_G0 547 /* TPREL(S+A) */

+#define R_AARCH64_TLSLE_MOVW_TPREL_G0_NC 548 /* TPREL(S+A) */

+#define R_AARCH64_TLSLE_ADD_TPREL_HI12 549 /* TPREL(S+A) */

+#define R_AARCH64_TLSLE_ADD_TPREL_LO12 550 /* TPREL(S+A) */

+#define R_AARCH64_TLSLE_ADD_TPREL_LO12_NC 551 /* TPREL(S+A) */

+#define R_AARCH64_TLSLE_LDST8_TPREL_LO12 552 /* TPREL(S+A) */

+#define R_AARCH64_TLSLE_LDST8_TPREL_LO12_NC 553 /* TPREL(S+A) */

+#define R_AARCH64_TLSLE_LDST16_TPREL_LO12 554 /* TPREL(S+A) */

+#define R_AARCH64_TLSLE_LDST16_TPREL_LO12_NC 555 /* TPREL(S+A)
*/

+#define R_AARCH64_TLSLE_LDST32_TPREL_LO12 556 /* TPREL(S+A) */

+#define R_AARCH64_TLSLE_LDST32_TPREL_LO12_NC 557 /* TPREL(S+A)
*/

+#define R_AARCH64_TLSLE_LDST64_TPREL_LO12 558 /* TPREL(S+A) */

+#define R_AARCH64_TLSLE_LDST64_TPREL_LO12_NC 559 /* TPREL(S+A)
*/

+/* Dynamic relocations */

+ /* Dynamic relocations */

+#define R_AARCH64_COPY 1024

+#define R_AARCH64_GLOB_DAT 1025 /* S + A */

+#define R_AARCH64_JUMP_SLOT 1026 /* S + A */

+#define R_AARCH64_RELATIVE 1027 /* Delta(S) + A , Delta(P) + A */

+#define R_AARCH64_TLS_DTPREL64 1028 /* DTPREL(S+A) */

+#define R_AARCH64_TLS_DTPMOD64 1029 /* LDM(S) */

+#define R_AARCH64_TLS_TPREL64 1030 /* TPREL(S+A) */

+#define R_AARCH64_TLS_DTPREL32 1031 /* DTPREL(S+A) */

+#define R_AARCH64_TLS_DTPMOD32 1032 /* LDM(S) */

+#define R_AARCH64_TLS_TPREL32 1033 /* DTPREL(S+A) */

+

+#define R_ALPHA_NONE 0 /* No reloc */

+#define R_ALPHA_REFLONG 1 /* Direct 32 bit */

+#define R_ALPHA_REFQUAD 2 /* Direct 64 bit */

+#define R_ALPHA_GPREL32 3 /* GP relative 32 bit */

+#define R_ALPHA_LITERAL 4 /* GP relative 16 bit w/optimization */

+#define R_ALPHA_LITUSE 5 /* Optimization hint for LITERAL */

+#define R_ALPHA_GPDISP 6 /* Add displacement to GP */

+#define R_ALPHA_BRADDR 7 /* PC+4 relative 23 bit shifted */

+#define R_ALPHA_HINT 8 /* PC+4 relative 16 bit shifted */

+#define R_ALPHA_SREL16 9 /* PC relative 16 bit */

+#define R_ALPHA_SREL32 10 /* PC relative 32 bit */

+#define R_ALPHA_SREL64 11 /* PC relative 64 bit */

+#define R_ALPHA_OP_PUSH 12 /* OP stack push */

+#define R_ALPHA_OP_STORE 13 /* OP stack pop and store */

+#define R_ALPHA_OP_PSUB 14 /* OP stack subtract */

+#define R_ALPHA_OP_PRSHIFT 15 /* OP stack right shift */

+#define R_ALPHA_GPVALUE 16

+#define R_ALPHA_GPRELHIGH 17

+#define R_ALPHA_GPRELLOW 18

+#define R_ALPHA_IMMED_GP_16 19

+#define R_ALPHA_IMMED_GP_HI32 20

+#define R_ALPHA_IMMED_SCN_HI32 21

+#define R_ALPHA_IMMED_BR_HI32 22

+#define R_ALPHA_IMMED_LO32 23

+#define R_ALPHA_COPY 24 /* Copy symbol at runtime */

+#define R_ALPHA_GLOB_DAT 25 /* Create GOT entry */

+#define R_ALPHA_JMP_SLOT 26 /* Create PLT entry */

+#define R_ALPHA_RELATIVE 27 /* Adjust by program base */

+

+#define R_ARM_NONE 0 /* No relocation. */

+#define R_ARM_PC24 1

+#define R_ARM_ABS32 2

+#define R_ARM_REL32 3

+#define R_ARM_PC13 4

+#define R_ARM_ABS16 5

+#define R_ARM_ABS12 6

+#define R_ARM_THM_ABS5 7

+#define R_ARM_ABS8 8

+#define R_ARM_SBREL32 9

+#define R_ARM_THM_PC22 10

+#define R_ARM_THM_PC8 11

+#define R_ARM_AMP_VCALL9 12

+#define R_ARM_SWI24 13

+#define R_ARM_THM_SWI8 14

+#define R_ARM_XPC25 15

+#define R_ARM_THM_XPC22 16

+#define R_ARM_COPY 20 /* Copy data from shared object. */

+#define R_ARM_GLOB_DAT 21 /* Set GOT entry to data address. */

+#define R_ARM_JUMP_SLOT 22 /* Set GOT entry to code address. */

+#define R_ARM_RELATIVE 23 /* Add load address of shared object. */

+#define R_ARM_GOTOFF 24 /* Add GOT-relative symbol address. */

+#define R_ARM_GOTPC 25 /* Add PC-relative GOT table address. */

+#define R_ARM_GOT32 26 /* Add PC-relative GOT offset. */

+#define R_ARM_PLT32 27 /* Add PC-relative PLT offset. */

+#define R_ARM_CALL 28

+#define R_ARM_JMP24 29

+#define R_ARM_THM_MOVW_ABS_NC 47

+#define R_ARM_THM_MOVT_ABS 48

+

+// Block of PC-relative relocations added to work around gcc putting

+// object relocations in static executables.

+#define R_ARM_THM_JUMP24 30

+#define R_ARM_PREL31 42

+#define R_ARM_MOVW_PREL_NC 45

+#define R_ARM_MOVT_PREL 46

+#define R_ARM_THM_MOVW_PREL_NC 49

+#define R_ARM_THM_MOVT_PREL 50

+#define R_ARM_THM_JMP6 52

+#define R_ARM_THM_ALU_PREL_11_0 53

+#define R_ARM_THM_PC12 54

+#define R_ARM_REL32_NOI 56

+#define R_ARM_ALU_PC_G0_NC 57

+#define R_ARM_ALU_PC_G0 58

+#define R_ARM_ALU_PC_G1_NC 59

+#define R_ARM_ALU_PC_G1 60

+#define R_ARM_ALU_PC_G2 61

+#define R_ARM_LDR_PC_G1 62

+#define R_ARM_LDR_PC_G2 63

+#define R_ARM_LDRS_PC_G0 64

+#define R_ARM_LDRS_PC_G1 65

+#define R_ARM_LDRS_PC_G2 66

+#define R_ARM_LDC_PC_G0 67

+#define R_ARM_LDC_PC_G1 68

+#define R_ARM_LDC_PC_G2 69

+#define R_ARM_GOT_PREL 96

+#define R_ARM_THM_JUMP11 102

+#define R_ARM_THM_JUMP8 103

+#define R_ARM_TLS_GD32 104

+#define R_ARM_TLS_LDM32 105

+#define R_ARM_TLS_IE32 107

+

+#define R_ARM_THM_JUMP19 51

+#define R_ARM_GNU_VTENTRY 100

+#define R_ARM_GNU_VTINHERIT 101

+#define R_ARM_RSBREL32 250

+#define R_ARM_THM_RPC22 251

+#define R_ARM_RREL32 252

+#define R_ARM_RABS32 253

+#define R_ARM_RPC24 254

+#define R_ARM_RBASE 255

+

+#define R_PPC_NONE 0 /* No relocation. */

+#define R_PPC_ADDR32 1

+#define R_PPC_ADDR24 2

+#define R_PPC_ADDR16 3

+#define R_PPC_ADDR16_LO 4

+#define R_PPC_ADDR16_HI 5

+#define R_PPC_ADDR16_HA 6

+#define R_PPC_ADDR14 7

+#define R_PPC_ADDR14_BRTAKEN 8

+#define R_PPC_ADDR14_BRNTAKEN 9

+#define R_PPC_REL24 10

+#define R_PPC_REL14 11

+#define R_PPC_REL14_BRTAKEN 12

+#define R_PPC_REL14_BRNTAKEN 13

+#define R_PPC_GOT16 14

+#define R_PPC_GOT16_LO 15

+#define R_PPC_GOT16_HI 16

+#define R_PPC_GOT16_HA 17

+#define R_PPC_PLTREL24 18

+#define R_PPC_COPY 19

+#define R_PPC_GLOB_DAT 20

+#define R_PPC_JMP_SLOT 21

+#define R_PPC_RELATIVE 22

+#define R_PPC_LOCAL24PC 23

+#define R_PPC_UADDR32 24

+#define R_PPC_UADDR16 25

+#define R_PPC_REL32 26

+#define R_PPC_PLT32 27

+#define R_PPC_PLTREL32 28

+#define R_PPC_PLT16_LO 29

+#define R_PPC_PLT16_HI 30

+#define R_PPC_PLT16_HA 31

+#define R_PPC_SDAREL16 32

+#define R_PPC_SECTOFF 33

+#define R_PPC_SECTOFF_LO 34

+#define R_PPC_SECTOFF_HI 35

+#define R_PPC_SECTOFF_HA 36

+

+/*

+ * TLS relocations

+ */

+#define R_PPC_TLS 67

+#define R_PPC_DTPMOD32 68

+#define R_PPC_TPREL16 69

+#define R_PPC_TPREL16_LO 70

+#define R_PPC_TPREL16_HI 71

+#define R_PPC_TPREL16_HA 72

+#define R_PPC_TPREL32 73

+#define R_PPC_DTPREL16 74

+#define R_PPC_DTPREL16_LO 75

+#define R_PPC_DTPREL16_HI 76

+#define R_PPC_DTPREL16_HA 77

+#define R_PPC_DTPREL32 78

+#define R_PPC_GOT_TLSGD16 79

+#define R_PPC_GOT_TLSGD16_LO 80

+#define R_PPC_GOT_TLSGD16_HI 81

+#define R_PPC_GOT_TLSGD16_HA 82

+#define R_PPC_GOT_TLSLD16 83

+#define R_PPC_GOT_TLSLD16_LO 84

+#define R_PPC_GOT_TLSLD16_HI 85

+#define R_PPC_GOT_TLSLD16_HA 86

+#define R_PPC_GOT_TPREL16 87

+#define R_PPC_GOT_TPREL16_LO 88

+#define R_PPC_GOT_TPREL16_HI 89

+#define R_PPC_GOT_TPREL16_HA 90

+

+/*

+ * The remaining relocs are from the Embedded ELF ABI, and are not in the

+ * SVR4 ELF ABI.

+ */

+

+#define R_PPC_EMB_NADDR32 101

+#define R_PPC_EMB_NADDR16 102

+#define R_PPC_EMB_NADDR16_LO 103

+#define R_PPC_EMB_NADDR16_HI 104

+#define R_PPC_EMB_NADDR16_HA 105

+#define R_PPC_EMB_SDAI16 106

+#define R_PPC_EMB_SDA2I16 107

+#define R_PPC_EMB_SDA2REL 108

+#define R_PPC_EMB_SDA21 109

+#define R_PPC_EMB_MRKREF 110

+#define R_PPC_EMB_RELSEC16 111

+#define R_PPC_EMB_RELST_LO 112

+#define R_PPC_EMB_RELST_HI 113

+#define R_PPC_EMB_RELST_HA 114

+#define R_PPC_EMB_BIT_FLD 115

+#define R_PPC_EMB_RELSDA 116

+

+#define R_SPARC_NONE 0

+#define R_SPARC_8 1

+#define R_SPARC_16 2

+#define R_SPARC_32 3

+#define R_SPARC_DISP8 4

+#define R_SPARC_DISP16 5

+#define R_SPARC_DISP32 6

+#define R_SPARC_WDISP30 7

+#define R_SPARC_WDISP22 8

+#define R_SPARC_HI22 9

+#define R_SPARC_22 10

+#define R_SPARC_13 11

+#define R_SPARC_LO10 12

+#define R_SPARC_GOT10 13

+#define R_SPARC_GOT13 14

+#define R_SPARC_GOT22 15

+#define R_SPARC_PC10 16

+#define R_SPARC_PC22 17

+#define R_SPARC_WPLT30 18

+#define R_SPARC_COPY 19

+#define R_SPARC_GLOB_DAT 20

+#define R_SPARC_JMP_SLOT 21

+#define R_SPARC_RELATIVE 22

+#define R_SPARC_UA32 23

+#define R_SPARC_PLT32 24

+#define R_SPARC_HIPLT22 25

+#define R_SPARC_LOPLT10 26

+#define R_SPARC_PCPLT32 27

+#define R_SPARC_PCPLT22 28

+#define R_SPARC_PCPLT10 29

+#define R_SPARC_10 30

+#define R_SPARC_11 31

+#define R_SPARC_64 32

+#define R_SPARC_OLO10 33

+#define R_SPARC_HH22 34

+#define R_SPARC_HM10 35

+#define R_SPARC_LM22 36

+#define R_SPARC_PC_HH22 37

+#define R_SPARC_PC_HM10 38

+#define R_SPARC_PC_LM22 39

+#define R_SPARC_WDISP16 40

+#define R_SPARC_WDISP19 41

+#define R_SPARC_GLOB_JMP 42

+#define R_SPARC_7 43

+#define R_SPARC_5 44

+#define R_SPARC_6 45

+#define R_SPARC_DISP64 46

+#define R_SPARC_PLT64 47

+#define R_SPARC_HIX22 48

+#define R_SPARC_LOX10 49

+#define R_SPARC_H44 50

+#define R_SPARC_M44 51

+#define R_SPARC_L44 52

+#define R_SPARC_REGISTER 53

+#define R_SPARC_UA64 54

+#define R_SPARC_UA16 55

+#define R_SPARC_TLS_GD_HI22 56

+#define R_SPARC_TLS_GD_LO10 57

+#define R_SPARC_TLS_GD_ADD 58

+#define R_SPARC_TLS_GD_CALL 59

+#define R_SPARC_TLS_LDM_HI22 60

+#define R_SPARC_TLS_LDM_LO10 61

+#define R_SPARC_TLS_LDM_ADD 62

+#define R_SPARC_TLS_LDM_CALL 63

+#define R_SPARC_TLS_LDO_HIX22 64

+#define R_SPARC_TLS_LDO_LOX10 65

+#define R_SPARC_TLS_LDO_ADD 66

+#define R_SPARC_TLS_IE_HI22 67

+#define R_SPARC_TLS_IE_LO10 68

+#define R_SPARC_TLS_IE_LD 69

+#define R_SPARC_TLS_IE_LDX 70

+#define R_SPARC_TLS_IE_ADD 71

+#define R_SPARC_TLS_LE_HIX22 72

+#define R_SPARC_TLS_LE_LOX10 73

+#define R_SPARC_TLS_DTPMOD32 74

+#define R_SPARC_TLS_DTPMOD64 75

+#define R_SPARC_TLS_DTPOFF32 76

+#define R_SPARC_TLS_DTPOFF64 77

+#define R_SPARC_TLS_TPOFF32 78

+#define R_SPARC_TLS_TPOFF64 79

+

+#define R_X86_64_NONE 0 /* No relocation. */

+#define R_X86_64_64 1 /* Add 64 bit symbol value. */

+#define R_X86_64_PC32 2 /* PC-relative 32 bit signed sym value. */

+#define R_X86_64_GOT32 3 /* PC-relative 32 bit GOT offset. */

+#define R_X86_64_PLT32 4 /* PC-relative 32 bit PLT offset. */

+#define R_X86_64_COPY 5 /* Copy data from shared object. */

+#define R_X86_64_GLOB_DAT 6 /* Set GOT entry to data address. */

+#define R_X86_64_JMP_SLOT 7 /* Set GOT entry to code address. */

+#define R_X86_64_RELATIVE 8 /* Add load address of shared object. */

+#define R_X86_64_GOTPCREL 9 /* Add 32 bit signed pcrel offset to GOT.
*/

+#define R_X86_64_32 10 /* Add 32 bit zero extended symbol value */

+#define R_X86_64_32S 11 /* Add 32 bit sign extended symbol value */

+#define R_X86_64_16 12 /* Add 16 bit zero extended symbol value */

+#define R_X86_64_PC16 13 /* Add 16 bit signed extended pc relative
symbol value */

+#define R_X86_64_8 14 /* Add 8 bit zero extended symbol value */

+#define R_X86_64_PC8 15 /* Add 8 bit signed extended pc relative
symbol value */

+#define R_X86_64_DTPMOD64 16 /* ID of module containing symbol */

+#define R_X86_64_DTPOFF64 17 /* Offset in TLS block */

+#define R_X86_64_TPOFF64 18 /* Offset in static TLS block */

+#define R_X86_64_TLSGD 19 /* PC relative offset to GD GOT entry */

+#define R_X86_64_TLSLD 20 /* PC relative offset to LD GOT entry */

+#define R_X86_64_DTPOFF32 21 /* Offset in TLS block */

+#define R_X86_64_GOTTPOFF 22 /* PC relative offset to IE GOT entry */

+#define R_X86_64_TPOFF32 23 /* Offset in static TLS block */

+#define R_X86_64_PC64 24 /* PC relative 64 bit */

+#define R_X86_64_GOTOFF64 25 /* 64 bit offset to GOT */

+#define R_X86_64_GOTPC3 26 /* 32 bit signed pc relative offset to GOT */

+#define R_X86_64_GOT64 27 /* 64-bit GOT entry offset */

+#define R_X86_64_GOTPCREL64 28 /* 64-bit PC relative offset to GOT
entry */

+#define R_X86_64_GOTPC64 29 /* 64-bit PC relative offset to GOT */

+#define R_X86_64_GOTPLT64 30 /* like GOT64, says PLT entry needed */

+#define R_X86_64_PLTOFF64 31 /* 64-bit GOT relative offset to PLT entry
*/

+#define R_X86_64_SIZE32 32 /* Size of symbol plus 32-bit addend */

+#define R_X86_64_SIZE64 33 /* Size of symbol plus 64-bit addend */

+#define R_X86_64_GOTPC32_TLSDESC 34 /* GOT offset for TLS descriptor.
*/

+#define R_X86_64_TLSDESC_CALL 35 /* Marker for call through TLS
descriptor. */

+#define R_X86_64_TLSDESC 36 /* TLS descriptor. */

+#define R_X86_64_IRELATIVE 37 /* Adjust indirectly by program base */

+#define R_X86_64_RELATIVE64 38 /* 64-bit adjust by program base */

+#define R_X86_64_GOTPCRELX 41 /* Load from 32 bit signed pc relative
offset to GOT entry without REX prefix, relaxable. */

+#define R_X86_64_REX_GOTPCRELX 42 /* Load from 32 bit signed pc
relative offset to GOT entry with REX prefix, relaxable. */

+

+

+#endif /* !_SYS_ELF_COMMON_H_ */

diff --git a/UefiPayloadPkg/PayloadLoaderPeim/ElfLib/ElfLib.c
b/UefiPayloadPkg/PayloadLoaderPeim/ElfLib/ElfLib.c
new file mode 100644
index 0000000000..531b3486d2
--- /dev/null
+++ b/UefiPayloadPkg/PayloadLoaderPeim/ElfLib/ElfLib.c
@@ -0,0 +1,473 @@
+/** @file

+ ELF library

+

+ Copyright (c) 2019 - 2021, Intel Corporation. All rights reserved.<BR>

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

+

+**/

+

+#include "ElfLibInternal.h"

+

+/**

+ Check if the ELF image is valid.

+

+ @param[in] ImageBase Memory address of an image.

+

+ @retval TRUE if valid.

+

+**/

+BOOLEAN

+IsElfFormat (

+ IN CONST UINT8 *ImageBase

+ )

+{

+ Elf32_Ehdr *Elf32Hdr;

+ Elf64_Ehdr *Elf64Hdr;

+

+ ASSERT (ImageBase != NULL);

+

+ Elf32Hdr = (Elf32_Ehdr *)ImageBase;

+

+ //

+ // Start with correct signature "\7fELF"

+ //

+ if ((Elf32Hdr->e_ident[EI_MAG0] != ELFMAG0) ||

+ (Elf32Hdr->e_ident[EI_MAG1] != ELFMAG1) ||

+ (Elf32Hdr->e_ident[EI_MAG1] != ELFMAG1) ||

+ (Elf32Hdr->e_ident[EI_MAG2] != ELFMAG2)

+ ) {

+ return FALSE;

+ }

+

+ //

+ // Support little-endian only

+ //

+ if (Elf32Hdr->e_ident[EI_DATA] != ELFDATA2LSB) {

+ return FALSE;

+ }

+

+ //

+ // Check 32/64-bit architecture

+ //

+ if (Elf32Hdr->e_ident[EI_CLASS] == ELFCLASS64) {

+ Elf64Hdr = (Elf64_Ehdr *)Elf32Hdr;

+ Elf32Hdr = NULL;

+ } else if (Elf32Hdr->e_ident[EI_CLASS] == ELFCLASS32) {

+ Elf64Hdr = NULL;

+ } else {

+ return FALSE;

+ }

+

+ if (Elf64Hdr != NULL) {

+ //

+ // Support intel architecture only for now

+ //

+ if (Elf64Hdr->e_machine != EM_X86_64) {

+ return FALSE;

+ }

+

+ //

+ // Support ELF types: EXEC (Executable file), DYN (Shared object file)

+ //

+ if ((Elf64Hdr->e_type != ET_EXEC) && (Elf64Hdr->e_type != ET_DYN)) {

+ return FALSE;

+ }

+

+ //

+ // Support current ELF version only

+ //

+ if (Elf64Hdr->e_version != EV_CURRENT) {

+ return FALSE;

+ }

+ } else {

+ //

+ // Support intel architecture only for now

+ //

+ if (Elf32Hdr->e_machine != EM_386) {

+ return FALSE;

+ }

+

+ //

+ // Support ELF types: EXEC (Executable file), DYN (Shared object file)

+ //

+ if ((Elf32Hdr->e_type != ET_EXEC) && (Elf32Hdr->e_type != ET_DYN)) {

+ return FALSE;

+ }

+

+ //

+ // Support current ELF version only

+ //

+ if (Elf32Hdr->e_version != EV_CURRENT) {

+ return FALSE;

+ }

+ }

+ return TRUE;

+}

+

+/**

+ Calculate a ELF file size.

+

+ @param[in] ElfCt ELF image context pointer.

+ @param[out] FileSize Return the file size.

+

+ @retval EFI_INVALID_PARAMETER ElfCt or SecPos is NULL.

+ @retval EFI_NOT_FOUND Could not find the section.

+ @retval EFI_SUCCESS Section posistion was filled successfully.

+**/

+EFI_STATUS

+CalculateElfFileSize (

+ IN ELF_IMAGE_CONTEXT *ElfCt,

+ OUT UINTN *FileSize

+ )

+{

+ EFI_STATUS Status;

+ UINTN FileSize1;

+ UINTN FileSize2;

+ Elf32_Ehdr *Elf32Hdr;

+ Elf64_Ehdr *Elf64Hdr;

+ UINTN Offset;

+ UINTN Size;

+

+ if ((ElfCt == NULL) || (FileSize == NULL)) {

+ return EFI_INVALID_PARAMETER;

+ }

+

+ // Use last section as end of file

+ Status = GetElfSectionPos (ElfCt, ElfCt->ShNum - 1, &Offset, &Size);

+ if (EFI_ERROR(Status)) {

+ return EFI_UNSUPPORTED;

+ }

+ FileSize1 = Offset + Size;

+

+ // Use end of section header as end of file

+ FileSize2 = 0;

+ if (ElfCt->EiClass == ELFCLASS32) {

+ Elf32Hdr = (Elf32_Ehdr *)ElfCt->FileBase;

+ FileSize2 = Elf32Hdr->e_shoff + Elf32Hdr->e_shentsize * Elf32Hdr-
e_shnum;
+ } else if (ElfCt->EiClass == ELFCLASS64) {

+ Elf64Hdr = (Elf64_Ehdr *)ElfCt->FileBase;

+ FileSize2 = (UINTN)(Elf64Hdr->e_shoff + Elf64Hdr->e_shentsize *
Elf64Hdr->e_shnum);

+ }

+

+ *FileSize = MAX(FileSize1, FileSize2);

+

+ return EFI_SUCCESS;

+}

+

+/**

+ Get a ELF program segment loading info.

+

+ @param[in] ImageBase Image base.

+ @param[in] EiClass ELF class.

+ @param[in] Index ELF segment index.

+ @param[out] SegInfo The pointer to the segment info.

+

+ @retval EFI_INVALID_PARAMETER ElfCt or SecPos is NULL.

+ @retval EFI_NOT_FOUND Could not find the section.

+ @retval EFI_SUCCESS Section posistion was filled successfully.

+**/

+EFI_STATUS

+GetElfSegmentInfo (

+ IN UINT8 *ImageBase,

+ IN UINT32 EiClass,

+ IN UINT32 Index,

+ OUT SEGMENT_INFO *SegInfo

+ )

+{

+ Elf32_Phdr *Elf32Phdr;

+ Elf64_Phdr *Elf64Phdr;

+

+ if ((ImageBase == NULL) || (SegInfo == NULL)) {

+ return EFI_INVALID_PARAMETER;

+ }

+

+ if (EiClass == ELFCLASS32) {

+ Elf32Phdr = GetElf32SegmentByIndex (ImageBase, Index);

+ if (Elf32Phdr != NULL) {

+ SegInfo->PtType = Elf32Phdr->p_type;

+ SegInfo->Offset = Elf32Phdr->p_offset;

+ SegInfo->Length = Elf32Phdr->p_filesz;

+ SegInfo->MemLen = Elf32Phdr->p_memsz;

+ SegInfo->MemAddr = Elf32Phdr->p_paddr;

+ SegInfo->Alignment = Elf32Phdr->p_align;

+ return EFI_SUCCESS;

+ }

+ } else if (EiClass == ELFCLASS64) {

+ Elf64Phdr = GetElf64SegmentByIndex (ImageBase, Index);

+ if (Elf64Phdr != NULL) {

+ SegInfo->PtType = Elf64Phdr->p_type;

+ SegInfo->Offset = (UINTN)Elf64Phdr->p_offset;

+ SegInfo->Length = (UINTN)Elf64Phdr->p_filesz;

+ SegInfo->MemLen = (UINTN)Elf64Phdr->p_memsz;

+ SegInfo->MemAddr = (UINTN)Elf64Phdr->p_paddr;

+ SegInfo->Alignment = (UINTN)Elf64Phdr->p_align;

+ return EFI_SUCCESS;

+ }

+ }

+

+ return EFI_NOT_FOUND;

+}

+

+/**

+ Parse the ELF image info.

+

+ On return, all fields in ElfCt are updated except ImageAddress.

+

+ @param[in] ImageBase Memory address of an image.

+ @param[out] ElfCt The EFL image context pointer.

+

+ @retval EFI_INVALID_PARAMETER Input parameters are not valid.

+ @retval EFI_UNSUPPORTED Unsupported binary type.

+ @retval EFI_LOAD_ERROR ELF binary loading error.

+ @retval EFI_SUCCESS ELF binary is loaded successfully.

+**/

+EFI_STATUS

+EFIAPI

+ParseElfImage (

+ IN VOID *ImageBase,

+ OUT ELF_IMAGE_CONTEXT *ElfCt

+ )

+{

+ Elf32_Ehdr *Elf32Hdr;

+ Elf64_Ehdr *Elf64Hdr;

+ Elf32_Shdr *Elf32Shdr;

+ Elf64_Shdr *Elf64Shdr;

+ EFI_STATUS Status;

+ UINT32 Index;

+ SEGMENT_INFO SegInfo;

+ UINTN End;

+ UINTN Base;

+

+ if (ElfCt == NULL) {

+ return EFI_INVALID_PARAMETER;

+ }

+ ZeroMem (ElfCt, sizeof(ELF_IMAGE_CONTEXT));

+

+ if (ImageBase == NULL) {

+ return (ElfCt->ParseStatus = EFI_INVALID_PARAMETER);

+ }

+

+ ElfCt->FileBase = (UINT8 *)ImageBase;

+ if (!IsElfFormat (ElfCt->FileBase)) {

+ return (ElfCt->ParseStatus = EFI_UNSUPPORTED);

+ }

+

+ Elf32Hdr = (Elf32_Ehdr *)ElfCt->FileBase;

+ ElfCt->EiClass = Elf32Hdr->e_ident[EI_CLASS];

+ if (ElfCt->EiClass == ELFCLASS32) {

+ if ((Elf32Hdr->e_type != ET_EXEC) && (Elf32Hdr->e_type != ET_DYN)) {

+ return (ElfCt->ParseStatus = EFI_UNSUPPORTED);

+ }

+ Elf32Shdr = (Elf32_Shdr *)GetElf32SectionByIndex (ElfCt->FileBase,
Elf32Hdr->e_shstrndx);

+ if (Elf32Shdr == NULL) {

+ return (ElfCt->ParseStatus = EFI_UNSUPPORTED);

+ }

+ ElfCt->EntryPoint = (UINTN)Elf32Hdr->e_entry;

+ ElfCt->ShNum = Elf32Hdr->e_shnum;

+ ElfCt->PhNum = Elf32Hdr->e_phnum;

+ ElfCt->ShStrLen = Elf32Shdr->sh_size;

+ ElfCt->ShStrOff = Elf32Shdr->sh_offset;

+ } else {

+ Elf64Hdr = (Elf64_Ehdr *)Elf32Hdr;

+ if ((Elf64Hdr->e_type != ET_EXEC) && (Elf64Hdr->e_type != ET_DYN)) {

+ return (ElfCt->ParseStatus = EFI_UNSUPPORTED);

+ }

+ Elf64Shdr = (Elf64_Shdr *)GetElf64SectionByIndex (ElfCt->FileBase,
Elf64Hdr->e_shstrndx);

+ if (Elf64Shdr == NULL) {

+ return (ElfCt->ParseStatus = EFI_UNSUPPORTED);

+ }

+ ElfCt->EntryPoint = (UINTN)Elf64Hdr->e_entry;

+ ElfCt->ShNum = Elf64Hdr->e_shnum;

+ ElfCt->PhNum = Elf64Hdr->e_phnum;

+ ElfCt->ShStrLen = (UINT32)Elf64Shdr->sh_size;

+ ElfCt->ShStrOff = (UINT32)Elf64Shdr->sh_offset;

+ }

+

+ //

+ // Get the preferred image base and required memory size when loaded
to new location.

+ //

+ End = 0;

+ Base = MAX_UINT32;

+ ElfCt->ReloadRequired = FALSE;

+ for (Index = 0; Index < ElfCt->PhNum; Index++) {

+ Status = GetElfSegmentInfo (ElfCt->FileBase, ElfCt->EiClass, Index,
&SegInfo);

+ ASSERT_EFI_ERROR (Status);

+

+ if (SegInfo.PtType != PT_LOAD) {

+ continue;

+ }

+

+ if (SegInfo.MemLen != SegInfo.Length) {

+ //

+ // Not enough space to execute at current location.

+ //

+ ElfCt->ReloadRequired = TRUE;

+ }

+

+ if (Base > (SegInfo.MemAddr & ~(EFI_PAGE_SIZE - 1))) {

+ Base = SegInfo.MemAddr & ~(EFI_PAGE_SIZE - 1);

+ }

+ if (End < ALIGN_VALUE (SegInfo.MemAddr + SegInfo.MemLen,
EFI_PAGE_SIZE) - 1) {

+ End = ALIGN_VALUE (SegInfo.MemAddr + SegInfo.MemLen,
EFI_PAGE_SIZE) - 1;

+ }

+ }

+ //

+ // 0 - MAX_UINT32 + 1 equals to 0.

+ //

+ ElfCt->ImageSize = End - Base + 1;

+ ElfCt->PreferredImageAddress = (VOID *) Base;

+

+ CalculateElfFileSize (ElfCt, &ElfCt->FileSize);

+ return (ElfCt->ParseStatus = EFI_SUCCESS);;

+}

+

+/**

+ Load the ELF image to Context.ImageAddress.

+

+ Context should be initialized by ParseElfImage().

+ Caller should set Context.ImageAddress to a proper value, either pointing
to

+ a new allocated memory whose size equal to Context.ImageSize, or
pointing

+ to Context.PreferredImageAddress.

+

+ @param[in] ElfCt ELF image context pointer.

+

+ @retval EFI_INVALID_PARAMETER Input parameters are not valid.

+ @retval EFI_UNSUPPORTED Unsupported binary type.

+ @retval EFI_LOAD_ERROR ELF binary loading error.

+ @retval EFI_SUCCESS ELF binary is loaded successfully.

+**/

+EFI_STATUS

+EFIAPI

+LoadElfImage (

+ IN ELF_IMAGE_CONTEXT *ElfCt

+ )

+{

+ EFI_STATUS Status;

+

+ if (ElfCt == NULL) {

+ return EFI_INVALID_PARAMETER;

+ }

+

+ if (EFI_ERROR (ElfCt->ParseStatus)) {

+ return ElfCt->ParseStatus;

+ }

+

+ if (ElfCt->ImageAddress == NULL) {

+ return EFI_INVALID_PARAMETER;

+ }

+

+ Status = EFI_UNSUPPORTED;

+ if (ElfCt->EiClass == ELFCLASS32) {

+ Status = LoadElf32Image (ElfCt);

+ } else if (ElfCt->EiClass == ELFCLASS64) {

+ Status = LoadElf64Image (ElfCt);

+ }

+

+ return Status;

+}

+

+

+/**

+ Get a ELF section name from its index.

+

+ @param[in] ElfCt ELF image context pointer.

+ @param[in] SectionIndex ELF section index.

+ @param[out] SectionName The pointer to the section name.

+

+ @retval EFI_INVALID_PARAMETER ElfCt or SecName is NULL.

+ @retval EFI_NOT_FOUND Could not find the section.

+ @retval EFI_SUCCESS Section name was filled successfully.

+**/

+EFI_STATUS

+EFIAPI

+GetElfSectionName (

+ IN ELF_IMAGE_CONTEXT *ElfCt,

+ IN UINT32 SectionIndex,

+ OUT CHAR8 **SectionName

+ )

+{

+ Elf32_Shdr *Elf32Shdr;

+ Elf64_Shdr *Elf64Shdr;

+ CHAR8 *Name;

+

+ if ((ElfCt == NULL) || (SectionName == NULL)) {

+ return EFI_INVALID_PARAMETER;

+ }

+

+ if (EFI_ERROR (ElfCt->ParseStatus)) {

+ return ElfCt->ParseStatus;

+ }

+

+ Name = NULL;

+ if (ElfCt->EiClass == ELFCLASS32) {

+ Elf32Shdr = GetElf32SectionByIndex (ElfCt->FileBase, SectionIndex);

+ if ((Elf32Shdr != NULL) && (Elf32Shdr->sh_name < ElfCt->ShStrLen)) {

+ Name = (CHAR8 *)(ElfCt->FileBase + ElfCt->ShStrOff + Elf32Shdr-
sh_name);
+ }

+ } else if (ElfCt->EiClass == ELFCLASS64) {

+ Elf64Shdr = GetElf64SectionByIndex (ElfCt->FileBase, SectionIndex);

+ if ((Elf64Shdr != NULL) && (Elf64Shdr->sh_name < ElfCt->ShStrLen)) {

+ Name = (CHAR8 *)(ElfCt->FileBase + ElfCt->ShStrOff + Elf64Shdr-
sh_name);
+ }

+ }

+

+ if (Name == NULL) {

+ return EFI_NOT_FOUND;

+ }

+

+ *SectionName = Name;

+ return EFI_SUCCESS;

+}

+

+

+/**

+ Get the offset and size of x-th ELF section.

+

+ @param[in] ElfCt ELF image context pointer.

+ @param[in] Index ELF section index.

+ @param[out] Offset Return the offset of the specific section.

+ @param[out] Size Return the size of the specific section.

+

+ @retval EFI_INVALID_PARAMETER ImageBase, Offset or Size is NULL.

+ @retval EFI_INVALID_PARAMETER EiClass doesn't equal to ELFCLASS32 or
ELFCLASS64.

+ @retval EFI_NOT_FOUND Could not find the section.

+ @retval EFI_SUCCESS Offset and Size are returned.

+**/

+EFI_STATUS

+EFIAPI

+GetElfSectionPos (

+ IN ELF_IMAGE_CONTEXT *ElfCt,

+ IN UINT32 Index,

+ OUT UINTN *Offset,

+ OUT UINTN *Size

+ )

+{

+ Elf32_Shdr *Elf32Shdr;

+ Elf64_Shdr *Elf64Shdr;

+

+ if ((ElfCt == NULL) || (Offset == NULL) || (Size == NULL)) {

+ return EFI_INVALID_PARAMETER;

+ }

+

+ if (EFI_ERROR (ElfCt->ParseStatus)) {

+ return ElfCt->ParseStatus;

+ }

+

+ if (ElfCt->EiClass == ELFCLASS32) {

+ Elf32Shdr = GetElf32SectionByIndex (ElfCt->FileBase, Index);

+ if (Elf32Shdr != NULL) {

+ *Offset = (UINTN)Elf32Shdr->sh_offset;

+ *Size = (UINTN)Elf32Shdr->sh_size;

+ return EFI_SUCCESS;

+ }

+ } else if (ElfCt->EiClass == ELFCLASS64) {

+ Elf64Shdr = GetElf64SectionByIndex (ElfCt->FileBase, Index);

+ if (Elf64Shdr != NULL) {

+ *Offset = (UINTN)Elf64Shdr->sh_offset;

+ *Size = (UINTN)Elf64Shdr->sh_size;

+ return EFI_SUCCESS;

+ }

+ }

+

+ return EFI_NOT_FOUND;

+}

diff --git a/UefiPayloadPkg/PayloadLoaderPeim/ElfLib/ElfLibInternal.h
b/UefiPayloadPkg/PayloadLoaderPeim/ElfLib/ElfLibInternal.h
new file mode 100644
index 0000000000..3c782807e2
--- /dev/null
+++ b/UefiPayloadPkg/PayloadLoaderPeim/ElfLib/ElfLibInternal.h
@@ -0,0 +1,109 @@
+/** @file

+ ELF library

+

+ Copyright (c) 2019 - 2021, Intel Corporation. All rights reserved.<BR>

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

+

+**/

+

+#ifndef EFI_LIB_INTERNAL_H_

+#define EFI_LIB_INTERNAL_H_

+

+#include <Library/BaseLib.h>

+#include <Library/DebugLib.h>

+#include <Library/BaseMemoryLib.h>

+#include "ElfLib.h"

+#include "ElfCommon.h"

+#include "Elf32.h"

+#include "Elf64.h"

+

+#define ELF_NEXT_ENTRY(EntryType, Current, EntrySize) \

+ ((EntryType *) ((UINT8 *)Current + EntrySize))

+

+

+/**

+ Return the section header specified by Index.

+

+ @param ImageBase The image base.

+ @param Index The section index.

+

+ @return Pointer to the section header.

+**/

+Elf32_Shdr *

+GetElf32SectionByIndex (

+ IN UINT8 *ImageBase,

+ IN UINT32 Index

+ );

+

+/**

+ Return the section header specified by Index.

+

+ @param ImageBase The image base.

+ @param Index The section index.

+

+ @return Pointer to the section header.

+**/

+Elf64_Shdr *

+GetElf64SectionByIndex (

+ IN UINT8 *ImageBase,

+ IN UINT32 Index

+ );

+

+/**

+ Return the segment header specified by Index.

+

+ @param ImageBase The image base.

+ @param Index The segment index.

+

+ @return Pointer to the segment header.

+**/

+Elf32_Phdr *

+GetElf32SegmentByIndex (

+ IN UINT8 *ImageBase,

+ IN UINT32 Index

+ );

+

+/**

+ Return the segment header specified by Index.

+

+ @param ImageBase The image base.

+ @param Index The segment index.

+

+ @return Pointer to the segment header.

+**/

+Elf64_Phdr *

+GetElf64SegmentByIndex (

+ IN UINT8 *ImageBase,

+ IN UINT32 Index

+ );

+

+/**

+ Load ELF image which has 32-bit architecture

+

+ @param[in] ElfCt ELF image context pointer.

+

+ @retval EFI_SUCCESS ELF binary is loaded successfully.

+ @retval Others Loading ELF binary fails.

+

+**/

+EFI_STATUS

+LoadElf32Image (

+ IN ELF_IMAGE_CONTEXT *ElfCt

+ );

+

+/**

+ Load ELF image which has 64-bit architecture

+

+ @param[in] ImageBase Memory address of an image.

+ @param[out] EntryPoint The entry point of loaded ELF image.

+

+ @retval EFI_SUCCESS ELF binary is loaded successfully.

+ @retval Others Loading ELF binary fails.

+

+**/

+EFI_STATUS

+LoadElf64Image (

+ IN ELF_IMAGE_CONTEXT *ElfCt

+ );

+

+#endif

diff --git a/UefiPayloadPkg/PayloadLoaderPeim/PayloadLoaderPeim.c
b/UefiPayloadPkg/PayloadLoaderPeim/PayloadLoaderPeim.c
new file mode 100644
index 0000000000..44639f9fd2
--- /dev/null
+++ b/UefiPayloadPkg/PayloadLoaderPeim/PayloadLoaderPeim.c
@@ -0,0 +1,187 @@
+/** @file

+ ELF Load Image Support

+

+Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>

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

+

+**/

+

+#include <PiPei.h>

+#include <UniversalPayload/UniversalPayload.h>

+#include <UniversalPayload/ExtraData.h>

+

+#include <Ppi/LoadFile.h>

+

+#include <Library/DebugLib.h>

+#include <Library/HobLib.h>

+#include <Library/PeiServicesLib.h>

+#include <Library/MemoryAllocationLib.h>

+#include <Library/BaseMemoryLib.h>

+

+#include "ElfLib.h"

+

+/**

+ The wrapper function of PeiLoadImageLoadImage().

+

+ @param This - Pointer to EFI_PEI_LOAD_FILE_PPI.

+ @param FileHandle - Pointer to the FFS file header of the image.

+ @param ImageAddressArg - Pointer to PE/TE image.

+ @param ImageSizeArg - Size of PE/TE image.

+ @param EntryPoint - Pointer to entry point of specified image file for
output.

+ @param AuthenticationState - Pointer to attestation authentication state
of image.

+

+ @return Status of PeiLoadImageLoadImage().

+

+**/

+EFI_STATUS

+EFIAPI

+PeiLoadFileLoadPayload (

+ IN CONST EFI_PEI_LOAD_FILE_PPI *This,

+ IN EFI_PEI_FILE_HANDLE FileHandle,

+ OUT EFI_PHYSICAL_ADDRESS *ImageAddressArg, OPTIONAL

+ OUT UINT64 *ImageSizeArg, OPTIONAL

+ OUT EFI_PHYSICAL_ADDRESS *EntryPoint,

+ OUT UINT32 *AuthenticationState

+ )

+{

+ EFI_STATUS Status;

+ VOID *Elf;

+ PLD_EXTRA_DATA *ExtraData;

+ ELF_IMAGE_CONTEXT Context;

+ PLD_INFO_HEADER *PldInfo;

+ UINT32 Index;

+ UINT16 ExtraDataIndex;

+ CHAR8 *SectionName;

+ UINTN Offset;

+ UINTN Size;

+ UINT32 ExtraDataCount;

+ UINTN Instance;

+

+ //

+ // ELF is added to file as RAW section for EDKII bootloader.

+ // But RAW section might be added by build tool before the ELF RAW
section when alignment is specified for ELF RAW section.

+ // Below loop skips the RAW section that doesn't contain valid ELF image.

+ //

+ Instance = 0;

+ do {

+ Status = PeiServicesFfsFindSectionData3 (EFI_SECTION_RAW, Instance++,
FileHandle, &Elf, AuthenticationState);

+ if (EFI_ERROR (Status)) {

+ return Status;

+ }

+

+ ZeroMem (&Context, sizeof (Context));

+ Status = ParseElfImage (Elf, &Context);

+ } while (EFI_ERROR (Status));

+

+ DEBUG ((

+ DEBUG_INFO, "Payload File Size: 0x%08X, Mem Size: 0x%08x,
Reload: %d\n",

+ Context.FileSize, Context.ImageSize, Context.ReloadRequired

+ ));

+

+ //

+ // Get PLD_INFO and number of additional PLD sections.

+ //

+ PldInfo = NULL;

+ ExtraDataCount = 0;

+ for (Index = 0; Index < Context.ShNum; Index++) {

+ Status = GetElfSectionName (&Context, Index, &SectionName);

+ if (EFI_ERROR(Status)) {

+ continue;

+ }

+ DEBUG ((DEBUG_INFO, "Payload Section[%d]: %a\n", Index,
SectionName));

+ if (AsciiStrCmp(SectionName, PLD_INFO_SEC_NAME) == 0) {

+ Status = GetElfSectionPos (&Context, Index, &Offset, &Size);

+ if (!EFI_ERROR(Status)) {

+ PldInfo = (PLD_INFO_HEADER *)(Context.FileBase + Offset);

+ }

+ } else if (AsciiStrnCmp(SectionName, PLD_EXTRA_SEC_NAME_PREFIX,
PLD_EXTRA_SEC_NAME_PREFIX_LENGTH) == 0) {

+ Status = GetElfSectionPos (&Context, Index, &Offset, &Size);

+ if (!EFI_ERROR (Status)) {

+ ExtraDataCount++;

+ }

+ }

+ }

+

+ //

+ // Report the additional PLD sections through HOB.

+ //

+ ExtraData = BuildGuidHob (

+ &gPldExtraDataGuid,

+ sizeof (PLD_EXTRA_DATA) + ExtraDataCount * sizeof
(PLD_EXTRA_DATA_ENTRY)

+ );

+ ExtraData->Count = ExtraDataCount;

+ if (ExtraDataCount != 0) {

+ for (ExtraDataIndex = 0, Index = 0; Index < Context.ShNum; Index++) {

+ Status = GetElfSectionName (&Context, Index, &SectionName);

+ if (EFI_ERROR(Status)) {

+ continue;

+ }

+ if (AsciiStrnCmp(SectionName, PLD_EXTRA_SEC_NAME_PREFIX,
PLD_EXTRA_SEC_NAME_PREFIX_LENGTH) == 0) {

+ Status = GetElfSectionPos (&Context, Index, &Offset, &Size);

+ if (!EFI_ERROR (Status)) {

+ ASSERT (ExtraDataIndex < ExtraDataCount);

+ AsciiStrCpyS (

+ ExtraData->Entry[ExtraDataIndex].Identifier,

+ sizeof(ExtraData->Entry[ExtraDataIndex].Identifier),

+ SectionName + PLD_EXTRA_SEC_NAME_PREFIX_LENGTH

+ );

+ ExtraData->Entry[ExtraDataIndex].Base = (UINTN)(Context.FileBase +
Offset);

+ ExtraData->Entry[ExtraDataIndex].Size = Size;

+ ExtraDataIndex++;

+ }

+ }

+ }

+ }

+

+ if (Context.ReloadRequired || Context.PreferredImageAddress !=
Context.FileBase) {

+ Context.ImageAddress = AllocatePages (EFI_SIZE_TO_PAGES
(Context.ImageSize));

+ } else {

+ Context.ImageAddress = Context.FileBase;

+ }

+

+ //

+ // Load ELF into the required base

+ //

+ Status = LoadElfImage (&Context);

+ if (!EFI_ERROR(Status)) {

+ *ImageAddressArg = (UINTN) Context.ImageAddress;

+ *EntryPoint = Context.EntryPoint;

+ *ImageSizeArg = Context.ImageSize;

+ }

+ return Status;

+}

+

+

+EFI_PEI_LOAD_FILE_PPI mPeiLoadFilePpi = {

+ PeiLoadFileLoadPayload

+};

+

+

+EFI_PEI_PPI_DESCRIPTOR gPpiLoadFilePpiList = {

+ (EFI_PEI_PPI_DESCRIPTOR_PPI |
EFI_PEI_PPI_DESCRIPTOR_TERMINATE_LIST),

+ &gEfiPeiLoadFilePpiGuid,

+ &mPeiLoadFilePpi

+};

+/**

+

+ Install Pei Load File PPI.

+

+ @param FileHandle Handle of the file being invoked.

+ @param PeiServices Describes the list of possible PEI Services.

+

+ @retval EFI_SUCESS The entry point executes successfully.

+ @retval Others Some error occurs during the execution of this function.

+

+**/

+EFI_STATUS

+EFIAPI

+InitializePayloadLoaderPeim (

+ IN EFI_PEI_FILE_HANDLE FileHandle,

+ IN CONST EFI_PEI_SERVICES **PeiServices

+ )

+{

+ EFI_STATUS Status;

+ Status = PeiServicesInstallPpi (&gPpiLoadFilePpiList);

+

+ return Status;

+}

diff --git a/UefiPayloadPkg/PayloadLoaderPeim/PayloadLoaderPeim.inf
b/UefiPayloadPkg/PayloadLoaderPeim/PayloadLoaderPeim.inf
new file mode 100644
index 0000000000..c45f3ecf2d
--- /dev/null
+++ b/UefiPayloadPkg/PayloadLoaderPeim/PayloadLoaderPeim.inf
@@ -0,0 +1,59 @@
+## @file

+# Produce LoadFile PPI for ELF loading.

+#

+# Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>

+#

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

+#

+##

+

+[Defines]

+ INF_VERSION = 0x00010005

+ BASE_NAME = ElfLoaderPeim

+ FILE_GUID = D071A3B4-3EC1-40C5-BEF8-D0BD4A2446F0

+ MODULE_TYPE = PEIM

+ VERSION_STRING = 1.0

+

+ ENTRY_POINT = InitializePayloadLoaderPeim

+

+#

+# The following information is for reference only and not required by the
build tools.

+#

+# VALID_ARCHITECTURES = IA32 X64

+#

+

+[Sources]

+ PayloadLoaderPeim.c

+ ElfLib.h

+ ElfLib/ElfLibInternal.h

+ ElfLib/ElfCommon.h

+ ElfLib/Elf32.h

+ ElfLib/Elf64.h

+ ElfLib/ElfLibInternal.h

+ ElfLib/ElfLib.c

+ ElfLib/Elf32Lib.c

+ ElfLib/Elf64Lib.c

+

+[Packages]

+ MdePkg/MdePkg.dec

+ MdeModulePkg/MdeModulePkg.dec

+ UefiPayloadPkg/UefiPayloadPkg.dec

+

+[LibraryClasses]

+ PcdLib

+ MemoryAllocationLib

+ BaseMemoryLib

+ PeiServicesLib

+ HobLib

+ BaseLib

+ PeimEntryPoint

+ DebugLib

+

+[Ppis]

+ gEfiPeiLoadFilePpiGuid ## PRODUCES

+

+[Guids]

+ gPldExtraDataGuid ## PRODUCES

+

+[Depex]

+ TRUE
\ No newline at end of file
--
2.31.1.windows.1


Marvin Häuser
 

Good day everyone,

Sorry that I comment with insufficient review, I am a bit low on time. However I have been working with the PE code in EDK II code for a while and thought I could share some comments based on my experiences with it.
I tried to mainly outline the kind of issues, my picks are not comprehensive or overly thorough, hope it's useful nevertheless. I would be really glad if revisions were possible before this set lands. Comments are inline.

Thanks for your time!

Best regards,
Marvin

On 03.06.21 08:22, Ni, Ray wrote:
Per universal payload spec, the payload is in ELF format.
The patch adds a payload loader that supports to load ELF image.

The location of extra data sections whose names start with "upld."
is stored in PLD_EXTRA_DATA HOB.

Signed-off-by: Maurice Ma <maurice.ma@...>
Signed-off-by: Ray Ni <ray.ni@...>
Cc: Maurice Ma <maurice.ma@...>
Cc: Guo Dong <guo.dong@...>
Cc: Benjamin You <benjamin.you@...>
---
UefiPayloadPkg/PayloadLoaderPeim/ElfLib.h | 122 +++
.../PayloadLoaderPeim/ElfLib/Elf32.h | 252 +++++
.../PayloadLoaderPeim/ElfLib/Elf32Lib.c | 451 ++++++++
.../PayloadLoaderPeim/ElfLib/Elf64.h | 254 +++++
.../PayloadLoaderPeim/ElfLib/Elf64Lib.c | 460 ++++++++
.../PayloadLoaderPeim/ElfLib/ElfCommon.h | 983 ++++++++++++++++++
.../PayloadLoaderPeim/ElfLib/ElfLib.c | 473 +++++++++
.../PayloadLoaderPeim/ElfLib/ElfLibInternal.h | 109 ++
.../PayloadLoaderPeim/PayloadLoaderPeim.c | 187 ++++
.../PayloadLoaderPeim/PayloadLoaderPeim.inf | 59 ++
10 files changed, 3350 insertions(+)
create mode 100644 UefiPayloadPkg/PayloadLoaderPeim/ElfLib.h
create mode 100644 UefiPayloadPkg/PayloadLoaderPeim/ElfLib/Elf32.h
create mode 100644 UefiPayloadPkg/PayloadLoaderPeim/ElfLib/Elf32Lib.c
create mode 100644 UefiPayloadPkg/PayloadLoaderPeim/ElfLib/Elf64.h
create mode 100644 UefiPayloadPkg/PayloadLoaderPeim/ElfLib/Elf64Lib.c
create mode 100644 UefiPayloadPkg/PayloadLoaderPeim/ElfLib/ElfCommon.h
create mode 100644 UefiPayloadPkg/PayloadLoaderPeim/ElfLib/ElfLib.c
create mode 100644 UefiPayloadPkg/PayloadLoaderPeim/ElfLib/ElfLibInternal.h
create mode 100644 UefiPayloadPkg/PayloadLoaderPeim/PayloadLoaderPeim.c
create mode 100644 UefiPayloadPkg/PayloadLoaderPeim/PayloadLoaderPeim.inf

diff --git a/UefiPayloadPkg/PayloadLoaderPeim/ElfLib.h b/UefiPayloadPkg/PayloadLoaderPeim/ElfLib.h
new file mode 100644
index 0000000000..9cfc2912cf
--- /dev/null
+++ b/UefiPayloadPkg/PayloadLoaderPeim/ElfLib.h
@@ -0,0 +1,122 @@
+/** @file
+ ELF library
+
+ Copyright (c) 2018 - 2021, Intel Corporation. All rights reserved.<BR>
+ SPDX-License-Identifier: BSD-2-Clause-Patent
+
+**/
+
+#ifndef ELF_LIB_H_
+#define ELF_LIB_H_
+
+#include <PiPei.h>
+
+#define ELF_CLASS32 1
+#define ELF_CLASS64 2
+
+#define ELF_PT_LOAD 1
+
+typedef struct {
+ RETURN_STATUS ParseStatus; ///< Return the status after ParseElfImage().
+ UINT8 *FileBase; ///< The source location in memory.
+ UINTN FileSize; ///< The size including sections that don't require loading.
+ UINT8 *PreferredImageAddress; ///< The preferred image to be loaded. No relocation is needed if loaded to this address.
+ BOOLEAN ReloadRequired; ///< The image needs a new memory location for running.
+ UINT8 *ImageAddress; ///< The destination memory address set by caller.
+ UINTN ImageSize; ///< The memory size for loading and execution.
+ UINT32 EiClass;
+ UINT32 ShNum;
+ UINT32 PhNum;
+ UINTN ShStrOff;
+ UINTN ShStrLen;
+ UINTN EntryPoint; ///< Return the actual entry point after LoadElfImage().
+} ELF_IMAGE_CONTEXT;
+
+
+typedef struct {
+ UINT32 PtType;
+ UINTN Offset;
+ UINTN Length;
+ UINTN MemLen;
+ UINTN MemAddr;
+ UINTN Alignment;
+} SEGMENT_INFO;
+
+/**
+ Parse the ELF image info.
+
+ @param[in] ImageBase Memory address of an image.
+ @param[out] ElfCt The EFL image context pointer.
+
+ @retval EFI_INVALID_PARAMETER Input parameters are not valid.
+ @retval EFI_UNSUPPORTED Unsupported binary type.
+ @retval EFI_LOAD_ERROR ELF binary loading error.
+ @retval EFI_SUCCESS ELF binary is loaded successfully.
+**/
+EFI_STATUS
+EFIAPI
+ParseElfImage (
+ IN VOID *ImageBase,
+ OUT ELF_IMAGE_CONTEXT *ElfCt
+ );
+
+/**
+ Load the ELF segments to specified address in ELF header.
+
+ This function loads ELF image segments into memory address specified
+ in ELF program header.
+
+ @param[in] ElfCt ELF image context pointer.
+
+ @retval EFI_INVALID_PARAMETER Input parameters are not valid.
+ @retval EFI_UNSUPPORTED Unsupported binary type.
+ @retval EFI_LOAD_ERROR ELF binary loading error.
+ @retval EFI_SUCCESS ELF binary is loaded successfully.
+**/
+EFI_STATUS
+EFIAPI
+LoadElfImage (
+ IN ELF_IMAGE_CONTEXT *ElfCt
+ );
+
+/**
+ Get a ELF section name from its index.
+
+ @param[in] ElfCt ELF image context pointer.
+ @param[in] SectionIndex ELF section index.
+ @param[out] SectionName The pointer to the section name.
+
+ @retval EFI_INVALID_PARAMETER ElfCt or SecName is NULL.
+ @retval EFI_NOT_FOUND Could not find the section.
+ @retval EFI_SUCCESS Section name was filled successfully.
+**/
+EFI_STATUS
+EFIAPI
+GetElfSectionName (
+ IN ELF_IMAGE_CONTEXT *ElfCt,
+ IN UINT32 SectionIndex,
+ OUT CHAR8 **SectionName
+ );
+
+/**
+ Get the offset and size of x-th ELF section.
+
+ @param[in] ElfCt ELF image context pointer.
+ @param[in] Index ELF section index.
+ @param[out] Offset Return the offset of the specific section.
+ @param[out] Size Return the size of the specific section.
+
+ @retval EFI_INVALID_PARAMETER ImageBase, Offset or Size is NULL.
+ @retval EFI_INVALID_PARAMETER EiClass doesn't equal to ELFCLASS32 or ELFCLASS64.
+ @retval EFI_NOT_FOUND Could not find the section.
+ @retval EFI_SUCCESS Offset and Size are returned.
+**/
+EFI_STATUS
+EFIAPI
+GetElfSectionPos (
+ IN ELF_IMAGE_CONTEXT *ElfCt,
+ IN UINT32 Index,
+ OUT UINTN *Offset,
+ OUT UINTN *Size
+ );
+#endif /* ELF_LIB_H_ */
diff --git a/UefiPayloadPkg/PayloadLoaderPeim/ElfLib/Elf32.h b/UefiPayloadPkg/PayloadLoaderPeim/ElfLib/Elf32.h
new file mode 100644
index 0000000000..ebed5f00c3
--- /dev/null
+++ b/UefiPayloadPkg/PayloadLoaderPeim/ElfLib/Elf32.h
@@ -0,0 +1,252 @@
+/** @file
+Ported ELF include files from FreeBSD
+
+Copyright (c) 2009 - 2010, Apple Inc. All rights reserved.<BR>
+SPDX-License-Identifier: BSD-2-Clause-Patent
+
+
+**/
+/*-
+ * Copyright (c) 1996-1998 John D. Polstra.
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ * 1. Redistributions of source code must retain the above copyright
+ * notice, this list of conditions and the following disclaimer.
+ * 2. Redistributions in binary form must reproduce the above copyright
+ * notice, this list of conditions and the following disclaimer in the
+ * documentation and/or other materials provided with the distribution.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
+ * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+ * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
+ * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
+ * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+ * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
+ * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
+ * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+ * SUCH DAMAGE.
+ *
+ * $FreeBSD: src/sys/sys/elf32.h,v 1.8.14.2 2007/12/03 21:30:36 marius Exp $
+ */
+
+#ifndef _SYS_ELF32_H_
+#define _SYS_ELF32_H_ 1
+
+
+/*
+ * ELF definitions common to all 32-bit architectures.
+ */
+
+typedef UINT32 Elf32_Addr;
+typedef UINT16 Elf32_Half;
+typedef UINT32 Elf32_Off;
+typedef INT32 Elf32_Sword;
+typedef UINT32 Elf32_Word;
+typedef UINT64 Elf32_Lword;
+
+typedef Elf32_Word Elf32_Hashelt;
+
+/* Non-standard class-dependent datatype used for abstraction. */
+typedef Elf32_Word Elf32_Size;
+typedef Elf32_Sword Elf32_Ssize;
+
+/*
+ * ELF header.
+ */
+
+typedef struct {
+ unsigned char e_ident[EI_NIDENT]; /* File identification. */
+ Elf32_Half e_type; /* File type. */
+ Elf32_Half e_machine; /* Machine architecture. */
+ Elf32_Word e_version; /* ELF format version. */
+ Elf32_Addr e_entry; /* Entry point. */
+ Elf32_Off e_phoff; /* Program header file offset. */
+ Elf32_Off e_shoff; /* Section header file offset. */
+ Elf32_Word e_flags; /* Architecture-specific flags. */
+ Elf32_Half e_ehsize; /* Size of ELF header in bytes. */
+ Elf32_Half e_phentsize; /* Size of program header entry. */
+ Elf32_Half e_phnum; /* Number of program header entries. */
+ Elf32_Half e_shentsize; /* Size of section header entry. */
+ Elf32_Half e_shnum; /* Number of section header entries. */
+ Elf32_Half e_shstrndx; /* Section name strings section. */
+} Elf32_Ehdr;
+
+/*
+ * Section header.
+ */
+
+typedef struct {
+ Elf32_Word sh_name; /* Section name (index into the
+ section header string table). */
+ Elf32_Word sh_type; /* Section type. */
+ Elf32_Word sh_flags; /* Section flags. */
+ Elf32_Addr sh_addr; /* Address in memory image. */
+ Elf32_Off sh_offset; /* Offset in file. */
+ Elf32_Word sh_size; /* Size in bytes. */
+ Elf32_Word sh_link; /* Index of a related section. */
+ Elf32_Word sh_info; /* Depends on section type. */
+ Elf32_Word sh_addralign; /* Alignment in bytes. */
+ Elf32_Word sh_entsize; /* Size of each entry in section. */
+} Elf32_Shdr;
+
+/*
+ * Program header.
+ */
+
+typedef struct {
+ Elf32_Word p_type; /* Entry type. */
+ Elf32_Off p_offset; /* File offset of contents. */
+ Elf32_Addr p_vaddr; /* Virtual address in memory image. */
+ Elf32_Addr p_paddr; /* Physical address (not used). */
+ Elf32_Word p_filesz; /* Size of contents in file. */
+ Elf32_Word p_memsz; /* Size of contents in memory. */
+ Elf32_Word p_flags; /* Access permission flags. */
+ Elf32_Word p_align; /* Alignment in memory and file. */
+} Elf32_Phdr;
+
+/*
+ * Dynamic structure. The ".dynamic" section contains an array of them.
+ */
+
+typedef struct {
+ Elf32_Sword d_tag; /* Entry type. */
+ union {
+ Elf32_Word d_val; /* Integer value. */
+ Elf32_Addr d_ptr; /* Address value. */
+ } d_un;
+} Elf32_Dyn;
+
+/*
+ * Relocation entries.
+ */
+
+/* Relocations that don't need an addend field. */
+typedef struct {
+ Elf32_Addr r_offset; /* Location to be relocated. */
+ Elf32_Word r_info; /* Relocation type and symbol index. */
+} Elf32_Rel;
+
+/* Relocations that need an addend field. */
+typedef struct {
+ Elf32_Addr r_offset; /* Location to be relocated. */
+ Elf32_Word r_info; /* Relocation type and symbol index. */
+ Elf32_Sword r_addend; /* Addend. */
+} Elf32_Rela;
+
+/* Macros for accessing the fields of r_info. */
+#define ELF32_R_SYM(info) ((info) >> 8)
+#define ELF32_R_TYPE(info) ((unsigned char)(info))
+
+/* Macro for constructing r_info from field values. */
+#define ELF32_R_INFO(sym, type) (((sym) << 8) + (unsigned char)(type))
+
+/*
+ * Note entry header
+ */
+typedef Elf_Note Elf32_Nhdr;
+
+/*
+ * Move entry
+ */
+typedef struct {
+ Elf32_Lword m_value; /* symbol value */
+ Elf32_Word m_info; /* size + index */
+ Elf32_Word m_poffset; /* symbol offset */
+ Elf32_Half m_repeat; /* repeat count */
+ Elf32_Half m_stride; /* stride info */
+} Elf32_Move;
+
+/*
+ * The macros compose and decompose values for Move.r_info
+ *
+ * sym = ELF32_M_SYM(M.m_info)
+ * size = ELF32_M_SIZE(M.m_info)
+ * M.m_info = ELF32_M_INFO(sym, size)
+ */
+#define ELF32_M_SYM(info) ((info)>>8)
+#define ELF32_M_SIZE(info) ((unsigned char)(info))
+#define ELF32_M_INFO(sym, size) (((sym)<<8)+(unsigned char)(size))
+
+/*
+ * Hardware/Software capabilities entry
+ */
+typedef struct {
+ Elf32_Word c_tag; /* how to interpret value */
+ union {
+ Elf32_Word c_val;
+ Elf32_Addr c_ptr;
+ } c_un;
+} Elf32_Cap;
+
+/*
+ * Symbol table entries.
+ */
+
+typedef struct {
+ Elf32_Word st_name; /* String table index of name. */
+ Elf32_Addr st_value; /* Symbol value. */
+ Elf32_Word st_size; /* Size of associated object. */
+ unsigned char st_info; /* Type and binding information. */
+ unsigned char st_other; /* Reserved (not used). */
+ Elf32_Half st_shndx; /* Section index of symbol. */
+} Elf32_Sym;
+
+/* Macros for accessing the fields of st_info. */
+#define ELF32_ST_BIND(info) ((info) >> 4)
+#define ELF32_ST_TYPE(info) ((info) & 0xf)
+
+/* Macro for constructing st_info from field values. */
+#define ELF32_ST_INFO(bind, type) (((bind) << 4) + ((type) & 0xf))
+
+/* Macro for accessing the fields of st_other. */
+#define ELF32_ST_VISIBILITY(oth) ((oth) & 0x3)
+
+/* Structures used by Sun & GNU symbol versioning. */
+typedef struct
+{
+ Elf32_Half vd_version;
+ Elf32_Half vd_flags;
+ Elf32_Half vd_ndx;
+ Elf32_Half vd_cnt;
+ Elf32_Word vd_hash;
+ Elf32_Word vd_aux;
+ Elf32_Word vd_next;
+} Elf32_Verdef;
+
+typedef struct
+{
+ Elf32_Word vda_name;
+ Elf32_Word vda_next;
+} Elf32_Verdaux;
+
+typedef struct
+{
+ Elf32_Half vn_version;
+ Elf32_Half vn_cnt;
+ Elf32_Word vn_file;
+ Elf32_Word vn_aux;
+ Elf32_Word vn_next;
+} Elf32_Verneed;
+
+typedef struct
+{
+ Elf32_Word vna_hash;
+ Elf32_Half vna_flags;
+ Elf32_Half vna_other;
+ Elf32_Word vna_name;
+ Elf32_Word vna_next;
+} Elf32_Vernaux;
+
+typedef Elf32_Half Elf32_Versym;
+
+typedef struct {
+ Elf32_Half si_boundto; /* direct bindings - symbol bound to */
+ Elf32_Half si_flags; /* per symbol flags */
+} Elf32_Syminfo;
+
+#endif /* !_SYS_ELF32_H_ */
diff --git a/UefiPayloadPkg/PayloadLoaderPeim/ElfLib/Elf32Lib.c b/UefiPayloadPkg/PayloadLoaderPeim/ElfLib/Elf32Lib.c
new file mode 100644
index 0000000000..3fa100ce4a
--- /dev/null
+++ b/UefiPayloadPkg/PayloadLoaderPeim/ElfLib/Elf32Lib.c
@@ -0,0 +1,451 @@
+/** @file
+ ELF library
+
+ Copyright (c) 2019 - 2021, Intel Corporation. All rights reserved.<BR>
+ SPDX-License-Identifier: BSD-2-Clause-Patent
+
+**/
+
+#include "ElfLibInternal.h"
+
+/**
+ Return the section header specified by Index.
+
+ @param ImageBase The image base.
+ @param Index The section index.
+
+ @return Pointer to the section header.
+**/
+Elf32_Shdr *
+GetElf32SectionByIndex (
+ IN UINT8 *ImageBase,
+ IN UINT32 Index
+ )
+{
+ Elf32_Ehdr *Ehdr;
+
+ Ehdr = (Elf32_Ehdr *)ImageBase;
+ if (Index >= Ehdr->e_shnum) {
+ return NULL;
+ }
+
+ return (Elf32_Shdr *)(ImageBase + Ehdr->e_shoff + Index * Ehdr->e_shentsize);
+}
+
+/**
+ Return the segment header specified by Index.
+
+ @param ImageBase The image base.
+ @param Index The segment index.
+
+ @return Pointer to the segment header.
+**/
+Elf32_Phdr *
+GetElf32SegmentByIndex (
+ IN UINT8 *ImageBase,
+ IN UINT32 Index
+ )
+{
+ Elf32_Ehdr *Ehdr;
+
+ Ehdr = (Elf32_Ehdr *)ImageBase;
+ if (Index >= Ehdr->e_phnum) {
+ return NULL;
+ }
+
+ return (Elf32_Phdr *)(ImageBase + Ehdr->e_phoff + Index * Ehdr->e_phentsize);
+}
+
+/**
+ Return the section header specified by the range.
+
+ @param ImageBase The image base.
+ @param Offset The section offset.
+ @param Size The section size.
+
+ @return Pointer to the section header.
+**/
+Elf32_Shdr *
+GetElf32SectionByRange (
+ IN UINT8 *ImageBase,
+ IN UINT32 Offset,
+ IN UINT32 Size
+ )
+{
+ UINT32 Index;
+ Elf32_Ehdr *Ehdr;
+ Elf32_Shdr *Shdr;
+
+ Ehdr = (Elf32_Ehdr *)ImageBase;
+
+ Shdr = (Elf32_Shdr *) (ImageBase + Ehdr->e_shoff);
+ for (Index = 0; Index < Ehdr->e_shnum; Index++) {
+ if ((Shdr->sh_offset == Offset) && (Shdr->sh_size == Size)) {
+ return Shdr;
+ }
+ Shdr = ELF_NEXT_ENTRY (Elf32_Shdr, Shdr, Ehdr->e_shentsize);
+ }
+ return NULL;
+}
+
+/**
+ Fix up the image based on the relocation entries.
+
+ @param Rela Relocation entries.
+ @param RelaSize Total size of relocation entries.
+ @param RelaEntrySize Relocation entry size.
+ @param RelaType Type of relocation entry.
+ @param Delta The delta between preferred image base and the actual image base.
+ @param DynamicLinking TRUE when fixing up according to dynamic relocation.
+
+ @retval EFI_SUCCESS The image fix up is processed successfully.
+**/
+EFI_STATUS
+ProcessRelocation32 (
+ IN Elf32_Rela *Rela,
+ IN UINT32 RelaSize,
+ IN UINT32 RelaEntrySize,
+ IN UINT32 RelaType,
+ IN INTN Delta,
+ IN BOOLEAN DynamicLinking
+ )
+{
+ UINTN Index;
+ UINT32 *Ptr;
+ UINT32 Type;
+
+ for ( Index = 0
+ ; RelaEntrySize * Index < RelaSize
Overflow?

+ ; Index++, Rela = ELF_NEXT_ENTRY (Elf32_Rela, Rela, RelaEntrySize)
+ ) {
+ //
+ // r_offset is the virtual address of the storage unit affected by the relocation.
+ //
+ Ptr = (UINT32 *)(UINTN)(Rela->r_offset + Delta);
Alignment?

+ Type = ELF32_R_TYPE(Rela->r_info);
+ switch (Type) {
+ case R_386_NONE:
+ case R_386_PC32:
+ //
+ // No fixup entry required.
+ //
+ break;
+
+ case R_386_32:
+ if (DynamicLinking) {
+ //
+ // Dynamic section doesn't contain entries of this type.
+ //
+ DEBUG ((DEBUG_INFO, "Unsupported relocation type %02X\n", Type));
+ ASSERT (FALSE);
+ } else {
+ *Ptr += (UINT32) Delta;
+ }
+ break;
+
+ case R_386_RELATIVE:
+ if (DynamicLinking) {
+ //
+ // A: Represents the addend used to compute the value of the relocatable field.
+ // B: Represents the base address at which a shared object has been loaded into memory during execution.
+ // Generally, a shared object is built with a 0 base virtual address, but the execution address will be different.
+ //
+ // B (Base Address) in ELF spec is slightly different:
+ // An executable or shared object file's base address (on platforms that support the concept) is calculated during
+ // execution from three values: the virtual memory load address, the maximum page size, and the lowest virtual address
+ // of a program's loadable segment. To compute the base address, one determines the memory address associated with the
+ // lowest p_vaddr value for a PT_LOAD segment. This address is truncated to the nearest multiple of the maximum page size.
+ // The corresponding p_vaddr value itself is also truncated to the nearest multiple of the maximum page size.
+ //
+ // *** The base address is the difference between the truncated memory address and the truncated p_vaddr value. ***
+ //
+ // Delta in this function is B.
+ //
+ // Calculation: B + A
+ //
+ if (RelaType == SHT_RELA) {
+ ASSERT (*Ptr == 0);
+ *Ptr = (UINT32) Delta + Rela->r_addend;
+ } else {
+ //
+ // A is stored in the field of relocation for REL type.
+ //
+ *Ptr = (UINT32) Delta + *Ptr;
+ }
+ } else {
+ //
+ // non-Dynamic section doesn't contain entries of this type.
+ //
+ DEBUG ((DEBUG_INFO, "Unsupported relocation type %02X\n", Type));
+ ASSERT (FALSE);
+ }
+ break;
+
+ default:
+ DEBUG ((DEBUG_INFO, "Unsupported relocation type %02X\n", Type));
+ }
+ }
Out of pure interest, if performance is a concern, have you profiled this code vs one with two loops and "DynamicLinking" pulled out?

+ return EFI_SUCCESS;
+}
+
+/**
+ Relocate the DYN type image.
+
+ @param ElfCt Point to image context.
+
+ @retval EFI_SUCCESS The relocation succeeds.
+ @retval EFI_UNSUPPORTED The image doesn't contain a dynamic section.
+**/
+EFI_STATUS
+RelocateElf32Dynamic (
+ IN ELF_IMAGE_CONTEXT *ElfCt
+ )
+{
+ UINT32 Index;
+ Elf32_Phdr *Phdr;
+ Elf32_Shdr *DynShdr;
+ Elf32_Shdr *RelShdr;
+ Elf32_Dyn *Dyn;
+ UINT32 RelaOffset;
+ UINT32 RelaCount;
+ UINT32 RelaSize;
+ UINT32 RelaEntrySize;
+ UINT32 RelaType;
+
+ //
+ // 1. Locate the dynamic section.
+ //
+ // If an object file participates in dynamic linking, its program header table
+ // will have an element of type PT_DYNAMIC.
+ // This ``segment'' contains the .dynamic section. A special symbol, _DYNAMIC,
+ // labels the section, which contains an array of Elf32_Dyn or Elf64_Dyn.
+ //
+ DynShdr = NULL;
+ for (Index = 0; Index < ElfCt->PhNum; Index++) {
+ Phdr = GetElf32SegmentByIndex (ElfCt->FileBase, Index);
+ ASSERT (Phdr != NULL);
+ if (Phdr->p_type == PT_DYNAMIC) {
+ //
+ // Verify the existence of the dynamic section.
+ //
+ DynShdr = GetElf32SectionByRange (ElfCt->FileBase, Phdr->p_offset, Phdr->p_filesz);
+ break;
+ }
+ }
+
+ //
+ // It's abnormal a DYN ELF doesn't contain a dynamic section.
+ //
+ ASSERT (DynShdr != NULL);
+ if (DynShdr == NULL) {
+ return EFI_UNSUPPORTED;
+ }
+ ASSERT (DynShdr->sh_type == SHT_DYNAMIC);
+ ASSERT (DynShdr->sh_entsize >= sizeof (*Dyn));
Abnormalities in unknown/untrusted data must be filtered with a runtime check, not with an ASSERT.

+
+ //
+ // 2. Locate the relocation section from the dynamic section.
+ //
+ RelaOffset = MAX_UINT32;
+ RelaSize = 0;
+ RelaCount = 0;
+ RelaEntrySize = 0;
+ RelaType = 0;
+ for ( Index = 0, Dyn = (Elf32_Dyn *) (ElfCt->FileBase + DynShdr->sh_offset)
+ ; Index < DynShdr->sh_size / DynShdr->sh_entsize
Is "sh_entsize" checked for 0?

+ ; Index++, Dyn = ELF_NEXT_ENTRY (Elf32_Dyn, Dyn, DynShdr->sh_entsize)
+ ) {
+ switch (Dyn->d_tag) {
+ case DT_RELA:
+ case DT_REL:
+ //
+ // DT_REL represent program virtual addresses.
+ // A file's virtual addresses might not match the memory virtual addresses during execution.
+ // When interpreting addresses contained in the dynamic structure, the dynamic linker computes actual addresses,
+ // based on the original file value and the memory base address.
+ // For consistency, files do not contain relocation entries to ``correct'' addresses in the dynamic structure.
+ //
+ RelaOffset = Dyn->d_un.d_ptr - (UINT32) (UINTN) ElfCt->PreferredImageAddress;
+ RelaType = (Dyn->d_tag == DT_RELA) ? SHT_RELA: SHT_REL;
+ break;
+ case DT_RELACOUNT:
+ case DT_RELCOUNT:
+ RelaCount = Dyn->d_un.d_val;
+ break;
+ case DT_RELENT:
+ case DT_RELAENT:
+ RelaEntrySize = Dyn->d_un.d_val;
+ break;
+ case DT_RELSZ:
+ case DT_RELASZ:
+ RelaSize = Dyn->d_un.d_val;
+ break;
+ default:
+ break;
+ }
+ }
+
+ if (RelaOffset == MAX_UINT64) {
+ ASSERT (RelaCount == 0);
+ ASSERT (RelaEntrySize == 0);
+ ASSERT (RelaSize == 0);
+ //
+ // It's fine that a DYN ELF doesn't contain relocation section.
+ //
+ return EFI_SUCCESS;
+ }
+
+ //
+ // Verify the existence of the relocation section.
+ //
+ RelShdr = GetElf32SectionByRange (ElfCt->FileBase, RelaOffset, RelaSize);
+ ASSERT (RelShdr != NULL);
+ if (RelShdr == NULL) {
+ return EFI_UNSUPPORTED;
+ }
+ ASSERT (RelShdr->sh_type == RelaType);
+ ASSERT (RelShdr->sh_entsize == RelaEntrySize);
See above.

+
+ //
+ // 3. Process the relocation section.
+ //
+ ProcessRelocation32 (
+ (Elf32_Rela *) (ElfCt->FileBase + RelShdr->sh_offset),
+ RelShdr->sh_size, RelShdr->sh_entsize, RelShdr->sh_type,
+ (UINTN) ElfCt->ImageAddress - (UINTN) ElfCt->PreferredImageAddress,
+ TRUE
+ );
+ return EFI_SUCCESS;
+}
+
+/**
+ Relocate all sections in a ELF image.
+
+ @param[in] ElfCt ELF image context pointer.
+
+ @retval EFI_UNSUPPORTED Relocation is not supported.
+ @retval EFI_SUCCESS ELF image was relocated successfully.
+**/
+EFI_STATUS
+RelocateElf32Sections (
+ IN ELF_IMAGE_CONTEXT *ElfCt
+ )
+{
+ EFI_STATUS Status;
+ Elf32_Ehdr *Ehdr;
+ Elf32_Shdr *RelShdr;
+ Elf32_Shdr *Shdr;
+ UINT32 Index;
+ UINTN Delta;
+
+ Ehdr = (Elf32_Ehdr *)ElfCt->FileBase;
+ if (Ehdr->e_machine != EM_386) {
+ return EFI_UNSUPPORTED;
+ }
+
+ Delta = (UINTN) ElfCt->ImageAddress - (UINTN) ElfCt->PreferredImageAddress;
+ ElfCt->EntryPoint = (UINTN)(Ehdr->e_entry + Delta);
+
+ //
+ // 1. Relocate dynamic ELF using the relocation section pointed by dynamic section
+ //
+ if (Ehdr->e_type == ET_DYN) {
+ DEBUG ((DEBUG_INFO, "DYN ELF: Relocate using dynamic sections...\n"));
+ Status = RelocateElf32Dynamic (ElfCt);
+ ASSERT_EFI_ERROR (Status);
Why cannot this fail?

+ return Status;
+ }
+
+ //
+ // 2. Executable ELF: Fix up the delta between actual image address and preferred image address.
+ //
+ // Linker already fixed up EXEC ELF based on the preferred image address.
+ // A ELF loader in modern OS only loads it into the preferred image address.
+ // The below relocation is unneeded in that case.
+ // But the ELF loader in firmware supports to load the image to a different address.
+ // The below relocation is needed in this case.
+ //
+ DEBUG ((DEBUG_INFO, "EXEC ELF: Fix actual/preferred base address delta ...\n"));
+ for ( Index = 0, RelShdr = (Elf32_Shdr *) (ElfCt->FileBase + Ehdr->e_shoff)
+ ; Index < Ehdr->e_shnum
+ ; Index++, RelShdr = ELF_NEXT_ENTRY (Elf32_Shdr, RelShdr, Ehdr->e_shentsize)
+ ) {
+ if ((RelShdr->sh_type != SHT_REL) && (RelShdr->sh_type != SHT_RELA)) {
+ continue;
+ }
+ Shdr = GetElf32SectionByIndex (ElfCt->FileBase, RelShdr->sh_info);
+ if ((Shdr->sh_flags & SHF_ALLOC) == SHF_ALLOC) {
+ //
+ // Only fix up sections that occupy memory during process execution.
+ //
+ ProcessRelocation32 (
+ (Elf32_Rela *)((UINT8*)Ehdr + RelShdr->sh_offset),
+ RelShdr->sh_size, RelShdr->sh_entsize, RelShdr->sh_type,
+ Delta, FALSE
+ );
+ }
+ }
+
+ return EFI_SUCCESS;
+}
+
+/**
+ Load ELF image which has 32-bit architecture.
+
+ Caller should set Context.ImageAddress to a proper value, either pointing to
+ a new allocated memory whose size equal to Context.ImageSize, or pointing
+ to Context.PreferredImageAddress.
+
+ @param[in] ElfCt ELF image context pointer.
+
+ @retval EFI_SUCCESS ELF binary is loaded successfully.
+ @retval Others Loading ELF binary fails.
+
+**/
+EFI_STATUS
+LoadElf32Image (
+ IN ELF_IMAGE_CONTEXT *ElfCt
+ )
+{
+ Elf32_Ehdr *Ehdr;
+ Elf32_Phdr *Phdr;
+ UINT16 Index;
+ UINTN Delta;
+
+ ASSERT (ElfCt != NULL);
+
+ //
+ // Per the sprit of ELF, loading to memory only consumes info from program headers.
+ //
+ Ehdr = (Elf32_Ehdr *)ElfCt->FileBase;
+
+ for ( Index = 0, Phdr = (Elf32_Phdr *)(ElfCt->FileBase + Ehdr->e_phoff)
+ ; Index < Ehdr->e_phnum
+ ; Index++, Phdr = ELF_NEXT_ENTRY (Elf32_Phdr, Phdr, Ehdr->e_phentsize)
+ ) {
+ //
+ // Skip segments that don't require load (type tells, or size is 0)
+ //
+ if ((Phdr->p_type != PT_LOAD) ||
+ (Phdr->p_memsz == 0)) {
+ continue;
+ }
+
+ //
+ // The memory offset of segment relative to the image base
+ // Note: CopyMem() does nothing when the dst equals to src.
+ //
+ Delta = Phdr->p_paddr - (UINT32) (UINTN) ElfCt->PreferredImageAddress;
+ CopyMem (ElfCt->ImageAddress + Delta, ElfCt->FileBase + Phdr->p_offset, Phdr->p_filesz);
+ ZeroMem (ElfCt->ImageAddress + Delta + Phdr->p_filesz, Phdr->p_memsz - Phdr->p_filesz);
+ }
+
+ //
+ // Relocate when new new image base is not the preferred image base.
+ //
+ if (ElfCt->ImageAddress != ElfCt->PreferredImageAddress) {
+ RelocateElf32Sections (ElfCt);
+ }
+
+ return EFI_SUCCESS;
+}
diff --git a/UefiPayloadPkg/PayloadLoaderPeim/ElfLib/Elf64.h b/UefiPayloadPkg/PayloadLoaderPeim/ElfLib/Elf64.h
new file mode 100644
index 0000000000..d64dc64a6a
--- /dev/null
+++ b/UefiPayloadPkg/PayloadLoaderPeim/ElfLib/Elf64.h
@@ -0,0 +1,254 @@
+/** @file
+Ported ELF include files from FreeBSD
+
+Copyright (c) 2009 - 2010, Apple Inc. All rights reserved.<BR>
+SPDX-License-Identifier: BSD-2-Clause-Patent
+
+**/
+/*-
+ * Copyright (c) 1996-1998 John D. Polstra.
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ * 1. Redistributions of source code must retain the above copyright
+ * notice, this list of conditions and the following disclaimer.
+ * 2. Redistributions in binary form must reproduce the above copyright
+ * notice, this list of conditions and the following disclaimer in the
+ * documentation and/or other materials provided with the distribution.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
+ * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+ * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
+ * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
+ * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+ * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
+ * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
+ * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+ * SUCH DAMAGE.
+ *
+ * $FreeBSD: src/sys/sys/elf64.h,v 1.10.14.2 2007/12/03 21:30:36 marius Exp $
+ */
+
+#ifndef _SYS_ELF64_H_
+#define _SYS_ELF64_H_ 1
+
+
+/*
+ * ELF definitions common to all 64-bit architectures.
+ */
+
+typedef UINT64 Elf64_Addr;
+typedef UINT16 Elf64_Half;
+typedef UINT64 Elf64_Off;
+typedef INT32 Elf64_Sword;
+typedef INT64 Elf64_Sxword;
+typedef UINT32 Elf64_Word;
+typedef UINT64 Elf64_Lword;
+typedef UINT64 Elf64_Xword;
+
+/*
+ * Types of dynamic symbol hash table bucket and chain elements.
+ *
+ * This is inconsistent among 64 bit architectures, so a machine dependent
+ * typedef is required.
+ */
+
+typedef Elf64_Word Elf64_Hashelt;
+
+/* Non-standard class-dependent datatype used for abstraction. */
+typedef Elf64_Xword Elf64_Size;
+typedef Elf64_Sxword Elf64_Ssize;
+
+/*
+ * ELF header.
+ */
+
+typedef struct {
+ unsigned char e_ident[EI_NIDENT]; /* File identification. */
+ Elf64_Half e_type; /* File type. */
+ Elf64_Half e_machine; /* Machine architecture. */
+ Elf64_Word e_version; /* ELF format version. */
+ Elf64_Addr e_entry; /* Entry point. */
+ Elf64_Off e_phoff; /* Program header file offset. */
+ Elf64_Off e_shoff; /* Section header file offset. */
+ Elf64_Word e_flags; /* Architecture-specific flags. */
+ Elf64_Half e_ehsize; /* Size of ELF header in bytes. */
+ Elf64_Half e_phentsize; /* Size of program header entry. */
+ Elf64_Half e_phnum; /* Number of program header entries. */
+ Elf64_Half e_shentsize; /* Size of section header entry. */
+ Elf64_Half e_shnum; /* Number of section header entries. */
+ Elf64_Half e_shstrndx; /* Section name strings section. */
+} Elf64_Ehdr;
+
+/*
+ * Section header.
+ */
+
+typedef struct {
+ Elf64_Word sh_name; /* Section name (index into the
+ section header string table). */
+ Elf64_Word sh_type; /* Section type. */
+ Elf64_Xword sh_flags; /* Section flags. */
+ Elf64_Addr sh_addr; /* Address in memory image. */
+ Elf64_Off sh_offset; /* Offset in file. */
+ Elf64_Xword sh_size; /* Size in bytes. */
+ Elf64_Word sh_link; /* Index of a related section. */
+ Elf64_Word sh_info; /* Depends on section type. */
+ Elf64_Xword sh_addralign; /* Alignment in bytes. */
+ Elf64_Xword sh_entsize; /* Size of each entry in section. */
+} Elf64_Shdr;
+
+/*
+ * Program header.
+ */
+
+typedef struct {
+ Elf64_Word p_type; /* Entry type. */
+ Elf64_Word p_flags; /* Access permission flags. */
+ Elf64_Off p_offset; /* File offset of contents. */
+ Elf64_Addr p_vaddr; /* Virtual address in memory image. */
+ Elf64_Addr p_paddr; /* Physical address (not used). */
+ Elf64_Xword p_filesz; /* Size of contents in file. */
+ Elf64_Xword p_memsz; /* Size of contents in memory. */
+ Elf64_Xword p_align; /* Alignment in memory and file. */
+} Elf64_Phdr;
+
+/*
+ * Dynamic structure. The ".dynamic" section contains an array of them.
+ */
+
+typedef struct {
+ Elf64_Sxword d_tag; /* Entry type. */
+ union {
+ Elf64_Xword d_val; /* Integer value. */
+ Elf64_Addr d_ptr; /* Address value. */
+ } d_un;
+} Elf64_Dyn;
+
+/*
+ * Relocation entries.
+ */
+
+/* Relocations that don't need an addend field. */
+typedef struct {
+ Elf64_Addr r_offset; /* Location to be relocated. */
+ Elf64_Xword r_info; /* Relocation type and symbol index. */
+} Elf64_Rel;
+
+/* Relocations that need an addend field. */
+typedef struct {
+ Elf64_Addr r_offset; /* Location to be relocated. */
+ Elf64_Xword r_info; /* Relocation type and symbol index. */
+ Elf64_Sxword r_addend; /* Addend. */
+} Elf64_Rela;
+
+/* Macros for accessing the fields of r_info. */
+#define ELF64_R_SYM(info) ((UINT32) RShiftU64 ((info), 32))
+#define ELF64_R_TYPE(info) ((info) & 0xffffffffL)
+
+/* Macro for constructing r_info from field values. */
+#define ELF64_R_INFO(sym, type) (((sym) << 32) + ((type) & 0xffffffffL))
+
+#define ELF64_R_TYPE_DATA(info) (((Elf64_Xword)(info)<<32)>>40)
+#define ELF64_R_TYPE_ID(info) (((Elf64_Xword)(info)<<56)>>56)
+#define ELF64_R_TYPE_INFO(data, type) \
+ (((Elf64_Xword)(data)<<8)+(Elf64_Xword)(type))
+
+/*
+ * Note entry header
+ */
+typedef Elf_Note Elf64_Nhdr;
+
+/*
+ * Move entry
+ */
+typedef struct {
+ Elf64_Lword m_value; /* symbol value */
+ Elf64_Xword m_info; /* size + index */
+ Elf64_Xword m_poffset; /* symbol offset */
+ Elf64_Half m_repeat; /* repeat count */
+ Elf64_Half m_stride; /* stride info */
+} Elf64_Move;
+
+#define ELF64_M_SYM(info) ((info)>>8)
+#define ELF64_M_SIZE(info) ((unsigned char)(info))
+#define ELF64_M_INFO(sym, size) (((sym)<<8)+(unsigned char)(size))
+
+/*
+ * Hardware/Software capabilities entry
+ */
+typedef struct {
+ Elf64_Xword c_tag; /* how to interpret value */
+ union {
+ Elf64_Xword c_val;
+ Elf64_Addr c_ptr;
+ } c_un;
+} Elf64_Cap;
+
+/*
+ * Symbol table entries.
+ */
+
+typedef struct {
+ Elf64_Word st_name; /* String table index of name. */
+ unsigned char st_info; /* Type and binding information. */
+ unsigned char st_other; /* Reserved (not used). */
+ Elf64_Half st_shndx; /* Section index of symbol. */
+ Elf64_Addr st_value; /* Symbol value. */
+ Elf64_Xword st_size; /* Size of associated object. */
+} Elf64_Sym;
+
+/* Macros for accessing the fields of st_info. */
+#define ELF64_ST_BIND(info) ((info) >> 4)
+#define ELF64_ST_TYPE(info) ((info) & 0xf)
+
+/* Macro for constructing st_info from field values. */
+#define ELF64_ST_INFO(bind, type) (((bind) << 4) + ((type) & 0xf))
+
+/* Macro for accessing the fields of st_other. */
+#define ELF64_ST_VISIBILITY(oth) ((oth) & 0x3)
+
+/* Structures used by Sun & GNU-style symbol versioning. */
+typedef struct {
+ Elf64_Half vd_version;
+ Elf64_Half vd_flags;
+ Elf64_Half vd_ndx;
+ Elf64_Half vd_cnt;
+ Elf64_Word vd_hash;
+ Elf64_Word vd_aux;
+ Elf64_Word vd_next;
+} Elf64_Verdef;
+
+typedef struct {
+ Elf64_Word vda_name;
+ Elf64_Word vda_next;
+} Elf64_Verdaux;
+
+typedef struct {
+ Elf64_Half vn_version;
+ Elf64_Half vn_cnt;
+ Elf64_Word vn_file;
+ Elf64_Word vn_aux;
+ Elf64_Word vn_next;
+} Elf64_Verneed;
+
+typedef struct {
+ Elf64_Word vna_hash;
+ Elf64_Half vna_flags;
+ Elf64_Half vna_other;
+ Elf64_Word vna_name;
+ Elf64_Word vna_next;
+} Elf64_Vernaux;
+
+typedef Elf64_Half Elf64_Versym;
+
+typedef struct {
+ Elf64_Half si_boundto; /* direct bindings - symbol bound to */
+ Elf64_Half si_flags; /* per symbol flags */
+} Elf64_Syminfo;
+
+#endif /* !_SYS_ELF64_H_ */
diff --git a/UefiPayloadPkg/PayloadLoaderPeim/ElfLib/Elf64Lib.c b/UefiPayloadPkg/PayloadLoaderPeim/ElfLib/Elf64Lib.c
new file mode 100644
index 0000000000..e364807007
--- /dev/null
+++ b/UefiPayloadPkg/PayloadLoaderPeim/ElfLib/Elf64Lib.c
@@ -0,0 +1,460 @@
+/** @file
+ ELF library
+
+ Copyright (c) 2019 - 2021, Intel Corporation. All rights reserved.<BR>
+ SPDX-License-Identifier: BSD-2-Clause-Patent
+
+**/
+
+#include "ElfLibInternal.h"
+
+/**
+ Return the section header specified by Index.
+
+ @param ImageBase The image base.
+ @param Index The section index.
+
+ @return Pointer to the section header.
+**/
+Elf64_Shdr *
+GetElf64SectionByIndex (
+ IN UINT8 *ImageBase,
+ IN UINT32 Index
+ )
+{
+ Elf64_Ehdr *Ehdr;
+
+ Ehdr = (Elf64_Ehdr *)ImageBase;
+ if (Index >= Ehdr->e_shnum) {
+ return NULL;
+ }
+
+ return (Elf64_Shdr *)(ImageBase + Ehdr->e_shoff + Index * Ehdr->e_shentsize);
+}
+
+/**
+ Return the segment header specified by Index.
+
+ @param ImageBase The image base.
+ @param Index The segment index.
+
+ @return Pointer to the segment header.
+**/
+Elf64_Phdr *
+GetElf64SegmentByIndex (
+ IN UINT8 *ImageBase,
+ IN UINT32 Index
+ )
+{
+ Elf64_Ehdr *Ehdr;
+
+ Ehdr = (Elf64_Ehdr *)ImageBase;
+ if (Index >= Ehdr->e_phnum) {
+ return NULL;
+ }
+
+ return (Elf64_Phdr *)(ImageBase + Ehdr->e_phoff + Index * Ehdr->e_phentsize);
Alignment checks? Bounds checks?

+}
+
+/**
+ Return the section header specified by the range.
+
+ @param ImageBase The image base.
+ @param Offset The section offset.
+ @param Size The section size.
+
+ @return Pointer to the section header.
+**/
+Elf64_Shdr *
+GetElf64SectionByRange (
+ IN UINT8 *ImageBase,
+ IN UINT64 Offset,
+ IN UINT64 Size
+ )
+{
+ UINT32 Index;
+ Elf64_Ehdr *Ehdr;
+ Elf64_Shdr *Shdr;
+
+ Ehdr = (Elf64_Ehdr *)ImageBase;
+
+ Shdr = (Elf64_Shdr *) (ImageBase + Ehdr->e_shoff);
+ for (Index = 0; Index < Ehdr->e_shnum; Index++) {
+ if ((Shdr->sh_offset == Offset) && (Shdr->sh_size == Size)) {
+ return Shdr;
+ }
+ Shdr = ELF_NEXT_ENTRY (Elf64_Shdr, Shdr, Ehdr->e_shentsize);
+ }
+ return NULL;
+}
+
+/**
+ Fix up the image based on the relocation entries.
+
+ @param Rela Relocation entries.
+ @param RelaSize Total size of relocation entries.
+ @param RelaEntrySize Relocation entry size.
+ @param RelaType Type of relocation entry.
+ @param Delta The delta between preferred image base and the actual image base.
+ @param DynamicLinking TRUE when fixing up according to dynamic relocation.
+
+ @retval EFI_SUCCESS The image fix up is processed successfully.
+**/
+EFI_STATUS
+ProcessRelocation64 (
+ IN Elf64_Rela *Rela,
+ IN UINT64 RelaSize,
+ IN UINT64 RelaEntrySize,
+ IN UINT64 RelaType,
+ IN INTN Delta,
+ IN BOOLEAN DynamicLinking
+ )
+{
+ UINTN Index;
+ UINT64 *Ptr;
+ UINT32 Type;
+
+ for ( Index = 0
+ ; MultU64x64 (RelaEntrySize, Index) < RelaSize
+ ; Index++, Rela = ELF_NEXT_ENTRY (Elf64_Rela, Rela, RelaEntrySize)
+ ) {
+ //
+ // r_offset is the virtual address of the storage unit affected by the relocation.
+ //
+ Ptr = (UINT64 *)(UINTN)(Rela->r_offset + Delta);
+ Type = ELF64_R_TYPE(Rela->r_info);
+ switch (Type) {
+ case R_X86_64_NONE:
+ case R_X86_64_PC32:
+ case R_X86_64_PLT32:
+ case R_X86_64_GOTPCREL:
+ case R_X86_64_GOTPCRELX:
+ case R_X86_64_REX_GOTPCRELX:
+ break;
+
+ case R_X86_64_64:
+ if (DynamicLinking) {
+ //
+ // Dynamic section doesn't contain entries of this type.
+ //
+ DEBUG ((DEBUG_INFO, "Unsupported relocation type %02X\n", Type));
+ ASSERT (FALSE);
+ } else {
+ *Ptr += Delta;
+ }
+ break;
+
+ case R_X86_64_32:
+ //
+ // Dynamic section doesn't contain entries of this type.
+ //
+ DEBUG ((DEBUG_INFO, "Unsupported relocation type %02X\n", Type));
+ ASSERT (FALSE);
+ break;
+
+ case R_X86_64_RELATIVE:
+ if (DynamicLinking) {
+ //
+ // A: Represents the addend used to compute the value of the relocatable field.
+ // B: Represents the base address at which a shared object has been loaded into memory during execution.
+ // Generally, a shared object is built with a 0 base virtual address, but the execution address will be different.
+ //
+ // B (Base Address) in ELF spec is slightly different:
+ // An executable or shared object file's base address (on platforms that support the concept) is calculated during
+ // execution from three values: the virtual memory load address, the maximum page size, and the lowest virtual address
+ // of a program's loadable segment. To compute the base address, one determines the memory address associated with the
+ // lowest p_vaddr value for a PT_LOAD segment. This address is truncated to the nearest multiple of the maximum page size.
+ // The corresponding p_vaddr value itself is also truncated to the nearest multiple of the maximum page size.
+ //
+ // *** The base address is the difference between the truncated memory address and the truncated p_vaddr value. ***
+ //
+ // Delta in this function is B.
+ //
+ // Calculation: B + A
+ //
+ if (RelaType == SHT_RELA) {
+ ASSERT (*Ptr == 0);
+ *Ptr = Delta + Rela->r_addend;
+ } else {
+ //
+ // A is stored in the field of relocation for REL type.
+ //
+ *Ptr = Delta + *Ptr;
+ }
+ } else {
+ //
+ // non-Dynamic section doesn't contain entries of this type.
+ //
+ DEBUG ((DEBUG_INFO, "Unsupported relocation type %02X\n", Type));
+ ASSERT (FALSE);
+ }
+ break;
+
+ default:
+ DEBUG ((DEBUG_INFO, "Unsupported relocation type %02X\n", Type));
+ }
+ }
+ return EFI_SUCCESS;
+}
+
+/**
+ Relocate the DYN type image.
+
+ @param ElfCt Point to image context.
+
+ @retval EFI_SUCCESS The relocation succeeds.
+ @retval EFI_UNSUPPORTED The image doesn't contain a dynamic section.
+**/
+EFI_STATUS
+RelocateElf64Dynamic (
+ IN ELF_IMAGE_CONTEXT *ElfCt
+ )
+{
+ UINT32 Index;
+ Elf64_Phdr *Phdr;
+ Elf64_Shdr *DynShdr;
+ Elf64_Shdr *RelShdr;
+ Elf64_Dyn *Dyn;
+ UINT64 RelaOffset;
+ UINT64 RelaCount;
+ UINT64 RelaSize;
+ UINT64 RelaEntrySize;
+ UINT64 RelaType;
+
+ //
+ // 1. Locate the dynamic section.
+ //
+ // If an object file participates in dynamic linking, its program header table
+ // will have an element of type PT_DYNAMIC.
+ // This ``segment'' contains the .dynamic section. A special symbol, _DYNAMIC,
+ // labels the section, which contains an array of Elf32_Dyn or Elf64_Dyn.
+ //
+ DynShdr = NULL;
+ for (Index = 0; Index < ElfCt->PhNum; Index++) {
+ Phdr = GetElf64SegmentByIndex (ElfCt->FileBase, Index);
+ ASSERT (Phdr != NULL);
+ if (Phdr->p_type == PT_DYNAMIC) {
+ //
+ // Verify the existence of the dynamic section.
+ //
+ DynShdr = GetElf64SectionByRange (ElfCt->FileBase, Phdr->p_offset, Phdr->p_filesz);
+ break;
+ }
+ }
+
+ //
+ // It's abnormal a DYN ELF doesn't contain a dynamic section.
+ //
+ ASSERT (DynShdr != NULL);
+ if (DynShdr == NULL) {
+ return EFI_UNSUPPORTED;
+ }
+ ASSERT (DynShdr->sh_type == SHT_DYNAMIC);
+ ASSERT (DynShdr->sh_entsize >= sizeof (*Dyn));
+
+ //
+ // 2. Locate the relocation section from the dynamic section.
+ //
+ RelaOffset = MAX_UINT64;
+ RelaSize = 0;
+ RelaCount = 0;
+ RelaEntrySize = 0;
+ RelaType = 0;
+ for ( Index = 0, Dyn = (Elf64_Dyn *) (ElfCt->FileBase + DynShdr->sh_offset)
+ ; Index < DivU64x64Remainder (DynShdr->sh_size, DynShdr->sh_entsize, NULL)
+ ; Index++, Dyn = ELF_NEXT_ENTRY (Elf64_Dyn, Dyn, DynShdr->sh_entsize)
+ ) {
+ switch (Dyn->d_tag) {
+ case DT_RELA:
+ case DT_REL:
+ //
+ // DT_REL represent program virtual addresses.
+ // A file's virtual addresses might not match the memory virtual addresses during execution.
+ // When interpreting addresses contained in the dynamic structure, the dynamic linker computes actual addresses,
+ // based on the original file value and the memory base address.
+ // For consistency, files do not contain relocation entries to ``correct'' addresses in the dynamic structure.
+ //
+ RelaOffset = Dyn->d_un.d_ptr - (UINTN) ElfCt->PreferredImageAddress;
+ RelaType = (Dyn->d_tag == DT_RELA) ? SHT_RELA: SHT_REL;
+ break;
+ case DT_RELACOUNT:
+ case DT_RELCOUNT:
+ RelaCount = Dyn->d_un.d_val;
+ break;
+ case DT_RELENT:
+ case DT_RELAENT:
+ RelaEntrySize = Dyn->d_un.d_val;
+ break;
+ case DT_RELSZ:
+ case DT_RELASZ:
+ RelaSize = Dyn->d_un.d_val;
+ break;
+ default:
+ break;
+ }
+ }
+
+ if (RelaOffset == MAX_UINT64) {
+ ASSERT (RelaCount == 0);
+ ASSERT (RelaEntrySize == 0);
+ ASSERT (RelaSize == 0);
+ //
+ // It's fine that a DYN ELF doesn't contain relocation section.
+ //
+ return EFI_SUCCESS;
+ }
+
+ //
+ // Verify the existence of the relocation section.
+ //
+ RelShdr = GetElf64SectionByRange (ElfCt->FileBase, RelaOffset, RelaSize);
+ ASSERT (RelShdr != NULL);
+ if (RelShdr == NULL) {
+ return EFI_UNSUPPORTED;
+ }
+ ASSERT (RelShdr->sh_type == RelaType);
+ ASSERT (RelShdr->sh_entsize == RelaEntrySize);
+
+ //
+ // 3. Process the relocation section.
+ //
+ ProcessRelocation64 (
+ (Elf64_Rela *) (ElfCt->FileBase + RelShdr->sh_offset),
Alignment? :) I know there is no real concept in EDK II yet, but it really is needed.

+ RelShdr->sh_size, RelShdr->sh_entsize, RelShdr->sh_type,
+ (UINTN) ElfCt->ImageAddress - (UINTN) ElfCt->PreferredImageAddress,
+ TRUE
+ );
+ return EFI_SUCCESS;
+}
+
+/**
+ Relocate all sections in a ELF image.
+
+ @param[in] ElfCt ELF image context pointer.
+
+ @retval EFI_UNSUPPORTED Relocation is not supported.
+ @retval EFI_SUCCESS ELF image was relocated successfully.
+**/
+EFI_STATUS
+RelocateElf64Sections (
+ IN ELF_IMAGE_CONTEXT *ElfCt
+ )
+{
+ EFI_STATUS Status;
+ Elf64_Ehdr *Ehdr;
+ Elf64_Shdr *RelShdr;
+ Elf64_Shdr *Shdr;
+ UINT32 Index;
+ UINTN Delta;
+
+ Ehdr = (Elf64_Ehdr *)ElfCt->FileBase;
+ if (Ehdr->e_machine != EM_X86_64) {
+ return EFI_UNSUPPORTED;
+ }
+
+ Delta = (UINTN) ElfCt->ImageAddress - (UINTN) ElfCt->PreferredImageAddress;
+ ElfCt->EntryPoint = (UINTN)(Ehdr->e_entry + Delta);
+
+ //
+ // 1. Relocate dynamic ELF using the relocation section pointed by dynamic section
+ //
+ if (Ehdr->e_type == ET_DYN) {
+ DEBUG ((DEBUG_INFO, "DYN ELF: Relocate using dynamic sections...\n"));
+ Status = RelocateElf64Dynamic (ElfCt);
+ ASSERT_EFI_ERROR (Status);
+ return Status;
+ }
+
+ //
+ // 2. Executable ELF: Fix up the delta between actual image address and preferred image address.
+ //
+ // Linker already fixed up EXEC ELF based on the preferred image address.
+ // A ELF loader in modern OS only loads it into the preferred image address.
+ // The below relocation is unneeded in that case.
+ // But the ELF loader in firmware supports to load the image to a different address.
+ // The below relocation is needed in this case.
+ //
+ DEBUG ((DEBUG_INFO, "EXEC ELF: Fix actual/preferred base address delta ...\n"));
+ for ( Index = 0, RelShdr = (Elf64_Shdr *) (ElfCt->FileBase + Ehdr->e_shoff)
+ ; Index < Ehdr->e_shnum
+ ; Index++, RelShdr = ELF_NEXT_ENTRY (Elf64_Shdr, RelShdr, Ehdr->e_shentsize)
+ ) {
+ if ((RelShdr->sh_type != SHT_REL) && (RelShdr->sh_type != SHT_RELA)) {
+ continue;
+ }
+ Shdr = GetElf64SectionByIndex (ElfCt->FileBase, RelShdr->sh_info);
+ if ((Shdr->sh_flags & SHF_ALLOC) == SHF_ALLOC) {
+ //
+ // Only fix up sections that occupy memory during process execution.
+ //
+ ProcessRelocation64 (
+ (Elf64_Rela *)((UINT8*)Ehdr + RelShdr->sh_offset),
+ RelShdr->sh_size, RelShdr->sh_entsize, RelShdr->sh_type,
+ Delta, FALSE
+ );
+ }
+ }
+
+ return EFI_SUCCESS;
+}
+
+/**
+ Load ELF image which has 64-bit architecture.
+
+ Caller should set Context.ImageAddress to a proper value, either pointing to
+ a new allocated memory whose size equal to Context.ImageSize, or pointing
+ to Context.PreferredImageAddress.
+
+ @param[in] ElfCt ELF image context pointer.
+
+ @retval EFI_SUCCESS ELF binary is loaded successfully.
+ @retval Others Loading ELF binary fails.
+
+**/
+EFI_STATUS
+LoadElf64Image (
+ IN ELF_IMAGE_CONTEXT *ElfCt
+ )
+{
+ Elf64_Ehdr *Ehdr;
+ Elf64_Phdr *Phdr;
+ UINT16 Index;
+ UINTN Delta;
+
+ ASSERT (ElfCt != NULL);
+
+ //
+ // Per the sprit of ELF, loading to memory only consumes info from program headers.
+ //
+ Ehdr = (Elf64_Ehdr *)ElfCt->FileBase;
+
+ for ( Index = 0, Phdr = (Elf64_Phdr *)(ElfCt->FileBase + Ehdr->e_phoff)
+ ; Index < Ehdr->e_phnum
+ ; Index++, Phdr = ELF_NEXT_ENTRY (Elf64_Phdr, Phdr, Ehdr->e_phentsize)
+ ) {
+ //
+ // Skip segments that don't require load (type tells, or size is 0)
+ //
+ if ((Phdr->p_type != PT_LOAD) ||
+ (Phdr->p_memsz == 0)) {
+ continue;
+ }
+
+ //
+ // The memory offset of segment relative to the image base
+ // Note: CopyMem() does nothing when the dst equals to src.
+ //
+ Delta = (UINTN) Phdr->p_paddr - (UINTN) ElfCt->PreferredImageAddress;
+ CopyMem (ElfCt->ImageAddress + Delta, ElfCt->FileBase + (UINTN) Phdr->p_offset, (UINTN) Phdr->p_filesz);
+ ZeroMem (ElfCt->ImageAddress + Delta + (UINTN) Phdr->p_filesz, (UINTN) (Phdr->p_memsz - Phdr->p_filesz));
+ }
+
+ //
+ // Relocate when new new image base is not the preferred image base.
+ //
+ if (ElfCt->ImageAddress != ElfCt->PreferredImageAddress) {
+ RelocateElf64Sections (ElfCt);
+ }
+
+ return EFI_SUCCESS;
+}
diff --git a/UefiPayloadPkg/PayloadLoaderPeim/ElfLib/ElfCommon.h b/UefiPayloadPkg/PayloadLoaderPeim/ElfLib/ElfCommon.h
new file mode 100644
index 0000000000..15c9e33d3f
--- /dev/null
+++ b/UefiPayloadPkg/PayloadLoaderPeim/ElfLib/ElfCommon.h
@@ -0,0 +1,983 @@
+/** @file
+Ported ELF include files from FreeBSD
+
+Copyright (c) 2009 - 2010, Apple Inc. All rights reserved.<BR>
+Portions Copyright (c) 2011 - 2013, ARM Ltd. All rights reserved.<BR>
+SPDX-License-Identifier: BSD-2-Clause-Patent
+
+
+**/
+/*-
+ * Copyright (c) 1998 John D. Polstra.
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ * 1. Redistributions of source code must retain the above copyright
+ * notice, this list of conditions and the following disclaimer.
+ * 2. Redistributions in binary form must reproduce the above copyright
+ * notice, this list of conditions and the following disclaimer in the
+ * documentation and/or other materials provided with the distribution.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
+ * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+ * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
+ * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
+ * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+ * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
+ * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
+ * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+ * SUCH DAMAGE.
+ *
+ * $FreeBSD: src/sys/sys/elf_common.h,v 1.15.8.2 2007/12/03 21:30:36 marius Exp $
+ */
+
+#ifndef _SYS_ELF_COMMON_H_
+#define _SYS_ELF_COMMON_H_ 1
+
+/*
+ * ELF definitions that are independent of architecture or word size.
+ */
+
+/*
+ * Note header. The ".note" section contains an array of notes. Each
+ * begins with this header, aligned to a word boundary. Immediately
+ * following the note header is n_namesz bytes of name, padded to the
+ * next word boundary. Then comes n_descsz bytes of descriptor, again
+ * padded to a word boundary. The values of n_namesz and n_descsz do
+ * not include the padding.
+ */
+
+typedef struct {
+ UINT32 n_namesz; /* Length of name. */
+ UINT32 n_descsz; /* Length of descriptor. */
+ UINT32 n_type; /* Type of this note. */
+} Elf_Note;
+
+/* Indexes into the e_ident array. Keep synced with
+ http://www.sco.com/developers/gabi/latest/ch4.eheader.html */
+#define EI_MAG0 0 /* Magic number, byte 0. */
+#define EI_MAG1 1 /* Magic number, byte 1. */
+#define EI_MAG2 2 /* Magic number, byte 2. */
+#define EI_MAG3 3 /* Magic number, byte 3. */
+#define EI_CLASS 4 /* Class of machine. */
+#define EI_DATA 5 /* Data format. */
+#define EI_VERSION 6 /* ELF format version. */
+#define EI_OSABI 7 /* Operating system / ABI identification */
+#define EI_ABIVERSION 8 /* ABI version */
+#define OLD_EI_BRAND 8 /* Start of architecture identification. */
+#define EI_PAD 9 /* Start of padding (per SVR4 ABI). */
+#define EI_NIDENT 16 /* Size of e_ident array. */
+
+/* Values for the magic number bytes. */
+#define ELFMAG0 0x7f
+#define ELFMAG1 'E'
+#define ELFMAG2 'L'
+#define ELFMAG3 'F'
+#define ELFMAG "\177ELF" /* magic string */
+#define SELFMAG 4 /* magic string size */
+
+/* Values for e_ident[EI_VERSION] and e_version. */
+#define EV_NONE 0
+#define EV_CURRENT 1
+
+/* Values for e_ident[EI_CLASS]. */
+#define ELFCLASSNONE 0 /* Unknown class. */
+#define ELFCLASS32 1 /* 32-bit architecture. */
+#define ELFCLASS64 2 /* 64-bit architecture. */
+
+/* Values for e_ident[EI_DATA]. */
+#define ELFDATANONE 0 /* Unknown data format. */
+#define ELFDATA2LSB 1 /* 2's complement little-endian. */
+#define ELFDATA2MSB 2 /* 2's complement big-endian. */
+
+/* Values for e_ident[EI_OSABI]. */
+#define ELFOSABI_NONE 0 /* UNIX System V ABI */
+#define ELFOSABI_HPUX 1 /* HP-UX operating system */
+#define ELFOSABI_NETBSD 2 /* NetBSD */
+#define ELFOSABI_LINUX 3 /* GNU/Linux */
+#define ELFOSABI_HURD 4 /* GNU/Hurd */
+#define ELFOSABI_86OPEN 5 /* 86Open common IA32 ABI */
+#define ELFOSABI_SOLARIS 6 /* Solaris */
+#define ELFOSABI_AIX 7 /* AIX */
+#define ELFOSABI_IRIX 8 /* IRIX */
+#define ELFOSABI_FREEBSD 9 /* FreeBSD */
+#define ELFOSABI_TRU64 10 /* TRU64 UNIX */
+#define ELFOSABI_MODESTO 11 /* Novell Modesto */
+#define ELFOSABI_OPENBSD 12 /* OpenBSD */
+#define ELFOSABI_OPENVMS 13 /* Open VMS */
+#define ELFOSABI_NSK 14 /* HP Non-Stop Kernel */
+#define ELFOSABI_ARM 97 /* ARM */
+#define ELFOSABI_STANDALONE 255 /* Standalone (embedded) application */
+
+#define ELFOSABI_SYSV ELFOSABI_NONE /* symbol used in old spec */
+#define ELFOSABI_MONTEREY ELFOSABI_AIX /* Monterey */
+
+/* e_ident */
+#define IS_ELF(ehdr) ((ehdr).e_ident[EI_MAG0] == ELFMAG0 && \
+ (ehdr).e_ident[EI_MAG1] == ELFMAG1 && \
+ (ehdr).e_ident[EI_MAG2] == ELFMAG2 && \
+ (ehdr).e_ident[EI_MAG3] == ELFMAG3)
+
+/* Values for e_type. */
+#define ET_NONE 0 /* Unknown type. */
+#define ET_REL 1 /* Relocatable. */
+#define ET_EXEC 2 /* Executable. */
+#define ET_DYN 3 /* Shared object. */
+#define ET_CORE 4 /* Core file. */
+#define ET_LOOS 0xfe00 /* First operating system specific. */
+#define ET_HIOS 0xfeff /* Last operating system-specific. */
+#define ET_LOPROC 0xff00 /* First processor-specific. */
+#define ET_HIPROC 0xffff /* Last processor-specific. */
+
+/* Values for e_machine. */
+#define EM_NONE 0 /* Unknown machine. */
+#define EM_M32 1 /* AT&T WE32100. */
+#define EM_SPARC 2 /* Sun SPARC. */
+#define EM_386 3 /* Intel i386. */
+#define EM_68K 4 /* Motorola 68000. */
+#define EM_88K 5 /* Motorola 88000. */
+#define EM_860 7 /* Intel i860. */
+#define EM_MIPS 8 /* MIPS R3000 Big-Endian only. */
+#define EM_S370 9 /* IBM System/370. */
+#define EM_MIPS_RS3_LE 10 /* MIPS R3000 Little-Endian. */
+#define EM_PARISC 15 /* HP PA-RISC. */
+#define EM_VPP500 17 /* Fujitsu VPP500. */
+#define EM_SPARC32PLUS 18 /* SPARC v8plus. */
+#define EM_960 19 /* Intel 80960. */
+#define EM_PPC 20 /* PowerPC 32-bit. */
+#define EM_PPC64 21 /* PowerPC 64-bit. */
+#define EM_S390 22 /* IBM System/390. */
+#define EM_V800 36 /* NEC V800. */
+#define EM_FR20 37 /* Fujitsu FR20. */
+#define EM_RH32 38 /* TRW RH-32. */
+#define EM_RCE 39 /* Motorola RCE. */
+#define EM_ARM 40 /* ARM. */
+#define EM_SH 42 /* Hitachi SH. */
+#define EM_SPARCV9 43 /* SPARC v9 64-bit. */
+#define EM_TRICORE 44 /* Siemens TriCore embedded processor. */
+#define EM_ARC 45 /* Argonaut RISC Core. */
+#define EM_H8_300 46 /* Hitachi H8/300. */
+#define EM_H8_300H 47 /* Hitachi H8/300H. */
+#define EM_H8S 48 /* Hitachi H8S. */
+#define EM_H8_500 49 /* Hitachi H8/500. */
+#define EM_MIPS_X 51 /* Stanford MIPS-X. */
+#define EM_COLDFIRE 52 /* Motorola ColdFire. */
+#define EM_68HC12 53 /* Motorola M68HC12. */
+#define EM_MMA 54 /* Fujitsu MMA. */
+#define EM_PCP 55 /* Siemens PCP. */
+#define EM_NCPU 56 /* Sony nCPU. */
+#define EM_NDR1 57 /* Denso NDR1 microprocessor. */
+#define EM_STARCORE 58 /* Motorola Star*Core processor. */
+#define EM_ME16 59 /* Toyota ME16 processor. */
+#define EM_ST100 60 /* STMicroelectronics ST100 processor. */
+#define EM_TINYJ 61 /* Advanced Logic Corp. TinyJ processor. */
+#define EM_X86_64 62 /* Advanced Micro Devices x86-64 */
+#define EM_AMD64 EM_X86_64 /* Advanced Micro Devices x86-64 (compat) */
+#define EM_AARCH64 183 /* ARM 64bit Architecture */
+
+/* Non-standard or deprecated. */
+#define EM_486 6 /* Intel i486. */
+#define EM_MIPS_RS4_BE 10 /* MIPS R4000 Big-Endian */
+#define EM_ALPHA_STD 41 /* Digital Alpha (standard value). */
+#define EM_ALPHA 0x9026 /* Alpha (written in the absence of an ABI) */
+
+/* Special section indexes. */
+#define SHN_UNDEF 0 /* Undefined, missing, irrelevant. */
+#define SHN_LORESERVE 0xff00 /* First of reserved range. */
+#define SHN_LOPROC 0xff00 /* First processor-specific. */
+#define SHN_HIPROC 0xff1f /* Last processor-specific. */
+#define SHN_LOOS 0xff20 /* First operating system-specific. */
+#define SHN_HIOS 0xff3f /* Last operating system-specific. */
+#define SHN_ABS 0xfff1 /* Absolute values. */
+#define SHN_COMMON 0xfff2 /* Common data. */
+#define SHN_XINDEX 0xffff /* Escape -- index stored elsewhere. */
+#define SHN_HIRESERVE 0xffff /* Last of reserved range. */
+
+/* sh_type */
+#define SHT_NULL 0 /* inactive */
+#define SHT_PROGBITS 1 /* program defined information */
+#define SHT_SYMTAB 2 /* symbol table section */
+#define SHT_STRTAB 3 /* string table section */
+#define SHT_RELA 4 /* relocation section with addends */
+#define SHT_HASH 5 /* symbol hash table section */
+#define SHT_DYNAMIC 6 /* dynamic section */
+#define SHT_NOTE 7 /* note section */
+#define SHT_NOBITS 8 /* no space section */
+#define SHT_REL 9 /* relocation section - no addends */
+#define SHT_SHLIB 10 /* reserved - purpose unknown */
+#define SHT_DYNSYM 11 /* dynamic symbol table section */
+#define SHT_INIT_ARRAY 14 /* Initialization function pointers. */
+#define SHT_FINI_ARRAY 15 /* Termination function pointers. */
+#define SHT_PREINIT_ARRAY 16 /* Pre-initialization function ptrs. */
+#define SHT_GROUP 17 /* Section group. */
+#define SHT_SYMTAB_SHNDX 18 /* Section indexes (see SHN_XINDEX). */
+#define SHT_LOOS 0x60000000 /* First of OS specific semantics */
+#define SHT_LOSUNW 0x6ffffff4
+#define SHT_SUNW_dof 0x6ffffff4
+#define SHT_SUNW_cap 0x6ffffff5
+#define SHT_SUNW_SIGNATURE 0x6ffffff6
+#define SHT_SUNW_ANNOTATE 0x6ffffff7
+#define SHT_SUNW_DEBUGSTR 0x6ffffff8
+#define SHT_SUNW_DEBUG 0x6ffffff9
+#define SHT_SUNW_move 0x6ffffffa
+#define SHT_SUNW_COMDAT 0x6ffffffb
+#define SHT_SUNW_syminfo 0x6ffffffc
+#define SHT_SUNW_verdef 0x6ffffffd
+#define SHT_GNU_verdef 0x6ffffffd /* Symbol versions provided */
+#define SHT_SUNW_verneed 0x6ffffffe
+#define SHT_GNU_verneed 0x6ffffffe /* Symbol versions required */
+#define SHT_SUNW_versym 0x6fffffff
+#define SHT_GNU_versym 0x6fffffff /* Symbol version table */
+#define SHT_HISUNW 0x6fffffff
+#define SHT_HIOS 0x6fffffff /* Last of OS specific semantics */
+#define SHT_LOPROC 0x70000000 /* reserved range for processor */
+#define SHT_AMD64_UNWIND 0x70000001 /* unwind information */
+#define SHT_HIPROC 0x7fffffff /* specific section header types */
+#define SHT_LOUSER 0x80000000 /* reserved range for application */
+#define SHT_HIUSER 0xffffffff /* specific indexes */
+
+/* Flags for sh_flags. */
+#define SHF_WRITE 0x1 /* Section contains writable data. */
+#define SHF_ALLOC 0x2 /* Section occupies memory. */
+#define SHF_EXECINSTR 0x4 /* Section contains instructions. */
+#define SHF_MERGE 0x10 /* Section may be merged. */
+#define SHF_STRINGS 0x20 /* Section contains strings. */
+#define SHF_INFO_LINK 0x40 /* sh_info holds section index. */
+#define SHF_LINK_ORDER 0x80 /* Special ordering requirements. */
+#define SHF_OS_NONCONFORMING 0x100 /* OS-specific processing required. */
+#define SHF_GROUP 0x200 /* Member of section group. */
+#define SHF_TLS 0x400 /* Section contains TLS data. */
+#define SHF_MASKOS 0x0ff00000 /* OS-specific semantics. */
+#define SHF_MASKPROC 0xf0000000 /* Processor-specific semantics. */
+
+/* Values for p_type. */
+#define PT_NULL 0 /* Unused entry. */
+#define PT_LOAD 1 /* Loadable segment. */
+#define PT_DYNAMIC 2 /* Dynamic linking information segment. */
+#define PT_INTERP 3 /* Pathname of interpreter. */
+#define PT_NOTE 4 /* Auxiliary information. */
+#define PT_SHLIB 5 /* Reserved (not used). */
+#define PT_PHDR 6 /* Location of program header itself. */
+#define PT_TLS 7 /* Thread local storage segment */
+#define PT_LOOS 0x60000000 /* First OS-specific. */
+#define PT_SUNW_UNWIND 0x6464e550 /* amd64 UNWIND program header */
+#define PT_GNU_EH_FRAME 0x6474e550
+#define PT_LOSUNW 0x6ffffffa
+#define PT_SUNWBSS 0x6ffffffa /* Sun Specific segment */
+#define PT_SUNWSTACK 0x6ffffffb /* describes the stack segment */
+#define PT_SUNWDTRACE 0x6ffffffc /* private */
+#define PT_SUNWCAP 0x6ffffffd /* hard/soft capabilities segment */
+#define PT_HISUNW 0x6fffffff
+#define PT_HIOS 0x6fffffff /* Last OS-specific. */
+#define PT_LOPROC 0x70000000 /* First processor-specific type. */
+#define PT_HIPROC 0x7fffffff /* Last processor-specific type. */
+
+/* Values for p_flags. */
+#define PF_X 0x1 /* Executable. */
+#define PF_W 0x2 /* Writable. */
+#define PF_R 0x4 /* Readable. */
+#define PF_MASKOS 0x0ff00000 /* Operating system-specific. */
+#define PF_MASKPROC 0xf0000000 /* Processor-specific. */
+
+/* Extended program header index. */
+#define PN_XNUM 0xffff
+
+/* Values for d_tag. */
+#define DT_NULL 0 /* Terminating entry. */
+#define DT_NEEDED 1 /* String table offset of a needed shared
+ library. */
+#define DT_PLTRELSZ 2 /* Total size in bytes of PLT relocations. */
+#define DT_PLTGOT 3 /* Processor-dependent address. */
+#define DT_HASH 4 /* Address of symbol hash table. */
+#define DT_STRTAB 5 /* Address of string table. */
+#define DT_SYMTAB 6 /* Address of symbol table. */
+#define DT_RELA 7 /* Address of ElfNN_Rela relocations. */
+#define DT_RELASZ 8 /* Total size of ElfNN_Rela relocations. */
+#define DT_RELAENT 9 /* Size of each ElfNN_Rela relocation entry. */
+#define DT_STRSZ 10 /* Size of string table. */
+#define DT_SYMENT 11 /* Size of each symbol table entry. */
+#define DT_INIT 12 /* Address of initialization function. */
+#define DT_FINI 13 /* Address of finalization function. */
+#define DT_SONAME 14 /* String table offset of shared object
+ name. */
+#define DT_RPATH 15 /* String table offset of library path. [sup] */
+#define DT_SYMBOLIC 16 /* Indicates "symbolic" linking. [sup] */
+#define DT_REL 17 /* Address of ElfNN_Rel relocations. */
+#define DT_RELSZ 18 /* Total size of ElfNN_Rel relocations. */
+#define DT_RELENT 19 /* Size of each ElfNN_Rel relocation. */
+#define DT_PLTREL 20 /* Type of relocation used for PLT. */
+#define DT_DEBUG 21 /* Reserved (not used). */
+#define DT_TEXTREL 22 /* Indicates there may be relocations in
+ non-writable segments. [sup] */
+#define DT_JMPREL 23 /* Address of PLT relocations. */
+#define DT_BIND_NOW 24 /* [sup] */
+#define DT_INIT_ARRAY 25 /* Address of the array of pointers to
+ initialization functions */
+#define DT_FINI_ARRAY 26 /* Address of the array of pointers to
+ termination functions */
+#define DT_INIT_ARRAYSZ 27 /* Size in bytes of the array of
+ initialization functions. */
+#define DT_FINI_ARRAYSZ 28 /* Size in bytes of the array of
+ terminationfunctions. */
+#define DT_RUNPATH 29 /* String table offset of a null-terminated
+ library search path string. */
+#define DT_FLAGS 30 /* Object specific flag values. */
+#define DT_ENCODING 32 /* Values greater than or equal to DT_ENCODING
+ and less than DT_LOOS follow the rules for
+ the interpretation of the d_un union
+ as follows: even == 'd_ptr', even == 'd_val'
+ or none */
+#define DT_PREINIT_ARRAY 32 /* Address of the array of pointers to
+ pre-initialization functions. */
+#define DT_PREINIT_ARRAYSZ 33 /* Size in bytes of the array of
+ pre-initialization functions. */
+#define DT_MAXPOSTAGS 34 /* number of positive tags */
+#define DT_LOOS 0x6000000d /* First OS-specific */
+#define DT_SUNW_AUXILIARY 0x6000000d /* symbol auxiliary name */
+#define DT_SUNW_RTLDINF 0x6000000e /* ld.so.1 info (private) */
+#define DT_SUNW_FILTER 0x6000000f /* symbol filter name */
+#define DT_SUNW_CAP 0x60000010 /* hardware/software */
+#define DT_HIOS 0x6ffff000 /* Last OS-specific */
+
+/*
+ * DT_* entries which fall between DT_VALRNGHI & DT_VALRNGLO use the
+ * Dyn.d_un.d_val field of the Elf*_Dyn structure.
+ */
+#define DT_VALRNGLO 0x6ffffd00
+#define DT_CHECKSUM 0x6ffffdf8 /* elf checksum */
+#define DT_PLTPADSZ 0x6ffffdf9 /* pltpadding size */
+#define DT_MOVEENT 0x6ffffdfa /* move table entry size */
+#define DT_MOVESZ 0x6ffffdfb /* move table size */
+#define DT_FEATURE_1 0x6ffffdfc /* feature holder */
+#define DT_POSFLAG_1 0x6ffffdfd /* flags for DT_* entries, effecting */
+ /* the following DT_* entry. */
+ /* See DF_P1_* definitions */
+#define DT_SYMINSZ 0x6ffffdfe /* syminfo table size (in bytes) */
+#define DT_SYMINENT 0x6ffffdff /* syminfo entry size (in bytes) */
+#define DT_VALRNGHI 0x6ffffdff
+
+/*
+ * DT_* entries which fall between DT_ADDRRNGHI & DT_ADDRRNGLO use the
+ * Dyn.d_un.d_ptr field of the Elf*_Dyn structure.
+ *
+ * If any adjustment is made to the ELF object after it has been
+ * built, these entries will need to be adjusted.
+ */
+#define DT_ADDRRNGLO 0x6ffffe00
+#define DT_CONFIG 0x6ffffefa /* configuration information */
+#define DT_DEPAUDIT 0x6ffffefb /* dependency auditing */
+#define DT_AUDIT 0x6ffffefc /* object auditing */
+#define DT_PLTPAD 0x6ffffefd /* pltpadding (sparcv9) */
+#define DT_MOVETAB 0x6ffffefe /* move table */
+#define DT_SYMINFO 0x6ffffeff /* syminfo table */
+#define DT_ADDRRNGHI 0x6ffffeff
+
+#define DT_VERSYM 0x6ffffff0 /* Address of versym section. */
+#define DT_RELACOUNT 0x6ffffff9 /* number of RELATIVE relocations */
+#define DT_RELCOUNT 0x6ffffffa /* number of RELATIVE relocations */
+#define DT_FLAGS_1 0x6ffffffb /* state flags - see DF_1_* defs */
+#define DT_VERDEF 0x6ffffffc /* Address of verdef section. */
+#define DT_VERDEFNUM 0x6ffffffd /* Number of elems in verdef section */
+#define DT_VERNEED 0x6ffffffe /* Address of verneed section. */
+#define DT_VERNEEDNUM 0x6fffffff /* Number of elems in verneed section */
+
+#define DT_LOPROC 0x70000000 /* First processor-specific type. */
+#define DT_DEPRECATED_SPARC_REGISTER 0x7000001
+#define DT_AUXILIARY 0x7ffffffd /* shared library auxiliary name */
+#define DT_USED 0x7ffffffe /* ignored - same as needed */
+#define DT_FILTER 0x7fffffff /* shared library filter name */
+#define DT_HIPROC 0x7fffffff /* Last processor-specific type. */
+
+/* Values for DT_FLAGS */
+#define DF_ORIGIN 0x0001 /* Indicates that the object being loaded may
+ make reference to the $ORIGIN substitution
+ string */
+#define DF_SYMBOLIC 0x0002 /* Indicates "symbolic" linking. */
+#define DF_TEXTREL 0x0004 /* Indicates there may be relocations in
+ non-writable segments. */
+#define DF_BIND_NOW 0x0008 /* Indicates that the dynamic linker should
+ process all relocations for the object
+ containing this entry before transferring
+ control to the program. */
+#define DF_STATIC_TLS 0x0010 /* Indicates that the shared object or
+ executable contains code using a static
+ thread-local storage scheme. */
+
+/* Values for n_type. Used in core files. */
+#define NT_PRSTATUS 1 /* Process status. */
+#define NT_FPREGSET 2 /* Floating point registers. */
+#define NT_PRPSINFO 3 /* Process state info. */
+
+/* Symbol Binding - ELFNN_ST_BIND - st_info */
+#define STB_LOCAL 0 /* Local symbol */
+#define STB_GLOBAL 1 /* Global symbol */
+#define STB_WEAK 2 /* like global - lower precedence */
+#define STB_LOOS 10 /* Reserved range for operating system */
+#define STB_HIOS 12 /* specific semantics. */
+#define STB_LOPROC 13 /* reserved range for processor */
+#define STB_HIPROC 15 /* specific semantics. */
+
+/* Symbol type - ELFNN_ST_TYPE - st_info */
+#define STT_NOTYPE 0 /* Unspecified type. */
+#define STT_OBJECT 1 /* Data object. */
+#define STT_FUNC 2 /* Function. */
+#define STT_SECTION 3 /* Section. */
+#define STT_FILE 4 /* Source file. */
+#define STT_COMMON 5 /* Uninitialized common block. */
+#define STT_TLS 6 /* TLS object. */
+#define STT_NUM 7
+#define STT_LOOS 10 /* Reserved range for operating system */
+#define STT_HIOS 12 /* specific semantics. */
+#define STT_LOPROC 13 /* reserved range for processor */
+#define STT_HIPROC 15 /* specific semantics. */
+
+/* Symbol visibility - ELFNN_ST_VISIBILITY - st_other */
+#define STV_DEFAULT 0x0 /* Default visibility (see binding). */
+#define STV_INTERNAL 0x1 /* Special meaning in relocatable objects. */
+#define STV_HIDDEN 0x2 /* Not visible. */
+#define STV_PROTECTED 0x3 /* Visible but not preemptible. */
+
+/* Special symbol table indexes. */
+#define STN_UNDEF 0 /* Undefined symbol index. */
+
+/* Symbol versioning flags. */
+#define VER_DEF_CURRENT 1
+#define VER_DEF_IDX(x) VER_NDX(x)
+
+#define VER_FLG_BASE 0x01
+#define VER_FLG_WEAK 0x02
+
+#define VER_NEED_CURRENT 1
+#define VER_NEED_WEAK (1u << 15)
+#define VER_NEED_HIDDEN VER_NDX_HIDDEN
+#define VER_NEED_IDX(x) VER_NDX(x)
+
+#define VER_NDX_LOCAL 0
+#define VER_NDX_GLOBAL 1
+#define VER_NDX_GIVEN 2
+
+#define VER_NDX_HIDDEN (1u << 15)
+#define VER_NDX(x) ((x) & ~(1u << 15))
+
+#define CA_SUNW_NULL 0
+#define CA_SUNW_HW_1 1 /* first hardware capabilities entry */
+#define CA_SUNW_SF_1 2 /* first software capabilities entry */
+
+/*
+ * Syminfo flag values
+ */
+#define SYMINFO_FLG_DIRECT 0x0001 /* symbol ref has direct association */
+ /* to object containing defn. */
+#define SYMINFO_FLG_PASSTHRU 0x0002 /* ignored - see SYMINFO_FLG_FILTER */
+#define SYMINFO_FLG_COPY 0x0004 /* symbol is a copy-reloc */
+#define SYMINFO_FLG_LAZYLOAD 0x0008 /* object containing defn should be */
+ /* lazily-loaded */
+#define SYMINFO_FLG_DIRECTBIND 0x0010 /* ref should be bound directly to */
+ /* object containing defn. */
+#define SYMINFO_FLG_NOEXTDIRECT 0x0020 /* don't let an external reference */
+ /* directly bind to this symbol */
+#define SYMINFO_FLG_FILTER 0x0002 /* symbol ref is associated to a */
+#define SYMINFO_FLG_AUXILIARY 0x0040 /* standard or auxiliary filter */
+
+/*
+ * Syminfo.si_boundto values.
+ */
+#define SYMINFO_BT_SELF 0xffff /* symbol bound to self */
+#define SYMINFO_BT_PARENT 0xfffe /* symbol bound to parent */
+#define SYMINFO_BT_NONE 0xfffd /* no special symbol binding */
+#define SYMINFO_BT_EXTERN 0xfffc /* symbol defined as external */
+#define SYMINFO_BT_LOWRESERVE 0xff00 /* beginning of reserved entries */
+
+/*
+ * Syminfo version values.
+ */
+#define SYMINFO_NONE 0 /* Syminfo version */
+#define SYMINFO_CURRENT 1
+#define SYMINFO_NUM 2
+
+/*
+ * Relocation types.
+ *
+ * All machine architectures are defined here to allow tools on one to
+ * handle others.
+ */
+
+#define R_386_NONE 0 /* No relocation. */
+#define R_386_32 1 /* Add symbol value. */
+#define R_386_PC32 2 /* Add PC-relative symbol value. */
+#define R_386_GOT32 3 /* Add PC-relative GOT offset. */
+#define R_386_PLT32 4 /* Add PC-relative PLT offset. */
+#define R_386_COPY 5 /* Copy data from shared object. */
+#define R_386_GLOB_DAT 6 /* Set GOT entry to data address. */
+#define R_386_JMP_SLOT 7 /* Set GOT entry to code address. */
+#define R_386_RELATIVE 8 /* Add load address of shared object. */
+#define R_386_GOTOFF 9 /* Add GOT-relative symbol address. */
+#define R_386_GOTPC 10 /* Add PC-relative GOT table address. */
+#define R_386_TLS_TPOFF 14 /* Negative offset in static TLS block */
+#define R_386_TLS_IE 15 /* Absolute address of GOT for -ve static TLS */
+#define R_386_TLS_GOTIE 16 /* GOT entry for negative static TLS block */
+#define R_386_TLS_LE 17 /* Negative offset relative to static TLS */
+#define R_386_TLS_GD 18 /* 32 bit offset to GOT (index,off) pair */
+#define R_386_TLS_LDM 19 /* 32 bit offset to GOT (index,zero) pair */
+#define R_386_TLS_GD_32 24 /* 32 bit offset to GOT (index,off) pair */
+#define R_386_TLS_GD_PUSH 25 /* pushl instruction for Sun ABI GD sequence */
+#define R_386_TLS_GD_CALL 26 /* call instruction for Sun ABI GD sequence */
+#define R_386_TLS_GD_POP 27 /* popl instruction for Sun ABI GD sequence */
+#define R_386_TLS_LDM_32 28 /* 32 bit offset to GOT (index,zero) pair */
+#define R_386_TLS_LDM_PUSH 29 /* pushl instruction for Sun ABI LD sequence */
+#define R_386_TLS_LDM_CALL 30 /* call instruction for Sun ABI LD sequence */
+#define R_386_TLS_LDM_POP 31 /* popl instruction for Sun ABI LD sequence */
+#define R_386_TLS_LDO_32 32 /* 32 bit offset from start of TLS block */
+#define R_386_TLS_IE_32 33 /* 32 bit offset to GOT static TLS offset entry */
+#define R_386_TLS_LE_32 34 /* 32 bit offset within static TLS block */
+#define R_386_TLS_DTPMOD32 35 /* GOT entry containing TLS index */
+#define R_386_TLS_DTPOFF32 36 /* GOT entry containing TLS offset */
+#define R_386_TLS_TPOFF32 37 /* GOT entry of -ve static TLS offset */
+
+/* Null relocation */
+#define R_AARCH64_NONE 256 /* No relocation */
+/* Static AArch64 relocations */
+ /* Static data relocations */
+#define R_AARCH64_ABS64 257 /* S + A */
+#define R_AARCH64_ABS32 258 /* S + A */
+#define R_AARCH64_ABS16 259 /* S + A */
+#define R_AARCH64_PREL64 260 /* S + A - P */
+#define R_AARCH64_PREL32 261 /* S + A - P */
+#define R_AARCH64_PREL16 262 /* S + A - P */
+ /* Group relocations to create a 16, 32, 48, or 64 bit unsigned data value or address inline */
+#define R_AARCH64_MOVW_UABS_G0 263 /* S + A */
+#define R_AARCH64_MOVW_UABS_G0_NC 264 /* S + A */
+#define R_AARCH64_MOVW_UABS_G1 265 /* S + A */
+#define R_AARCH64_MOVW_UABS_G1_NC 266 /* S + A */
+#define R_AARCH64_MOVW_UABS_G2 267 /* S + A */
+#define R_AARCH64_MOVW_UABS_G2_NC 268 /* S + A */
+#define R_AARCH64_MOVW_UABS_G3 269 /* S + A */
+ /* Group relocations to create a 16, 32, 48, or 64 bit signed data or offset value inline */
+#define R_AARCH64_MOVW_SABS_G0 270 /* S + A */
+#define R_AARCH64_MOVW_SABS_G1 271 /* S + A */
+#define R_AARCH64_MOVW_SABS_G2 272 /* S + A */
+ /* Relocations to generate 19, 21 and 33 bit PC-relative addresses */
+#define R_AARCH64_LD_PREL_LO19 273 /* S + A - P */
+#define R_AARCH64_ADR_PREL_LO21 274 /* S + A - P */
+#define R_AARCH64_ADR_PREL_PG_HI21 275 /* Page(S+A) - Page(P) */
+#define R_AARCH64_ADR_PREL_PG_HI21_NC 276 /* Page(S+A) - Page(P) */
+#define R_AARCH64_ADD_ABS_LO12_NC 277 /* S + A */
+#define R_AARCH64_LDST8_ABS_LO12_NC 278 /* S + A */
+#define R_AARCH64_LDST16_ABS_LO12_NC 284 /* S + A */
+#define R_AARCH64_LDST32_ABS_LO12_NC 285 /* S + A */
+#define R_AARCH64_LDST64_ABS_LO12_NC 286 /* S + A */
+#define R_AARCH64_LDST128_ABS_LO12_NC 299 /* S + A */
+ /* Relocations for control-flow instructions - all offsets are a multiple of 4 */
+#define R_AARCH64_TSTBR14 279 /* S+A-P */
+#define R_AARCH64_CONDBR19 280 /* S+A-P */
+#define R_AARCH64_JUMP26 282 /* S+A-P */
+#define R_AARCH64_CALL26 283 /* S+A-P */
+ /* Group relocations to create a 16, 32, 48, or 64 bit PC-relative offset inline */
+#define R_AARCH64_MOVW_PREL_G0 287 /* S+A-P */
+#define R_AARCH64_MOVW_PREL_G0_NC 288 /* S+A-P */
+#define R_AARCH64_MOVW_PREL_G1 289 /* S+A-P */
+#define R_AARCH64_MOVW_PREL_G1_NC 290 /* S+A-P */
+#define R_AARCH64_MOVW_PREL_G2 291 /* S+A-P */
+#define R_AARCH64_MOVW_PREL_G2_NC 292 /* S+A-P */
+#define R_AARCH64_MOVW_PREL_G3 293 /* S+A-P */
+ /* Group relocations to create a 16, 32, 48, or 64 bit GOT-relative offsets inline */
+#define R_AARCH64_MOVW_GOTOFF_G0 300 /* G(S)-GOT */
+#define R_AARCH64_MOVW_GOTOFF_G0_NC 301 /* G(S)-GOT */
+#define R_AARCH64_MOVW_GOTOFF_G1 302 /* G(S)-GOT */
+#define R_AARCH64_MOVW_GOTOFF_G1_NC 303 /* G(S)-GOT */
+#define R_AARCH64_MOVW_GOTOFF_G2 304 /* G(S)-GOT */
+#define R_AARCH64_MOVW_GOTOFF_G2_NC 305 /* G(S)-GOT */
+#define R_AARCH64_MOVW_GOTOFF_G3 306 /* G(S)-GOT */
+ /* GOT-relative data relocations */
+#define R_AARCH64_GOTREL64 307 /* S+A-GOT */
+#define R_AARCH64_GOTREL32 308 /* S+A-GOT */
+ /* GOT-relative instruction relocations */
+#define R_AARCH64_GOT_LD_PREL19 309 /* G(S)-P */
+#define R_AARCH64_LD64_GOTOFF_LO15 310 /* G(S)-GOT */
+#define R_AARCH64_ADR_GOT_PAGE 311 /* Page(G(S))-Page(P) */
+#define R_AARCH64_LD64_GOT_LO12_NC 312 /* G(S) */
+#define R_AARCH64_LD64_GOTPAGE_LO15 313 /* G(S)-Page(GOT) */
+/* Relocations for thread-local storage */
+ /* General Dynamic TLS relocations */
+#define R_AARCH64_TLSGD_ADR_PREL21 512 /* G(TLSIDX(S+A)) - P */
+#define R_AARCH64_TLSGD_ADR_PAGE21 513 /* Page(G(TLSIDX(S+A))) - Page(P) */
+#define R_AARCH64_TLSGD_ADD_LO12_NC 514 /* G(TLSIDX(S+A)) */
+#define R_AARCH64_TLSGD_MOVW_G1 515 /* G(TLSIDX(S+A)) - GOT */
+#define R_AARCH64_TLSGD_MOVW_G0_NC 516 /* G(TLSIDX(S+A)) - GOT */
+ /* Local Dynamic TLS relocations */
+#define R_AARCH64_TLSLD_ADR_PREL21 517 /* G(LDM(S))) - P */
+#define R_AARCH64_TLSLD_ADR_PAGE21 518 /* Page(G(LDM(S)))-Page(P) */
+#define R_AARCH64_TLSLD_ADD_LO12_NC 519 /* G(LDM(S)) */
+#define R_AARCH64_TLSLD_MOVW_G1 520 /* G(LDM(S)) - GOT */
+#define R_AARCH64_TLSLD_MOVW_G0_NC 521 /* G(LDM(S)) - GOT */
+#define R_AARCH64_TLSLD_LD_PREL19 522 /* G(LDM(S)) - P */
+#define R_AARCH64_TLSLD_MOVW_DTPREL_G2 523 /* DTPREL(S+A) */
+#define R_AARCH64_TLSLD_MOVW_DTPREL_G1 524 /* DTPREL(S+A) */
+#define R_AARCH64_TLSLD_MOVW_DTPREL_G1_NC 525 /* DTPREL(S+A) */
+#define R_AARCH64_TLSLD_MOVW_DTPREL_G0 526 /* DTPREL(S+A) */
+#define R_AARCH64_TLSLD_MOVW_DTPREL_G0_NC 527 /* DTPREL(S+A) */
+#define R_AARCH64_TLSLD_ADD_DTPREL_HI12 528 /* DTPREL(S+A) */
+#define R_AARCH64_TLSLD_ADD_DTPREL_LO12 529 /* DTPREL(S+A) */
+#define R_AARCH64_TLSLD_ADD_DTPREL_LO12_NC 530 /* DTPREL(S+A) */
+#define R_AARCH64_TLSLD_LDST8_DTPREL_LO12 531 /* DTPREL(S+A) */
+#define R_AARCH64_TLSLD_LDST8_DTPREL_LO12_NC 532 /* DTPREL(S+A) */
+#define R_AARCH64_TLSLD_LDST16_DTPREL_LO12 533 /* DTPREL(S+A) */
+#define R_AARCH64_TLSLD_LDST16_DTPREL_LO12_NC 534 /* DTPREL(S+A) */
+#define R_AARCH64_TLSLD_LDST32_DTPREL_LO12 535 /* DTPREL(S+A) */
+#define R_AARCH64_TLSLD_LDST32_DTPREL_LO12_NC 536 /* DTPREL(S+A) */
+#define R_AARCH64_TLSLD_LDST64_DTPREL_LO12 537 /* DTPREL(S+A) */
+#define R_AARCH64_TLSLD_LDST64_DTPREL_LO12_NC 538 /* DTPREL(S+A) */
+ /* Initial Exec TLS relocations */
+#define R_AARCH64_TLSIE_MOVW_GOTTPREL_G1 539 /* G(TPREL(S+A)) - GOT */
+#define R_AARCH64_TLSIE_MOVW_GOTTPREL_G0_NC 540 /* G(TPREL(S+A)) - GOT */
+#define R_AARCH64_TLSIE_ADR_GOTTPREL_PAGE21 541 /* Page(G(TPREL(S+A))) - Page(P) */
+#define R_AARCH64_TLSIE_LD64_GOTTPREL_LO12_NC 542 /* G(TPREL(S+A)) */
+#define R_AARCH64_TLSIE_LD_GOTTPREL_PREL19 543 /* G(TPREL(S+A)) - P */
+ /* Local Exec TLS relocations */
+#define R_AARCH64_TLSLE_MOVW_TPREL_G2 544 /* TPREL(S+A) */
+#define R_AARCH64_TLSLE_MOVW_TPREL_G1 545 /* TPREL(S+A) */
+#define R_AARCH64_TLSLE_MOVW_TPREL_G1_NC 546 /* TPREL(S+A) */
+#define R_AARCH64_TLSLE_MOVW_TPREL_G0 547 /* TPREL(S+A) */
+#define R_AARCH64_TLSLE_MOVW_TPREL_G0_NC 548 /* TPREL(S+A) */
+#define R_AARCH64_TLSLE_ADD_TPREL_HI12 549 /* TPREL(S+A) */
+#define R_AARCH64_TLSLE_ADD_TPREL_LO12 550 /* TPREL(S+A) */
+#define R_AARCH64_TLSLE_ADD_TPREL_LO12_NC 551 /* TPREL(S+A) */
+#define R_AARCH64_TLSLE_LDST8_TPREL_LO12 552 /* TPREL(S+A) */
+#define R_AARCH64_TLSLE_LDST8_TPREL_LO12_NC 553 /* TPREL(S+A) */
+#define R_AARCH64_TLSLE_LDST16_TPREL_LO12 554 /* TPREL(S+A) */
+#define R_AARCH64_TLSLE_LDST16_TPREL_LO12_NC 555 /* TPREL(S+A) */
+#define R_AARCH64_TLSLE_LDST32_TPREL_LO12 556 /* TPREL(S+A) */
+#define R_AARCH64_TLSLE_LDST32_TPREL_LO12_NC 557 /* TPREL(S+A) */
+#define R_AARCH64_TLSLE_LDST64_TPREL_LO12 558 /* TPREL(S+A) */
+#define R_AARCH64_TLSLE_LDST64_TPREL_LO12_NC 559 /* TPREL(S+A) */
+/* Dynamic relocations */
+ /* Dynamic relocations */
+#define R_AARCH64_COPY 1024
+#define R_AARCH64_GLOB_DAT 1025 /* S + A */
+#define R_AARCH64_JUMP_SLOT 1026 /* S + A */
+#define R_AARCH64_RELATIVE 1027 /* Delta(S) + A , Delta(P) + A */
+#define R_AARCH64_TLS_DTPREL64 1028 /* DTPREL(S+A) */
+#define R_AARCH64_TLS_DTPMOD64 1029 /* LDM(S) */
+#define R_AARCH64_TLS_TPREL64 1030 /* TPREL(S+A) */
+#define R_AARCH64_TLS_DTPREL32 1031 /* DTPREL(S+A) */
+#define R_AARCH64_TLS_DTPMOD32 1032 /* LDM(S) */
+#define R_AARCH64_TLS_TPREL32 1033 /* DTPREL(S+A) */
+
+#define R_ALPHA_NONE 0 /* No reloc */
+#define R_ALPHA_REFLONG 1 /* Direct 32 bit */
+#define R_ALPHA_REFQUAD 2 /* Direct 64 bit */
+#define R_ALPHA_GPREL32 3 /* GP relative 32 bit */
+#define R_ALPHA_LITERAL 4 /* GP relative 16 bit w/optimization */
+#define R_ALPHA_LITUSE 5 /* Optimization hint for LITERAL */
+#define R_ALPHA_GPDISP 6 /* Add displacement to GP */
+#define R_ALPHA_BRADDR 7 /* PC+4 relative 23 bit shifted */
+#define R_ALPHA_HINT 8 /* PC+4 relative 16 bit shifted */
+#define R_ALPHA_SREL16 9 /* PC relative 16 bit */
+#define R_ALPHA_SREL32 10 /* PC relative 32 bit */
+#define R_ALPHA_SREL64 11 /* PC relative 64 bit */
+#define R_ALPHA_OP_PUSH 12 /* OP stack push */
+#define R_ALPHA_OP_STORE 13 /* OP stack pop and store */
+#define R_ALPHA_OP_PSUB 14 /* OP stack subtract */
+#define R_ALPHA_OP_PRSHIFT 15 /* OP stack right shift */
+#define R_ALPHA_GPVALUE 16
+#define R_ALPHA_GPRELHIGH 17
+#define R_ALPHA_GPRELLOW 18
+#define R_ALPHA_IMMED_GP_16 19
+#define R_ALPHA_IMMED_GP_HI32 20
+#define R_ALPHA_IMMED_SCN_HI32 21
+#define R_ALPHA_IMMED_BR_HI32 22
+#define R_ALPHA_IMMED_LO32 23
+#define R_ALPHA_COPY 24 /* Copy symbol at runtime */
+#define R_ALPHA_GLOB_DAT 25 /* Create GOT entry */
+#define R_ALPHA_JMP_SLOT 26 /* Create PLT entry */
+#define R_ALPHA_RELATIVE 27 /* Adjust by program base */
+
+#define R_ARM_NONE 0 /* No relocation. */
+#define R_ARM_PC24 1
+#define R_ARM_ABS32 2
+#define R_ARM_REL32 3
+#define R_ARM_PC13 4
+#define R_ARM_ABS16 5
+#define R_ARM_ABS12 6
+#define R_ARM_THM_ABS5 7
+#define R_ARM_ABS8 8
+#define R_ARM_SBREL32 9
+#define R_ARM_THM_PC22 10
+#define R_ARM_THM_PC8 11
+#define R_ARM_AMP_VCALL9 12
+#define R_ARM_SWI24 13
+#define R_ARM_THM_SWI8 14
+#define R_ARM_XPC25 15
+#define R_ARM_THM_XPC22 16
+#define R_ARM_COPY 20 /* Copy data from shared object. */
+#define R_ARM_GLOB_DAT 21 /* Set GOT entry to data address. */
+#define R_ARM_JUMP_SLOT 22 /* Set GOT entry to code address. */
+#define R_ARM_RELATIVE 23 /* Add load address of shared object. */
+#define R_ARM_GOTOFF 24 /* Add GOT-relative symbol address. */
+#define R_ARM_GOTPC 25 /* Add PC-relative GOT table address. */
+#define R_ARM_GOT32 26 /* Add PC-relative GOT offset. */
+#define R_ARM_PLT32 27 /* Add PC-relative PLT offset. */
+#define R_ARM_CALL 28
+#define R_ARM_JMP24 29
+#define R_ARM_THM_MOVW_ABS_NC 47
+#define R_ARM_THM_MOVT_ABS 48
+
+// Block of PC-relative relocations added to work around gcc putting
+// object relocations in static executables.
+#define R_ARM_THM_JUMP24 30
+#define R_ARM_PREL31 42
+#define R_ARM_MOVW_PREL_NC 45
+#define R_ARM_MOVT_PREL 46
+#define R_ARM_THM_MOVW_PREL_NC 49
+#define R_ARM_THM_MOVT_PREL 50
+#define R_ARM_THM_JMP6 52
+#define R_ARM_THM_ALU_PREL_11_0 53
+#define R_ARM_THM_PC12 54
+#define R_ARM_REL32_NOI 56
+#define R_ARM_ALU_PC_G0_NC 57
+#define R_ARM_ALU_PC_G0 58
+#define R_ARM_ALU_PC_G1_NC 59
+#define R_ARM_ALU_PC_G1 60
+#define R_ARM_ALU_PC_G2 61
+#define R_ARM_LDR_PC_G1 62
+#define R_ARM_LDR_PC_G2 63
+#define R_ARM_LDRS_PC_G0 64
+#define R_ARM_LDRS_PC_G1 65
+#define R_ARM_LDRS_PC_G2 66
+#define R_ARM_LDC_PC_G0 67
+#define R_ARM_LDC_PC_G1 68
+#define R_ARM_LDC_PC_G2 69
+#define R_ARM_GOT_PREL 96
+#define R_ARM_THM_JUMP11 102
+#define R_ARM_THM_JUMP8 103
+#define R_ARM_TLS_GD32 104
+#define R_ARM_TLS_LDM32 105
+#define R_ARM_TLS_IE32 107
+
+#define R_ARM_THM_JUMP19 51
+#define R_ARM_GNU_VTENTRY 100
+#define R_ARM_GNU_VTINHERIT 101
+#define R_ARM_RSBREL32 250
+#define R_ARM_THM_RPC22 251
+#define R_ARM_RREL32 252
+#define R_ARM_RABS32 253
+#define R_ARM_RPC24 254
+#define R_ARM_RBASE 255
+
+#define R_PPC_NONE 0 /* No relocation. */
+#define R_PPC_ADDR32 1
+#define R_PPC_ADDR24 2
+#define R_PPC_ADDR16 3
+#define R_PPC_ADDR16_LO 4
+#define R_PPC_ADDR16_HI 5
+#define R_PPC_ADDR16_HA 6
+#define R_PPC_ADDR14 7
+#define R_PPC_ADDR14_BRTAKEN 8
+#define R_PPC_ADDR14_BRNTAKEN 9
+#define R_PPC_REL24 10
+#define R_PPC_REL14 11
+#define R_PPC_REL14_BRTAKEN 12
+#define R_PPC_REL14_BRNTAKEN 13
+#define R_PPC_GOT16 14
+#define R_PPC_GOT16_LO 15
+#define R_PPC_GOT16_HI 16
+#define R_PPC_GOT16_HA 17
+#define R_PPC_PLTREL24 18
+#define R_PPC_COPY 19
+#define R_PPC_GLOB_DAT 20
+#define R_PPC_JMP_SLOT 21
+#define R_PPC_RELATIVE 22
+#define R_PPC_LOCAL24PC 23
+#define R_PPC_UADDR32 24
+#define R_PPC_UADDR16 25
+#define R_PPC_REL32 26
+#define R_PPC_PLT32 27
+#define R_PPC_PLTREL32 28
+#define R_PPC_PLT16_LO 29
+#define R_PPC_PLT16_HI 30
+#define R_PPC_PLT16_HA 31
+#define R_PPC_SDAREL16 32
+#define R_PPC_SECTOFF 33
+#define R_PPC_SECTOFF_LO 34
+#define R_PPC_SECTOFF_HI 35
+#define R_PPC_SECTOFF_HA 36
+
+/*
+ * TLS relocations
+ */
+#define R_PPC_TLS 67
+#define R_PPC_DTPMOD32 68
+#define R_PPC_TPREL16 69
+#define R_PPC_TPREL16_LO 70
+#define R_PPC_TPREL16_HI 71
+#define R_PPC_TPREL16_HA 72
+#define R_PPC_TPREL32 73
+#define R_PPC_DTPREL16 74
+#define R_PPC_DTPREL16_LO 75
+#define R_PPC_DTPREL16_HI 76
+#define R_PPC_DTPREL16_HA 77
+#define R_PPC_DTPREL32 78
+#define R_PPC_GOT_TLSGD16 79
+#define R_PPC_GOT_TLSGD16_LO 80
+#define R_PPC_GOT_TLSGD16_HI 81
+#define R_PPC_GOT_TLSGD16_HA 82
+#define R_PPC_GOT_TLSLD16 83
+#define R_PPC_GOT_TLSLD16_LO 84
+#define R_PPC_GOT_TLSLD16_HI 85
+#define R_PPC_GOT_TLSLD16_HA 86
+#define R_PPC_GOT_TPREL16 87
+#define R_PPC_GOT_TPREL16_LO 88
+#define R_PPC_GOT_TPREL16_HI 89
+#define R_PPC_GOT_TPREL16_HA 90
+
+/*
+ * The remaining relocs are from the Embedded ELF ABI, and are not in the
+ * SVR4 ELF ABI.
+ */
+
+#define R_PPC_EMB_NADDR32 101
+#define R_PPC_EMB_NADDR16 102
+#define R_PPC_EMB_NADDR16_LO 103
+#define R_PPC_EMB_NADDR16_HI 104
+#define R_PPC_EMB_NADDR16_HA 105
+#define R_PPC_EMB_SDAI16 106
+#define R_PPC_EMB_SDA2I16 107
+#define R_PPC_EMB_SDA2REL 108
+#define R_PPC_EMB_SDA21 109
+#define R_PPC_EMB_MRKREF 110
+#define R_PPC_EMB_RELSEC16 111
+#define R_PPC_EMB_RELST_LO 112
+#define R_PPC_EMB_RELST_HI 113
+#define R_PPC_EMB_RELST_HA 114
+#define R_PPC_EMB_BIT_FLD 115
+#define R_PPC_EMB_RELSDA 116
+
+#define R_SPARC_NONE 0
+#define R_SPARC_8 1
+#define R_SPARC_16 2
+#define R_SPARC_32 3
+#define R_SPARC_DISP8 4
+#define R_SPARC_DISP16 5
+#define R_SPARC_DISP32 6
+#define R_SPARC_WDISP30 7
+#define R_SPARC_WDISP22 8
+#define R_SPARC_HI22 9
+#define R_SPARC_22 10
+#define R_SPARC_13 11
+#define R_SPARC_LO10 12
+#define R_SPARC_GOT10 13
+#define R_SPARC_GOT13 14
+#define R_SPARC_GOT22 15
+#define R_SPARC_PC10 16
+#define R_SPARC_PC22 17
+#define R_SPARC_WPLT30 18
+#define R_SPARC_COPY 19
+#define R_SPARC_GLOB_DAT 20
+#define R_SPARC_JMP_SLOT 21
+#define R_SPARC_RELATIVE 22
+#define R_SPARC_UA32 23
+#define R_SPARC_PLT32 24
+#define R_SPARC_HIPLT22 25
+#define R_SPARC_LOPLT10 26
+#define R_SPARC_PCPLT32 27
+#define R_SPARC_PCPLT22 28
+#define R_SPARC_PCPLT10 29
+#define R_SPARC_10 30
+#define R_SPARC_11 31
+#define R_SPARC_64 32
+#define R_SPARC_OLO10 33
+#define R_SPARC_HH22 34
+#define R_SPARC_HM10 35
+#define R_SPARC_LM22 36
+#define R_SPARC_PC_HH22 37
+#define R_SPARC_PC_HM10 38
+#define R_SPARC_PC_LM22 39
+#define R_SPARC_WDISP16 40
+#define R_SPARC_WDISP19 41
+#define R_SPARC_GLOB_JMP 42
+#define R_SPARC_7 43
+#define R_SPARC_5 44
+#define R_SPARC_6 45
+#define R_SPARC_DISP64 46
+#define R_SPARC_PLT64 47
+#define R_SPARC_HIX22 48
+#define R_SPARC_LOX10 49
+#define R_SPARC_H44 50
+#define R_SPARC_M44 51
+#define R_SPARC_L44 52
+#define R_SPARC_REGISTER 53
+#define R_SPARC_UA64 54
+#define R_SPARC_UA16 55
+#define R_SPARC_TLS_GD_HI22 56
+#define R_SPARC_TLS_GD_LO10 57
+#define R_SPARC_TLS_GD_ADD 58
+#define R_SPARC_TLS_GD_CALL 59
+#define R_SPARC_TLS_LDM_HI22 60
+#define R_SPARC_TLS_LDM_LO10 61
+#define R_SPARC_TLS_LDM_ADD 62
+#define R_SPARC_TLS_LDM_CALL 63
+#define R_SPARC_TLS_LDO_HIX22 64
+#define R_SPARC_TLS_LDO_LOX10 65
+#define R_SPARC_TLS_LDO_ADD 66
+#define R_SPARC_TLS_IE_HI22 67
+#define R_SPARC_TLS_IE_LO10 68
+#define R_SPARC_TLS_IE_LD 69
+#define R_SPARC_TLS_IE_LDX 70
+#define R_SPARC_TLS_IE_ADD 71
+#define R_SPARC_TLS_LE_HIX22 72
+#define R_SPARC_TLS_LE_LOX10 73
+#define R_SPARC_TLS_DTPMOD32 74
+#define R_SPARC_TLS_DTPMOD64 75
+#define R_SPARC_TLS_DTPOFF32 76
+#define R_SPARC_TLS_DTPOFF64 77
+#define R_SPARC_TLS_TPOFF32 78
+#define R_SPARC_TLS_TPOFF64 79
+
+#define R_X86_64_NONE 0 /* No relocation. */
+#define R_X86_64_64 1 /* Add 64 bit symbol value. */
+#define R_X86_64_PC32 2 /* PC-relative 32 bit signed sym value. */
+#define R_X86_64_GOT32 3 /* PC-relative 32 bit GOT offset. */
+#define R_X86_64_PLT32 4 /* PC-relative 32 bit PLT offset. */
+#define R_X86_64_COPY 5 /* Copy data from shared object. */
+#define R_X86_64_GLOB_DAT 6 /* Set GOT entry to data address. */
+#define R_X86_64_JMP_SLOT 7 /* Set GOT entry to code address. */
+#define R_X86_64_RELATIVE 8 /* Add load address of shared object. */
+#define R_X86_64_GOTPCREL 9 /* Add 32 bit signed pcrel offset to GOT. */
+#define R_X86_64_32 10 /* Add 32 bit zero extended symbol value */
+#define R_X86_64_32S 11 /* Add 32 bit sign extended symbol value */
+#define R_X86_64_16 12 /* Add 16 bit zero extended symbol value */
+#define R_X86_64_PC16 13 /* Add 16 bit signed extended pc relative symbol value */
+#define R_X86_64_8 14 /* Add 8 bit zero extended symbol value */
+#define R_X86_64_PC8 15 /* Add 8 bit signed extended pc relative symbol value */
+#define R_X86_64_DTPMOD64 16 /* ID of module containing symbol */
+#define R_X86_64_DTPOFF64 17 /* Offset in TLS block */
+#define R_X86_64_TPOFF64 18 /* Offset in static TLS block */
+#define R_X86_64_TLSGD 19 /* PC relative offset to GD GOT entry */
+#define R_X86_64_TLSLD 20 /* PC relative offset to LD GOT entry */
+#define R_X86_64_DTPOFF32 21 /* Offset in TLS block */
+#define R_X86_64_GOTTPOFF 22 /* PC relative offset to IE GOT entry */
+#define R_X86_64_TPOFF32 23 /* Offset in static TLS block */
+#define R_X86_64_PC64 24 /* PC relative 64 bit */
+#define R_X86_64_GOTOFF64 25 /* 64 bit offset to GOT */
+#define R_X86_64_GOTPC3 26 /* 32 bit signed pc relative offset to GOT */
+#define R_X86_64_GOT64 27 /* 64-bit GOT entry offset */
+#define R_X86_64_GOTPCREL64 28 /* 64-bit PC relative offset to GOT entry */
+#define R_X86_64_GOTPC64 29 /* 64-bit PC relative offset to GOT */
+#define R_X86_64_GOTPLT64 30 /* like GOT64, says PLT entry needed */
+#define R_X86_64_PLTOFF64 31 /* 64-bit GOT relative offset to PLT entry */
+#define R_X86_64_SIZE32 32 /* Size of symbol plus 32-bit addend */
+#define R_X86_64_SIZE64 33 /* Size of symbol plus 64-bit addend */
+#define R_X86_64_GOTPC32_TLSDESC 34 /* GOT offset for TLS descriptor. */
+#define R_X86_64_TLSDESC_CALL 35 /* Marker for call through TLS descriptor. */
+#define R_X86_64_TLSDESC 36 /* TLS descriptor. */
+#define R_X86_64_IRELATIVE 37 /* Adjust indirectly by program base */
+#define R_X86_64_RELATIVE64 38 /* 64-bit adjust by program base */
+#define R_X86_64_GOTPCRELX 41 /* Load from 32 bit signed pc relative offset to GOT entry without REX prefix, relaxable. */
+#define R_X86_64_REX_GOTPCRELX 42 /* Load from 32 bit signed pc relative offset to GOT entry with REX prefix, relaxable. */
+
+
+#endif /* !_SYS_ELF_COMMON_H_ */
diff --git a/UefiPayloadPkg/PayloadLoaderPeim/ElfLib/ElfLib.c b/UefiPayloadPkg/PayloadLoaderPeim/ElfLib/ElfLib.c
new file mode 100644
index 0000000000..531b3486d2
--- /dev/null
+++ b/UefiPayloadPkg/PayloadLoaderPeim/ElfLib/ElfLib.c
@@ -0,0 +1,473 @@
+/** @file
+ ELF library
+
+ Copyright (c) 2019 - 2021, Intel Corporation. All rights reserved.<BR>
+ SPDX-License-Identifier: BSD-2-Clause-Patent
+
+**/
+
+#include "ElfLibInternal.h"
+
+/**
+ Check if the ELF image is valid.
+
+ @param[in] ImageBase Memory address of an image.
+
+ @retval TRUE if valid.
+
+**/
+BOOLEAN
+IsElfFormat (
+ IN CONST UINT8 *ImageBase
You cannot safely inspect untrusted/unknown data without a size field, also needs checks below.

+ )
+{
+ Elf32_Ehdr *Elf32Hdr;
+ Elf64_Ehdr *Elf64Hdr;
+
+ ASSERT (ImageBase != NULL);
+
+ Elf32Hdr = (Elf32_Ehdr *)ImageBase;
+
+ //
+ // Start with correct signature "\7fELF"
+ //
+ if ((Elf32Hdr->e_ident[EI_MAG0] != ELFMAG0) ||
+ (Elf32Hdr->e_ident[EI_MAG1] != ELFMAG1) ||
+ (Elf32Hdr->e_ident[EI_MAG1] != ELFMAG1) ||
+ (Elf32Hdr->e_ident[EI_MAG2] != ELFMAG2)
+ ) {
+ return FALSE;
+ }
+
+ //
+ // Support little-endian only
+ //
+ if (Elf32Hdr->e_ident[EI_DATA] != ELFDATA2LSB) {
+ return FALSE;
+ }
+
+ //
+ // Check 32/64-bit architecture
+ //
+ if (Elf32Hdr->e_ident[EI_CLASS] == ELFCLASS64) {
+ Elf64Hdr = (Elf64_Ehdr *)Elf32Hdr;
+ Elf32Hdr = NULL;
+ } else if (Elf32Hdr->e_ident[EI_CLASS] == ELFCLASS32) {
+ Elf64Hdr = NULL;
+ } else {
+ return FALSE;
+ }
Why are the branches above and below separated when they map basically 1:1?

+
+ if (Elf64Hdr != NULL) {
+ //
+ // Support intel architecture only for now
+ //
+ if (Elf64Hdr->e_machine != EM_X86_64) {
+ return FALSE;
+ }
+
+ //
+ // Support ELF types: EXEC (Executable file), DYN (Shared object file)
+ //
+ if ((Elf64Hdr->e_type != ET_EXEC) && (Elf64Hdr->e_type != ET_DYN)) {
+ return FALSE;
+ }
+
+ //
+ // Support current ELF version only
+ //
+ if (Elf64Hdr->e_version != EV_CURRENT) {
+ return FALSE;
+ }
+ } else {
+ //
+ // Support intel architecture only for now
+ //
+ if (Elf32Hdr->e_machine != EM_386) {
+ return FALSE;
+ }
+
+ //
+ // Support ELF types: EXEC (Executable file), DYN (Shared object file)
+ //
+ if ((Elf32Hdr->e_type != ET_EXEC) && (Elf32Hdr->e_type != ET_DYN)) {
+ return FALSE;
+ }
+
+ //
+ // Support current ELF version only
+ //
+ if (Elf32Hdr->e_version != EV_CURRENT) {
+ return FALSE;
+ }
+ }
+ return TRUE;
+}
+
+/**
+ Calculate a ELF file size.
+
+ @param[in] ElfCt ELF image context pointer.
+ @param[out] FileSize Return the file size.
+
+ @retval EFI_INVALID_PARAMETER ElfCt or SecPos is NULL.
+ @retval EFI_NOT_FOUND Could not find the section.
+ @retval EFI_SUCCESS Section posistion was filled successfully.
+**/
+EFI_STATUS
+CalculateElfFileSize (
+ IN ELF_IMAGE_CONTEXT *ElfCt,
+ OUT UINTN *FileSize
+ )
+{
+ EFI_STATUS Status;
+ UINTN FileSize1;
+ UINTN FileSize2;
+ Elf32_Ehdr *Elf32Hdr;
+ Elf64_Ehdr *Elf64Hdr;
+ UINTN Offset;
+ UINTN Size;
+
+ if ((ElfCt == NULL) || (FileSize == NULL)) {
+ return EFI_INVALID_PARAMETER;
+ }
+
+ // Use last section as end of file
+ Status = GetElfSectionPos (ElfCt, ElfCt->ShNum - 1, &Offset, &Size);
What if ShNum is 0?

+ if (EFI_ERROR(Status)) {
+ return EFI_UNSUPPORTED;
+ }
+ FileSize1 = Offset + Size;
+
+ // Use end of section header as end of file
+ FileSize2 = 0;
+ if (ElfCt->EiClass == ELFCLASS32) {
+ Elf32Hdr = (Elf32_Ehdr *)ElfCt->FileBase;
+ FileSize2 = Elf32Hdr->e_shoff + Elf32Hdr->e_shentsize * Elf32Hdr->e_shnum;
+ } else if (ElfCt->EiClass == ELFCLASS64) {
+ Elf64Hdr = (Elf64_Ehdr *)ElfCt->FileBase;
+ FileSize2 = (UINTN)(Elf64Hdr->e_shoff + Elf64Hdr->e_shentsize * Elf64Hdr->e_shnum);
+ }
Overflows?

+
+ *FileSize = MAX(FileSize1, FileSize2);
+
+ return EFI_SUCCESS;
+}
+
+/**
+ Get a ELF program segment loading info.
+
+ @param[in] ImageBase Image base.
+ @param[in] EiClass ELF class.
+ @param[in] Index ELF segment index.
+ @param[out] SegInfo The pointer to the segment info.
+
+ @retval EFI_INVALID_PARAMETER ElfCt or SecPos is NULL.
+ @retval EFI_NOT_FOUND Could not find the section.
+ @retval EFI_SUCCESS Section posistion was filled successfully.
+**/
+EFI_STATUS
+GetElfSegmentInfo (
+ IN UINT8 *ImageBase,
+ IN UINT32 EiClass,
+ IN UINT32 Index,
+ OUT SEGMENT_INFO *SegInfo
+ )
+{
+ Elf32_Phdr *Elf32Phdr;
+ Elf64_Phdr *Elf64Phdr;
+
+ if ((ImageBase == NULL) || (SegInfo == NULL)) {
+ return EFI_INVALID_PARAMETER;
+ }
+
+ if (EiClass == ELFCLASS32) {
+ Elf32Phdr = GetElf32SegmentByIndex (ImageBase, Index);
+ if (Elf32Phdr != NULL) {
+ SegInfo->PtType = Elf32Phdr->p_type;
+ SegInfo->Offset = Elf32Phdr->p_offset;
+ SegInfo->Length = Elf32Phdr->p_filesz;
+ SegInfo->MemLen = Elf32Phdr->p_memsz;
+ SegInfo->MemAddr = Elf32Phdr->p_paddr;
+ SegInfo->Alignment = Elf32Phdr->p_align;
+ return EFI_SUCCESS;
+ }
+ } else if (EiClass == ELFCLASS64) {
+ Elf64Phdr = GetElf64SegmentByIndex (ImageBase, Index);
+ if (Elf64Phdr != NULL) {
+ SegInfo->PtType = Elf64Phdr->p_type;
+ SegInfo->Offset = (UINTN)Elf64Phdr->p_offset;
+ SegInfo->Length = (UINTN)Elf64Phdr->p_filesz;
+ SegInfo->MemLen = (UINTN)Elf64Phdr->p_memsz;
+ SegInfo->MemAddr = (UINTN)Elf64Phdr->p_paddr;
+ SegInfo->Alignment = (UINTN)Elf64Phdr->p_align;
+ return EFI_SUCCESS;
+ }
+ }
+
+ return EFI_NOT_FOUND;
+}
+
+/**
+ Parse the ELF image info.
+
+ On return, all fields in ElfCt are updated except ImageAddress.
+
+ @param[in] ImageBase Memory address of an image.
+ @param[out] ElfCt The EFL image context pointer.
+
+ @retval EFI_INVALID_PARAMETER Input parameters are not valid.
+ @retval EFI_UNSUPPORTED Unsupported binary type.
+ @retval EFI_LOAD_ERROR ELF binary loading error.
+ @retval EFI_SUCCESS ELF binary is loaded successfully.
+**/
+EFI_STATUS
+EFIAPI
+ParseElfImage (
+ IN VOID *ImageBase,
+ OUT ELF_IMAGE_CONTEXT *ElfCt
+ )
+{
+ Elf32_Ehdr *Elf32Hdr;
+ Elf64_Ehdr *Elf64Hdr;
+ Elf32_Shdr *Elf32Shdr;
+ Elf64_Shdr *Elf64Shdr;
+ EFI_STATUS Status;
+ UINT32 Index;
+ SEGMENT_INFO SegInfo;
+ UINTN End;
+ UINTN Base;
+
+ if (ElfCt == NULL) {
+ return EFI_INVALID_PARAMETER;
+ }
As this is function contract, I'd replace this with an ASSERT, or at least have both.

+ ZeroMem (ElfCt, sizeof(ELF_IMAGE_CONTEXT));
+
+ if (ImageBase == NULL) {
+ return (ElfCt->ParseStatus = EFI_INVALID_PARAMETER);
If I see it correctly, all instances that can assign ParseStatus also return it. Why is the member needed at all?

+ }
+
+ ElfCt->FileBase = (UINT8 *)ImageBase;
+ if (!IsElfFormat (ElfCt->FileBase)) {
+ return (ElfCt->ParseStatus = EFI_UNSUPPORTED);
+ }
+
+ Elf32Hdr = (Elf32_Ehdr *)ElfCt->FileBase;
+ ElfCt->EiClass = Elf32Hdr->e_ident[EI_CLASS];
+ if (ElfCt->EiClass == ELFCLASS32) {
+ if ((Elf32Hdr->e_type != ET_EXEC) && (Elf32Hdr->e_type != ET_DYN)) {
+ return (ElfCt->ParseStatus = EFI_UNSUPPORTED);
+ }
+ Elf32Shdr = (Elf32_Shdr *)GetElf32SectionByIndex (ElfCt->FileBase, Elf32Hdr->e_shstrndx);
+ if (Elf32Shdr == NULL) {
+ return (ElfCt->ParseStatus = EFI_UNSUPPORTED);
+ }
+ ElfCt->EntryPoint = (UINTN)Elf32Hdr->e_entry;
+ ElfCt->ShNum = Elf32Hdr->e_shnum;
+ ElfCt->PhNum = Elf32Hdr->e_phnum;
+ ElfCt->ShStrLen = Elf32Shdr->sh_size;
+ ElfCt->ShStrOff = Elf32Shdr->sh_offset;
+ } else {
+ Elf64Hdr = (Elf64_Ehdr *)Elf32Hdr;
+ if ((Elf64Hdr->e_type != ET_EXEC) && (Elf64Hdr->e_type != ET_DYN)) {
+ return (ElfCt->ParseStatus = EFI_UNSUPPORTED);
+ }
+ Elf64Shdr = (Elf64_Shdr *)GetElf64SectionByIndex (ElfCt->FileBase, Elf64Hdr->e_shstrndx);
+ if (Elf64Shdr == NULL) {
+ return (ElfCt->ParseStatus = EFI_UNSUPPORTED);
+ }
+ ElfCt->EntryPoint = (UINTN)Elf64Hdr->e_entry;
+ ElfCt->ShNum = Elf64Hdr->e_shnum;
+ ElfCt->PhNum = Elf64Hdr->e_phnum;
+ ElfCt->ShStrLen = (UINT32)Elf64Shdr->sh_size;
+ ElfCt->ShStrOff = (UINT32)Elf64Shdr->sh_offset;
+ }
+
+ //
+ // Get the preferred image base and required memory size when loaded to new location.
+ //
+ End = 0;
+ Base = MAX_UINT32;
+ ElfCt->ReloadRequired = FALSE;
+ for (Index = 0; Index < ElfCt->PhNum; Index++) {
+ Status = GetElfSegmentInfo (ElfCt->FileBase, ElfCt->EiClass, Index, &SegInfo);
+ ASSERT_EFI_ERROR (Status);
+
+ if (SegInfo.PtType != PT_LOAD) {
+ continue;
+ }
+
+ if (SegInfo.MemLen != SegInfo.Length) {
+ //
+ // Not enough space to execute at current location.
+ //
+ ElfCt->ReloadRequired = TRUE;
+ }
+
+ if (Base > (SegInfo.MemAddr & ~(EFI_PAGE_SIZE - 1))) {
+ Base = SegInfo.MemAddr & ~(EFI_PAGE_SIZE - 1);
+ }
+ if (End < ALIGN_VALUE (SegInfo.MemAddr + SegInfo.MemLen, EFI_PAGE_SIZE) - 1) {
+ End = ALIGN_VALUE (SegInfo.MemAddr + SegInfo.MemLen, EFI_PAGE_SIZE) - 1;
+ }
+ }
+ //
+ // 0 - MAX_UINT32 + 1 equals to 0.
+ //
+ ElfCt->ImageSize = End - Base + 1;
+ ElfCt->PreferredImageAddress = (VOID *) Base;
+
+ CalculateElfFileSize (ElfCt, &ElfCt->FileSize);
+ return (ElfCt->ParseStatus = EFI_SUCCESS);;
+}
+
+/**
+ Load the ELF image to Context.ImageAddress.
+
+ Context should be initialized by ParseElfImage().
+ Caller should set Context.ImageAddress to a proper value, either pointing to
+ a new allocated memory whose size equal to Context.ImageSize, or pointing
+ to Context.PreferredImageAddress.
+
+ @param[in] ElfCt ELF image context pointer.
+
+ @retval EFI_INVALID_PARAMETER Input parameters are not valid.
+ @retval EFI_UNSUPPORTED Unsupported binary type.
+ @retval EFI_LOAD_ERROR ELF binary loading error.
+ @retval EFI_SUCCESS ELF binary is loaded successfully.
+**/
+EFI_STATUS
+EFIAPI
+LoadElfImage (
+ IN ELF_IMAGE_CONTEXT *ElfCt
+ )
+{
+ EFI_STATUS Status;
+
+ if (ElfCt == NULL) {
+ return EFI_INVALID_PARAMETER;
+ }
+
+ if (EFI_ERROR (ElfCt->ParseStatus)) {
+ return ElfCt->ParseStatus;
+ }
+
+ if (ElfCt->ImageAddress == NULL) {
+ return EFI_INVALID_PARAMETER;
+ }
+
+ Status = EFI_UNSUPPORTED;
+ if (ElfCt->EiClass == ELFCLASS32) {
+ Status = LoadElf32Image (ElfCt);
+ } else if (ElfCt->EiClass == ELFCLASS64) {
+ Status = LoadElf64Image (ElfCt);
+ }
+
+ return Status;
+}
+
+
+/**
+ Get a ELF section name from its index.
+
+ @param[in] ElfCt ELF image context pointer.
+ @param[in] SectionIndex ELF section index.
+ @param[out] SectionName The pointer to the section name.
+
+ @retval EFI_INVALID_PARAMETER ElfCt or SecName is NULL.
+ @retval EFI_NOT_FOUND Could not find the section.
+ @retval EFI_SUCCESS Section name was filled successfully.
+**/
+EFI_STATUS
+EFIAPI
+GetElfSectionName (
+ IN ELF_IMAGE_CONTEXT *ElfCt,
+ IN UINT32 SectionIndex,
+ OUT CHAR8 **SectionName
+ )
+{
+ Elf32_Shdr *Elf32Shdr;
+ Elf64_Shdr *Elf64Shdr;
+ CHAR8 *Name;
+
+ if ((ElfCt == NULL) || (SectionName == NULL)) {
+ return EFI_INVALID_PARAMETER;
+ }
+
+ if (EFI_ERROR (ElfCt->ParseStatus)) {
+ return ElfCt->ParseStatus;
+ }
+
+ Name = NULL;
+ if (ElfCt->EiClass == ELFCLASS32) {
+ Elf32Shdr = GetElf32SectionByIndex (ElfCt->FileBase, SectionIndex);
+ if ((Elf32Shdr != NULL) && (Elf32Shdr->sh_name < ElfCt->ShStrLen)) {
+ Name = (CHAR8 *)(ElfCt->FileBase + ElfCt->ShStrOff + Elf32Shdr->sh_name);
+ }
+ } else if (ElfCt->EiClass == ELFCLASS64) {
+ Elf64Shdr = GetElf64SectionByIndex (ElfCt->FileBase, SectionIndex);
+ if ((Elf64Shdr != NULL) && (Elf64Shdr->sh_name < ElfCt->ShStrLen)) {
+ Name = (CHAR8 *)(ElfCt->FileBase + ElfCt->ShStrOff + Elf64Shdr->sh_name);
0-termination checks, or return size?

+ }
+ }
+
+ if (Name == NULL) {
+ return EFI_NOT_FOUND;
+ }
+
+ *SectionName = Name;
+ return EFI_SUCCESS;
+}
+
+
+/**
+ Get the offset and size of x-th ELF section.
+
+ @param[in] ElfCt ELF image context pointer.
+ @param[in] Index ELF section index.
+ @param[out] Offset Return the offset of the specific section.
+ @param[out] Size Return the size of the specific section.
+
+ @retval EFI_INVALID_PARAMETER ImageBase, Offset or Size is NULL.
+ @retval EFI_INVALID_PARAMETER EiClass doesn't equal to ELFCLASS32 or ELFCLASS64.
+ @retval EFI_NOT_FOUND Could not find the section.
+ @retval EFI_SUCCESS Offset and Size are returned.
+**/
+EFI_STATUS
+EFIAPI
+GetElfSectionPos (
+ IN ELF_IMAGE_CONTEXT *ElfCt,
+ IN UINT32 Index,
+ OUT UINTN *Offset,
+ OUT UINTN *Size
+ )
+{
+ Elf32_Shdr *Elf32Shdr;
+ Elf64_Shdr *Elf64Shdr;
+
+ if ((ElfCt == NULL) || (Offset == NULL) || (Size == NULL)) {
+ return EFI_INVALID_PARAMETER;
+ }
+
+ if (EFI_ERROR (ElfCt->ParseStatus)) {
+ return ElfCt->ParseStatus;
+ }
+
+ if (ElfCt->EiClass == ELFCLASS32) {
+ Elf32Shdr = GetElf32SectionByIndex (ElfCt->FileBase, Index);
+ if (Elf32Shdr != NULL) {
+ *Offset = (UINTN)Elf32Shdr->sh_offset;
+ *Size = (UINTN)Elf32Shdr->sh_size;
+ return EFI_SUCCESS;
+ }
+ } else if (ElfCt->EiClass == ELFCLASS64) {
+ Elf64Shdr = GetElf64SectionByIndex (ElfCt->FileBase, Index);
+ if (Elf64Shdr != NULL) {
+ *Offset = (UINTN)Elf64Shdr->sh_offset;
+ *Size = (UINTN)Elf64Shdr->sh_size;
+ return EFI_SUCCESS;
+ }
+ }
+
+ return EFI_NOT_FOUND;
+}
diff --git a/UefiPayloadPkg/PayloadLoaderPeim/ElfLib/ElfLibInternal.h b/UefiPayloadPkg/PayloadLoaderPeim/ElfLib/ElfLibInternal.h
new file mode 100644
index 0000000000..3c782807e2
--- /dev/null
+++ b/UefiPayloadPkg/PayloadLoaderPeim/ElfLib/ElfLibInternal.h
@@ -0,0 +1,109 @@
+/** @file
+ ELF library
+
+ Copyright (c) 2019 - 2021, Intel Corporation. All rights reserved.<BR>
+ SPDX-License-Identifier: BSD-2-Clause-Patent
+
+**/
+
+#ifndef EFI_LIB_INTERNAL_H_
+#define EFI_LIB_INTERNAL_H_
+
+#include <Library/BaseLib.h>
+#include <Library/DebugLib.h>
+#include <Library/BaseMemoryLib.h>
+#include "ElfLib.h"
+#include "ElfCommon.h"
+#include "Elf32.h"
+#include "Elf64.h"
+
+#define ELF_NEXT_ENTRY(EntryType, Current, EntrySize) \
+ ((EntryType *) ((UINT8 *)Current + EntrySize))
+
+
+/**
+ Return the section header specified by Index.
+
+ @param ImageBase The image base.
+ @param Index The section index.
+
+ @return Pointer to the section header.
+**/
+Elf32_Shdr *
+GetElf32SectionByIndex (
+ IN UINT8 *ImageBase,
+ IN UINT32 Index
+ );
+
+/**
+ Return the section header specified by Index.
+
+ @param ImageBase The image base.
+ @param Index The section index.
+
+ @return Pointer to the section header.
+**/
+Elf64_Shdr *
+GetElf64SectionByIndex (
+ IN UINT8 *ImageBase,
+ IN UINT32 Index
+ );
+
+/**
+ Return the segment header specified by Index.
+
+ @param ImageBase The image base.
+ @param Index The segment index.
+
+ @return Pointer to the segment header.
+**/
+Elf32_Phdr *
+GetElf32SegmentByIndex (
+ IN UINT8 *ImageBase,
+ IN UINT32 Index
+ );
+
+/**
+ Return the segment header specified by Index.
+
+ @param ImageBase The image base.
+ @param Index The segment index.
+
+ @return Pointer to the segment header.
+**/
+Elf64_Phdr *
+GetElf64SegmentByIndex (
+ IN UINT8 *ImageBase,
+ IN UINT32 Index
+ );
+
+/**
+ Load ELF image which has 32-bit architecture
+
+ @param[in] ElfCt ELF image context pointer.
+
+ @retval EFI_SUCCESS ELF binary is loaded successfully.
+ @retval Others Loading ELF binary fails.
+
+**/
+EFI_STATUS
+LoadElf32Image (
+ IN ELF_IMAGE_CONTEXT *ElfCt
+ );
+
+/**
+ Load ELF image which has 64-bit architecture
+
+ @param[in] ImageBase Memory address of an image.
+ @param[out] EntryPoint The entry point of loaded ELF image.
+
+ @retval EFI_SUCCESS ELF binary is loaded successfully.
+ @retval Others Loading ELF binary fails.
+
+**/
+EFI_STATUS
+LoadElf64Image (
+ IN ELF_IMAGE_CONTEXT *ElfCt
+ );
+
+#endif
diff --git a/UefiPayloadPkg/PayloadLoaderPeim/PayloadLoaderPeim.c b/UefiPayloadPkg/PayloadLoaderPeim/PayloadLoaderPeim.c
new file mode 100644
index 0000000000..44639f9fd2
--- /dev/null
+++ b/UefiPayloadPkg/PayloadLoaderPeim/PayloadLoaderPeim.c
@@ -0,0 +1,187 @@
+/** @file
+ ELF Load Image Support
+
+Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+SPDX-License-Identifier: BSD-2-Clause-Patent
+
+**/
+
+#include <PiPei.h>
+#include <UniversalPayload/UniversalPayload.h>
+#include <UniversalPayload/ExtraData.h>
+
+#include <Ppi/LoadFile.h>
+
+#include <Library/DebugLib.h>
+#include <Library/HobLib.h>
+#include <Library/PeiServicesLib.h>
+#include <Library/MemoryAllocationLib.h>
+#include <Library/BaseMemoryLib.h>
+
+#include "ElfLib.h"
+
+/**
+ The wrapper function of PeiLoadImageLoadImage().
+
+ @param This - Pointer to EFI_PEI_LOAD_FILE_PPI.
+ @param FileHandle - Pointer to the FFS file header of the image.
+ @param ImageAddressArg - Pointer to PE/TE image.
+ @param ImageSizeArg - Size of PE/TE image.
+ @param EntryPoint - Pointer to entry point of specified image file for output.
+ @param AuthenticationState - Pointer to attestation authentication state of image.
+
+ @return Status of PeiLoadImageLoadImage().
+
+**/
+EFI_STATUS
+EFIAPI
+PeiLoadFileLoadPayload (
+ IN CONST EFI_PEI_LOAD_FILE_PPI *This,
+ IN EFI_PEI_FILE_HANDLE FileHandle,
+ OUT EFI_PHYSICAL_ADDRESS *ImageAddressArg, OPTIONAL
+ OUT UINT64 *ImageSizeArg, OPTIONAL
+ OUT EFI_PHYSICAL_ADDRESS *EntryPoint,
+ OUT UINT32 *AuthenticationState
+ )
+{
+ EFI_STATUS Status;
+ VOID *Elf;
+ PLD_EXTRA_DATA *ExtraData;
+ ELF_IMAGE_CONTEXT Context;
+ PLD_INFO_HEADER *PldInfo;
+ UINT32 Index;
+ UINT16 ExtraDataIndex;
+ CHAR8 *SectionName;
+ UINTN Offset;
+ UINTN Size;
+ UINT32 ExtraDataCount;
+ UINTN Instance;
+
+ //
+ // ELF is added to file as RAW section for EDKII bootloader.
+ // But RAW section might be added by build tool before the ELF RAW section when alignment is specified for ELF RAW section.
+ // Below loop skips the RAW section that doesn't contain valid ELF image.
+ //
+ Instance = 0;
+ do {
+ Status = PeiServicesFfsFindSectionData3 (EFI_SECTION_RAW, Instance++, FileHandle, &Elf, AuthenticationState);
+ if (EFI_ERROR (Status)) {
+ return Status;
+ }
+
+ ZeroMem (&Context, sizeof (Context));
This is done by the callee already.

+ Status = ParseElfImage (Elf, &Context);
+ } while (EFI_ERROR (Status));
+
+ DEBUG ((
+ DEBUG_INFO, "Payload File Size: 0x%08X, Mem Size: 0x%08x, Reload: %d\n",
+ Context.FileSize, Context.ImageSize, Context.ReloadRequired
+ ));
+
+ //
+ // Get PLD_INFO and number of additional PLD sections.
+ //
+ PldInfo = NULL;
+ ExtraDataCount = 0;
+ for (Index = 0; Index < Context.ShNum; Index++) {
+ Status = GetElfSectionName (&Context, Index, &SectionName);
+ if (EFI_ERROR(Status)) {
+ continue;
+ }
+ DEBUG ((DEBUG_INFO, "Payload Section[%d]: %a\n", Index, SectionName));
+ if (AsciiStrCmp(SectionName, PLD_INFO_SEC_NAME) == 0) {
+ Status = GetElfSectionPos (&Context, Index, &Offset, &Size);
+ if (!EFI_ERROR(Status)) {
+ PldInfo = (PLD_INFO_HEADER *)(Context.FileBase + Offset);
+ }
+ } else if (AsciiStrnCmp(SectionName, PLD_EXTRA_SEC_NAME_PREFIX, PLD_EXTRA_SEC_NAME_PREFIX_LENGTH) == 0) {
+ Status = GetElfSectionPos (&Context, Index, &Offset, &Size);
+ if (!EFI_ERROR (Status)) {
+ ExtraDataCount++;
+ }
+ }
+ }
+
+ //
+ // Report the additional PLD sections through HOB.
+ //
+ ExtraData = BuildGuidHob (
+ &gPldExtraDataGuid,
+ sizeof (PLD_EXTRA_DATA) + ExtraDataCount * sizeof (PLD_EXTRA_DATA_ENTRY)
+ );
+ ExtraData->Count = ExtraDataCount;
+ if (ExtraDataCount != 0) {
+ for (ExtraDataIndex = 0, Index = 0; Index < Context.ShNum; Index++) {
+ Status = GetElfSectionName (&Context, Index, &SectionName);
+ if (EFI_ERROR(Status)) {
+ continue;
+ }
+ if (AsciiStrnCmp(SectionName, PLD_EXTRA_SEC_NAME_PREFIX, PLD_EXTRA_SEC_NAME_PREFIX_LENGTH) == 0) {
+ Status = GetElfSectionPos (&Context, Index, &Offset, &Size);
+ if (!EFI_ERROR (Status)) {
+ ASSERT (ExtraDataIndex < ExtraDataCount);
+ AsciiStrCpyS (
+ ExtraData->Entry[ExtraDataIndex].Identifier,
+ sizeof(ExtraData->Entry[ExtraDataIndex].Identifier),
+ SectionName + PLD_EXTRA_SEC_NAME_PREFIX_LENGTH
+ );
+ ExtraData->Entry[ExtraDataIndex].Base = (UINTN)(Context.FileBase + Offset);
+ ExtraData->Entry[ExtraDataIndex].Size = Size;
+ ExtraDataIndex++;
+ }
+ }
+ }
+ }
+
+ if (Context.ReloadRequired || Context.PreferredImageAddress != Context.FileBase) {
+ Context.ImageAddress = AllocatePages (EFI_SIZE_TO_PAGES (Context.ImageSize));
+ } else {
+ Context.ImageAddress = Context.FileBase;
+ }
+
+ //
+ // Load ELF into the required base
+ //
+ Status = LoadElfImage (&Context);
+ if (!EFI_ERROR(Status)) {
+ *ImageAddressArg = (UINTN) Context.ImageAddress;
+ *EntryPoint = Context.EntryPoint;
+ *ImageSizeArg = Context.ImageSize;
+ }
+ return Status;
+}
+
+
+EFI_PEI_LOAD_FILE_PPI mPeiLoadFilePpi = {
+ PeiLoadFileLoadPayload
+};
+
+
+EFI_PEI_PPI_DESCRIPTOR gPpiLoadFilePpiList = {
+ (EFI_PEI_PPI_DESCRIPTOR_PPI | EFI_PEI_PPI_DESCRIPTOR_TERMINATE_LIST),
+ &gEfiPeiLoadFilePpiGuid,
+ &mPeiLoadFilePpi
+};
+/**
+
+ Install Pei Load File PPI.
+
+ @param FileHandle Handle of the file being invoked.
+ @param PeiServices Describes the list of possible PEI Services.
+
+ @retval EFI_SUCESS The entry point executes successfully.
+ @retval Others Some error occurs during the execution of this function.
+
+**/
+EFI_STATUS
+EFIAPI
+InitializePayloadLoaderPeim (
+ IN EFI_PEI_FILE_HANDLE FileHandle,
+ IN CONST EFI_PEI_SERVICES **PeiServices
+ )
+{
+ EFI_STATUS Status;
+ Status = PeiServicesInstallPpi (&gPpiLoadFilePpiList);
+
+ return Status;
+}
diff --git a/UefiPayloadPkg/PayloadLoaderPeim/PayloadLoaderPeim.inf b/UefiPayloadPkg/PayloadLoaderPeim/PayloadLoaderPeim.inf
new file mode 100644
index 0000000000..c45f3ecf2d
--- /dev/null
+++ b/UefiPayloadPkg/PayloadLoaderPeim/PayloadLoaderPeim.inf
@@ -0,0 +1,59 @@
+## @file
+# Produce LoadFile PPI for ELF loading.
+#
+# Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+#
+# SPDX-License-Identifier: BSD-2-Clause-Patent
+#
+##
+
+[Defines]
+ INF_VERSION = 0x00010005
+ BASE_NAME = ElfLoaderPeim
+ FILE_GUID = D071A3B4-3EC1-40C5-BEF8-D0BD4A2446F0
+ MODULE_TYPE = PEIM
+ VERSION_STRING = 1.0
+
+ ENTRY_POINT = InitializePayloadLoaderPeim
+
+#
+# The following information is for reference only and not required by the build tools.
+#
+# VALID_ARCHITECTURES = IA32 X64
+#
+
+[Sources]
+ PayloadLoaderPeim.c
+ ElfLib.h
+ ElfLib/ElfLibInternal.h
+ ElfLib/ElfCommon.h
+ ElfLib/Elf32.h
+ ElfLib/Elf64.h
+ ElfLib/ElfLibInternal.h
+ ElfLib/ElfLib.c
+ ElfLib/Elf32Lib.c
+ ElfLib/Elf64Lib.c
+
+[Packages]
+ MdePkg/MdePkg.dec
+ MdeModulePkg/MdeModulePkg.dec
+ UefiPayloadPkg/UefiPayloadPkg.dec
+
+[LibraryClasses]
+ PcdLib
+ MemoryAllocationLib
+ BaseMemoryLib
+ PeiServicesLib
+ HobLib
+ BaseLib
+ PeimEntryPoint
+ DebugLib
+
+[Ppis]
+ gEfiPeiLoadFilePpiGuid ## PRODUCES
+
+[Guids]
+ gPldExtraDataGuid ## PRODUCES
+
+[Depex]
+ TRUE
\ No newline at end of file


Ni, Ray
 

Marvin, thank you very much for reviewing the detailed logics.

Are you ok that I will send a separate patch based on this PayloadLoaderPeim? I think that will be more convenient for both of us for further review and discussion. I will reply your comments in next mail.


Ni, Ray
 

Marvin,
Comments below.


+EFI_STATUS
+ProcessRelocation32 (
+ IN Elf32_Rela *Rela,
+ IN UINT32 RelaSize,
+ IN UINT32 RelaEntrySize,
+ IN UINT32 RelaType,
+ IN INTN Delta,
+ IN BOOLEAN DynamicLinking
+ )
+{
+ UINTN Index;
+ UINT32 *Ptr;
+ UINT32 Type;
+
+ for ( Index = 0
+ ; RelaEntrySize * Index < RelaSize
Overflow?
Will change from:
RelaEntrySize * Index < RelaSize
to:
Index < RelaSize / RelaEntrySize


+ ; Index++, Rela = ELF_NEXT_ENTRY (Elf32_Rela, Rela, RelaEntrySize)
+ ) {
+ //
+ // r_offset is the virtual address of the storage unit affected by the relocation.
+ //
+ Ptr = (UINT32 *)(UINTN)(Rela->r_offset + Delta);
Alignment?
I don't understand. Can you explain a bit more?


+ if (DynamicLinking) {
+ //
+ // A: Represents the addend used to compute the value of the relocatable field.
+ // B: Represents the base address at which a shared object has been loaded into memory during execution.
+ // Generally, a shared object is built with a 0 base virtual address, but the execution address will be different.
+ //
+ // B (Base Address) in ELF spec is slightly different:
+ // An executable or shared object file's base address (on platforms that support the concept) is calculated during
+ // execution from three values: the virtual memory load address, the maximum page size, and the lowest virtual
address
+ // of a program's loadable segment. To compute the base address, one determines the memory address associated
with the
+ // lowest p_vaddr value for a PT_LOAD segment. This address is truncated to the nearest multiple of the maximum
page size.
+ // The corresponding p_vaddr value itself is also truncated to the nearest multiple of the maximum page size.
+ //
+ // *** The base address is the difference between the truncated memory address and the truncated p_vaddr value.
***
+ //
+ // Delta in this function is B.
+ //
+ // Calculation: B + A
+ //
+ if (RelaType == SHT_RELA) {
+ ASSERT (*Ptr == 0);
+ *Ptr = (UINT32) Delta + Rela->r_addend;
+ } else {
+ //
+ // A is stored in the field of relocation for REL type.
+ //
+ *Ptr = (UINT32) Delta + *Ptr;
+ }
+ } else {
+ //
+ // non-Dynamic section doesn't contain entries of this type.
+ //
+ DEBUG ((DEBUG_INFO, "Unsupported relocation type %02X\n", Type));
+ ASSERT (FALSE);
+ }
+ break;
+
+ default:
+ DEBUG ((DEBUG_INFO, "Unsupported relocation type %02X\n", Type));
+ }
+ }
Out of pure interest, if performance is a concern, have you profiled
this code vs one with two loops and "DynamicLinking" pulled out?
I don't think the performance is a concern here.

+ //
+ // It's abnormal a DYN ELF doesn't contain a dynamic section.
+ //
+ ASSERT (DynShdr != NULL);
+ if (DynShdr == NULL) {
+ return EFI_UNSUPPORTED;
+ }
+ ASSERT (DynShdr->sh_type == SHT_DYNAMIC);
+ ASSERT (DynShdr->sh_entsize >= sizeof (*Dyn));
Abnormalities in unknown/untrusted data must be filtered with a runtime
check, not with an ASSERT.
Sure. I will add if-check below the assertion so assertion-enabled build can
report the errors earlier.


+ for ( Index = 0, Dyn = (Elf32_Dyn *) (ElfCt->FileBase + DynShdr->sh_offset)
+ ; Index < DynShdr->sh_size / DynShdr->sh_entsize
Is "sh_entsize" checked for 0?
No need. Because code above makes sure sh_entsize >= sizeof (*Dyn).


+ ASSERT (RelShdr->sh_type == RelaType);
+ ASSERT (RelShdr->sh_entsize == RelaEntrySize);
See above.
Agree. Will add if-checks.


+ DEBUG ((DEBUG_INFO, "DYN ELF: Relocate using dynamic sections...\n"));
+ Status = RelocateElf32Dynamic (ElfCt);
+ ASSERT_EFI_ERROR (Status);
Why cannot this fail?
A DYN type ELF image should contain dynamic section. So only an abnormal ELF image can fail.


+ return (Elf64_Phdr *)(ImageBase + Ehdr->e_phoff + Index * Ehdr->e_phentsize);
Alignment checks? Bounds checks?
For the alignment checks, do you suggest that I should make sure the segment should be placed
in the address that meets the alignment requirement?
ELF spec just requires below for Elf64_Phdr.p_align:
loadable process segments must have congruent values for p_vaddr and p_offset, modulo the page size.

I can add such check in ParseElfImage().

+ ProcessRelocation64 (
+ (Elf64_Rela *) (ElfCt->FileBase + RelShdr->sh_offset),
Alignment? :) I know there is no real concept in EDK II yet, but it
really is needed.
Can you explain a bit more on the alignment?


+
+/**
+ Check if the ELF image is valid.
+
+ @param[in] ImageBase Memory address of an image.
+
+ @retval TRUE if valid.
+
+**/
+BOOLEAN
+IsElfFormat (
+ IN CONST UINT8 *ImageBase
You cannot safely inspect untrusted/unknown data without a size field,
also needs checks below.
Agree. Original idea was to add a ELF loader that can load the ELF assuming
the ELF image is well-formatted.

But with your help, I am glad to enhance the logic a bit more to expand
the support of external ELF images.

Will add a "UINTN ImageSize" parameter.

+ )
+{
+ Elf32_Ehdr *Elf32Hdr;
+ Elf64_Ehdr *Elf64Hdr;
+
+ ASSERT (ImageBase != NULL);
+
+ Elf32Hdr = (Elf32_Ehdr *)ImageBase;
+
+ //
+ // Start with correct signature "\7fELF"
+ //
+ if ((Elf32Hdr->e_ident[EI_MAG0] != ELFMAG0) ||
+ (Elf32Hdr->e_ident[EI_MAG1] != ELFMAG1) ||
+ (Elf32Hdr->e_ident[EI_MAG1] != ELFMAG1) ||
+ (Elf32Hdr->e_ident[EI_MAG2] != ELFMAG2)
+ ) {
+ return FALSE;
+ }
+
+ //
+ // Support little-endian only
+ //
+ if (Elf32Hdr->e_ident[EI_DATA] != ELFDATA2LSB) {
+ return FALSE;
+ }
+
+ //
+ // Check 32/64-bit architecture
+ //
+ if (Elf32Hdr->e_ident[EI_CLASS] == ELFCLASS64) {
+ Elf64Hdr = (Elf64_Ehdr *)Elf32Hdr;
+ Elf32Hdr = NULL;
+ } else if (Elf32Hdr->e_ident[EI_CLASS] == ELFCLASS32) {
+ Elf64Hdr = NULL;
+ } else {
+ return FALSE;
+ }
Why are the branches above and below separated when they map basically 1:1?
Indeed. Thanks for catching this.
Will merge the separate "if" together.

+
+ if (Elf64Hdr != NULL) {
+ //
+ // Support intel architecture only for now
+ //
+ if (Elf64Hdr->e_machine != EM_X86_64) {
+ return FALSE;
+ }
+

+ // Use last section as end of file
+ Status = GetElfSectionPos (ElfCt, ElfCt->ShNum - 1, &Offset, &Size);
What if ShNum is 0?
Agree. The logic to calculate file size might not be needed.
Let me confirm and try to remove the entire function.


+ if (ElfCt->EiClass == ELFCLASS32) {
+ Elf32Hdr = (Elf32_Ehdr *)ElfCt->FileBase;
+ FileSize2 = Elf32Hdr->e_shoff + Elf32Hdr->e_shentsize * Elf32Hdr->e_shnum;
+ } else if (ElfCt->EiClass == ELFCLASS64) {
+ Elf64Hdr = (Elf64_Ehdr *)ElfCt->FileBase;
+ FileSize2 = (UINTN)(Elf64Hdr->e_shoff + Elf64Hdr->e_shentsize * Elf64Hdr->e_shnum);
+ }
Overflows?
Integer overflow?
Will add integer overflow check if this file size calculation logic is still needed.


+
+ if (ElfCt == NULL) {
+ return EFI_INVALID_PARAMETER;
+ }
As this is function contract, I'd replace this with an ASSERT, or at
least have both.
I will put "ASSERT (ElfCt != NULL)" above the if.


+ ZeroMem (ElfCt, sizeof(ELF_IMAGE_CONTEXT));
+
+ if (ImageBase == NULL) {
+ return (ElfCt->ParseStatus = EFI_INVALID_PARAMETER);
If I see it correctly, all instances that can assign ParseStatus also
return it. Why is the member needed at all?
I expect that caller needs to call ParseElfImage() to get the ParseStatus
properly assigned before calling LoadElfImage().

The member ParseStatus is checked in LoadElfImage() later.
Today it's just PayloadLoaderPeim that calls the ElfLib functions.
But I expect that the ElfLib functions can be public lib APIs in future
if needs appear.


+ Name = (CHAR8 *)(ElfCt->FileBase + ElfCt->ShStrOff + Elf64Shdr->sh_name);
0-termination checks, or return size?
I will validate the string section in ParseElfImage(). The validation logic will:
1. Verify that each section name is pointed from the e_shstrndx
2. Verify that section name strings don't occupy spaces outside of the string section.


+
+ ZeroMem (&Context, sizeof (Context));
This is done by the callee already.
Indeed. Will remove this.


+ Status = ParseElfImage (Elf, &Context);
+ } while (EFI_ERROR (Status));


Marvin Häuser
 

Thank you for your quick reply, comments inline.

On 08.06.21 05:10, Ni, Ray wrote:
Marvin,
Comments below.


+EFI_STATUS
+ProcessRelocation32 (
+ IN Elf32_Rela *Rela,
+ IN UINT32 RelaSize,
+ IN UINT32 RelaEntrySize,
+ IN UINT32 RelaType,
+ IN INTN Delta,
+ IN BOOLEAN DynamicLinking
+ )
+{
+ UINTN Index;
+ UINT32 *Ptr;
+ UINT32 Type;
+
+ for ( Index = 0
+ ; RelaEntrySize * Index < RelaSize
Overflow?
Will change from:
RelaEntrySize * Index < RelaSize
to:
Index < RelaSize / RelaEntrySize
imo add ASSERT for RelaEntrySize > 0 then.



+ ; Index++, Rela = ELF_NEXT_ENTRY (Elf32_Rela, Rela, RelaEntrySize)
+ ) {
+ //
+ // r_offset is the virtual address of the storage unit affected by the relocation.
+ //
+ Ptr = (UINT32 *)(UINTN)(Rela->r_offset + Delta);
Alignment?
I don't understand. Can you explain a bit more?
Basically the alignment of any offset with which a pointer to non-trivially-aligned (i.e. requirement > 1 Byte) data can be forged must be checked.

Examples from our new PE loader:
https://github.com/mhaeuser/ISPRASOpen-SecurePE/tree/6a7abcd8647cf6faa733082f6d8dcc9adc141d7e/src/PeCoffInit.c#L1226 -> https://github.com/mhaeuser/ISPRASOpen-SecurePE/tree/6a7abcd8647cf6faa733082f6d8dcc9adc141d7e/src/PeCoffInit.c#L1242
https://github.com/mhaeuser/ISPRASOpen-SecurePE/tree/6a7abcd8647cf6faa733082f6d8dcc9adc141d7e/src/PeCoffInit.c#L1389 -> https://github.com/mhaeuser/ISPRASOpen-SecurePE/tree/6a7abcd8647cf6faa733082f6d8dcc9adc141d7e/src/PeCoffInit.c#L148

The idea here is that the base pointer (i.e. image header) is "maximally aligned" (i.e. can hold data of any platform data alignment). For the 8 Bytes AllocatePool() guarantees (file data), this is sufficient for any primitive and composite data type. For the 4 KB AllocatePages() guarantees (destination), this is sufficient of that, and for advanced things like AVX (however not needed here). If the base is maximally aligned, Base + X is guaranteed aligned for A if X is aligned for A, i.e. X % _Alignof(A) = 0. Failing to verify this can cause exceptions on platforms which don't support or have disabled the capability to perform unaligned memory accesses.



+ if (DynamicLinking) {
+ //
+ // A: Represents the addend used to compute the value of the relocatable field.
+ // B: Represents the base address at which a shared object has been loaded into memory during execution.
+ // Generally, a shared object is built with a 0 base virtual address, but the execution address will be different.
+ //
+ // B (Base Address) in ELF spec is slightly different:
+ // An executable or shared object file's base address (on platforms that support the concept) is calculated during
+ // execution from three values: the virtual memory load address, the maximum page size, and the lowest virtual
address
+ // of a program's loadable segment. To compute the base address, one determines the memory address associated
with the
+ // lowest p_vaddr value for a PT_LOAD segment. This address is truncated to the nearest multiple of the maximum
page size.
+ // The corresponding p_vaddr value itself is also truncated to the nearest multiple of the maximum page size.
+ //
+ // *** The base address is the difference between the truncated memory address and the truncated p_vaddr value.
***
+ //
+ // Delta in this function is B.
+ //
+ // Calculation: B + A
+ //
+ if (RelaType == SHT_RELA) {
+ ASSERT (*Ptr == 0);
+ *Ptr = (UINT32) Delta + Rela->r_addend;
+ } else {
+ //
+ // A is stored in the field of relocation for REL type.
+ //
+ *Ptr = (UINT32) Delta + *Ptr;
+ }
+ } else {
+ //
+ // non-Dynamic section doesn't contain entries of this type.
+ //
+ DEBUG ((DEBUG_INFO, "Unsupported relocation type %02X\n", Type));
+ ASSERT (FALSE);
+ }
+ break;
+
+ default:
+ DEBUG ((DEBUG_INFO, "Unsupported relocation type %02X\n", Type));
+ }
+ }
Out of pure interest, if performance is a concern, have you profiled
this code vs one with two loops and "DynamicLinking" pulled out?
I don't think the performance is a concern here.
OK, tyvm.


+ //
+ // It's abnormal a DYN ELF doesn't contain a dynamic section.
+ //
+ ASSERT (DynShdr != NULL);
+ if (DynShdr == NULL) {
+ return EFI_UNSUPPORTED;
+ }
+ ASSERT (DynShdr->sh_type == SHT_DYNAMIC);
+ ASSERT (DynShdr->sh_entsize >= sizeof (*Dyn));
Abnormalities in unknown/untrusted data must be filtered with a runtime
check, not with an ASSERT.
Sure. I will add if-check below the assertion so assertion-enabled build can
report the errors earlier.
I have started this discussion under another patch, maybe I should write a broader-scope mail to the list for comments. Basically using ASSERTs for anything but *impossible* (*not* assuming the input data is well-formed) situations significantly reduces the efficacy of dynamic analysis. When doing fuzzing for example, you want to keep the ASSERTs enabled to be made aware of any internal invariant violations. But if ASSERTs happen on possible conditions, they will kill the fuzzing process for no good reason. Turning them off will not analyse your ASSERTs for possible code defects.

Maybe fuzzing would be a good idea for this library? :)



+ for ( Index = 0, Dyn = (Elf32_Dyn *) (ElfCt->FileBase + DynShdr->sh_offset)
+ ; Index < DynShdr->sh_size / DynShdr->sh_entsize
Is "sh_entsize" checked for 0?
No need. Because code above makes sure sh_entsize >= sizeof (*Dyn).
When you turn it into a runtime check as discussed above, yes.



+ ASSERT (RelShdr->sh_type == RelaType);
+ ASSERT (RelShdr->sh_entsize == RelaEntrySize);
See above.
Agree. Will add if-checks.


+ DEBUG ((DEBUG_INFO, "DYN ELF: Relocate using dynamic sections...\n"));
+ Status = RelocateElf32Dynamic (ElfCt);
+ ASSERT_EFI_ERROR (Status);
Why cannot this fail?
A DYN type ELF image should contain dynamic section. So only an abnormal ELF image can fail.
Same ASSERT point as above, "cannot" refers to both well-formed and ill-formed images.



+ return (Elf64_Phdr *)(ImageBase + Ehdr->e_phoff + Index * Ehdr->e_phentsize);
Alignment checks? Bounds checks?
For the alignment checks, do you suggest that I should make sure the segment should be placed
in the address that meets the alignment requirement?
It could be implemented, PE code does it, but I meant pointer alignment as discussed above somewhere. I don't think ELFs would likely request more than page alignment, but abort + DEBUG message sounds like a good idea.

ELF spec just requires below for Elf64_Phdr.p_align:
loadable process segments must have congruent values for p_vaddr and p_offset, modulo the page size.

I can add such check in ParseElfImage().

+ ProcessRelocation64 (
+ (Elf64_Rela *) (ElfCt->FileBase + RelShdr->sh_offset),
Alignment? :) I know there is no real concept in EDK II yet, but it
really is needed.
Can you explain a bit more on the alignment?
Done above, sorry.



+
+/**
+ Check if the ELF image is valid.
+
+ @param[in] ImageBase Memory address of an image.
+
+ @retval TRUE if valid.
+
+**/
+BOOLEAN
+IsElfFormat (
+ IN CONST UINT8 *ImageBase
You cannot safely inspect untrusted/unknown data without a size field,
also needs checks below.
Agree. Original idea was to add a ELF loader that can load the ELF assuming
the ELF image is well-formatted.
I get that idea, but the reality is that people will start using it for external images once it is needed. :)
Sorry for being pedantic.


But with your help, I am glad to enhance the logic a bit more to expand
the support of external ELF images.

Will add a "UINTN ImageSize" parameter.

+ )
+{
+ Elf32_Ehdr *Elf32Hdr;
+ Elf64_Ehdr *Elf64Hdr;
+
+ ASSERT (ImageBase != NULL);
+
+ Elf32Hdr = (Elf32_Ehdr *)ImageBase;
+
+ //
+ // Start with correct signature "\7fELF"
+ //
+ if ((Elf32Hdr->e_ident[EI_MAG0] != ELFMAG0) ||
+ (Elf32Hdr->e_ident[EI_MAG1] != ELFMAG1) ||
+ (Elf32Hdr->e_ident[EI_MAG1] != ELFMAG1) ||
+ (Elf32Hdr->e_ident[EI_MAG2] != ELFMAG2)
+ ) {
+ return FALSE;
+ }
+
+ //
+ // Support little-endian only
+ //
+ if (Elf32Hdr->e_ident[EI_DATA] != ELFDATA2LSB) {
+ return FALSE;
+ }
+
+ //
+ // Check 32/64-bit architecture
+ //
+ if (Elf32Hdr->e_ident[EI_CLASS] == ELFCLASS64) {
+ Elf64Hdr = (Elf64_Ehdr *)Elf32Hdr;
+ Elf32Hdr = NULL;
+ } else if (Elf32Hdr->e_ident[EI_CLASS] == ELFCLASS32) {
+ Elf64Hdr = NULL;
+ } else {
+ return FALSE;
+ }
Why are the branches above and below separated when they map basically 1:1?
Indeed. Thanks for catching this.
Will merge the separate "if" together.

+
+ if (Elf64Hdr != NULL) {
+ //
+ // Support intel architecture only for now
+ //
+ if (Elf64Hdr->e_machine != EM_X86_64) {
+ return FALSE;
+ }
+
+ // Use last section as end of file
+ Status = GetElfSectionPos (ElfCt, ElfCt->ShNum - 1, &Offset, &Size);
What if ShNum is 0?
Agree. The logic to calculate file size might not be needed.
Let me confirm and try to remove the entire function.


+ if (ElfCt->EiClass == ELFCLASS32) {
+ Elf32Hdr = (Elf32_Ehdr *)ElfCt->FileBase;
+ FileSize2 = Elf32Hdr->e_shoff + Elf32Hdr->e_shentsize * Elf32Hdr->e_shnum;
+ } else if (ElfCt->EiClass == ELFCLASS64) {
+ Elf64Hdr = (Elf64_Ehdr *)ElfCt->FileBase;
+ FileSize2 = (UINTN)(Elf64Hdr->e_shoff + Elf64Hdr->e_shentsize * Elf64Hdr->e_shnum);
+ }
Overflows?
Integer overflow?
Yes, sorry.

Will add integer overflow check if this file size calculation logic is still needed.


+
+ if (ElfCt == NULL) {
+ return EFI_INVALID_PARAMETER;
+ }
As this is function contract, I'd replace this with an ASSERT, or at
least have both.
I will put "ASSERT (ElfCt != NULL)" above the if.


+ ZeroMem (ElfCt, sizeof(ELF_IMAGE_CONTEXT));
+
+ if (ImageBase == NULL) {
+ return (ElfCt->ParseStatus = EFI_INVALID_PARAMETER);
If I see it correctly, all instances that can assign ParseStatus also
return it. Why is the member needed at all?
I expect that caller needs to call ParseElfImage() to get the ParseStatus
properly assigned before calling LoadElfImage().
But it just throws back the error without doing anything as far as I can see. For the new PE loader, there are "PeCoffInitializeContext" (more or less "ParseElfImage") and "PeCoffLoadImage" (more or less "LoadElfImage"), and there is a precondition to not call latter when former error'd.
A minimal caller cal look like this:

  Status = PeCoffInitializeContext (&Context, FileBuffer, FileSize);
  if (RETURN_ERROR (Status)) {
    return Status;
  }

  // [ ... hash image, allocate destination, and so on ... ]

  PeCoffLoadImage (Context, Destination, DestinationSize);

The load function is never invoked if the init function fails. This gives an intuitive and easy-to-comprehend control flow. The old PE lib also has a status member in the context, and it was one of the first things I went away with. Callers should not read from the context, and callees have clear contracts.


The member ParseStatus is checked in LoadElfImage() later.
Today it's just PayloadLoaderPeim that calls the ElfLib functions.
But I expect that the ElfLib functions can be public lib APIs in future
if needs appear.


+ Name = (CHAR8 *)(ElfCt->FileBase + ElfCt->ShStrOff + Elf64Shdr->sh_name);
0-termination checks, or return size?
I will validate the string section in ParseElfImage(). The validation logic will:
1. Verify that each section name is pointed from the e_shstrndx
2. Verify that section name strings don't occupy spaces outside of the string section.


+
+ ZeroMem (&Context, sizeof (Context));
This is done by the callee already.
Indeed. Will remove this.
Rest looks good, thanks a lot!

If you have some time, please consider checking the rest for similar issues. I maybe could help with it if you would like that, but not right now, sorry. :)

Best regards,
Marvin



+ Status = ParseElfImage (Elf, &Context);
+ } while (EFI_ERROR (Status));


Ni, Ray
 

Thank you for your quick reply, comments inline.
I have to be quick because my project depends on the check-in of this code😊

+ for ( Index = 0
+ ; RelaEntrySize * Index < RelaSize
Overflow?
Will change from:
RelaEntrySize * Index < RelaSize
to:
Index < RelaSize / RelaEntrySize
imo add ASSERT for RelaEntrySize > 0 then.
Sure. To avoid dividend by zero error.

Basically the alignment of any offset with which a pointer to
non-trivially-aligned (i.e. requirement > 1 Byte) data can be forged
must be checked.

Examples from our new PE loader:
https://github.com/mhaeuser/ISPRASOpen-
SecurePE/tree/6a7abcd8647cf6faa733082f6d8dcc9adc141d7e/src/PeCoffInit.
c#L1226
->
https://github.com/mhaeuser/ISPRASOpen-
SecurePE/tree/6a7abcd8647cf6faa733082f6d8dcc9adc141d7e/src/PeCoffInit.
c#L1242
https://github.com/mhaeuser/ISPRASOpen-
SecurePE/tree/6a7abcd8647cf6faa733082f6d8dcc9adc141d7e/src/PeCoffInit.
c#L1389
->
https://github.com/mhaeuser/ISPRASOpen-
SecurePE/tree/6a7abcd8647cf6faa733082f6d8dcc9adc141d7e/src/PeCoffInit.
c#L148

The idea here is that the base pointer (i.e. image header) is "maximally
aligned" (i.e. can hold data of any platform data alignment). For the 8
Bytes AllocatePool() guarantees (file data), this is sufficient for any
primitive and composite data type. For the 4 KB AllocatePages()
guarantees (destination), this is sufficient of that, and for advanced
things like AVX (however not needed here). If the base is maximally
aligned, Base + X is guaranteed aligned for A if X is aligned for A,
i.e. X % _Alignof(A) = 0. Failing to verify this can cause exceptions on
platforms which don't support or have disabled the capability to perform
unaligned memory accesses.
I understand now. I remember that X86 contains a control flag that can trigger
CPU exception as well when unaligned access happens.

But adding such check in all places might require a huge change to today's code.
Can you accept that I ignore such check for now and add it later?



+ //
+ // It's abnormal a DYN ELF doesn't contain a dynamic section.
+ //
+ ASSERT (DynShdr != NULL);
+ if (DynShdr == NULL) {
+ return EFI_UNSUPPORTED;
+ }
+ ASSERT (DynShdr->sh_type == SHT_DYNAMIC);
+ ASSERT (DynShdr->sh_entsize >= sizeof (*Dyn));
Abnormalities in unknown/untrusted data must be filtered with a runtime
check, not with an ASSERT.
Sure. I will add if-check below the assertion so assertion-enabled build can
report the errors earlier.
I have started this discussion under another patch, maybe I should write
a broader-scope mail to the list for comments. Basically using ASSERTs
for anything but *impossible* (*not* assuming the input data is
well-formed) situations significantly reduces the efficacy of dynamic
analysis. When doing fuzzing for example, you want to keep the ASSERTs
enabled to be made aware of any internal invariant violations. But if
ASSERTs happen on possible conditions, they will kill the fuzzing
process for no good reason. Turning them off will not analyse your
ASSERTs for possible code defects.

Maybe fuzzing would be a good idea for this library? :)
I understand now. I am ok to remove assertion for external inputs.



+ for ( Index = 0, Dyn = (Elf32_Dyn *) (ElfCt->FileBase + DynShdr-
sh_offset)
+ ; Index < DynShdr->sh_size / DynShdr->sh_entsize
Is "sh_entsize" checked for 0?
No need. Because code above makes sure sh_entsize >= sizeof (*Dyn).
When you turn it into a runtime check as discussed above, yes.



+ ASSERT (RelShdr->sh_type == RelaType);
+ ASSERT (RelShdr->sh_entsize == RelaEntrySize);
See above.
Agree. Will add if-checks.


+ DEBUG ((DEBUG_INFO, "DYN ELF: Relocate using dynamic
sections...\n"));
+ Status = RelocateElf32Dynamic (ElfCt);
+ ASSERT_EFI_ERROR (Status);
Why cannot this fail?
A DYN type ELF image should contain dynamic section. So only an abnormal
ELF image can fail.

Same ASSERT point as above, "cannot" refers to both well-formed and
ill-formed images.
Sure. Will remove assertion.



+ return (Elf64_Phdr *)(ImageBase + Ehdr->e_phoff + Index * Ehdr-
e_phentsize);
Alignment checks? Bounds checks?
For the alignment checks, do you suggest that I should make sure the
segment should be placed
in the address that meets the alignment requirement?
It could be implemented, PE code does it, but I meant pointer alignment
as discussed above somewhere. I don't think ELFs would likely request
more than page alignment, but abort + DEBUG message sounds like a good
idea.

ELF spec just requires below for Elf64_Phdr.p_align:
loadable process segments must have congruent values for p_vaddr and
p_offset, modulo the page size.

I can add such check in ParseElfImage().

+ ProcessRelocation64 (
+ (Elf64_Rela *) (ElfCt->FileBase + RelShdr->sh_offset),
Alignment? :) I know there is no real concept in EDK II yet, but it
really is needed.
Can you explain a bit more on the alignment?
Done above, sorry.



+
+/**
+ Check if the ELF image is valid.
+
+ @param[in] ImageBase Memory address of an image.
+
+ @retval TRUE if valid.
+
+**/
+BOOLEAN
+IsElfFormat (
+ IN CONST UINT8 *ImageBase
You cannot safely inspect untrusted/unknown data without a size field,
also needs checks below.
Agree. Original idea was to add a ELF loader that can load the ELF assuming
the ELF image is well-formatted.
I get that idea, but the reality is that people will start using it for
external images once it is needed. :)
Sorry for being pedantic.


But with your help, I am glad to enhance the logic a bit more to expand
the support of external ELF images.

Will add a "UINTN ImageSize" parameter.

+ )
+{
+ Elf32_Ehdr *Elf32Hdr;
+ Elf64_Ehdr *Elf64Hdr;
+
+ ASSERT (ImageBase != NULL);
+
+ Elf32Hdr = (Elf32_Ehdr *)ImageBase;
+
+ //
+ // Start with correct signature "\7fELF"
+ //
+ if ((Elf32Hdr->e_ident[EI_MAG0] != ELFMAG0) ||
+ (Elf32Hdr->e_ident[EI_MAG1] != ELFMAG1) ||
+ (Elf32Hdr->e_ident[EI_MAG1] != ELFMAG1) ||
+ (Elf32Hdr->e_ident[EI_MAG2] != ELFMAG2)
+ ) {
+ return FALSE;
+ }
+
+ //
+ // Support little-endian only
+ //
+ if (Elf32Hdr->e_ident[EI_DATA] != ELFDATA2LSB) {
+ return FALSE;
+ }
+
+ //
+ // Check 32/64-bit architecture
+ //
+ if (Elf32Hdr->e_ident[EI_CLASS] == ELFCLASS64) {
+ Elf64Hdr = (Elf64_Ehdr *)Elf32Hdr;
+ Elf32Hdr = NULL;
+ } else if (Elf32Hdr->e_ident[EI_CLASS] == ELFCLASS32) {
+ Elf64Hdr = NULL;
+ } else {
+ return FALSE;
+ }
Why are the branches above and below separated when they map
basically 1:1?
Indeed. Thanks for catching this.
Will merge the separate "if" together.

+
+ if (Elf64Hdr != NULL) {
+ //
+ // Support intel architecture only for now
+ //
+ if (Elf64Hdr->e_machine != EM_X86_64) {
+ return FALSE;
+ }
+
+ // Use last section as end of file
+ Status = GetElfSectionPos (ElfCt, ElfCt->ShNum - 1, &Offset, &Size);
What if ShNum is 0?
Agree. The logic to calculate file size might not be needed.
Let me confirm and try to remove the entire function.


+ if (ElfCt->EiClass == ELFCLASS32) {
+ Elf32Hdr = (Elf32_Ehdr *)ElfCt->FileBase;
+ FileSize2 = Elf32Hdr->e_shoff + Elf32Hdr->e_shentsize * Elf32Hdr-
e_shnum;
+ } else if (ElfCt->EiClass == ELFCLASS64) {
+ Elf64Hdr = (Elf64_Ehdr *)ElfCt->FileBase;
+ FileSize2 = (UINTN)(Elf64Hdr->e_shoff + Elf64Hdr->e_shentsize *
Elf64Hdr->e_shnum);
+ }
Overflows?
Integer overflow?
Yes, sorry.

Will add integer overflow check if this file size calculation logic is still needed.


+
+ if (ElfCt == NULL) {
+ return EFI_INVALID_PARAMETER;
+ }
As this is function contract, I'd replace this with an ASSERT, or at
least have both.
I will put "ASSERT (ElfCt != NULL)" above the if.


+ ZeroMem (ElfCt, sizeof(ELF_IMAGE_CONTEXT));
+
+ if (ImageBase == NULL) {
+ return (ElfCt->ParseStatus = EFI_INVALID_PARAMETER);
If I see it correctly, all instances that can assign ParseStatus also
return it. Why is the member needed at all?
I expect that caller needs to call ParseElfImage() to get the ParseStatus
properly assigned before calling LoadElfImage().
But it just throws back the error without doing anything as far as I can
see. For the new PE loader, there are "PeCoffInitializeContext" (more or
less "ParseElfImage") and "PeCoffLoadImage" (more or less
"LoadElfImage"), and there is a precondition to not call latter when
former error'd.
A minimal caller cal look like this:

Status = PeCoffInitializeContext (&Context, FileBuffer, FileSize);
if (RETURN_ERROR (Status)) {
return Status;
}

// [ ... hash image, allocate destination, and so on ... ]

PeCoffLoadImage (Context, Destination, DestinationSize);

The load function is never invoked if the init function fails. This
gives an intuitive and easy-to-comprehend control flow. The old PE lib
also has a status member in the context, and it was one of the first
things I went away with. Callers should not read from the context, and
callees have clear contracts.
Without the ParseStatus field, callee cannot know whether ParseElfImage() is called.
There are several APIs which all depend on the well format of ELF image.
For example:
GetElfSectionName
GetElfSectionPos
LoadElfImage

If the ParseStatus is removed, all above API implementations need to call
ParseElfImage() again internally to make sure the ELF image is well formatted.

Caller doesn't need to read the ParseStatus. It just need to check the return
status of API calls.


The member ParseStatus is checked in LoadElfImage() later.
Today it's just PayloadLoaderPeim that calls the ElfLib functions.
But I expect that the ElfLib functions can be public lib APIs in future
if needs appear.


+ Name = (CHAR8 *)(ElfCt->FileBase + ElfCt->ShStrOff + Elf64Shdr-
sh_name);
0-termination checks, or return size?
I will validate the string section in ParseElfImage(). The validation logic will:
1. Verify that each section name is pointed from the e_shstrndx
2. Verify that section name strings don't occupy spaces outside of the string
section.


+
+ ZeroMem (&Context, sizeof (Context));
This is done by the callee already.
Indeed. Will remove this.
Rest looks good, thanks a lot!

If you have some time, please consider checking the rest for similar
issues. I maybe could help with it if you would like that, but not right
now, sorry. :)

Best regards,
Marvin


Marvin Häuser
 

On 09.06.21 11:49, Ni, Ray wrote:
Thank you for your quick reply, comments inline.
I have to be quick because my project depends on the check-in of this code😊
Sure, so thanks a lot for taking the time!
One non-trivial comment at the bottom.


+ for ( Index = 0
+ ; RelaEntrySize * Index < RelaSize
Overflow?
Will change from:
RelaEntrySize * Index < RelaSize
to:
Index < RelaSize / RelaEntrySize
imo add ASSERT for RelaEntrySize > 0 then.
Sure. To avoid dividend by zero error.

Basically the alignment of any offset with which a pointer to
non-trivially-aligned (i.e. requirement > 1 Byte) data can be forged
must be checked.

Examples from our new PE loader:
https://github.com/mhaeuser/ISPRASOpen-
SecurePE/tree/6a7abcd8647cf6faa733082f6d8dcc9adc141d7e/src/PeCoffInit.
c#L1226
->
https://github.com/mhaeuser/ISPRASOpen-
SecurePE/tree/6a7abcd8647cf6faa733082f6d8dcc9adc141d7e/src/PeCoffInit.
c#L1242
https://github.com/mhaeuser/ISPRASOpen-
SecurePE/tree/6a7abcd8647cf6faa733082f6d8dcc9adc141d7e/src/PeCoffInit.
c#L1389
->
https://github.com/mhaeuser/ISPRASOpen-
SecurePE/tree/6a7abcd8647cf6faa733082f6d8dcc9adc141d7e/src/PeCoffInit.
c#L148

The idea here is that the base pointer (i.e. image header) is "maximally
aligned" (i.e. can hold data of any platform data alignment). For the 8
Bytes AllocatePool() guarantees (file data), this is sufficient for any
primitive and composite data type. For the 4 KB AllocatePages()
guarantees (destination), this is sufficient of that, and for advanced
things like AVX (however not needed here). If the base is maximally
aligned, Base + X is guaranteed aligned for A if X is aligned for A,
i.e. X % _Alignof(A) = 0. Failing to verify this can cause exceptions on
platforms which don't support or have disabled the capability to perform
unaligned memory accesses.
I understand now. I remember that X86 contains a control flag that can trigger
CPU exception as well when unaligned access happens.

But adding such check in all places might require a huge change to today's code.
Can you accept that I ignore such check for now and add it later?
Of course, I mean, it needs some EDK II wide concept first anyway. Just the overall situation is similar (but a lot worse in severity) with the PE loader and now it's not easy to address the issues. :)
So if there are plans to address it, that's great!


+ //
+ // It's abnormal a DYN ELF doesn't contain a dynamic section.
+ //
+ ASSERT (DynShdr != NULL);
+ if (DynShdr == NULL) {
+ return EFI_UNSUPPORTED;
+ }
+ ASSERT (DynShdr->sh_type == SHT_DYNAMIC);
+ ASSERT (DynShdr->sh_entsize >= sizeof (*Dyn));
Abnormalities in unknown/untrusted data must be filtered with a runtime
check, not with an ASSERT.
Sure. I will add if-check below the assertion so assertion-enabled build can
report the errors earlier.
I have started this discussion under another patch, maybe I should write
a broader-scope mail to the list for comments. Basically using ASSERTs
for anything but *impossible* (*not* assuming the input data is
well-formed) situations significantly reduces the efficacy of dynamic
analysis. When doing fuzzing for example, you want to keep the ASSERTs
enabled to be made aware of any internal invariant violations. But if
ASSERTs happen on possible conditions, they will kill the fuzzing
process for no good reason. Turning them off will not analyse your
ASSERTs for possible code defects.

Maybe fuzzing would be a good idea for this library? :)
I understand now. I am ok to remove assertion for external inputs.
Thank you.



+ for ( Index = 0, Dyn = (Elf32_Dyn *) (ElfCt->FileBase + DynShdr-
sh_offset)
+ ; Index < DynShdr->sh_size / DynShdr->sh_entsize
Is "sh_entsize" checked for 0?
No need. Because code above makes sure sh_entsize >= sizeof (*Dyn).
When you turn it into a runtime check as discussed above, yes.


+ ASSERT (RelShdr->sh_type == RelaType);
+ ASSERT (RelShdr->sh_entsize == RelaEntrySize);
See above.
Agree. Will add if-checks.


+ DEBUG ((DEBUG_INFO, "DYN ELF: Relocate using dynamic
sections...\n"));
+ Status = RelocateElf32Dynamic (ElfCt);
+ ASSERT_EFI_ERROR (Status);
Why cannot this fail?
A DYN type ELF image should contain dynamic section. So only an abnormal
ELF image can fail.

Same ASSERT point as above, "cannot" refers to both well-formed and
ill-formed images.
Sure. Will remove assertion.


+ return (Elf64_Phdr *)(ImageBase + Ehdr->e_phoff + Index * Ehdr-
e_phentsize);
Alignment checks? Bounds checks?
For the alignment checks, do you suggest that I should make sure the
segment should be placed
in the address that meets the alignment requirement?
It could be implemented, PE code does it, but I meant pointer alignment
as discussed above somewhere. I don't think ELFs would likely request
more than page alignment, but abort + DEBUG message sounds like a good
idea.

ELF spec just requires below for Elf64_Phdr.p_align:
loadable process segments must have congruent values for p_vaddr and
p_offset, modulo the page size.
I can add such check in ParseElfImage().

+ ProcessRelocation64 (
+ (Elf64_Rela *) (ElfCt->FileBase + RelShdr->sh_offset),
Alignment? :) I know there is no real concept in EDK II yet, but it
really is needed.
Can you explain a bit more on the alignment?
Done above, sorry.


+
+/**
+ Check if the ELF image is valid.
+
+ @param[in] ImageBase Memory address of an image.
+
+ @retval TRUE if valid.
+
+**/
+BOOLEAN
+IsElfFormat (
+ IN CONST UINT8 *ImageBase
You cannot safely inspect untrusted/unknown data without a size field,
also needs checks below.
Agree. Original idea was to add a ELF loader that can load the ELF assuming
the ELF image is well-formatted.
I get that idea, but the reality is that people will start using it for
external images once it is needed. :)
Sorry for being pedantic.

But with your help, I am glad to enhance the logic a bit more to expand
the support of external ELF images.

Will add a "UINTN ImageSize" parameter.

+ )
+{
+ Elf32_Ehdr *Elf32Hdr;
+ Elf64_Ehdr *Elf64Hdr;
+
+ ASSERT (ImageBase != NULL);
+
+ Elf32Hdr = (Elf32_Ehdr *)ImageBase;
+
+ //
+ // Start with correct signature "\7fELF"
+ //
+ if ((Elf32Hdr->e_ident[EI_MAG0] != ELFMAG0) ||
+ (Elf32Hdr->e_ident[EI_MAG1] != ELFMAG1) ||
+ (Elf32Hdr->e_ident[EI_MAG1] != ELFMAG1) ||
+ (Elf32Hdr->e_ident[EI_MAG2] != ELFMAG2)
+ ) {
+ return FALSE;
+ }
+
+ //
+ // Support little-endian only
+ //
+ if (Elf32Hdr->e_ident[EI_DATA] != ELFDATA2LSB) {
+ return FALSE;
+ }
+
+ //
+ // Check 32/64-bit architecture
+ //
+ if (Elf32Hdr->e_ident[EI_CLASS] == ELFCLASS64) {
+ Elf64Hdr = (Elf64_Ehdr *)Elf32Hdr;
+ Elf32Hdr = NULL;
+ } else if (Elf32Hdr->e_ident[EI_CLASS] == ELFCLASS32) {
+ Elf64Hdr = NULL;
+ } else {
+ return FALSE;
+ }
Why are the branches above and below separated when they map
basically 1:1?
Indeed. Thanks for catching this.
Will merge the separate "if" together.

+
+ if (Elf64Hdr != NULL) {
+ //
+ // Support intel architecture only for now
+ //
+ if (Elf64Hdr->e_machine != EM_X86_64) {
+ return FALSE;
+ }
+
+ // Use last section as end of file
+ Status = GetElfSectionPos (ElfCt, ElfCt->ShNum - 1, &Offset, &Size);
What if ShNum is 0?
Agree. The logic to calculate file size might not be needed.
Let me confirm and try to remove the entire function.


+ if (ElfCt->EiClass == ELFCLASS32) {
+ Elf32Hdr = (Elf32_Ehdr *)ElfCt->FileBase;
+ FileSize2 = Elf32Hdr->e_shoff + Elf32Hdr->e_shentsize * Elf32Hdr-
e_shnum;
+ } else if (ElfCt->EiClass == ELFCLASS64) {
+ Elf64Hdr = (Elf64_Ehdr *)ElfCt->FileBase;
+ FileSize2 = (UINTN)(Elf64Hdr->e_shoff + Elf64Hdr->e_shentsize *
Elf64Hdr->e_shnum);
+ }
Overflows?
Integer overflow?
Yes, sorry.

Will add integer overflow check if this file size calculation logic is still needed.


+
+ if (ElfCt == NULL) {
+ return EFI_INVALID_PARAMETER;
+ }
As this is function contract, I'd replace this with an ASSERT, or at
least have both.
I will put "ASSERT (ElfCt != NULL)" above the if.


+ ZeroMem (ElfCt, sizeof(ELF_IMAGE_CONTEXT));
+
+ if (ImageBase == NULL) {
+ return (ElfCt->ParseStatus = EFI_INVALID_PARAMETER);
If I see it correctly, all instances that can assign ParseStatus also
return it. Why is the member needed at all?
I expect that caller needs to call ParseElfImage() to get the ParseStatus
properly assigned before calling LoadElfImage().
But it just throws back the error without doing anything as far as I can
see. For the new PE loader, there are "PeCoffInitializeContext" (more or
less "ParseElfImage") and "PeCoffLoadImage" (more or less
"LoadElfImage"), and there is a precondition to not call latter when
former error'd.
A minimal caller cal look like this:

Status = PeCoffInitializeContext (&Context, FileBuffer, FileSize);
if (RETURN_ERROR (Status)) {
return Status;
}

// [ ... hash image, allocate destination, and so on ... ]

PeCoffLoadImage (Context, Destination, DestinationSize);

The load function is never invoked if the init function fails. This
gives an intuitive and easy-to-comprehend control flow. The old PE lib
also has a status member in the context, and it was one of the first
things I went away with. Callers should not read from the context, and
callees have clear contracts.
Without the ParseStatus field, callee cannot know whether ParseElfImage() is called.
It can by function contracts, the caller guarantees it. I.e. with the PE library I linked, no other function must be called before the init function.
Your "ParseElfImage" function is very similar. The context is initialized by it, i.e. it is trash if it is not called, i.e. it must be called before other functions.
If it is called, which we know, the caller has the return status. For PE, it means the caller must not proceed with any further PE processing and abort immediately.
Is there any scenario where this does not work for ELF? Sorry if I missed something.

Best regards,
Marvin

There are several APIs which all depend on the well format of ELF image.
For example:
GetElfSectionName
GetElfSectionPos
LoadElfImage

If the ParseStatus is removed, all above API implementations need to call
ParseElfImage() again internally to make sure the ELF image is well formatted.

Caller doesn't need to read the ParseStatus. It just need to check the return
status of API calls.

The member ParseStatus is checked in LoadElfImage() later.
Today it's just PayloadLoaderPeim that calls the ElfLib functions.
But I expect that the ElfLib functions can be public lib APIs in future
if needs appear.


+ Name = (CHAR8 *)(ElfCt->FileBase + ElfCt->ShStrOff + Elf64Shdr-
sh_name);
0-termination checks, or return size?
I will validate the string section in ParseElfImage(). The validation logic will:
1. Verify that each section name is pointed from the e_shstrndx
2. Verify that section name strings don't occupy spaces outside of the string
section.

+
+ ZeroMem (&Context, sizeof (Context));
This is done by the callee already.
Indeed. Will remove this.
Rest looks good, thanks a lot!

If you have some time, please consider checking the rest for similar
issues. I maybe could help with it if you would like that, but not right
now, sorry. :)

Best regards,
Marvin



Ni, Ray
 

Without the ParseStatus field, callee cannot know whether ParseElfImage()
is called.

It can by function contracts, the caller guarantees it. I.e. with the PE
library I linked, no other function must be called before the init function.
Your "ParseElfImage" function is very similar. The context is
initialized by it, i.e. it is trash if it is not called, i.e. it must be
called before other functions.
If it is called, which we know, the caller has the return status. For
PE, it means the caller must not proceed with any further PE processing
and abort immediately.
Is there any scenario where this does not work for ELF? Sorry if I
missed something.
Caller might call LoadElfImage() without firstly calling ParseElfImage() by mistake.
ParseStatus is added to catch such mistake.

I don't trust the caller would follow the contracts properly😊.


Marvin Häuser
 

On 10.06.21 05:40, Ni, Ray wrote:
Without the ParseStatus field, callee cannot know whether ParseElfImage()
is called.

It can by function contracts, the caller guarantees it. I.e. with the PE
library I linked, no other function must be called before the init function.
Your "ParseElfImage" function is very similar. The context is
initialized by it, i.e. it is trash if it is not called, i.e. it must be
called before other functions.
If it is called, which we know, the caller has the return status. For
PE, it means the caller must not proceed with any further PE processing
and abort immediately.
Is there any scenario where this does not work for ELF? Sorry if I
missed something.
Caller might call LoadElfImage() without firstly calling ParseElfImage() by mistake.
ParseStatus is added to catch such mistake.
If ParseElfImage() is not called, nothing will initialize ParseStatus and the load function will read random data. If AllocateZeroPool was used for the context, a common pattern throughout the codebase to harden against memory initialization bugs, it would even report success at all times anyway. Sorry, but I think this is dead code.

Maybe for some context, my main issue at first was that the checks are all proper runtime checks with no ASSERTs at all, so I got confused how this situation could happen in a realistic scenario. I needed to trace the ParseStatus data flow to understand the idea is basically the same as in the PE library. Code in a way is self-documenting, and this personally gave me a hard time understanding why it is written this way. But thanks for clarifying your intention! :)

Best regards,
Marvin


I don't trust the caller would follow the contracts properly😊.


Ni, Ray
 

Maybe for some context, my main issue at first was that the checks are
all proper runtime checks with no ASSERTs at all, so I got confused how
this situation could happen in a realistic scenario. I needed to trace
the ParseStatus data flow to understand the idea is basically the same
as in the PE library. Code in a way is self-documenting, and this
personally gave me a hard time understanding why it is written this way.
But thanks for clarifying your intention! :)
I assume you are ok with the ParseStatus.
I will send new version based on mail discussion. Thanks!


Marvin Häuser
 

On 10.06.21 11:39, Ni, Ray wrote:
Maybe for some context, my main issue at first was that the checks are
all proper runtime checks with no ASSERTs at all, so I got confused how
this situation could happen in a realistic scenario. I needed to trace
the ParseStatus data flow to understand the idea is basically the same
as in the PE library. Code in a way is self-documenting, and this
personally gave me a hard time understanding why it is written this way.
But thanks for clarifying your intention! :)
I assume you are ok with the ParseStatus.
I will send new version based on mail discussion. Thanks!
I don't need to be okay with anything, I'm not a maintainer nor an authority. But I gave my opinion, which is that it is dead code that makes the design/flow harder to understand for a third party, at no obvious benefit.

Thank you for preparing fixes.

Best regards,
Marvin


Michael Brown
 

On 10/06/2021 11:13, Marvin Häuser wrote:
On 10.06.21 11:39, Ni, Ray wrote:
Maybe for some context, my main issue at first was that the checks are
all proper runtime checks with no ASSERTs at all, so I got confused how
this situation could happen in a realistic scenario. I needed to trace
the ParseStatus data flow to understand the idea is basically the same
as in the PE library. Code in a way is self-documenting, and this
personally gave me a hard time understanding why it is written this way.
But thanks for clarifying your intention! :)
I assume you are ok with the ParseStatus.
I will send new version based on mail discussion. Thanks!
I don't need to be okay with anything, I'm not a maintainer nor an authority. But I gave my opinion, which is that it is dead code that makes the design/flow harder to understand for a third party, at no obvious benefit.
FWIW, I strongly agree with Marvin on this: having ParseStatus in its current form is a bad idea since it adds no value but does incur a cost.

Thanks,

Michael


Ni, Ray
 

-----Original Message-----
From: devel@edk2.groups.io <devel@edk2.groups.io> On Behalf Of Michael Brown
Sent: Thursday, June 10, 2021 6:43 PM
To: devel@edk2.groups.io; mhaeuser@...; Ni, Ray <ray.ni@...>
Cc: Ma, Maurice <maurice.ma@...>; Dong, Guo <guo.dong@...>; You, Benjamin <benjamin.you@...>
Subject: Re: [edk2-devel] [PATCH v2 2/3] UefiPayloadPkg: Add PayloadLoaderPeim which can load ELF payload

On 10/06/2021 11:13, Marvin Häuser wrote:
On 10.06.21 11:39, Ni, Ray wrote:
Maybe for some context, my main issue at first was that the checks are
all proper runtime checks with no ASSERTs at all, so I got confused how
this situation could happen in a realistic scenario. I needed to trace
the ParseStatus data flow to understand the idea is basically the same
as in the PE library. Code in a way is self-documenting, and this
personally gave me a hard time understanding why it is written this way.
But thanks for clarifying your intention! :)
I assume you are ok with the ParseStatus.
I will send new version based on mail discussion. Thanks!
I don't need to be okay with anything, I'm not a maintainer nor an
authority. But I gave my opinion, which is that it is dead code that
makes the design/flow harder to understand for a third party, at no
obvious benefit.
FWIW, I strongly agree with Marvin on this: having ParseStatus in its
current form is a bad idea since it adds no value but does incur a cost.
OK. I can remove that😊


Ni, Ray
 

Marvin,
I have sent out https://edk2.groups.io/g/devel/message/76429 <UefiPayloadPkg/PayloadLoader: Add more checks to verify ELF images> to address your feedbacks.

Can I merge the 3 patches first? (we can continue discussing the more-checks patch.)

Thanks,
Ray

-----Original Message-----
From: devel@edk2.groups.io <devel@edk2.groups.io> On Behalf Of Ni, Ray
Sent: Thursday, June 10, 2021 7:37 PM
To: devel@edk2.groups.io; mcb30@...; mhaeuser@...
Cc: Ma, Maurice <maurice.ma@...>; Dong, Guo <guo.dong@...>; You, Benjamin <benjamin.you@...>
Subject: Re: [edk2-devel] [PATCH v2 2/3] UefiPayloadPkg: Add PayloadLoaderPeim which can load ELF payload



-----Original Message-----
From: devel@edk2.groups.io <devel@edk2.groups.io> On Behalf Of Michael Brown
Sent: Thursday, June 10, 2021 6:43 PM
To: devel@edk2.groups.io; mhaeuser@...; Ni, Ray <ray.ni@...>
Cc: Ma, Maurice <maurice.ma@...>; Dong, Guo <guo.dong@...>; You, Benjamin <benjamin.you@...>
Subject: Re: [edk2-devel] [PATCH v2 2/3] UefiPayloadPkg: Add PayloadLoaderPeim which can load ELF payload

On 10/06/2021 11:13, Marvin Häuser wrote:
On 10.06.21 11:39, Ni, Ray wrote:
Maybe for some context, my main issue at first was that the checks are
all proper runtime checks with no ASSERTs at all, so I got confused how
this situation could happen in a realistic scenario. I needed to trace
the ParseStatus data flow to understand the idea is basically the same
as in the PE library. Code in a way is self-documenting, and this
personally gave me a hard time understanding why it is written this way.
But thanks for clarifying your intention! :)
I assume you are ok with the ParseStatus.
I will send new version based on mail discussion. Thanks!
I don't need to be okay with anything, I'm not a maintainer nor an
authority. But I gave my opinion, which is that it is dead code that
makes the design/flow harder to understand for a third party, at no
obvious benefit.
FWIW, I strongly agree with Marvin on this: having ParseStatus in its
current form is a bad idea since it adds no value but does incur a cost.
OK. I can remove that😊





Marvin Häuser
 

Hey Ray,

Sure, thanks a lot for taking the time. I will need a bit longer to get to it, sorry. :)

Best regards,
Marvin

On 15.06.21 16:36, Ni, Ray wrote:
Marvin,
I have sent out https://edk2.groups.io/g/devel/message/76429 <UefiPayloadPkg/PayloadLoader: Add more checks to verify ELF images> to address your feedbacks.

Can I merge the 3 patches first? (we can continue discussing the more-checks patch.)

Thanks,
Ray

-----Original Message-----
From: devel@edk2.groups.io <devel@edk2.groups.io> On Behalf Of Ni, Ray
Sent: Thursday, June 10, 2021 7:37 PM
To: devel@edk2.groups.io; mcb30@...; mhaeuser@...
Cc: Ma, Maurice <maurice.ma@...>; Dong, Guo <guo.dong@...>; You, Benjamin <benjamin.you@...>
Subject: Re: [edk2-devel] [PATCH v2 2/3] UefiPayloadPkg: Add PayloadLoaderPeim which can load ELF payload



-----Original Message-----
From: devel@edk2.groups.io <devel@edk2.groups.io> On Behalf Of Michael Brown
Sent: Thursday, June 10, 2021 6:43 PM
To: devel@edk2.groups.io; mhaeuser@...; Ni, Ray <ray.ni@...>
Cc: Ma, Maurice <maurice.ma@...>; Dong, Guo <guo.dong@...>; You, Benjamin <benjamin.you@...>
Subject: Re: [edk2-devel] [PATCH v2 2/3] UefiPayloadPkg: Add PayloadLoaderPeim which can load ELF payload

On 10/06/2021 11:13, Marvin Häuser wrote:
On 10.06.21 11:39, Ni, Ray wrote:
Maybe for some context, my main issue at first was that the checks are
all proper runtime checks with no ASSERTs at all, so I got confused how
this situation could happen in a realistic scenario. I needed to trace
the ParseStatus data flow to understand the idea is basically the same
as in the PE library. Code in a way is self-documenting, and this
personally gave me a hard time understanding why it is written this way.
But thanks for clarifying your intention! :)
I assume you are ok with the ParseStatus.
I will send new version based on mail discussion. Thanks!
I don't need to be okay with anything, I'm not a maintainer nor an
authority. But I gave my opinion, which is that it is dead code that
makes the design/flow harder to understand for a third party, at no
obvious benefit.
FWIW, I strongly agree with Marvin on this: having ParseStatus in its
current form is a bad idea since it adds no value but does incur a cost.
OK. I can remove that😊