// elfcpp.h -- main header file for elfcpp -*- C++ -*-
+// Copyright 2006, 2007, 2008, 2009, 2010 Free Software Foundation, Inc.
+// Written by Ian Lance Taylor <iant@google.com>.
+
+// This file is part of elfcpp.
+
+// This program is free software; you can redistribute it and/or
+// modify it under the terms of the GNU Library General Public License
+// as published by the Free Software Foundation; either version 2, or
+// (at your option) any later version.
+
+// In addition to the permissions in the GNU Library General Public
+// License, the Free Software Foundation gives you unlimited
+// permission to link the compiled version of this file into
+// combinations with other programs, and to distribute those
+// combinations without any restriction coming from the use of this
+// file. (The Library Public License restrictions do apply in other
+// respects; for example, they cover modification of the file, and
+// distribution when not linked into a combined executable.)
+
+// This program is distributed in the hope that it will be useful, but
+// WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+// Library General Public License for more details.
+
+// You should have received a copy of the GNU Library General Public
+// License along with this program; if not, write to the Free Software
+// Foundation, Inc., 51 Franklin Street - Fifth Floor, Boston, MA
+// 02110-1301, USA.
+
// This is the external interface for elfcpp.
#ifndef ELFCPP_H
#define ELFCPP_H
-#include "elfcpp_config.h"
#include "elfcpp_swap.h"
#include <stdint.h>
// Old MN10200 objects used 0xdead (EM_MN10200 is correct).
};
+// A special value found in the Ehdr e_phnum field.
+
+enum
+{
+ // Number of program segments stored in sh_info field of first
+ // section headre.
+ PN_XNUM = 0xffff
+};
+
// Special section indices.
enum
SHN_ABS = 0xfff1,
SHN_COMMON = 0xfff2,
SHN_XINDEX = 0xffff,
- SHN_HIRESERVE = 0xffff
+ SHN_HIRESERVE = 0xffff,
+
+ // Provide for initial and final section ordering in conjunction
+ // with the SHF_LINK_ORDER and SHF_ORDERED section flags.
+ SHN_BEFORE = 0xff00,
+ SHN_AFTER = 0xff01,
+
+ // x86_64 specific large common symbol.
+ SHN_X86_64_LCOMMON = 0xff02
};
// The valid values found in the Shdr sh_type field.
SHT_LOUSER = 0x80000000,
SHT_HIUSER = 0xffffffff,
// The remaining values are not in the standard.
+ // Incremental build data.
+ SHT_GNU_INCREMENTAL_INPUTS = 0x6fff4700,
+ SHT_GNU_INCREMENTAL_SYMTAB = 0x6fff4701,
+ SHT_GNU_INCREMENTAL_RELOCS = 0x6fff4702,
+ SHT_GNU_INCREMENTAL_GOT_PLT = 0x6fff4703,
+ // Object attributes.
+ SHT_GNU_ATTRIBUTES = 0x6ffffff5,
+ // GNU style dynamic hash table.
+ SHT_GNU_HASH = 0x6ffffff6,
// List of prelink dependencies.
SHT_GNU_LIBLIST = 0x6ffffff7,
// Versions defined by file.
// Symbol versions,
SHT_SUNW_versym = 0x6fffffff,
SHT_GNU_versym = 0x6fffffff,
+
+ SHT_SPARC_GOTDATA = 0x70000000,
+
+ // ARM-specific section types.
+ // Exception Index table.
+ SHT_ARM_EXIDX = 0x70000001,
+ // BPABI DLL dynamic linking pre-emption map.
+ SHT_ARM_PREEMPTMAP = 0x70000002,
+ // Object file compatibility attributes.
+ SHT_ARM_ATTRIBUTES = 0x70000003,
+ // Support for debugging overlaid programs.
+ SHT_ARM_DEBUGOVERLAY = 0x70000004,
+ SHT_ARM_OVERLAYSECTION = 0x70000005,
+
+ // x86_64 unwind information.
+ SHT_X86_64_UNWIND = 0x70000001,
+
+ // Link editor is to sort the entries in this section based on the
+ // address specified in the associated symbol table entry.
+ SHT_ORDERED = 0x7fffffff
};
// The valid bit flags found in the Shdr sh_flags field.
SHF_GROUP = 0x200,
SHF_TLS = 0x400,
SHF_MASKOS = 0x0ff00000,
- SHF_MASKPROC = 0xf0000000
+ SHF_MASKPROC = 0xf0000000,
+
+ // Indicates this section requires ordering in relation to
+ // other sections of the same type. Ordered sections are
+ // combined within the section pointed to by the sh_link entry.
+ // The sh_info values SHN_BEFORE and SHN_AFTER imply that the
+ // sorted section is to precede or follow, respectively, all
+ // other sections in the set being ordered.
+ SHF_ORDERED = 0x40000000,
+ // This section is excluded from input to the link-edit of an
+ // executable or shared object. This flag is ignored if SHF_ALLOC
+ // is also set, or if relocations exist against the section.
+ SHF_EXCLUDE = 0x80000000,
+
+ // x86_64 specific large section.
+ SHF_X86_64_LARGE = 0x10000000
};
// Bit flags which appear in the first 32-bit word of the section data
// Stack flags.
PT_GNU_STACK = 0x6474e551,
// Read only after relocation.
- PT_GNU_RELRO = 0x6474e552
+ PT_GNU_RELRO = 0x6474e552,
+ // Platform architecture compatibility information
+ PT_ARM_ARCHEXT = 0x70000000,
+ // Exception unwind tables
+ PT_ARM_EXIDX = 0x70000001
};
// The valid bit flags found in the Phdr p_flags field.
STB_GLOBAL = 1,
STB_WEAK = 2,
STB_LOOS = 10,
+ STB_GNU_UNIQUE = 10,
STB_HIOS = 12,
STB_LOPROC = 13,
STB_HIPROC = 15
STT_COMMON = 5,
STT_TLS = 6,
STT_LOOS = 10,
+ STT_GNU_IFUNC = 10,
STT_HIOS = 12,
STT_LOPROC = 13,
- STT_HIPROC = 15
+ STT_HIPROC = 15,
+
+ // The section type that must be used for register symbols on
+ // Sparc. These symbols initialize a global register.
+ STT_SPARC_REGISTER = 13,
+
+ // ARM: a THUMB function. This is not defined in ARM ELF Specification but
+ // used by the GNU tool-chain.
+ STT_ARM_TFUNC = 13
};
inline STB
DT_FINI_ARRAYSZ = 28,
DT_RUNPATH = 29,
DT_FLAGS = 30,
+
+ // This is used to mark a range of dynamic tags. It is not really
+ // a tag value.
DT_ENCODING = 32,
- DT_PREINIT_ARRAY = 33,
+
+ DT_PREINIT_ARRAY = 32,
DT_PREINIT_ARRAYSZ = 33,
DT_LOOS = 0x6000000d,
DT_HIOS = 0x6ffff000,
DT_VERSYM = 0x6ffffff0,
+ // Specify the value of _GLOBAL_OFFSET_TABLE_.
+ DT_PPC_GOT = 0x70000000,
+
+ // Specify the start of the .glink section.
+ DT_PPC64_GLINK = 0x70000000,
+
+ // Specify the start and size of the .opd section.
+ DT_PPC64_OPD = 0x70000001,
+ DT_PPC64_OPDSZ = 0x70000002,
+
+ // The index of an STT_SPARC_REGISTER symbol within the DT_SYMTAB
+ // symbol table. One dynamic entry exists for every STT_SPARC_REGISTER
+ // symbol in the symbol table.
+ DT_SPARC_REGISTER = 0x70000001,
+
DT_AUXILIARY = 0x7ffffffd,
DT_USED = 0x7ffffffe,
DT_FILTER = 0x7fffffff
DF_STATIC_TLS = 0x10
};
+// Flags found in the DT_FLAGS_1 dynamic element.
+
+enum DF_1
+{
+ DF_1_NOW = 0x1,
+ DF_1_GLOBAL = 0x2,
+ DF_1_GROUP = 0x4,
+ DF_1_NODELETE = 0x8,
+ DF_1_LOADFLTR = 0x10,
+ DF_1_INITFIRST = 0x20,
+ DF_1_NOOPEN = 0x40,
+ DF_1_ORIGIN = 0x80,
+ DF_1_DIRECT = 0x100,
+ DF_1_TRANS = 0x200,
+ DF_1_INTERPOSE = 0x400,
+ DF_1_NODEFLIB = 0x800,
+ DF_1_NODUMP = 0x1000,
+ DF_1_CONLFAT = 0x2000
+};
+
// Version numbers which appear in the vd_version field of a Verdef
// structure.
const int VER_FLG_BASE = 0x1;
const int VER_FLG_WEAK = 0x2;
+const int VER_FLG_INFO = 0x4;
// Special constants found in the SHT_GNU_versym entries.
const int VERSYM_VERSION = 0x7fff;
+// Note descriptor type codes for notes in a non-core file with an
+// empty name.
+
+enum
+{
+ // A version string.
+ NT_VERSION = 1,
+ // An architecture string.
+ NT_ARCH = 2
+};
+
+// Note descriptor type codes for notes in a non-core file with the
+// name "GNU".
+
+enum
+{
+ // The minimum ABI level. This is used by the dynamic linker to
+ // describe the minimal kernel version on which a shared library may
+ // be used. Th value should be four words. Word 0 is an OS
+ // descriptor (see below). Word 1 is the major version of the ABI.
+ // Word 2 is the minor version. Word 3 is the subminor version.
+ NT_GNU_ABI_TAG = 1,
+ // Hardware capabilities information. Word 0 is the number of
+ // entries. Word 1 is a bitmask of enabled entries. The rest of
+ // the descriptor is a series of entries, where each entry is a
+ // single byte followed by a nul terminated string. The byte gives
+ // the bit number to test if enabled in the bitmask.
+ NT_GNU_HWCAP = 2,
+ // The build ID as set by the linker's --build-id option. The
+ // format of the descriptor depends on the build ID style.
+ NT_GNU_BUILD_ID = 3,
+ // The version of gold used to link. Th descriptor is just a
+ // string.
+ NT_GNU_GOLD_VERSION = 4
+};
+
+// The OS values which may appear in word 0 of a NT_GNU_ABI_TAG note.
+
+enum
+{
+ ELF_NOTE_OS_LINUX = 0,
+ ELF_NOTE_OS_GNU = 1,
+ ELF_NOTE_OS_SOLARIS2 = 2,
+ ELF_NOTE_OS_FREEBSD = 3,
+ ELF_NOTE_OS_NETBSD = 4,
+ ELF_NOTE_OS_SYLLABLE = 5
+};
+
} // End namespace elfcpp.
// Include internal details after defining the types.
static const int rela_size = sizeof(internal::Rela_data<size>);
// Size of ELF dynamic entry.
static const int dyn_size = sizeof(internal::Dyn_data<size>);
+ // Size of ELF version structures.
+ static const int verdef_size = sizeof(internal::Verdef_data);
+ static const int verdaux_size = sizeof(internal::Verdaux_data);
+ static const int verneed_size = sizeof(internal::Verneed_data);
+ static const int vernaux_size = sizeof(internal::Vernaux_data);
};
// Accessor class for the ELF file header.
void
put_e_type(Elf_Half v)
{ this->p_->e_type = Convert<16, big_endian>::convert_host(v); }
-
+
void
put_e_machine(Elf_Half v)
{ this->p_->e_machine = Convert<16, big_endian>::convert_host(v); }
internal::Sym_data<size>* p_;
};
-// Accessor classes for Elf relocation table entries.
+// Accessor classes for an ELF REL relocation entry.
template<int size, bool big_endian>
class Rel
const internal::Rel_data<size>* p_;
};
+// Writer class for an ELF Rel relocation.
+
+template<int size, bool big_endian>
+class Rel_write
+{
+ public:
+ Rel_write(unsigned char* p)
+ : p_(reinterpret_cast<internal::Rel_data<size>*>(p))
+ { }
+
+ void
+ put_r_offset(typename Elf_types<size>::Elf_Addr v)
+ { this->p_->r_offset = Convert<size, big_endian>::convert_host(v); }
+
+ void
+ put_r_info(typename Elf_types<size>::Elf_WXword v)
+ { this->p_->r_info = Convert<size, big_endian>::convert_host(v); }
+
+ private:
+ internal::Rel_data<size>* p_;
+};
+
+// Accessor class for an ELF Rela relocation.
+
template<int size, bool big_endian>
class Rela
{
const internal::Rela_data<size>* p_;
};
+// Writer class for an ELF Rela relocation.
+
+template<int size, bool big_endian>
+class Rela_write
+{
+ public:
+ Rela_write(unsigned char* p)
+ : p_(reinterpret_cast<internal::Rela_data<size>*>(p))
+ { }
+
+ void
+ put_r_offset(typename Elf_types<size>::Elf_Addr v)
+ { this->p_->r_offset = Convert<size, big_endian>::convert_host(v); }
+
+ void
+ put_r_info(typename Elf_types<size>::Elf_WXword v)
+ { this->p_->r_info = Convert<size, big_endian>::convert_host(v); }
+
+ void
+ put_r_addend(typename Elf_types<size>::Elf_Swxword v)
+ { this->p_->r_addend = Convert<size, big_endian>::convert_host(v); }
+
+ private:
+ internal::Rela_data<size>* p_;
+};
+
// Accessor classes for entries in the ELF SHT_DYNAMIC section aka
// PT_DYNAMIC segment.
const internal::Dyn_data<size>* p_;
};
+// Write class for an entry in the SHT_DYNAMIC section.
+
+template<int size, bool big_endian>
+class Dyn_write
+{
+ public:
+ Dyn_write(unsigned char* p)
+ : p_(reinterpret_cast<internal::Dyn_data<size>*>(p))
+ { }
+
+ void
+ put_d_tag(typename Elf_types<size>::Elf_Swxword v)
+ { this->p_->d_tag = Convert<size, big_endian>::convert_host(v); }
+
+ void
+ put_d_val(typename Elf_types<size>::Elf_WXword v)
+ { this->p_->d_val = Convert<size, big_endian>::convert_host(v); }
+
+ void
+ put_d_ptr(typename Elf_types<size>::Elf_Addr v)
+ { this->p_->d_val = Convert<size, big_endian>::convert_host(v); }
+
+ private:
+ internal::Dyn_data<size>* p_;
+};
+
// Accessor classes for entries in the ELF SHT_GNU_verdef section.
template<int size, bool big_endian>
const internal::Verdef_data* p_;
};
+template<int size, bool big_endian>
+class Verdef_write
+{
+ public:
+ Verdef_write(unsigned char* p)
+ : p_(reinterpret_cast<internal::Verdef_data*>(p))
+ { }
+
+ void
+ set_vd_version(Elf_Half v)
+ { this->p_->vd_version = Convert<16, big_endian>::convert_host(v); }
+
+ void
+ set_vd_flags(Elf_Half v)
+ { this->p_->vd_flags = Convert<16, big_endian>::convert_host(v); }
+
+ void
+ set_vd_ndx(Elf_Half v)
+ { this->p_->vd_ndx = Convert<16, big_endian>::convert_host(v); }
+
+ void
+ set_vd_cnt(Elf_Half v)
+ { this->p_->vd_cnt = Convert<16, big_endian>::convert_host(v); }
+
+ void
+ set_vd_hash(Elf_Word v)
+ { this->p_->vd_hash = Convert<32, big_endian>::convert_host(v); }
+
+ void
+ set_vd_aux(Elf_Word v)
+ { this->p_->vd_aux = Convert<32, big_endian>::convert_host(v); }
+
+ void
+ set_vd_next(Elf_Word v)
+ { this->p_->vd_next = Convert<32, big_endian>::convert_host(v); }
+
+ private:
+ internal::Verdef_data* p_;
+};
+
// Accessor classes for auxiliary entries in the ELF SHT_GNU_verdef
// section.
const internal::Verdaux_data* p_;
};
+template<int size, bool big_endian>
+class Verdaux_write
+{
+ public:
+ Verdaux_write(unsigned char* p)
+ : p_(reinterpret_cast<internal::Verdaux_data*>(p))
+ { }
+
+ void
+ set_vda_name(Elf_Word v)
+ { this->p_->vda_name = Convert<32, big_endian>::convert_host(v); }
+
+ void
+ set_vda_next(Elf_Word v)
+ { this->p_->vda_next = Convert<32, big_endian>::convert_host(v); }
+
+ private:
+ internal::Verdaux_data* p_;
+};
+
// Accessor classes for entries in the ELF SHT_GNU_verneed section.
template<int size, bool big_endian>
const internal::Verneed_data* p_;
};
+template<int size, bool big_endian>
+class Verneed_write
+{
+ public:
+ Verneed_write(unsigned char* p)
+ : p_(reinterpret_cast<internal::Verneed_data*>(p))
+ { }
+
+ void
+ set_vn_version(Elf_Half v)
+ { this->p_->vn_version = Convert<16, big_endian>::convert_host(v); }
+
+ void
+ set_vn_cnt(Elf_Half v)
+ { this->p_->vn_cnt = Convert<16, big_endian>::convert_host(v); }
+
+ void
+ set_vn_file(Elf_Word v)
+ { this->p_->vn_file = Convert<32, big_endian>::convert_host(v); }
+
+ void
+ set_vn_aux(Elf_Word v)
+ { this->p_->vn_aux = Convert<32, big_endian>::convert_host(v); }
+
+ void
+ set_vn_next(Elf_Word v)
+ { this->p_->vn_next = Convert<32, big_endian>::convert_host(v); }
+
+ private:
+ internal::Verneed_data* p_;
+};
+
// Accessor classes for auxiliary entries in the ELF SHT_GNU_verneed
// section.
const internal::Vernaux_data* p_;
};
+template<int size, bool big_endian>
+class Vernaux_write
+{
+ public:
+ Vernaux_write(unsigned char* p)
+ : p_(reinterpret_cast<internal::Vernaux_data*>(p))
+ { }
+
+ void
+ set_vna_hash(Elf_Word v)
+ { this->p_->vna_hash = Convert<32, big_endian>::convert_host(v); }
+
+ void
+ set_vna_flags(Elf_Half v)
+ { this->p_->vna_flags = Convert<16, big_endian>::convert_host(v); }
+
+ void
+ set_vna_other(Elf_Half v)
+ { this->p_->vna_other = Convert<16, big_endian>::convert_host(v); }
+
+ void
+ set_vna_name(Elf_Word v)
+ { this->p_->vna_name = Convert<32, big_endian>::convert_host(v); }
+
+ void
+ set_vna_next(Elf_Word v)
+ { this->p_->vna_next = Convert<32, big_endian>::convert_host(v); }
+
+ private:
+ internal::Vernaux_data* p_;
+};
} // End namespace elfcpp.