#------------------------------------------------------------------------------- # elftools: elf/descriptions.py # # Textual descriptions of the various enums and flags of ELF # # Eli Bendersky (eliben@gmail.com) # This code is in the public domain #------------------------------------------------------------------------------- from .enums import ( ENUM_D_TAG, ENUM_E_VERSION, ENUM_RELOC_TYPE_i386, ENUM_RELOC_TYPE_x64, ENUM_RELOC_TYPE_ARM, ENUM_RELOC_TYPE_AARCH64) from .constants import P_FLAGS, SH_FLAGS, SUNW_SYMINFO_FLAGS, VER_FLAGS from ..common.py3compat import iteritems def describe_ei_class(x): return _DESCR_EI_CLASS.get(x, _unknown) def describe_ei_data(x): return _DESCR_EI_DATA.get(x, _unknown) def describe_ei_version(x): s = '%d' % ENUM_E_VERSION[x] if x == 'EV_CURRENT': s += ' (current)' return s def describe_ei_osabi(x): return _DESCR_EI_OSABI.get(x, _unknown) def describe_e_type(x): return _DESCR_E_TYPE.get(x, _unknown) def describe_e_machine(x): return _DESCR_E_MACHINE.get(x, _unknown) def describe_e_version_numeric(x): return '0x%x' % ENUM_E_VERSION[x] def describe_p_type(x): return _DESCR_P_TYPE.get(x, _unknown) def describe_p_flags(x): s = '' for flag in (P_FLAGS.PF_R, P_FLAGS.PF_W, P_FLAGS.PF_X): s += _DESCR_P_FLAGS[flag] if (x & flag) else ' ' return s def describe_sh_type(x): return _DESCR_SH_TYPE.get(x, _unknown) def describe_sh_flags(x): s = '' for flag in ( SH_FLAGS.SHF_WRITE, SH_FLAGS.SHF_ALLOC, SH_FLAGS.SHF_EXECINSTR, SH_FLAGS.SHF_MERGE, SH_FLAGS.SHF_STRINGS, SH_FLAGS.SHF_INFO_LINK, SH_FLAGS.SHF_LINK_ORDER, SH_FLAGS.SHF_OS_NONCONFORMING, SH_FLAGS.SHF_GROUP, SH_FLAGS.SHF_TLS, SH_FLAGS.SHF_EXCLUDE): s += _DESCR_SH_FLAGS[flag] if (x & flag) else '' return s def describe_symbol_type(x): return _DESCR_ST_INFO_TYPE.get(x, _unknown) def describe_symbol_bind(x): return _DESCR_ST_INFO_BIND.get(x, _unknown) def describe_symbol_visibility(x): return _DESCR_ST_VISIBILITY.get(x, _unknown) def describe_symbol_shndx(x): return _DESCR_ST_SHNDX.get(x, '%3s' % x) def describe_reloc_type(x, elffile): arch = elffile.get_machine_arch() if arch == 'x86': return _DESCR_RELOC_TYPE_i386.get(x, _unknown) elif arch == 'x64': return _DESCR_RELOC_TYPE_x64.get(x, _unknown) elif arch == 'ARM': return _DESCR_RELOC_TYPE_ARM.get(x, _unknown) elif arch == 'AArch64': return _DESCR_RELOC_TYPE_AARCH64.get(x, _unknown) else: return 'unrecognized: %-7x' % (x & 0xFFFFFFFF) def describe_dyn_tag(x): return _DESCR_D_TAG.get(x, _unknown) def describe_syminfo_flags(x): return ''.join(_DESCR_SYMINFO_FLAGS[flag] for flag in ( SUNW_SYMINFO_FLAGS.SYMINFO_FLG_CAP, SUNW_SYMINFO_FLAGS.SYMINFO_FLG_DIRECT, SUNW_SYMINFO_FLAGS.SYMINFO_FLG_FILTER, SUNW_SYMINFO_FLAGS.SYMINFO_FLG_AUXILIARY, SUNW_SYMINFO_FLAGS.SYMINFO_FLG_DIRECTBIND, SUNW_SYMINFO_FLAGS.SYMINFO_FLG_COPY, SUNW_SYMINFO_FLAGS.SYMINFO_FLG_LAZYLOAD, SUNW_SYMINFO_FLAGS.SYMINFO_FLG_NOEXTDIRECT, SUNW_SYMINFO_FLAGS.SYMINFO_FLG_INTERPOSE, SUNW_SYMINFO_FLAGS.SYMINFO_FLG_DEFERRED) if x & flag) def describe_symbol_boundto(x): return _DESCR_SYMINFO_BOUNDTO.get(x, '%3s' % x) def describe_ver_flags(x): return ' | '.join(_DESCR_VER_FLAGS[flag] for flag in ( VER_FLAGS.VER_FLG_WEAK, VER_FLAGS.VER_FLG_BASE, VER_FLAGS.VER_FLG_INFO) if x & flag) #------------------------------------------------------------------------------- _unknown = '' _DESCR_EI_CLASS = dict( ELFCLASSNONE='none', ELFCLASS32='ELF32', ELFCLASS64='ELF64', ) _DESCR_EI_DATA = dict( ELFDATANONE='none', ELFDATA2LSB="2's complement, little endian", ELFDATA2MSB="2's complement, big endian", ) _DESCR_EI_OSABI = dict( ELFOSABI_SYSV='UNIX - System V', ELFOSABI_HPUX='UNIX - HP-UX', ELFOSABI_NETBSD='UNIX - NetBSD', ELFOSABI_LINUX='UNIX - Linux', ELFOSABI_HURD='UNIX - GNU/Hurd', ELFOSABI_SOLARIS='UNIX - Solaris', ELFOSABI_AIX='UNIX - AIX', ELFOSABI_IRIX='UNIX - IRIX', ELFOSABI_FREEBSD='UNIX - FreeBSD', ELFOSABI_TRU64='UNIX - TRU64', ELFOSABI_MODESTO='Novell - Modesto', ELFOSABI_OPENBSD='UNIX - OpenBSD', ELFOSABI_OPENVMS='VMS - OpenVMS', ELFOSABI_NSK='HP - Non-Stop Kernel', ELFOSABI_AROS='AROS', ELFOSABI_ARM='ARM', ELFOSABI_STANDALONE='Standalone App', ) _DESCR_E_TYPE = dict( ET_NONE='NONE (None)', ET_REL='REL (Relocatable file)', ET_EXEC='EXEC (Executable file)', ET_DYN='DYN (Shared object file)', ET_CORE='CORE (Core file)', PROC_SPECIFIC='Processor Specific', ) _DESCR_E_MACHINE = dict( EM_NONE='None', EM_M32='WE32100', EM_SPARC='Sparc', EM_386='Intel 80386', EM_68K='MC68000', EM_88K='MC88000', EM_860='Intel 80860', EM_MIPS='MIPS R3000', EM_S370='IBM System/370', EM_MIPS_RS4_BE='MIPS 4000 big-endian', EM_IA_64='Intel IA-64', EM_X86_64='Advanced Micro Devices X86-64', EM_AVR='Atmel AVR 8-bit microcontroller', EM_ARM='ARM', EM_AARCH64='AArch64', EM_BLAFKIN='Analog Devices Blackfin', RESERVED='RESERVED', ) _DESCR_P_TYPE = dict( PT_NULL='NULL', PT_LOAD='LOAD', PT_DYNAMIC='DYNAMIC', PT_INTERP='INTERP', PT_NOTE='NOTE', PT_SHLIB='SHLIB', PT_PHDR='PHDR', PT_GNU_EH_FRAME='GNU_EH_FRAME', PT_GNU_STACK='GNU_STACK', PT_GNU_RELRO='GNU_RELRO', PT_ARM_ARCHEXT='ARM_ARCHEXT', PT_ARM_EXIDX='ARM_EXIDX', PT_ARM_UNWIND='ARM_UNWIND', PT_AARCH64_ARCHEXT='AARCH64_ARCHEXT', PT_AARCH64_UNWIND='AARCH64_UNWIND', ) _DESCR_P_FLAGS = { P_FLAGS.PF_X: 'E', P_FLAGS.PF_R: 'R', P_FLAGS.PF_W: 'W', } _DESCR_SH_TYPE = dict( SHT_NULL='NULL', SHT_PROGBITS='PROGBITS', SHT_SYMTAB='SYMTAB', SHT_STRTAB='STRTAB', SHT_RELA='RELA', SHT_HASH='HASH', SHT_DYNAMIC='DYNAMIC', SHT_NOTE='NOTE', SHT_NOBITS='NOBITS', SHT_REL='REL', SHT_SHLIB='SHLIB', SHT_DYNSYM='DYNSYM', SHT_INIT_ARRAY='INIT_ARRAY', SHT_FINI_ARRAY='FINI_ARRAY', SHT_PREINIT_ARRAY='PREINIT_ARRAY', SHT_GNU_HASH='GNU_HASH', SHT_GROUP='GROUP', SHT_SYMTAB_SHNDX='SYMTAB SECTION INDICIES', SHT_GNU_verdef='VERDEF', SHT_GNU_verneed='VERNEED', SHT_GNU_versym='VERSYM', SHT_GNU_LIBLIST='GNU_LIBLIST', SHT_ARM_EXIDX='ARM_EXIDX', SHT_ARM_PREEMPTMAP='ARM_PREEMPTMAP', SHT_ARM_ATTRIBUTES='ARM_ATTRIBUTES', SHT_ARM_DEBUGOVERLAY='ARM_DEBUGOVERLAY', ) _DESCR_SH_FLAGS = { SH_FLAGS.SHF_WRITE: 'W', SH_FLAGS.SHF_ALLOC: 'A', SH_FLAGS.SHF_EXECINSTR: 'X', SH_FLAGS.SHF_MERGE: 'M', SH_FLAGS.SHF_STRINGS: 'S', SH_FLAGS.SHF_INFO_LINK: 'I', SH_FLAGS.SHF_LINK_ORDER: 'L', SH_FLAGS.SHF_OS_NONCONFORMING: 'O', SH_FLAGS.SHF_GROUP: 'G', SH_FLAGS.SHF_TLS: 'T', SH_FLAGS.SHF_EXCLUDE: 'E', } _DESCR_ST_INFO_TYPE = dict( STT_NOTYPE='NOTYPE', STT_OBJECT='OBJECT', STT_FUNC='FUNC', STT_SECTION='SECTION', STT_FILE='FILE', STT_COMMON='COMMON', STT_TLS='TLS', STT_NUM='NUM', STT_RELC='RELC', STT_SRELC='SRELC', ) _DESCR_ST_INFO_BIND = dict( STB_LOCAL='LOCAL', STB_GLOBAL='GLOBAL', STB_WEAK='WEAK', ) _DESCR_ST_VISIBILITY = dict( STV_DEFAULT='DEFAULT', STV_INTERNAL='INTERNAL', STV_HIDDEN='HIDDEN', STV_PROTECTED='PROTECTED', STV_EXPORTED='EXPORTED', STV_SINGLETON='SINGLETON', STV_ELIMINATE='ELIMINATE', ) _DESCR_ST_SHNDX = dict( SHN_UNDEF='UND', SHN_ABS='ABS', SHN_COMMON='COM', ) _DESCR_SYMINFO_FLAGS = { SUNW_SYMINFO_FLAGS.SYMINFO_FLG_DIRECT: 'D', SUNW_SYMINFO_FLAGS.SYMINFO_FLG_DIRECTBIND: 'B', SUNW_SYMINFO_FLAGS.SYMINFO_FLG_COPY: 'C', SUNW_SYMINFO_FLAGS.SYMINFO_FLG_LAZYLOAD: 'L', SUNW_SYMINFO_FLAGS.SYMINFO_FLG_NOEXTDIRECT: 'N', SUNW_SYMINFO_FLAGS.SYMINFO_FLG_AUXILIARY: 'A', SUNW_SYMINFO_FLAGS.SYMINFO_FLG_FILTER: 'F', SUNW_SYMINFO_FLAGS.SYMINFO_FLG_INTERPOSE: 'I', SUNW_SYMINFO_FLAGS.SYMINFO_FLG_CAP: 'S', SUNW_SYMINFO_FLAGS.SYMINFO_FLG_DEFERRED: 'P', } _DESCR_SYMINFO_BOUNDTO = dict( SYMINFO_BT_SELF='', SYMINFO_BT_PARENT='', SYMINFO_BT_NONE='', SYMINFO_BT_EXTERN='', ) _DESCR_VER_FLAGS = { 0: '', VER_FLAGS.VER_FLG_BASE: 'BASE', VER_FLAGS.VER_FLG_WEAK: 'WEAK', VER_FLAGS.VER_FLG_INFO: 'INFO', } _DESCR_RELOC_TYPE_i386 = dict( (v, k) for k, v in iteritems(ENUM_RELOC_TYPE_i386)) _DESCR_RELOC_TYPE_x64 = dict( (v, k) for k, v in iteritems(ENUM_RELOC_TYPE_x64)) _DESCR_RELOC_TYPE_ARM = dict( (v, k) for k, v in iteritems(ENUM_RELOC_TYPE_ARM)) _DESCR_RELOC_TYPE_AARCH64 = dict( (v, k) for k, v in iteritems(ENUM_RELOC_TYPE_AARCH64)) _DESCR_D_TAG = dict( (v, k) for k, v in iteritems(ENUM_D_TAG))