From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from mga18.intel.com (mga18.intel.com [134.134.136.126]) by mx.groups.io with SMTP id smtpd.web12.4406.1622701406547707263 for ; Wed, 02 Jun 2021 23:23:26 -0700 Authentication-Results: mx.groups.io; dkim=missing; spf=pass (domain: intel.com, ip: 134.134.136.126, mailfrom: ray.ni@intel.com) IronPort-SDR: haURbYVGyJtAEzPdX319Ji8ivqn/BAUGIZZ+TzQ9SiTeSiVOu7v5bigOwmcQJZXiTCVzcJ5j5Y hMCZY/qtL/OA== X-IronPort-AV: E=McAfee;i="6200,9189,10003"; a="191323257" X-IronPort-AV: E=Sophos;i="5.83,244,1616482800"; d="scan'208";a="191323257" Received: from fmsmga008.fm.intel.com ([10.253.24.58]) by orsmga106.jf.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 02 Jun 2021 23:23:25 -0700 IronPort-SDR: 0fHQjOQ3n9VOjv1zR4n1pzUJb8aifbopG+X6aYIftjf1OGbslGwwnpCmBBg9nPysBbE5ix2lmR gIM2iGWkThVQ== X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.83,244,1616482800"; d="scan'208";a="447728744" Received: from ray-dev.ccr.corp.intel.com ([10.239.158.87]) by fmsmga008.fm.intel.com with ESMTP; 02 Jun 2021 23:23:22 -0700 From: "Ni, Ray" To: devel@edk2.groups.io Cc: Maurice Ma , Guo Dong , Benjamin You Subject: [PATCH v2 2/3] UefiPayloadPkg: Add PayloadLoaderPeim which can load ELF payload Date: Thu, 3 Jun 2021 14:22:58 +0800 Message-Id: <20210603062259.1390-3-ray.ni@intel.com> X-Mailer: git-send-email 2.31.1.windows.1 In-Reply-To: <20210603062259.1390-1-ray.ni@intel.com> References: <20210603062259.1390-1-ray.ni@intel.com> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable 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 Signed-off-by: Ray Ni Cc: Maurice Ma Cc: Guo Dong Cc: 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.
=0D + SPDX-License-Identifier: BSD-2-Clause-Patent=0D +=0D +**/=0D +=0D +#ifndef ELF_LIB_H_=0D +#define ELF_LIB_H_=0D +=0D +#include =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.
=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.
=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.
=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.
=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.
=0D +Portions Copyright (c) 2011 - 2013, ARM Ltd. All rights reserved.
=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.
=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.
=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 =0D +#include =0D +#include =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.
=0D +SPDX-License-Identifier: BSD-2-Clause-Patent=0D +=0D +**/=0D +=0D +#include =0D +#include =0D +#include =0D +=0D +#include =0D +=0D +#include =0D +#include =0D +#include =0D +#include =0D +#include =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.
=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