/* * private.h - private definitions for libelf. * Copyright (C) 1995 - 2007 Michael Riepe * * This library 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 of the License, or (at your option) any later version. * * This library 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 library; if not, write to the Free Software * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA */ /* @(#) $Id: private.h,v 1.40 2009/11/01 13:04:19 michael Exp $ */ #ifndef _PRIVATE_H #define _PRIVATE_H #define __LIBELF_INTERNAL__ 1 #if HAVE_CONFIG_H # include #endif /* HAVE_CONFIG_H */ /* * Workaround for GLIBC bug: * include before */ #if HAVE_STDINT_H #include #endif #include #if STDC_HEADERS # include # include #else /* STDC_HEADERS */ extern void *malloc(), *realloc(); extern void free(), bcopy(), abort(); extern int strcmp(), strncmp(), memcmp(); extern void *memcpy(), *memmove(), *memset(); #endif /* STDC_HEADERS */ #if defined(_WIN32) #include #else #if HAVE_UNISTD_H # include #else /* HAVE_UNISTD_H */ extern int read(), write(), close(); extern off_t lseek(); #if HAVE_FTRUNCATE extern int ftruncate(); #endif /* HAVE_FTRUNCATE */ #endif /* HAVE_UNISTD_H */ #endif /* defined(_WIN32) */ #ifndef SEEK_SET #define SEEK_SET 0 #endif /* SEEK_SET */ #ifndef SEEK_CUR #define SEEK_CUR 1 #endif /* SEEK_CUR */ #ifndef SEEK_END #define SEEK_END 2 #endif /* SEEK_END */ #if !HAVE_MEMCMP # define memcmp strncmp #endif /* !HAVE_MEMCMP */ #if !HAVE_MEMCPY # define memcpy(d,s,n) bcopy(s,d,n) #endif /* !HAVE_MEMCPY */ #if !HAVE_MEMMOVE # define memmove(d,s,n) bcopy(s,d,n) #endif /* !HAVE_MEMMOVE */ #if !HAVE_MEMSET # define memset _elf_memset extern void *_elf_memset(); #endif /* !HAVE_MEMSET */ #if HAVE_STRUCT_NLIST_DECLARATION # define nlist __override_nlist_declaration #endif /* HAVE_STRUCT_NLIST_DECLARATION */ #if __LIBELF_NEED_LINK_H # include #elif __LIBELF_NEED_SYS_LINK_H # include #endif /* __LIBELF_NEED_LINK_H */ #if HAVE_AR_H #include #else /* HAVE_AR_H */ #define ARMAG "!\n" #define SARMAG 8 struct ar_hdr { char ar_name[16]; char ar_date[12]; char ar_uid[6]; char ar_gid[6]; char ar_mode[8]; char ar_size[10]; char ar_fmag[2]; }; #define ARFMAG "`\n" #endif /* HAVE_AR_H */ #include #if HAVE_STRUCT_NLIST_DECLARATION # undef nlist #endif /* HAVE_STRUCT_NLIST_DECLARATION */ #if __LIBELF64 #include #endif /* __LIBELF64 */ typedef struct Scn_Data Scn_Data; /* * ELF descriptor */ struct Elf { /* common */ size_t e_size; /* file/member size */ size_t e_dsize; /* size of memory image */ Elf_Kind e_kind; /* kind of file */ char* e_data; /* file/member data */ char* e_rawdata; /* file/member raw data */ size_t e_idlen; /* identifier size */ int e_fd; /* file descriptor */ unsigned e_count; /* activation count */ /* archive members (still common) */ Elf* e_parent; /* NULL if not an archive member */ size_t e_next; /* 0 if not an archive member */ size_t e_base; /* 0 if not an archive member */ Elf* e_link; /* next archive member or NULL */ Elf_Arhdr* e_arhdr; /* archive member header or NULL */ /* archives */ size_t e_off; /* current member offset (for elf_begin) */ Elf* e_members; /* linked list of active archive members */ char* e_symtab; /* archive symbol table */ size_t e_symlen; /* length of archive symbol table */ char* e_strtab; /* archive string table */ size_t e_strlen; /* length of archive string table */ /* ELF files */ unsigned e_class; /* ELF class */ unsigned e_encoding; /* ELF data encoding */ unsigned e_version; /* ELF version */ char* e_ehdr; /* ELF header */ char* e_phdr; /* ELF program header table */ size_t e_phnum; /* size of program header table */ Elf_Scn* e_scn_1; /* first section */ Elf_Scn* e_scn_n; /* last section */ unsigned e_elf_flags; /* elf flags (ELF_F_*) */ unsigned e_ehdr_flags; /* ehdr flags (ELF_F_*) */ unsigned e_phdr_flags; /* phdr flags (ELF_F_*) */ /* misc flags */ unsigned e_readable : 1; /* file is readable */ unsigned e_writable : 1; /* file is writable */ unsigned e_disabled : 1; /* e_fd has been disabled */ unsigned e_cooked : 1; /* e_data was modified */ unsigned e_free_syms : 1; /* e_symtab is malloc'ed */ unsigned e_unmap_data : 1; /* e_data is mmap'ed */ unsigned e_memory : 1; /* created by elf_memory() */ /* magic number for debugging */ long e_magic; }; #define ELF_MAGIC 0x012b649e #define INIT_ELF {\ /* e_size */ 0,\ /* e_dsize */ 0,\ /* e_kind */ ELF_K_NONE,\ /* e_data */ NULL,\ /* e_rawdata */ NULL,\ /* e_idlen */ 0,\ /* e_fd */ -1,\ /* e_count */ 1,\ /* e_parent */ NULL,\ /* e_next */ 0,\ /* e_base */ 0,\ /* e_link */ NULL,\ /* e_arhdr */ NULL,\ /* e_off */ 0,\ /* e_members */ NULL,\ /* e_symtab */ NULL,\ /* e_symlen */ 0,\ /* e_strtab */ NULL,\ /* e_strlen */ 0,\ /* e_class */ ELFCLASSNONE,\ /* e_encoding */ ELFDATANONE,\ /* e_version */ EV_NONE,\ /* e_ehdr */ NULL,\ /* e_phdr */ NULL,\ /* e_phnum */ 0,\ /* e_scn_1 */ NULL,\ /* e_scn_n */ NULL,\ /* e_elf_flags */ 0,\ /* e_ehdr_flags */ 0,\ /* e_phdr_flags */ 0,\ /* e_readable */ 0,\ /* e_writable */ 0,\ /* e_disabled */ 0,\ /* e_cooked */ 0,\ /* e_free_syms */ 0,\ /* e_unmap_data */ 0,\ /* e_memory */ 0,\ /* e_magic */ ELF_MAGIC\ } /* * Section descriptor */ struct Elf_Scn { Elf_Scn* s_link; /* pointer to next Elf_Scn */ Elf* s_elf; /* pointer to elf descriptor */ size_t s_index; /* number of this section */ unsigned s_scn_flags; /* section flags (ELF_F_*) */ unsigned s_shdr_flags; /* shdr flags (ELF_F_*) */ Scn_Data* s_data_1; /* first data buffer */ Scn_Data* s_data_n; /* last data buffer */ Scn_Data* s_rawdata; /* raw data buffer */ /* data copied from shdr */ unsigned s_type; /* section type */ size_t s_offset; /* section offset */ size_t s_size; /* section size */ /* misc flags */ unsigned s_freeme : 1; /* this Elf_Scn was malloc'ed */ /* section header */ union { #if __LIBELF64 Elf64_Shdr u_shdr64; #endif /* __LIBELF64 */ Elf32_Shdr u_shdr32; } s_uhdr; /* magic number for debugging */ long s_magic; }; #define s_shdr32 s_uhdr.u_shdr32 #define s_shdr64 s_uhdr.u_shdr64 #define SCN_MAGIC 0x012c747d #define INIT_SCN {\ /* s_link */ NULL,\ /* s_elf */ NULL,\ /* s_index */ 0,\ /* s_scn_flags */ 0,\ /* s_shdr_flags */ 0,\ /* s_data_1 */ NULL,\ /* s_data_n */ NULL,\ /* s_rawdata */ NULL,\ /* s_type */ SHT_NULL,\ /* s_offset */ 0,\ /* s_size */ 0,\ /* s_freeme */ 0,\ /* s_uhdr */ {{0,}},\ /* s_magic */ SCN_MAGIC\ } /* * Data descriptor */ struct Scn_Data { Elf_Data sd_data; /* must be first! */ Scn_Data* sd_link; /* pointer to next Scn_Data */ Elf_Scn* sd_scn; /* pointer to section */ char* sd_memdata; /* memory image of section */ unsigned sd_data_flags; /* data flags (ELF_F_*) */ /* misc flags */ unsigned sd_freeme : 1; /* this Scn_Data was malloc'ed */ unsigned sd_free_data : 1; /* sd_memdata is malloc'ed */ /* magic number for debugging */ long sd_magic; }; #define DATA_MAGIC 0x01072639 #define INIT_DATA {\ {\ /* d_buf */ NULL,\ /* d_type */ ELF_T_BYTE,\ /* d_size */ 0,\ /* d_off */ 0,\ /* d_align */ 0,\ /* d_version */ EV_NONE\ },\ /* sd_link */ NULL,\ /* sd_scn */ NULL,\ /* sd_memdata */ NULL,\ /* sd_data_flags */ 0,\ /* sd_freeme */ 0,\ /* sd_free_data */ 0,\ /* sd_magic */ DATA_MAGIC\ } /* * Private status variables */ extern unsigned _elf_version; extern int _elf_errno; extern int _elf_fill; extern int _elf_sanity_checks; #define SANITY_CHECK_STRPTR (1u << 0) /* * Private functions */ extern void *_elf_read __P((Elf*, void*, size_t, size_t)); extern void *_elf_mmap __P((Elf*)); extern int _elf_cook __P((Elf*)); extern char *_elf_getehdr __P((Elf*, unsigned)); extern char *_elf_getphdr __P((Elf*, unsigned)); extern Elf_Data *_elf_xlatetom __P((const Elf*, Elf_Data*, const Elf_Data*)); extern Elf_Type _elf_scn_type __P((unsigned)); extern size_t _elf32_xltsize __P((const Elf_Data *__src, unsigned __dv, unsigned __encode, int __tof)); extern size_t _elf64_xltsize __P((const Elf_Data *__src, unsigned __dv, unsigned __encode, int __tof)); extern int _elf_update_shnum(Elf *__elf, size_t __shnum); extern Elf_Scn *_elf_first_scn(Elf *__elf); /* * Special translators */ extern size_t _elf_verdef_32L11_tof __P((unsigned char *dst, const unsigned char *src, size_t n)); extern size_t _elf_verdef_32L11_tom __P((unsigned char *dst, const unsigned char *src, size_t n)); extern size_t _elf_verdef_32M11_tof __P((unsigned char *dst, const unsigned char *src, size_t n)); extern size_t _elf_verdef_32M11_tom __P((unsigned char *dst, const unsigned char *src, size_t n)); extern size_t _elf_verdef_64L11_tof __P((unsigned char *dst, const unsigned char *src, size_t n)); extern size_t _elf_verdef_64L11_tom __P((unsigned char *dst, const unsigned char *src, size_t n)); extern size_t _elf_verdef_64M11_tof __P((unsigned char *dst, const unsigned char *src, size_t n)); extern size_t _elf_verdef_64M11_tom __P((unsigned char *dst, const unsigned char *src, size_t n)); extern size_t _elf_verneed_32L11_tof __P((unsigned char *dst, const unsigned char *src, size_t n)); extern size_t _elf_verneed_32L11_tom __P((unsigned char *dst, const unsigned char *src, size_t n)); extern size_t _elf_verneed_32M11_tof __P((unsigned char *dst, const unsigned char *src, size_t n)); extern size_t _elf_verneed_32M11_tom __P((unsigned char *dst, const unsigned char *src, size_t n)); extern size_t _elf_verneed_64L11_tof __P((unsigned char *dst, const unsigned char *src, size_t n)); extern size_t _elf_verneed_64L11_tom __P((unsigned char *dst, const unsigned char *src, size_t n)); extern size_t _elf_verneed_64M11_tof __P((unsigned char *dst, const unsigned char *src, size_t n)); extern size_t _elf_verneed_64M11_tom __P((unsigned char *dst, const unsigned char *src, size_t n)); /* * Private data */ extern const Elf_Scn _elf_scn_init; extern const Scn_Data _elf_data_init; extern const size_t _elf_fmsize[2][EV_CURRENT - EV_NONE][ELF_T_NUM][2]; /* * Access macros for _elf_fmsize[] */ #define _fmsize(c,v,t,w) \ (_elf_fmsize[(c)-ELFCLASS32][(v)-EV_NONE-1][(t)-ELF_T_BYTE][(w)]) #define _fsize(c,v,t) _fmsize((c),(v),(t),1) #define _msize(c,v,t) _fmsize((c),(v),(t),0) /* * Various checks */ #define valid_class(c) ((c) >= ELFCLASS32 && (c) <= ELFCLASS64) #define valid_encoding(e) ((e) >= ELFDATA2LSB && (e) <= ELFDATA2MSB) #define valid_version(v) ((v) > EV_NONE && (v) <= EV_CURRENT) #define valid_type(t) ((unsigned)(t) < ELF_T_NUM) /* * Error codes */ enum { #define __err__(a,b) a, #include /* include constants from errors.h */ #undef __err__ ERROR_NUM }; #define seterr(err) (_elf_errno = (err)) /* * Sizes of data types (external representation) * These definitions should be in , but... */ #ifndef ELF32_FSZ_ADDR # define ELF32_FSZ_ADDR 4 # define ELF32_FSZ_HALF 2 # define ELF32_FSZ_OFF 4 # define ELF32_FSZ_SWORD 4 # define ELF32_FSZ_WORD 4 #endif /* ELF32_FSZ_ADDR */ #ifndef ELF64_FSZ_ADDR # define ELF64_FSZ_ADDR 8 # define ELF64_FSZ_HALF 2 # define ELF64_FSZ_OFF 8 # define ELF64_FSZ_SWORD 4 # define ELF64_FSZ_SXWORD 8 # define ELF64_FSZ_WORD 4 # define ELF64_FSZ_XWORD 8 #endif /* ELF64_FSZ_ADDR */ /* * More missing pieces, in no particular order */ #ifndef SHT_SYMTAB_SHNDX #define SHT_SYMTAB_SHNDX 18 #endif /* SHT_SYMTAB_SHNDX */ #ifndef SHN_XINDEX #define SHN_XINDEX 0xffff #endif /* SHN_XINDEX */ #ifndef PN_XNUM #define PN_XNUM 0xffff #endif /* PN_XNUM */ /* * Debugging */ #if ENABLE_DEBUG extern void __elf_assert __P((const char*, unsigned, const char*)); # if (__STDC__ + 0) # define elf_assert(x) do{if(!(x))__elf_assert(__FILE__,__LINE__,#x);}while(0) # else /* __STDC__ */ # define elf_assert(x) do{if(!(x))__elf_assert(__FILE__,__LINE__,"x");}while(0) # endif /* __STDC__ */ #else /* ENABLE_DEBUG */ # define elf_assert(x) do{}while(0) #endif /* ENABLE_DEBUG */ /* * Return values for certain functions */ #define LIBELF_SUCCESS 1 #define LIBELF_FAILURE 0 #endif /* _PRIVATE_H */