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