elftools/elf/descriptions.py

   1 #-------------------------------------------------------------------------------
   2 # elftools: elf/descriptions.py
   3 #
   4 # Textual descriptions of the various enums and flags of ELF
   5 #
   6 # Eli Bendersky (eliben@gmail.com)
   7 # This code is in the public domain
   8 #-------------------------------------------------------------------------------
   9 from .enums import (
  10     ENUM_D_TAG, ENUM_E_VERSION, ENUM_P_TYPE_BASE, ENUM_SH_TYPE_BASE,
  11     ENUM_RELOC_TYPE_i386, ENUM_RELOC_TYPE_x64,
  12     ENUM_RELOC_TYPE_ARM, ENUM_RELOC_TYPE_AARCH64, ENUM_RELOC_TYPE_PPC64,
  13     ENUM_RELOC_TYPE_MIPS, ENUM_ATTR_TAG_ARM, ENUM_DT_FLAGS, ENUM_DT_FLAGS_1)
  14 from .constants import (
  15     P_FLAGS, RH_FLAGS, SH_FLAGS, SUNW_SYMINFO_FLAGS, VER_FLAGS)
  16 from ..common.py3compat import bytes2hex, iteritems
  17
  18
  19 def describe_ei_class(x):
  20     return _DESCR_EI_CLASS.get(x, _unknown)
  21
  22
  23 def describe_ei_data(x):
  24     return _DESCR_EI_DATA.get(x, _unknown)
  25
  26
  27 def describe_ei_version(x):
  28     s = '%d' % ENUM_E_VERSION[x]
  29     if x == 'EV_CURRENT':
  30         s += ' (current)'
  31     return s
  32
  33
  34 def describe_ei_osabi(x):
  35     return _DESCR_EI_OSABI.get(x, _unknown)
  36
  37
  38 def describe_e_type(x, elffile=None):
  39     if elffile is not None and x == 'ET_DYN':
  40         # Detect whether this is a normal SO or a PIE executable
  41         dynamic = elffile.get_section_by_name('.dynamic')
  42         for t in dynamic.iter_tags('DT_FLAGS_1'):
  43             if t.entry.d_val & ENUM_DT_FLAGS_1['DF_1_PIE']:
  44                 return 'DYN (Position-Independent Executable file)'
  45     return _DESCR_E_TYPE.get(x, _unknown)
  46
  47
  48 def describe_e_machine(x):
  49     return _DESCR_E_MACHINE.get(x, _unknown)
  50
  51
  52 def describe_e_version_numeric(x):
  53     return '0x%x' % ENUM_E_VERSION[x]
  54
  55
  56 def describe_p_type(x):
  57     if x in _DESCR_P_TYPE:
  58         return _DESCR_P_TYPE.get(x)
  59     elif x >= ENUM_P_TYPE_BASE['PT_LOOS'] and x <= ENUM_P_TYPE_BASE['PT_HIOS']:
  60         return 'LOOS+%lx' % (x - ENUM_P_TYPE_BASE['PT_LOOS'])
  61     else:
  62         return _unknown
  63
  64
  65 def describe_p_flags(x):
  66     s = ''
  67     for flag in (P_FLAGS.PF_R, P_FLAGS.PF_W, P_FLAGS.PF_X):
  68         s += _DESCR_P_FLAGS[flag] if (x & flag) else ' '
  69     return s
  70
  71
  72 def describe_rh_flags(x):
  73     return ' '.join(
  74         _DESCR_RH_FLAGS[flag]
  75         for flag in (RH_FLAGS.RHF_NONE, RH_FLAGS.RHF_QUICKSTART,
  76                      RH_FLAGS.RHF_NOTPOT, RH_FLAGS.RHF_NO_LIBRARY_REPLACEMENT,
  77                      RH_FLAGS.RHF_NO_MOVE, RH_FLAGS.RHF_SGI_ONLY,
  78                      RH_FLAGS.RHF_GUARANTEE_INIT,
  79                      RH_FLAGS.RHF_DELTA_C_PLUS_PLUS,
  80                      RH_FLAGS.RHF_GUARANTEE_START_INIT, RH_FLAGS.RHF_PIXIE,
  81                      RH_FLAGS.RHF_DEFAULT_DELAY_LOAD,
  82                      RH_FLAGS.RHF_REQUICKSTART, RH_FLAGS.RHF_REQUICKSTARTED,
  83                      RH_FLAGS.RHF_CORD, RH_FLAGS.RHF_NO_UNRES_UNDEF,
  84                      RH_FLAGS.RHF_RLD_ORDER_SAFE)
  85         if x & flag)
  86
  87
  88 def describe_sh_type(x):
  89     if x in _DESCR_SH_TYPE:
  90         return _DESCR_SH_TYPE.get(x)
  91     elif (x >= ENUM_SH_TYPE_BASE['SHT_LOOS'] and
  92           x < ENUM_SH_TYPE_BASE['SHT_GNU_versym']):
  93         return 'loos+0x%lx' % (x - ENUM_SH_TYPE_BASE['SHT_LOOS'])
  94     else:
  95         return _unknown
  96
  97
  98 def describe_sh_flags(x):
  99     s = ''
 100     for flag in (
 101             SH_FLAGS.SHF_WRITE, SH_FLAGS.SHF_ALLOC, SH_FLAGS.SHF_EXECINSTR,
 102             SH_FLAGS.SHF_MERGE, SH_FLAGS.SHF_STRINGS, SH_FLAGS.SHF_INFO_LINK,
 103             SH_FLAGS.SHF_LINK_ORDER, SH_FLAGS.SHF_OS_NONCONFORMING,
 104             SH_FLAGS.SHF_GROUP, SH_FLAGS.SHF_TLS, SH_FLAGS.SHF_MASKOS,
 105             SH_FLAGS.SHF_EXCLUDE):
 106         s += _DESCR_SH_FLAGS[flag] if (x & flag) else ''
 107     if not x & SH_FLAGS.SHF_EXCLUDE:
 108         if x & SH_FLAGS.SHF_MASKPROC:
 109             s += 'p'
 110     return s
 111
 112
 113 def describe_symbol_type(x):
 114     return _DESCR_ST_INFO_TYPE.get(x, _unknown)
 115
 116
 117 def describe_symbol_bind(x):
 118     return _DESCR_ST_INFO_BIND.get(x, _unknown)
 119
 120
 121 def describe_symbol_visibility(x):
 122     return _DESCR_ST_VISIBILITY.get(x, _unknown)
 123
 124
 125 def describe_symbol_local(x):
 126     return '[<localentry>: ' + str(1 << x) + ']'
 127
 128
 129 def describe_symbol_other(x):
 130     vis = describe_symbol_visibility(x['visibility'])
 131     if x['local'] > 1 and x['local'] < 7:
 132         return vis + ' ' + describe_symbol_local(x['local'])
 133     return vis
 134
 135
 136 def describe_symbol_shndx(x):
 137     return _DESCR_ST_SHNDX.get(x, '%3s' % x)
 138
 139
 140 def describe_reloc_type(x, elffile):
 141     arch = elffile.get_machine_arch()
 142     if arch == 'x86':
 143         return _DESCR_RELOC_TYPE_i386.get(x, _unknown)
 144     elif arch == 'x64':
 145         return _DESCR_RELOC_TYPE_x64.get(x, _unknown)
 146     elif arch == 'ARM':
 147         return _DESCR_RELOC_TYPE_ARM.get(x, _unknown)
 148     elif arch == 'AArch64':
 149         return _DESCR_RELOC_TYPE_AARCH64.get(x, _unknown)
 150     elif arch == '64-bit PowerPC':
 151         return _DESCR_RELOC_TYPE_PPC64.get(x, _unknown)
 152     elif arch == 'MIPS':
 153         return _DESCR_RELOC_TYPE_MIPS.get(x, _unknown)
 154     else:
 155         return 'unrecognized: %-7x' % (x & 0xFFFFFFFF)
 156
 157
 158 def describe_dyn_tag(x):
 159     return _DESCR_D_TAG.get(x, _unknown)
 160
 161
 162 def describe_dt_flags(x):
 163     return ' '.join(key[3:] for key, val in
 164         sorted(ENUM_DT_FLAGS.items(), key=lambda t: t[1]) if x & val)
 165
 166
 167 def describe_dt_flags_1(x):
 168     return ' '.join(key[5:] for key, val in
 169         sorted(ENUM_DT_FLAGS_1.items(), key=lambda t: t[1]) if x & val)
 170
 171
 172 def describe_syminfo_flags(x):
 173     return ''.join(_DESCR_SYMINFO_FLAGS[flag] for flag in (
 174         SUNW_SYMINFO_FLAGS.SYMINFO_FLG_CAP,
 175         SUNW_SYMINFO_FLAGS.SYMINFO_FLG_DIRECT,
 176         SUNW_SYMINFO_FLAGS.SYMINFO_FLG_FILTER,
 177         SUNW_SYMINFO_FLAGS.SYMINFO_FLG_AUXILIARY,
 178         SUNW_SYMINFO_FLAGS.SYMINFO_FLG_DIRECTBIND,
 179         SUNW_SYMINFO_FLAGS.SYMINFO_FLG_COPY,
 180         SUNW_SYMINFO_FLAGS.SYMINFO_FLG_LAZYLOAD,
 181         SUNW_SYMINFO_FLAGS.SYMINFO_FLG_NOEXTDIRECT,
 182         SUNW_SYMINFO_FLAGS.SYMINFO_FLG_INTERPOSE,
 183         SUNW_SYMINFO_FLAGS.SYMINFO_FLG_DEFERRED) if x & flag)
 184
 185
 186 def describe_symbol_boundto(x):
 187     return _DESCR_SYMINFO_BOUNDTO.get(x, '%3s' % x)
 188
 189
 190 def describe_ver_flags(x):
 191     return ' | '.join(_DESCR_VER_FLAGS[flag] for flag in (
 192         VER_FLAGS.VER_FLG_WEAK,
 193         VER_FLAGS.VER_FLG_BASE,
 194         VER_FLAGS.VER_FLG_INFO) if x & flag)
 195
 196
 197 def describe_note(x):
 198     n_desc = x['n_desc']
 199     desc = ''
 200     if x['n_type'] == 'NT_GNU_ABI_TAG':
 201         if x['n_name'] == 'Android':
 202             desc = '\n   description data: %s ' % bytes2hex(x['n_descdata'])
 203         else:
 204             desc = '\n    OS: %s, ABI: %d.%d.%d' % (
 205                 _DESCR_NOTE_ABI_TAG_OS.get(n_desc['abi_os'], _unknown),
 206                 n_desc['abi_major'], n_desc['abi_minor'], n_desc['abi_tiny'])
 207     elif x['n_type'] == 'NT_GNU_BUILD_ID':
 208         desc = '\n    Build ID: %s' % (n_desc)
 209     elif x['n_type'] == 'NT_GNU_GOLD_VERSION':
 210         desc = '\n    Version: %s' % (n_desc)
 211     elif x['n_type'] == 'NT_GNU_PROPERTY_TYPE_0':
 212         desc = '\n      Properties: ' + describe_note_gnu_properties(x['n_desc'])
 213     else:
 214         desc = '\n      description data: {}'.format(bytes2hex(n_desc))
 215
 216     if x['n_type'] == 'NT_GNU_ABI_TAG' and x['n_name'] == 'Android':
 217         note_type = 'NT_VERSION'
 218         note_type_desc = 'version'
 219     else:
 220         note_type = (x['n_type'] if isinstance(x['n_type'], str)
 221                     else 'Unknown note type:')
 222         note_type_desc = ('0x%.8x' % x['n_type']
 223                         if isinstance(x['n_type'], int) else
 224                         _DESCR_NOTE_N_TYPE.get(x['n_type'], _unknown))
 225     return '%s (%s)%s' % (note_type, note_type_desc, desc)
 226
 227
 228 def describe_attr_tag_arm(tag, val, extra):
 229     idx = ENUM_ATTR_TAG_ARM[tag] - 1
 230     d_entry = _DESCR_ATTR_VAL_ARM[idx]
 231
 232     if d_entry is None:
 233         if tag == 'TAG_COMPATIBILITY':
 234             return (_DESCR_ATTR_TAG_ARM[tag]
 235                     + 'flag = %d, vendor = %s' % (val, extra))
 236
 237         elif tag == 'TAG_ALSO_COMPATIBLE_WITH':
 238             if val.tag == 'TAG_CPU_ARCH':
 239                 return _DESCR_ATTR_TAG_ARM[tag] + d_entry[val]
 240
 241             else:
 242                 return _DESCR_ATTR_TAG_ARM[tag] + '??? (%d)' % val.tag
 243
 244         elif tag == 'TAG_NODEFAULTS':
 245             return _DESCR_ATTR_TAG_ARM[tag] + 'True'
 246
 247         s = _DESCR_ATTR_TAG_ARM[tag]
 248         s += '"%s"' % val if val else ''
 249         return s
 250
 251     else:
 252         return _DESCR_ATTR_TAG_ARM[tag] + d_entry[val]
 253
 254
 255 def describe_note_gnu_property_x86_feature_1(value):
 256     descs = []
 257     for mask, desc in _DESCR_NOTE_GNU_PROPERTY_X86_FEATURE_1_FLAGS:
 258         if value & mask:
 259             descs.append(desc)
 260     return 'x86 feature: ' + ', '.join(descs)
 261
 262 def describe_note_gnu_property_x86_isa_1(value):
 263     descs = []
 264     for mask, desc in _DESCR_NOTE_GNU_PROPERTY_X86_ISA_1_FLAGS:
 265         if value & mask:
 266             descs.append(desc)
 267     return 'x86 ISA needed: ' + ', '.join(descs)
 268
 269 def describe_note_gnu_properties(properties):
 270     descriptions = []
 271     for prop in properties:
 272         t, d, sz = prop.pr_type, prop.pr_data, prop.pr_datasz
 273         if t == 'GNU_PROPERTY_STACK_SIZE':
 274             if type(d) is int:
 275                 prop_desc = 'stack size: 0x%x' % d
 276             else:
 277                 prop_desc = 'stack size: <corrupt length: 0x%x>' % sz
 278         elif t == 'GNU_PROPERTY_NO_COPY_ON_PROTECTED':
 279             if sz != 0:
 280                 prop_desc = ' <corrupt length: 0x%x>' % sz
 281             else:
 282                 prop_desc = 'no copy on protected'
 283         elif t == 'GNU_PROPERTY_X86_FEATURE_1_AND':
 284             if sz != 4:
 285                 prop_desc = ' <corrupt length: 0x%x>' % sz
 286             else:
 287                 prop_desc = describe_note_gnu_property_x86_feature_1(d)
 288         elif t == 'GNU_PROPERTY_X86_ISA_1_NEEDED':
 289             if sz != 4:
 290                 prop_desc = ' <corrupt length: 0x%x>' % sz
 291             else:
 292                 prop_desc = describe_note_gnu_property_x86_isa_1(d)
 293         elif _DESCR_NOTE_GNU_PROPERTY_TYPE_LOPROC <= t <= _DESCR_NOTE_GNU_PROPERTY_TYPE_HIPROC:
 294             prop_desc = '<processor-specific type 0x%x data: %s >' % (t, bytes2hex(d, sep=' '))
 295         elif _DESCR_NOTE_GNU_PROPERTY_TYPE_LOUSER <= t <= _DESCR_NOTE_GNU_PROPERTY_TYPE_HIUSER:
 296             prop_desc = '<application-specific type 0x%x data: %s >' % (t, bytes2hex(d, sep=' '))
 297         else:
 298             prop_desc = '<unknown type 0x%x data: %s >' % (t, bytes2hex(d, sep=' '))
 299         descriptions.append(prop_desc)
 300     return '\n        '.join(descriptions)
 301
 302 #-------------------------------------------------------------------------------
 303 _unknown = '<unknown>'
 304
 305
 306 _DESCR_EI_CLASS = dict(
 307     ELFCLASSNONE='none',
 308     ELFCLASS32='ELF32',
 309     ELFCLASS64='ELF64',
 310 )
 311
 312
 313 _DESCR_EI_DATA = dict(
 314     ELFDATANONE='none',
 315     ELFDATA2LSB="2's complement, little endian",
 316     ELFDATA2MSB="2's complement, big endian",
 317 )
 318
 319
 320 _DESCR_EI_OSABI = dict(
 321     ELFOSABI_SYSV='UNIX - System V',
 322     ELFOSABI_HPUX='UNIX - HP-UX',
 323     ELFOSABI_NETBSD='UNIX - NetBSD',
 324     ELFOSABI_LINUX='UNIX - Linux',
 325     ELFOSABI_HURD='UNIX - GNU/Hurd',
 326     ELFOSABI_SOLARIS='UNIX - Solaris',
 327     ELFOSABI_AIX='UNIX - AIX',
 328     ELFOSABI_IRIX='UNIX - IRIX',
 329     ELFOSABI_FREEBSD='UNIX - FreeBSD',
 330     ELFOSABI_TRU64='UNIX - TRU64',
 331     ELFOSABI_MODESTO='Novell - Modesto',
 332     ELFOSABI_OPENBSD='UNIX - OpenBSD',
 333     ELFOSABI_OPENVMS='VMS - OpenVMS',
 334     ELFOSABI_NSK='HP - Non-Stop Kernel',
 335     ELFOSABI_AROS='AROS',
 336     ELFOSABI_FENIXOS='Fenix OS',
 337     ELFOSABI_CLOUD='Nuxi - CloudABI',
 338     ELFOSABI_SORTIX='Sortix',
 339     ELFOSABI_ARM_AEABI='ARM - EABI',
 340     ELFOSABI_ARM='ARM - ABI',
 341     ELFOSABI_CELL_LV2='CellOS Lv-2',
 342     ELFOSABI_STANDALONE='Standalone App',
 343 )
 344
 345
 346 _DESCR_E_TYPE = dict(
 347     ET_NONE='NONE (None)',
 348     ET_REL='REL (Relocatable file)',
 349     ET_EXEC='EXEC (Executable file)',
 350     ET_DYN='DYN (Shared object file)',
 351     ET_CORE='CORE (Core file)',
 352     PROC_SPECIFIC='Processor Specific',
 353 )
 354
 355
 356 _DESCR_E_MACHINE = dict(
 357     EM_NONE='None',
 358     EM_M32='WE32100',
 359     EM_SPARC='Sparc',
 360     EM_386='Intel 80386',
 361     EM_68K='MC68000',
 362     EM_88K='MC88000',
 363     EM_860='Intel 80860',
 364     EM_MIPS='MIPS R3000',
 365     EM_S370='IBM System/370',
 366     EM_MIPS_RS4_BE='MIPS 4000 big-endian',
 367     EM_IA_64='Intel IA-64',
 368     EM_X86_64='Advanced Micro Devices X86-64',
 369     EM_AVR='Atmel AVR 8-bit microcontroller',
 370     EM_ARM='ARM',
 371     EM_AARCH64='AArch64',
 372     EM_BLACKFIN='Analog Devices Blackfin',
 373     EM_PPC='PowerPC',
 374     EM_PPC64='PowerPC64',
 375     RESERVED='RESERVED',
 376 )
 377
 378
 379 _DESCR_P_TYPE = dict(
 380     PT_NULL='NULL',
 381     PT_LOAD='LOAD',
 382     PT_DYNAMIC='DYNAMIC',
 383     PT_INTERP='INTERP',
 384     PT_NOTE='NOTE',
 385     PT_SHLIB='SHLIB',
 386     PT_PHDR='PHDR',
 387     PT_GNU_EH_FRAME='GNU_EH_FRAME',
 388     PT_GNU_STACK='GNU_STACK',
 389     PT_GNU_RELRO='GNU_RELRO',
 390     PT_GNU_PROPERTY='GNU_PROPERTY',
 391     PT_ARM_ARCHEXT='ARM_ARCHEXT',
 392     PT_ARM_EXIDX='EXIDX',  # binutils calls this EXIDX, not ARM_EXIDX
 393     PT_AARCH64_ARCHEXT='AARCH64_ARCHEXT',
 394     PT_AARCH64_UNWIND='AARCH64_UNWIND',
 395     PT_TLS='TLS',
 396     PT_MIPS_ABIFLAGS='ABIFLAGS'
 397 )
 398
 399
 400 _DESCR_P_FLAGS = {
 401     P_FLAGS.PF_X: 'E',
 402     P_FLAGS.PF_R: 'R',
 403     P_FLAGS.PF_W: 'W',
 404 }
 405
 406
 407 _DESCR_SH_TYPE = dict(
 408     SHT_NULL='NULL',
 409     SHT_PROGBITS='PROGBITS',
 410     SHT_SYMTAB='SYMTAB',
 411     SHT_STRTAB='STRTAB',
 412     SHT_RELA='RELA',
 413     SHT_HASH='HASH',
 414     SHT_DYNAMIC='DYNAMIC',
 415     SHT_NOTE='NOTE',
 416     SHT_NOBITS='NOBITS',
 417     SHT_REL='REL',
 418     SHT_SHLIB='SHLIB',
 419     SHT_DYNSYM='DYNSYM',
 420     SHT_INIT_ARRAY='INIT_ARRAY',
 421     SHT_FINI_ARRAY='FINI_ARRAY',
 422     SHT_PREINIT_ARRAY='PREINIT_ARRAY',
 423     SHT_GNU_ATTRIBUTES='GNU_ATTRIBUTES',
 424     SHT_GNU_HASH='GNU_HASH',
 425     SHT_GROUP='GROUP',
 426     SHT_SYMTAB_SHNDX='SYMTAB SECTION INDICIES',
 427     SHT_RELR='RELR',
 428     SHT_GNU_verdef='VERDEF',
 429     SHT_GNU_verneed='VERNEED',
 430     SHT_GNU_versym='VERSYM',
 431     SHT_GNU_LIBLIST='GNU_LIBLIST',
 432     SHT_ARM_EXIDX='ARM_EXIDX',
 433     SHT_ARM_PREEMPTMAP='ARM_PREEMPTMAP',
 434     SHT_ARM_ATTRIBUTES='ARM_ATTRIBUTES',
 435     SHT_ARM_DEBUGOVERLAY='ARM_DEBUGOVERLAY',
 436     SHT_MIPS_LIBLIST='MIPS_LIBLIST',
 437     SHT_MIPS_DEBUG='MIPS_DEBUG',
 438     SHT_MIPS_REGINFO='MIPS_REGINFO',
 439     SHT_MIPS_PACKAGE='MIPS_PACKAGE',
 440     SHT_MIPS_PACKSYM='MIPS_PACKSYM',
 441     SHT_MIPS_RELD='MIPS_RELD',
 442     SHT_MIPS_IFACE='MIPS_IFACE',
 443     SHT_MIPS_CONTENT='MIPS_CONTENT',
 444     SHT_MIPS_OPTIONS='MIPS_OPTIONS',
 445     SHT_MIPS_SHDR='MIPS_SHDR',
 446     SHT_MIPS_FDESC='MIPS_FDESC',
 447     SHT_MIPS_EXTSYM='MIPS_EXTSYM',
 448     SHT_MIPS_DENSE='MIPS_DENSE',
 449     SHT_MIPS_PDESC='MIPS_PDESC',
 450     SHT_MIPS_LOCSYM='MIPS_LOCSYM',
 451     SHT_MIPS_AUXSYM='MIPS_AUXSYM',
 452     SHT_MIPS_OPTSYM='MIPS_OPTSYM',
 453     SHT_MIPS_LOCSTR='MIPS_LOCSTR',
 454     SHT_MIPS_LINE='MIPS_LINE',
 455     SHT_MIPS_RFDESC='MIPS_RFDESC',
 456     SHT_MIPS_DELTASYM='MIPS_DELTASYM',
 457     SHT_MIPS_DELTAINST='MIPS_DELTAINST',
 458     SHT_MIPS_DELTACLASS='MIPS_DELTACLASS',
 459     SHT_MIPS_DWARF='MIPS_DWARF',
 460     SHT_MIPS_DELTADECL='MIPS_DELTADECL',
 461     SHT_MIPS_SYMBOL_LIB='MIPS_SYMBOL_LIB',
 462     SHT_MIPS_EVENTS='MIPS_EVENTS',
 463     SHT_MIPS_TRANSLATE='MIPS_TRANSLATE',
 464     SHT_MIPS_PIXIE='MIPS_PIXIE',
 465     SHT_MIPS_XLATE='MIPS_XLATE',
 466     SHT_MIPS_XLATE_DEBUG='MIPS_XLATE_DEBUG',
 467     SHT_MIPS_WHIRL='MIPS_WHIRL',
 468     SHT_MIPS_EH_REGION='MIPS_EH_REGION',
 469     SHT_MIPS_XLATE_OLD='MIPS_XLATE_OLD',
 470     SHT_MIPS_PDR_EXCEPTION='MIPS_PDR_EXCEPTION',
 471     SHT_MIPS_ABIFLAGS='MIPS_ABIFLAGS',
 472 )
 473
 474
 475 _DESCR_SH_FLAGS = {
 476     SH_FLAGS.SHF_WRITE: 'W',
 477     SH_FLAGS.SHF_ALLOC: 'A',
 478     SH_FLAGS.SHF_EXECINSTR: 'X',
 479     SH_FLAGS.SHF_MERGE: 'M',
 480     SH_FLAGS.SHF_STRINGS: 'S',
 481     SH_FLAGS.SHF_INFO_LINK: 'I',
 482     SH_FLAGS.SHF_LINK_ORDER: 'L',
 483     SH_FLAGS.SHF_OS_NONCONFORMING: 'O',
 484     SH_FLAGS.SHF_GROUP: 'G',
 485     SH_FLAGS.SHF_TLS: 'T',
 486     SH_FLAGS.SHF_MASKOS: 'o',
 487     SH_FLAGS.SHF_EXCLUDE: 'E',
 488 }
 489
 490
 491 _DESCR_RH_FLAGS = {
 492     RH_FLAGS.RHF_NONE: 'NONE',
 493     RH_FLAGS.RHF_QUICKSTART: 'QUICKSTART',
 494     RH_FLAGS.RHF_NOTPOT: 'NOTPOT',
 495     RH_FLAGS.RHF_NO_LIBRARY_REPLACEMENT: 'NO_LIBRARY_REPLACEMENT',
 496     RH_FLAGS.RHF_NO_MOVE: 'NO_MOVE',
 497     RH_FLAGS.RHF_SGI_ONLY: 'SGI_ONLY',
 498     RH_FLAGS.RHF_GUARANTEE_INIT: 'GUARANTEE_INIT',
 499     RH_FLAGS.RHF_DELTA_C_PLUS_PLUS: 'DELTA_C_PLUS_PLUS',
 500     RH_FLAGS.RHF_GUARANTEE_START_INIT: 'GUARANTEE_START_INIT',
 501     RH_FLAGS.RHF_PIXIE: 'PIXIE',
 502     RH_FLAGS.RHF_DEFAULT_DELAY_LOAD: 'DEFAULT_DELAY_LOAD',
 503     RH_FLAGS.RHF_REQUICKSTART: 'REQUICKSTART',
 504     RH_FLAGS.RHF_REQUICKSTARTED: 'REQUICKSTARTED',
 505     RH_FLAGS.RHF_CORD: 'CORD',
 506     RH_FLAGS.RHF_NO_UNRES_UNDEF: 'NO_UNRES_UNDEF',
 507     RH_FLAGS.RHF_RLD_ORDER_SAFE: 'RLD_ORDER_SAFE',
 508 }
 509
 510
 511 _DESCR_ST_INFO_TYPE = dict(
 512     STT_NOTYPE='NOTYPE',
 513     STT_OBJECT='OBJECT',
 514     STT_FUNC='FUNC',
 515     STT_SECTION='SECTION',
 516     STT_FILE='FILE',
 517     STT_COMMON='COMMON',
 518     STT_TLS='TLS',
 519     STT_NUM='NUM',
 520     STT_RELC='RELC',
 521     STT_SRELC='SRELC',
 522 )
 523
 524
 525 _DESCR_ST_INFO_BIND = dict(
 526     STB_LOCAL='LOCAL',
 527     STB_GLOBAL='GLOBAL',
 528     STB_WEAK='WEAK',
 529 )
 530
 531
 532 _DESCR_ST_VISIBILITY = dict(
 533     STV_DEFAULT='DEFAULT',
 534     STV_INTERNAL='INTERNAL',
 535     STV_HIDDEN='HIDDEN',
 536     STV_PROTECTED='PROTECTED',
 537     STV_EXPORTED='EXPORTED',
 538     STV_SINGLETON='SINGLETON',
 539     STV_ELIMINATE='ELIMINATE',
 540 )
 541
 542
 543 _DESCR_ST_SHNDX = dict(
 544     SHN_UNDEF='UND',
 545     SHN_ABS='ABS',
 546     SHN_COMMON='COM',
 547 )
 548
 549
 550 _DESCR_SYMINFO_FLAGS = {
 551     SUNW_SYMINFO_FLAGS.SYMINFO_FLG_DIRECT: 'D',
 552     SUNW_SYMINFO_FLAGS.SYMINFO_FLG_DIRECTBIND: 'B',
 553     SUNW_SYMINFO_FLAGS.SYMINFO_FLG_COPY: 'C',
 554     SUNW_SYMINFO_FLAGS.SYMINFO_FLG_LAZYLOAD: 'L',
 555     SUNW_SYMINFO_FLAGS.SYMINFO_FLG_NOEXTDIRECT: 'N',
 556     SUNW_SYMINFO_FLAGS.SYMINFO_FLG_AUXILIARY: 'A',
 557     SUNW_SYMINFO_FLAGS.SYMINFO_FLG_FILTER: 'F',
 558     SUNW_SYMINFO_FLAGS.SYMINFO_FLG_INTERPOSE: 'I',
 559     SUNW_SYMINFO_FLAGS.SYMINFO_FLG_CAP: 'S',
 560     SUNW_SYMINFO_FLAGS.SYMINFO_FLG_DEFERRED: 'P',
 561 }
 562
 563
 564 _DESCR_SYMINFO_BOUNDTO = dict(
 565     SYMINFO_BT_SELF='<self>',
 566     SYMINFO_BT_PARENT='<parent>',
 567     SYMINFO_BT_NONE='',
 568     SYMINFO_BT_EXTERN='<extern>',
 569 )
 570
 571
 572 _DESCR_VER_FLAGS = {
 573     0: '',
 574     VER_FLAGS.VER_FLG_BASE: 'BASE',
 575     VER_FLAGS.VER_FLG_WEAK: 'WEAK',
 576     VER_FLAGS.VER_FLG_INFO: 'INFO',
 577 }
 578
 579
 580 # PT_NOTE section types
 581 _DESCR_NOTE_N_TYPE = dict(
 582     NT_GNU_ABI_TAG='ABI version tag',
 583     NT_GNU_HWCAP='DSO-supplied software HWCAP info',
 584     NT_GNU_BUILD_ID='unique build ID bitstring',
 585     NT_GNU_GOLD_VERSION='gold version',
 586     NT_GNU_PROPERTY_TYPE_0='program properties'
 587 )
 588
 589
 590 # Values in GNU .note.ABI-tag notes (n_type=='NT_GNU_ABI_TAG')
 591 _DESCR_NOTE_ABI_TAG_OS = dict(
 592     ELF_NOTE_OS_LINUX='Linux',
 593     ELF_NOTE_OS_GNU='GNU',
 594     ELF_NOTE_OS_SOLARIS2='Solaris 2',
 595     ELF_NOTE_OS_FREEBSD='FreeBSD',
 596     ELF_NOTE_OS_NETBSD='NetBSD',
 597     ELF_NOTE_OS_SYLLABLE='Syllable',
 598 )
 599
 600
 601 # Values in GNU .note.gnu.property notes (n_type=='NT_GNU_PROPERTY_TYPE_0') have
 602 # different formats which need to be parsed/described differently
 603 _DESCR_NOTE_GNU_PROPERTY_TYPE_LOPROC=0xc0000000
 604 _DESCR_NOTE_GNU_PROPERTY_TYPE_HIPROC=0xdfffffff
 605 _DESCR_NOTE_GNU_PROPERTY_TYPE_LOUSER=0xe0000000
 606 _DESCR_NOTE_GNU_PROPERTY_TYPE_HIUSER=0xffffffff
 607
 608
 609 # Bit masks for GNU_PROPERTY_X86_FEATURE_1_xxx flags in the form
 610 # (mask, flag_description) in the desired output order
 611 _DESCR_NOTE_GNU_PROPERTY_X86_FEATURE_1_FLAGS = (
 612     (1, 'IBT'),
 613     (2, 'SHSTK'),
 614     (4, 'LAM_U48'),
 615     (8, 'LAM_U57'),
 616 )
 617
 618 # Same for GNU_PROPERTY_X86_SET_1_xxx
 619 _DESCR_NOTE_GNU_PROPERTY_X86_ISA_1_FLAGS = (
 620     (1, 'x86-64-baseline'),
 621     # TODO; there is a long list
 622 )
 623
 624
 625 def _reverse_dict(d, low_priority=()):
 626     """
 627     This is a tiny helper function to "reverse" the keys/values of a dictionary
 628     provided in the first argument, i.e. {k: v} becomes {v: k}.
 629
 630     The second argument (optional) provides primitive control over what to do in
 631     the case of conflicting values - if a value is present in this list, it will
 632     not override any other entries of the same value.
 633     """
 634     out = {}
 635     for k, v in iteritems(d):
 636         if v in out and k in low_priority:
 637             continue
 638         out[v] = k
 639     return out
 640
 641 _DESCR_RELOC_TYPE_i386 = _reverse_dict(ENUM_RELOC_TYPE_i386)
 642 _DESCR_RELOC_TYPE_x64 = _reverse_dict(ENUM_RELOC_TYPE_x64)
 643 _DESCR_RELOC_TYPE_ARM = _reverse_dict(ENUM_RELOC_TYPE_ARM)
 644 _DESCR_RELOC_TYPE_AARCH64 = _reverse_dict(ENUM_RELOC_TYPE_AARCH64)
 645 _DESCR_RELOC_TYPE_PPC64 = _reverse_dict(ENUM_RELOC_TYPE_PPC64)
 646 _DESCR_RELOC_TYPE_MIPS = _reverse_dict(ENUM_RELOC_TYPE_MIPS)
 647
 648 _low_priority_D_TAG = (
 649     # these are 'meta-tags' marking semantics of numeric ranges of the enum
 650     # they should not override other tags with the same numbers
 651     # see https://docs.oracle.com/cd/E23824_01/html/819-0690/chapter6-42444.html
 652     'DT_LOOS',
 653     'DT_HIOS',
 654     'DT_LOPROC',
 655     'DT_HIPROC',
 656     'DT_ENCODING',
 657 )
 658 _DESCR_D_TAG = _reverse_dict(ENUM_D_TAG, low_priority=_low_priority_D_TAG)
 659
 660 _DESCR_ATTR_TAG_ARM = dict(
 661     TAG_FILE='File Attributes',
 662     TAG_SECTION='Section Attributes:',
 663     TAG_SYMBOL='Symbol Attributes:',
 664     TAG_CPU_RAW_NAME='Tag_CPU_raw_name: ',
 665     TAG_CPU_NAME='Tag_CPU_name: ',
 666     TAG_CPU_ARCH='Tag_CPU_arch: ',
 667     TAG_CPU_ARCH_PROFILE='Tag_CPU_arch_profile: ',
 668     TAG_ARM_ISA_USE='Tag_ARM_ISA_use: ',
 669     TAG_THUMB_ISA_USE='Tag_Thumb_ISA_use: ',
 670     TAG_FP_ARCH='Tag_FP_arch: ',
 671     TAG_WMMX_ARCH='Tag_WMMX_arch: ',
 672     TAG_ADVANCED_SIMD_ARCH='Tag_Advanced_SIMD_arch: ',
 673     TAG_PCS_CONFIG='Tag_PCS_config: ',
 674     TAG_ABI_PCS_R9_USE='Tag_ABI_PCS_R9_use: ',
 675     TAG_ABI_PCS_RW_DATA='Tag_ABI_PCS_RW_use: ',
 676     TAG_ABI_PCS_RO_DATA='Tag_ABI_PCS_RO_use: ',
 677     TAG_ABI_PCS_GOT_USE='Tag_ABI_PCS_GOT_use: ',
 678     TAG_ABI_PCS_WCHAR_T='Tag_ABI_PCS_wchar_t: ',
 679     TAG_ABI_FP_ROUNDING='Tag_ABI_FP_rounding: ',
 680     TAG_ABI_FP_DENORMAL='Tag_ABI_FP_denormal: ',
 681     TAG_ABI_FP_EXCEPTIONS='Tag_ABI_FP_exceptions: ',
 682     TAG_ABI_FP_USER_EXCEPTIONS='Tag_ABI_FP_user_exceptions: ',
 683     TAG_ABI_FP_NUMBER_MODEL='Tag_ABI_FP_number_model: ',
 684     TAG_ABI_ALIGN_NEEDED='Tag_ABI_align_needed: ',
 685     TAG_ABI_ALIGN_PRESERVED='Tag_ABI_align_preserved: ',
 686     TAG_ABI_ENUM_SIZE='Tag_ABI_enum_size: ',
 687     TAG_ABI_HARDFP_USE='Tag_ABI_HardFP_use: ',
 688     TAG_ABI_VFP_ARGS='Tag_ABI_VFP_args: ',
 689     TAG_ABI_WMMX_ARGS='Tag_ABI_WMMX_args: ',
 690     TAG_ABI_OPTIMIZATION_GOALS='Tag_ABI_optimization_goals: ',
 691     TAG_ABI_FP_OPTIMIZATION_GOALS='Tag_ABI_FP_optimization_goals: ',
 692     TAG_COMPATIBILITY='Tag_compatibility: ',
 693     TAG_CPU_UNALIGNED_ACCESS='Tag_CPU_unaligned_access: ',
 694     TAG_FP_HP_EXTENSION='Tag_FP_HP_extension: ',
 695     TAG_ABI_FP_16BIT_FORMAT='Tag_ABI_FP_16bit_format: ',
 696     TAG_MPEXTENSION_USE='Tag_MPextension_use: ',
 697     TAG_DIV_USE='Tag_DIV_use: ',
 698     TAG_NODEFAULTS='Tag_nodefaults: ',
 699     TAG_ALSO_COMPATIBLE_WITH='Tag_also_compatible_with: ',
 700     TAG_T2EE_USE='Tag_T2EE_use: ',
 701     TAG_CONFORMANCE='Tag_conformance: ',
 702     TAG_VIRTUALIZATION_USE='Tag_Virtualization_use: ',
 703     TAG_MPEXTENSION_USE_OLD='Tag_MPextension_use_old: ',
 704 )
 705
 706
 707 _DESCR_ATTR_VAL_ARM = [
 708     None, #1
 709     None, #2
 710     None, #3
 711     None, #4
 712     None, #5
 713     { #6 TAG_CPU_ARCH
 714         0 : 'Pre-v4',
 715         1 : 'v4',
 716         2 : 'v4T',
 717         3 : 'v5T',
 718         4 : 'v5TE',
 719         5 : 'v5TEJ',
 720         6 : 'v6',
 721         7 : 'v6KZ',
 722         8 : 'v6T2',
 723         9 : 'v6K',
 724         10: 'v7',
 725         11: 'v6-M',
 726         12: 'v6S-M',
 727         13: 'v7E-M',
 728         14: 'v8',
 729         15: 'v8-R',
 730         16: 'v8-M.baseline',
 731         17: 'v8-M.mainline',
 732     },
 733     { #7 TAG_CPU_ARCH_PROFILE
 734         0x00: 'None',
 735         0x41: 'Application',
 736         0x52: 'Realtime',
 737         0x4D: 'Microcontroller',
 738         0x53: 'Application or Realtime',
 739     },
 740     { #8 TAG_ARM_ISA
 741         0: 'No',
 742         1: 'Yes',
 743     },
 744     { #9 TAG_THUMB_ISA
 745         0: 'No',
 746         1: 'Thumb-1',
 747         2: 'Thumb-2',
 748         3: 'Yes',
 749     },
 750     { #10 TAG_FP_ARCH
 751         0: 'No',
 752         1: 'VFPv1',
 753         2: 'VFPv2 ',
 754         3: 'VFPv3',
 755         4: 'VFPv3-D16',
 756         5: 'VFPv4',
 757         6: 'VFPv4-D16',
 758         7: 'FP ARM v8',
 759         8: 'FPv5/FP-D16 for ARMv8',
 760     },
 761     { #11 TAG_WMMX_ARCH
 762         0: 'No',
 763         1: 'WMMXv1',
 764         2: 'WMMXv2',
 765     },
 766     { #12 TAG_ADVANCED_SIMD_ARCH
 767         0: 'No',
 768         1: 'NEONv1',
 769         2: 'NEONv1 with Fused-MAC',
 770         3: 'NEON for ARMv8',
 771         4: 'NEON for ARMv8.1',
 772     },
 773     { #13 TAG_PCS_CONFIG
 774         0: 'None',
 775         1: 'Bare platform',
 776         2: 'Linux application',
 777         3: 'Linux DSO',
 778         4: 'PalmOS 2004',
 779         5: 'PalmOS (reserved)',
 780         6: 'SymbianOS 2004',
 781         7: 'SymbianOS (reserved)',
 782     },
 783     { #14 TAG_ABI_PCS_R9_USE
 784         0: 'v6',
 785         1: 'SB',
 786         2: 'TLS',
 787         3: 'Unused',
 788     },
 789     { #15 TAG_ABI_PCS_RW_DATA
 790         0: 'Absolute',
 791         1: 'PC-relative',
 792         2: 'SB-relative',
 793         3: 'None',
 794     },
 795     { #16 TAG_ABI_PCS_RO_DATA
 796         0: 'Absolute',
 797         1: 'PC-relative',
 798         2: 'None',
 799     },
 800     { #17 TAG_ABI_PCS_GOT_USE
 801         0: 'None',
 802         1: 'direct',
 803         2: 'GOT-indirect',
 804     },
 805     { #18 TAG_ABI_PCS_WCHAR_T
 806         0: 'None',
 807         1: '??? 1',
 808         2: '2',
 809         3: '??? 3',
 810         4: '4',
 811     },
 812     { #19 TAG_ABI_FP_ROUNDING
 813         0: 'Unused',
 814         1: 'Needed',
 815     },
 816     { #20 TAG_ABI_FP_DENORMAL
 817         0: 'Unused',
 818         1: 'Needed',
 819         2: 'Sign only',
 820     },
 821     { #21 TAG_ABI_FP_EXCEPTIONS
 822         0: 'Unused',
 823         1: 'Needed',
 824     },
 825     { #22 TAG_ABI_FP_USER_EXCEPTIONS
 826         0: 'Unused',
 827         1: 'Needed',
 828     },
 829     { #23 TAG_ABI_FP_NUMBER_MODEL
 830         0: 'Unused',
 831         1: 'Finite',
 832         2: 'RTABI',
 833         3: 'IEEE 754',
 834     },
 835     { #24 TAG_ABI_ALIGN_NEEDED
 836         0: 'None',
 837         1: '8-byte',
 838         2: '4-byte',
 839         3: '??? 3',
 840     },
 841     { #25 TAG_ABI_ALIGN_PRESERVED
 842         0: 'None',
 843         1: '8-byte, except leaf SP',
 844         2: '8-byte',
 845         3: '??? 3',
 846     },
 847     { #26 TAG_ABI_ENUM_SIZE
 848         0: 'Unused',
 849         1: 'small',
 850         2: 'int',
 851         3: 'forced to int',
 852     },
 853     { #27 TAG_ABI_HARDFP_USE
 854         0: 'As Tag_FP_arch',
 855         1: 'SP only',
 856         2: 'Reserved',
 857         3: 'Deprecated',
 858     },
 859     { #28 TAG_ABI_VFP_ARGS
 860         0: 'AAPCS',
 861         1: 'VFP registers',
 862         2: 'custom',
 863         3: 'compatible',
 864     },
 865     { #29 TAG_ABI_WMMX_ARGS
 866         0: 'AAPCS',
 867         1: 'WMMX registers',
 868         2: 'custom',
 869     },
 870     { #30 TAG_ABI_OPTIMIZATION_GOALS
 871         0: 'None',
 872         1: 'Prefer Speed',
 873         2: 'Aggressive Speed',
 874         3: 'Prefer Size',
 875         4: 'Aggressive Size',
 876         5: 'Prefer Debug',
 877         6: 'Aggressive Debug',
 878     },
 879     { #31 TAG_ABI_FP_OPTIMIZATION_GOALS
 880         0: 'None',
 881         1: 'Prefer Speed',
 882         2: 'Aggressive Speed',
 883         3: 'Prefer Size',
 884         4: 'Aggressive Size',
 885         5: 'Prefer Accuracy',
 886         6: 'Aggressive Accuracy',
 887     },
 888     { #32 TAG_COMPATIBILITY
 889         0: 'No',
 890         1: 'Yes',
 891     },
 892     None, #33
 893     { #34 TAG_CPU_UNALIGNED_ACCESS
 894         0: 'None',
 895         1: 'v6',
 896     },
 897     None, #35
 898     { #36 TAG_FP_HP_EXTENSION
 899         0: 'Not Allowed',
 900         1: 'Allowed',
 901     },
 902     None, #37
 903     { #38 TAG_ABI_FP_16BIT_FORMAT
 904         0: 'None',
 905         1: 'IEEE 754',
 906         2: 'Alternative Format',
 907     },
 908     None, #39
 909     None, #40
 910     None, #41
 911     { #42 TAG_MPEXTENSION_USE
 912         0: 'Not Allowed',
 913         1: 'Allowed',
 914     },
 915     None, #43
 916     { #44 TAG_DIV_USE
 917         0: 'Allowed in Thumb-ISA, v7-R or v7-M',
 918         1: 'Not allowed',
 919         2: 'Allowed in v7-A with integer division extension',
 920     },
 921     None, #45
 922     None, #46
 923     None, #47
 924     None, #48
 925     None, #49
 926     None, #50
 927     None, #51
 928     None, #52
 929     None, #53
 930     None, #54
 931     None, #55
 932     None, #56
 933     None, #57
 934     None, #58
 935     None, #59
 936     None, #60
 937     None, #61
 938     None, #62
 939     None, #63
 940     None, #64
 941     None, #65
 942     { #66 TAG_FP_HP_EXTENSION
 943         0: 'Not Allowed',
 944         1: 'Allowed',
 945     },
 946     None, #67
 947     { #68 TAG_VIRTUALIZATION_USE
 948         0: 'Not Allowed',
 949         1: 'TrustZone',
 950         2: 'Virtualization Extensions',
 951         3: 'TrustZone and Virtualization Extensions',
 952     },
 953     None, #69
 954     { #70 TAG_MPEXTENSION_USE_OLD
 955         0: 'Not Allowed',
 956         1: 'Allowed',
 957     },
 958 ]