Shofel2_T124_python/venv/bin/readelf.py

1880 lines
85 KiB
Python
Raw Normal View History

2024-05-25 16:45:07 +00:00
#!/home/eljakim/Source/tegrax1_plus/source/Shofel2_T124_python/venv/bin/python3
#-------------------------------------------------------------------------------
# scripts/readelf.py
#
# A clone of 'readelf' in Python, based on the pyelftools library
#
# Eli Bendersky (eliben@gmail.com)
# This code is in the public domain
#-------------------------------------------------------------------------------
import argparse
import os, sys
import re
import string
import traceback
import itertools
# Note: zip has different behaviour between Python 2.x and 3.x.
# - Using izip ensures compatibility.
try:
from itertools import izip
except:
izip = zip
# For running from development directory. It should take precedence over the
# installed pyelftools.
sys.path.insert(0, '.')
from elftools import __version__
from elftools.common.exceptions import ELFError
from elftools.common.utils import bytes2str, iterbytes
from elftools.elf.elffile import ELFFile
from elftools.elf.dynamic import DynamicSection, DynamicSegment
from elftools.elf.enums import ENUM_D_TAG
from elftools.elf.segments import InterpSegment
from elftools.elf.sections import (
NoteSection, SymbolTableSection, SymbolTableIndexSection
)
from elftools.elf.gnuversions import (
GNUVerSymSection, GNUVerDefSection,
GNUVerNeedSection,
)
from elftools.elf.relocation import RelocationSection
from elftools.elf.descriptions import (
describe_ei_class, describe_ei_data, describe_ei_version,
describe_ei_osabi, describe_e_type, describe_e_machine,
describe_e_version_numeric, describe_p_type, describe_p_flags,
describe_rh_flags, describe_sh_type, describe_sh_flags,
describe_symbol_type, describe_symbol_bind, describe_symbol_visibility,
describe_symbol_shndx, describe_reloc_type, describe_dyn_tag,
describe_dt_flags, describe_dt_flags_1, describe_ver_flags, describe_note,
describe_attr_tag_arm, describe_attr_tag_riscv, describe_symbol_other
)
from elftools.elf.constants import E_FLAGS
from elftools.elf.constants import E_FLAGS_MASKS
from elftools.elf.constants import SH_FLAGS
from elftools.elf.constants import SHN_INDICES
from elftools.dwarf.dwarfinfo import DWARFInfo
from elftools.dwarf.descriptions import (
describe_reg_name, describe_attr_value, set_global_machine_arch,
describe_CFI_instructions, describe_CFI_register_rule,
describe_CFI_CFA_rule, describe_DWARF_expr
)
from elftools.dwarf.constants import (
DW_LNS_copy, DW_LNS_set_file, DW_LNE_define_file)
from elftools.dwarf.locationlists import LocationParser, LocationEntry, LocationViewPair, BaseAddressEntry as LocBaseAddressEntry, LocationListsPair
from elftools.dwarf.ranges import RangeEntry, BaseAddressEntry as RangeBaseAddressEntry, RangeListsPair
from elftools.dwarf.callframe import CIE, FDE, ZERO
from elftools.ehabi.ehabiinfo import CorruptEHABIEntry, CannotUnwindEHABIEntry, GenericEHABIEntry
from elftools.dwarf.enums import ENUM_DW_UT
def _get_cu_base(cu):
top_die = cu.get_top_DIE()
attr = top_die.attributes
if 'DW_AT_low_pc' in attr:
return attr['DW_AT_low_pc'].value
elif 'DW_AT_entry_pc' in attr:
return attr['DW_AT_entry_pc'].value
elif 'DW_AT_ranges' in attr:
# Rare case but happens: rangelist in the top DIE.
# If there is a base or at least one absolute entry,
# this will give us the base IP for the CU.
rl = cu.dwarfinfo.range_lists().get_range_list_at_offset(attr['DW_AT_ranges'].value, cu)
base_ip = None
for r in rl:
if isinstance(r, RangeBaseAddressEntry):
ip = r.base_address
elif isinstance(r, RangeEntry) and r.is_absolute:
ip = r.begin_offset
else:
ip = None
if ip is not None and (base_ip is None or ip < base_ip):
base_ip = ip
if base_ip is None:
raise ValueError("Can't find the base IP (low_pc) for a CU")
return base_ip
else:
raise ValueError("Can't find the base IP (low_pc) for a CU")
# Matcher for all control characters, for transforming them into "^X" form when
# formatting symbol names for display.
_CONTROL_CHAR_RE = re.compile(r'[\x01-\x1f]')
def _format_symbol_name(s):
return _CONTROL_CHAR_RE.sub(lambda match: '^' + chr(0x40 + ord(match[0])), s)
class ReadElf(object):
""" display_* methods are used to emit output into the output stream
"""
def __init__(self, file, output):
""" file:
stream object with the ELF file to read
output:
output stream to write to
"""
self.elffile = ELFFile(file)
self.output = output
# Lazily initialized if a debug dump is requested
self._dwarfinfo = None
self._versioninfo = None
self._shndx_sections = None
def display_file_header(self):
""" Display the ELF file header
"""
self._emitline('ELF Header:')
self._emit(' Magic: ')
self._emit(' '.join('%2.2x' % b
for b in self.elffile.e_ident_raw))
self._emitline(' ')
header = self.elffile.header
e_ident = header['e_ident']
self._emitline(' Class: %s' %
describe_ei_class(e_ident['EI_CLASS']))
self._emitline(' Data: %s' %
describe_ei_data(e_ident['EI_DATA']))
self._emitline(' Version: %s' %
describe_ei_version(e_ident['EI_VERSION']))
self._emitline(' OS/ABI: %s' %
describe_ei_osabi(e_ident['EI_OSABI']))
self._emitline(' ABI Version: %d' %
e_ident['EI_ABIVERSION'])
self._emitline(' Type: %s' %
describe_e_type(header['e_type'], self.elffile))
self._emitline(' Machine: %s' %
describe_e_machine(header['e_machine']))
self._emitline(' Version: %s' %
describe_e_version_numeric(header['e_version']))
self._emitline(' Entry point address: %s' %
self._format_hex(header['e_entry']))
self._emit(' Start of program headers: %s' %
header['e_phoff'])
self._emitline(' (bytes into file)')
self._emit(' Start of section headers: %s' %
header['e_shoff'])
self._emitline(' (bytes into file)')
self._emitline(' Flags: %s%s' %
(self._format_hex(header['e_flags']),
self.decode_flags(header['e_flags'])))
self._emitline(' Size of this header: %s (bytes)' %
header['e_ehsize'])
self._emitline(' Size of program headers: %s (bytes)' %
header['e_phentsize'])
self._emitline(' Number of program headers: %s' %
header['e_phnum'])
self._emitline(' Size of section headers: %s (bytes)' %
header['e_shentsize'])
self._emit(' Number of section headers: %s' %
header['e_shnum'])
if header['e_shnum'] == 0 and self.elffile.num_sections() != 0:
self._emitline(' (%d)' % self.elffile.num_sections())
else:
self._emitline('')
self._emit(' Section header string table index: %s' %
header['e_shstrndx'])
if header['e_shstrndx'] == SHN_INDICES.SHN_XINDEX:
self._emitline(' (%d)' % self.elffile.get_shstrndx())
else:
self._emitline('')
def decode_flags(self, flags):
description = ""
if self.elffile['e_machine'] == "EM_ARM":
eabi = flags & E_FLAGS.EF_ARM_EABIMASK
flags &= ~E_FLAGS.EF_ARM_EABIMASK
if flags & E_FLAGS.EF_ARM_RELEXEC:
description += ', relocatable executabl'
flags &= ~E_FLAGS.EF_ARM_RELEXEC
if eabi == E_FLAGS.EF_ARM_EABI_VER5:
EF_ARM_KNOWN_FLAGS = E_FLAGS.EF_ARM_ABI_FLOAT_SOFT|E_FLAGS.EF_ARM_ABI_FLOAT_HARD|E_FLAGS.EF_ARM_LE8|E_FLAGS.EF_ARM_BE8
description += ', Version5 EABI'
if flags & E_FLAGS.EF_ARM_ABI_FLOAT_SOFT:
description += ", soft-float ABI"
elif flags & E_FLAGS.EF_ARM_ABI_FLOAT_HARD:
description += ", hard-float ABI"
if flags & E_FLAGS.EF_ARM_BE8:
description += ", BE8"
elif flags & E_FLAGS.EF_ARM_LE8:
description += ", LE8"
if flags & ~EF_ARM_KNOWN_FLAGS:
description += ', <unknown>'
else:
description += ', <unrecognized EABI>'
elif self.elffile['e_machine'] == 'EM_PPC64':
if flags & E_FLAGS.EF_PPC64_ABI_V2:
description += ', abiv2'
elif self.elffile['e_machine'] == "EM_MIPS":
if flags & E_FLAGS.EF_MIPS_NOREORDER:
description += ", noreorder"
if flags & E_FLAGS.EF_MIPS_PIC:
description += ", pic"
if flags & E_FLAGS.EF_MIPS_CPIC:
description += ", cpic"
if (flags & E_FLAGS.EF_MIPS_ABI2):
description += ", abi2"
if (flags & E_FLAGS.EF_MIPS_32BITMODE):
description += ", 32bitmode"
if (flags & E_FLAGS_MASKS.EFM_MIPS_ABI_O32):
description += ", o32"
elif (flags & E_FLAGS_MASKS.EFM_MIPS_ABI_O64):
description += ", o64"
elif (flags & E_FLAGS_MASKS.EFM_MIPS_ABI_EABI32):
description += ", eabi32"
elif (flags & E_FLAGS_MASKS.EFM_MIPS_ABI_EABI64):
description += ", eabi64"
if (flags & E_FLAGS.EF_MIPS_ARCH) == E_FLAGS.EF_MIPS_ARCH_1:
description += ", mips1"
if (flags & E_FLAGS.EF_MIPS_ARCH) == E_FLAGS.EF_MIPS_ARCH_2:
description += ", mips2"
if (flags & E_FLAGS.EF_MIPS_ARCH) == E_FLAGS.EF_MIPS_ARCH_3:
description += ", mips3"
if (flags & E_FLAGS.EF_MIPS_ARCH) == E_FLAGS.EF_MIPS_ARCH_4:
description += ", mips4"
if (flags & E_FLAGS.EF_MIPS_ARCH) == E_FLAGS.EF_MIPS_ARCH_5:
description += ", mips5"
if (flags & E_FLAGS.EF_MIPS_ARCH) == E_FLAGS.EF_MIPS_ARCH_32R2:
description += ", mips32r2"
if (flags & E_FLAGS.EF_MIPS_ARCH) == E_FLAGS.EF_MIPS_ARCH_64R2:
description += ", mips64r2"
if (flags & E_FLAGS.EF_MIPS_ARCH) == E_FLAGS.EF_MIPS_ARCH_32:
description += ", mips32"
if (flags & E_FLAGS.EF_MIPS_ARCH) == E_FLAGS.EF_MIPS_ARCH_64:
description += ", mips64"
elif self.elffile['e_machine'] == "EM_RISCV":
if flags & E_FLAGS.EF_RISCV_RVC:
description += ", RVC"
if (flags & E_FLAGS.EF_RISCV_RVE):
description += ", RVE"
if (flags & E_FLAGS.EF_RISCV_TSO):
description += ", TSO"
if (flags & E_FLAGS.EF_RISCV_FLOAT_ABI) == E_FLAGS.EF_RISCV_FLOAT_ABI_SOFT:
description += ", soft-float ABI"
if (flags & E_FLAGS.EF_RISCV_FLOAT_ABI) == E_FLAGS.EF_RISCV_FLOAT_ABI_SINGLE:
description += ", single-float ABI"
if (flags & E_FLAGS.EF_RISCV_FLOAT_ABI) == E_FLAGS.EF_RISCV_FLOAT_ABI_DOUBLE:
description += ", double-float ABI"
if (flags & E_FLAGS.EF_RISCV_FLOAT_ABI) == E_FLAGS.EF_RISCV_FLOAT_ABI_QUAD:
description += ", quad-float ABI"
elif self.elffile['e_machine'] == "EM_LOONGARCH":
if (flags & E_FLAGS.EF_LOONGARCH_ABI_MODIFIER_MASK) == E_FLAGS.EF_LOONGARCH_ABI_SOFT_FLOAT:
description += ", SOFT-FLOAT"
if (flags & E_FLAGS.EF_LOONGARCH_ABI_MODIFIER_MASK) == E_FLAGS.EF_LOONGARCH_ABI_SINGLE_FLOAT:
description += ", SINGLE-FLOAT"
if (flags & E_FLAGS.EF_LOONGARCH_ABI_MODIFIER_MASK) == E_FLAGS.EF_LOONGARCH_ABI_DOUBLE_FLOAT:
description += ", DOUBLE-FLOAT"
if (flags & E_FLAGS.EF_LOONGARCH_OBJABI_MASK) == E_FLAGS.EF_LOONGARCH_OBJABI_V0:
description += ", OBJ-v0"
if (flags & E_FLAGS.EF_LOONGARCH_OBJABI_MASK) == E_FLAGS.EF_LOONGARCH_OBJABI_V1:
description += ", OBJ-v1"
return description
def display_program_headers(self, show_heading=True):
""" Display the ELF program headers.
If show_heading is True, displays the heading for this information
(Elf file type is...)
"""
self._emitline()
if self.elffile.num_segments() == 0:
self._emitline('There are no program headers in this file.')
return
elfheader = self.elffile.header
if show_heading:
self._emitline('Elf file type is %s' %
describe_e_type(elfheader['e_type'], self.elffile))
self._emitline('Entry point is %s' %
self._format_hex(elfheader['e_entry']))
# readelf weirness - why isn't e_phoff printed as hex? (for section
# headers, it is...)
self._emitline('There are %s program headers, starting at offset %s' % (
self.elffile.num_segments(), elfheader['e_phoff']))
self._emitline()
self._emitline('Program Headers:')
# Now comes the table of program headers with their attributes. Note
# that due to different formatting constraints of 32-bit and 64-bit
# addresses, there are some conditions on elfclass here.
#
# First comes the table heading
#
if self.elffile.elfclass == 32:
self._emitline(' Type Offset VirtAddr PhysAddr FileSiz MemSiz Flg Align')
else:
self._emitline(' Type Offset VirtAddr PhysAddr')
self._emitline(' FileSiz MemSiz Flags Align')
# Now the entries
#
for segment in self.elffile.iter_segments():
self._emit(' %-14s ' % describe_p_type(segment['p_type']))
if self.elffile.elfclass == 32:
self._emitline('%s %s %s %s %s %-3s %s' % (
self._format_hex(segment['p_offset'], fieldsize=6),
self._format_hex(segment['p_vaddr'], fullhex=True),
self._format_hex(segment['p_paddr'], fullhex=True),
self._format_hex(segment['p_filesz'], fieldsize=5),
self._format_hex(segment['p_memsz'], fieldsize=5),
describe_p_flags(segment['p_flags']),
self._format_hex(segment['p_align'])))
else: # 64
self._emitline('%s %s %s' % (
self._format_hex(segment['p_offset'], fullhex=True),
self._format_hex(segment['p_vaddr'], fullhex=True),
self._format_hex(segment['p_paddr'], fullhex=True)))
self._emitline(' %s %s %-3s %s' % (
self._format_hex(segment['p_filesz'], fullhex=True),
self._format_hex(segment['p_memsz'], fullhex=True),
describe_p_flags(segment['p_flags']),
# lead0x set to False for p_align, to mimic readelf.
# No idea why the difference from 32-bit mode :-|
self._format_hex(segment['p_align'], lead0x=False)))
if isinstance(segment, InterpSegment):
self._emitline(' [Requesting program interpreter: %s]' %
segment.get_interp_name())
# Sections to segments mapping
#
if self.elffile.num_sections() == 0:
# No sections? We're done
return
self._emitline('\n Section to Segment mapping:')
self._emitline(' Segment Sections...')
for nseg, segment in enumerate(self.elffile.iter_segments()):
self._emit(' %2.2d ' % nseg)
for section in self.elffile.iter_sections():
if ( not section.is_null() and
not ((section['sh_flags'] & SH_FLAGS.SHF_TLS) != 0 and
section['sh_type'] == 'SHT_NOBITS' and
segment['p_type'] != 'PT_TLS') and
segment.section_in_segment(section)):
self._emit('%s ' % section.name)
self._emitline('')
def display_section_headers(self, show_heading=True):
""" Display the ELF section headers
"""
elfheader = self.elffile.header
if show_heading:
self._emitline('There are %s section headers, starting at offset %s' % (
elfheader['e_shnum'], self._format_hex(elfheader['e_shoff'])))
if self.elffile.num_sections() == 0:
self._emitline('There are no sections in this file.')
return
self._emitline('\nSection Header%s:' % (
's' if self.elffile.num_sections() > 1 else ''))
# Different formatting constraints of 32-bit and 64-bit addresses
#
if self.elffile.elfclass == 32:
self._emitline(' [Nr] Name Type Addr Off Size ES Flg Lk Inf Al')
else:
self._emitline(' [Nr] Name Type Address Offset')
self._emitline(' Size EntSize Flags Link Info Align')
# Now the entries
#
for nsec, section in enumerate(self.elffile.iter_sections()):
self._emit(' [%2u] %-17.17s %-15.15s ' % (
nsec, section.name, describe_sh_type(section['sh_type'])))
if self.elffile.elfclass == 32:
self._emitline('%s %s %s %s %3s %2s %3s %2s' % (
self._format_hex(section['sh_addr'], fieldsize=8, lead0x=False),
self._format_hex(section['sh_offset'], fieldsize=6, lead0x=False),
self._format_hex(section['sh_size'], fieldsize=6, lead0x=False),
self._format_hex(section['sh_entsize'], fieldsize=2, lead0x=False),
describe_sh_flags(section['sh_flags']),
section['sh_link'], section['sh_info'],
section['sh_addralign']))
else: # 64
self._emitline(' %s %s' % (
self._format_hex(section['sh_addr'], fullhex=True, lead0x=False),
self._format_hex(section['sh_offset'],
fieldsize=16 if section['sh_offset'] > 0xffffffff else 8,
lead0x=False)))
self._emitline(' %s %s %3s %2s %3s %s' % (
self._format_hex(section['sh_size'], fullhex=True, lead0x=False),
self._format_hex(section['sh_entsize'], fullhex=True, lead0x=False),
describe_sh_flags(section['sh_flags']),
section['sh_link'], section['sh_info'],
section['sh_addralign']))
self._emitline('Key to Flags:')
self._emitline(' W (write), A (alloc), X (execute), M (merge),'
' S (strings), I (info),')
self._emitline(' L (link order), O (extra OS processing required),'
' G (group), T (TLS),')
self._emitline(' C (compressed), x (unknown), o (OS specific),'
' E (exclude),')
self._emit(' ')
if self.elffile['e_machine'] == 'EM_ARM':
self._emit('y (purecode), ')
self._emitline('p (processor specific)')
def display_symbol_tables(self):
""" Display the symbol tables contained in the file
"""
self._init_versioninfo()
symbol_tables = [(idx, s) for idx, s in enumerate(self.elffile.iter_sections())
if isinstance(s, SymbolTableSection)]
if not symbol_tables and self.elffile.num_sections() == 0:
self._emitline('')
self._emitline('Dynamic symbol information is not available for'
' displaying symbols.')
for section_index, section in symbol_tables:
if not isinstance(section, SymbolTableSection):
continue
if section['sh_entsize'] == 0:
self._emitline("\nSymbol table '%s' has a sh_entsize of zero!" % (
section.name))
continue
self._emitline("\nSymbol table '%s' contains %d %s:" % (
section.name,
section.num_symbols(),
'entry' if section.num_symbols() == 1 else 'entries'))
if self.elffile.elfclass == 32:
self._emitline(' Num: Value Size Type Bind Vis Ndx Name')
else: # 64
self._emitline(' Num: Value Size Type Bind Vis Ndx Name')
for nsym, symbol in enumerate(section.iter_symbols()):
version_info = ''
# readelf doesn't display version info for Solaris versioning
if (section['sh_type'] == 'SHT_DYNSYM' and
self._versioninfo['type'] == 'GNU'):
version = self._symbol_version(nsym)
if (version['name'] != symbol.name and
version['index'] not in ('VER_NDX_LOCAL',
'VER_NDX_GLOBAL')):
if version['filename']:
# external symbol
version_info = '@%(name)s (%(index)i)' % version
else:
# internal symbol
if version['hidden']:
version_info = '@%(name)s' % version
else:
version_info = '@@%(name)s' % version
symbol_name = symbol.name
# Print section names for STT_SECTION symbols as readelf does
if (symbol['st_info']['type'] == 'STT_SECTION'
and symbol['st_shndx'] < self.elffile.num_sections()
and symbol['st_name'] == 0):
symbol_name = self.elffile.get_section(symbol['st_shndx']).name
# symbol names are truncated to 25 chars, similarly to readelf
self._emitline('%6d: %s %s %-7s %-6s %-7s %4s %.25s%s' % (
nsym,
self._format_hex(
symbol['st_value'], fullhex=True, lead0x=False),
"%5d" % symbol['st_size'] if symbol['st_size'] < 100000 else hex(symbol['st_size']),
describe_symbol_type(symbol['st_info']['type']),
describe_symbol_bind(symbol['st_info']['bind']),
describe_symbol_other(symbol['st_other']),
describe_symbol_shndx(self._get_symbol_shndx(symbol,
nsym,
section_index)),
_format_symbol_name(symbol_name),
version_info))
def display_dynamic_tags(self):
""" Display the dynamic tags contained in the file
"""
has_dynamic_sections = False
for section in self.elffile.iter_sections():
if not isinstance(section, DynamicSection):
continue
has_dynamic_sections = True
self._emitline("\nDynamic section at offset %s contains %d %s:" % (
self._format_hex(section['sh_offset']),
section.num_tags(),
'entry' if section.num_tags() == 1 else 'entries'))
self._emitline(" Tag Type Name/Value")
padding = 20 + (8 if self.elffile.elfclass == 32 else 0)
for tag in section.iter_tags():
if tag.entry.d_tag == 'DT_NEEDED':
parsed = 'Shared library: [%s]' % tag.needed
elif tag.entry.d_tag == 'DT_RPATH':
parsed = 'Library rpath: [%s]' % tag.rpath
elif tag.entry.d_tag == 'DT_RUNPATH':
parsed = 'Library runpath: [%s]' % tag.runpath
elif tag.entry.d_tag == 'DT_SONAME':
parsed = 'Library soname: [%s]' % tag.soname
elif tag.entry.d_tag.endswith(('SZ', 'ENT')):
parsed = '%i (bytes)' % tag['d_val']
elif tag.entry.d_tag == 'DT_FLAGS':
parsed = describe_dt_flags(tag.entry.d_val)
elif tag.entry.d_tag == 'DT_FLAGS_1':
parsed = 'Flags: %s' % describe_dt_flags_1(tag.entry.d_val)
elif tag.entry.d_tag.endswith(('NUM', 'COUNT')):
parsed = '%i' % tag['d_val']
elif tag.entry.d_tag == 'DT_PLTREL':
s = describe_dyn_tag(tag.entry.d_val)
if s.startswith('DT_'):
s = s[3:]
parsed = '%s' % s
elif tag.entry.d_tag == 'DT_MIPS_FLAGS':
parsed = describe_rh_flags(tag.entry.d_val)
elif tag.entry.d_tag in ('DT_MIPS_SYMTABNO',
'DT_MIPS_LOCAL_GOTNO'):
parsed = str(tag.entry.d_val)
else:
parsed = '%#x' % tag['d_val']
self._emitline(" %s %-*s %s" % (
self._format_hex(ENUM_D_TAG.get(tag.entry.d_tag, tag.entry.d_tag),
fullhex=True, lead0x=True),
padding,
'(%s)' % (tag.entry.d_tag[3:],),
parsed))
if not has_dynamic_sections:
self._emitline("\nThere is no dynamic section in this file.")
def display_notes(self):
""" Display the notes contained in the file
"""
for section in self.elffile.iter_sections():
if isinstance(section, NoteSection):
for note in section.iter_notes():
self._emitline("\nDisplaying notes found in: {}".format(
section.name))
self._emitline(' Owner Data size Description')
self._emitline(' %s %s\t%s' % (
note['n_name'].ljust(20),
self._format_hex(note['n_descsz'], fieldsize=8),
describe_note(note)))
def display_relocations(self):
""" Display the relocations contained in the file
"""
has_relocation_sections = False
for section in self.elffile.iter_sections():
if not isinstance(section, RelocationSection):
continue
has_relocation_sections = True
self._emitline("\nRelocation section '%.128s' at offset %s contains %d %s:" % (
section.name,
self._format_hex(section['sh_offset']),
section.num_relocations(),
'entry' if section.num_relocations() == 1 else 'entries'))
if section.is_RELA():
self._emitline(" Offset Info Type Sym. Value Sym. Name + Addend")
else:
self._emitline(" Offset Info Type Sym.Value Sym. Name")
# The symbol table section pointed to in sh_link
symtable = self.elffile.get_section(section['sh_link'])
for rel in section.iter_relocations():
hexwidth = 8 if self.elffile.elfclass == 32 else 12
self._emit('%s %s %-17.17s' % (
self._format_hex(rel['r_offset'],
fieldsize=hexwidth, lead0x=False),
self._format_hex(rel['r_info'],
fieldsize=hexwidth, lead0x=False),
describe_reloc_type(
rel['r_info_type'], self.elffile)))
if rel['r_info_sym'] == 0:
if section.is_RELA():
fieldsize = 8 if self.elffile.elfclass == 32 else 16
addend = self._format_hex(rel['r_addend'], lead0x=False)
self._emit(' %s %s' % (' ' * fieldsize, addend))
self._emitline()
else:
symbol = symtable.get_symbol(rel['r_info_sym'])
# Some symbols have zero 'st_name', so instead what's used
# is the name of the section they point at. Truncate symbol
# names (excluding version info) to 22 chars, similarly to
# readelf.
if symbol['st_name'] == 0:
symsecidx = self._get_symbol_shndx(symbol,
rel['r_info_sym'],
section['sh_link'])
symsec = self.elffile.get_section(symsecidx)
symbol_name = symsec.name
version = ''
else:
symbol_name = symbol.name
version = self._symbol_version(rel['r_info_sym'])
version = (version['name']
if version and version['name'] else '')
symbol_name = '%.22s' % symbol_name
if version:
symbol_name += '@' + version
self._emit(' %s %s' % (
self._format_hex(
symbol['st_value'],
fullhex=True, lead0x=False),
_format_symbol_name(symbol_name)))
if section.is_RELA():
self._emit(' %s %x' % (
'+' if rel['r_addend'] >= 0 else '-',
abs(rel['r_addend'])))
self._emitline()
# Emit the two additional relocation types for ELF64 MIPS
# binaries.
if (self.elffile.elfclass == 64 and
self.elffile['e_machine'] == 'EM_MIPS'):
for i in (2, 3):
rtype = rel['r_info_type%s' % i]
self._emit(' Type%s: %s' % (
i,
describe_reloc_type(rtype, self.elffile)))
self._emitline()
if not has_relocation_sections:
self._emitline('\nThere are no relocations in this file.')
def display_arm_unwind(self):
if not self.elffile.has_ehabi_info():
self._emitline('There are no .ARM.idx sections in this file.')
return
for ehabi_info in self.elffile.get_ehabi_infos():
# Unwind section '.ARM.exidx' at offset 0x203e8 contains 1009 entries:
self._emitline("\nUnwind section '%s' at offset 0x%x contains %d %s" % (
ehabi_info.section_name(),
ehabi_info.section_offset(),
ehabi_info.num_entry(),
'entry' if ehabi_info.num_entry() == 1 else 'entries'))
for i in range(ehabi_info.num_entry()):
entry = ehabi_info.get_entry(i)
self._emitline()
self._emitline("Entry %d:" % i)
if isinstance(entry, CorruptEHABIEntry):
self._emitline(" [corrupt] %s" % entry.reason)
continue
self._emit(" Function offset 0x%x: " % entry.function_offset)
if isinstance(entry, CannotUnwindEHABIEntry):
self._emitline("[cantunwind]")
continue
elif entry.eh_table_offset:
self._emitline("@0x%x" % entry.eh_table_offset)
else:
self._emitline("Compact (inline)")
if isinstance(entry, GenericEHABIEntry):
self._emitline(" Personality: 0x%x" % entry.personality)
else:
self._emitline(" Compact model index: %d" % entry.personality)
for mnemonic_item in entry.mnmemonic_array():
self._emit(' ')
self._emitline(mnemonic_item)
def display_version_info(self):
""" Display the version info contained in the file
"""
self._init_versioninfo()
if not self._versioninfo['type']:
self._emitline("\nNo version information found in this file.")
return
for section in self.elffile.iter_sections():
if isinstance(section, GNUVerSymSection):
self._print_version_section_header(section, 'Version symbols')
num_symbols = section.num_symbols()
# Symbol version info are printed four by four entries
for idx_by_4 in range(0, num_symbols, 4):
self._emit(' %03x:' % idx_by_4)
for idx in range(idx_by_4, min(idx_by_4 + 4, num_symbols)):
symbol_version = self._symbol_version(idx)
if symbol_version['index'] == 'VER_NDX_LOCAL':
version_index = 0
version_name = '(*local*)'
elif symbol_version['index'] == 'VER_NDX_GLOBAL':
version_index = 1
version_name = '(*global*)'
else:
version_index = symbol_version['index']
version_name = '(%(name)s)' % symbol_version
visibility = 'h' if symbol_version['hidden'] else ' '
self._emit('%4x%s%-13s' % (
version_index, visibility, version_name))
self._emitline()
elif isinstance(section, GNUVerDefSection):
self._print_version_section_header(
section, 'Version definition', indent=2)
offset = 0
for verdef, verdaux_iter in section.iter_versions():
verdaux = next(verdaux_iter)
name = verdaux.name
if verdef['vd_flags']:
flags = describe_ver_flags(verdef['vd_flags'])
# Mimic exactly the readelf output
flags += ' '
else:
flags = 'none'
self._emitline(' %s: Rev: %i Flags: %s Index: %i'
' Cnt: %i Name: %s' % (
self._format_hex(offset, fieldsize=6,
alternate=True),
verdef['vd_version'], flags, verdef['vd_ndx'],
verdef['vd_cnt'], name))
verdaux_offset = (
offset + verdef['vd_aux'] + verdaux['vda_next'])
for idx, verdaux in enumerate(verdaux_iter, start=1):
self._emitline(' %s: Parent %i: %s' %
(self._format_hex(verdaux_offset, fieldsize=4),
idx, verdaux.name))
verdaux_offset += verdaux['vda_next']
offset += verdef['vd_next']
elif isinstance(section, GNUVerNeedSection):
self._print_version_section_header(section, 'Version needs')
offset = 0
for verneed, verneed_iter in section.iter_versions():
self._emitline(' %s: Version: %i File: %s Cnt: %i' % (
self._format_hex(offset, fieldsize=6,
alternate=True),
verneed['vn_version'], verneed.name,
verneed['vn_cnt']))
vernaux_offset = offset + verneed['vn_aux']
for idx, vernaux in enumerate(verneed_iter, start=1):
if vernaux['vna_flags']:
flags = describe_ver_flags(vernaux['vna_flags'])
# Mimic exactly the readelf output
flags += ' '
else:
flags = 'none'
self._emitline(
' %s: Name: %s Flags: %s Version: %i' % (
self._format_hex(vernaux_offset, fieldsize=4),
vernaux.name, flags,
vernaux['vna_other']))
vernaux_offset += vernaux['vna_next']
offset += verneed['vn_next']
def display_arch_specific(self):
""" Display the architecture-specific info contained in the file.
"""
if self.elffile['e_machine'] == 'EM_ARM':
self._display_arch_specific_arm()
elif self.elffile['e_machine'] == 'EM_RISCV':
self._display_arch_specific_riscv()
def display_hex_dump(self, section_spec):
""" Display a hex dump of a section. section_spec is either a section
number or a name.
"""
section = self._section_from_spec(section_spec)
if section is None:
# readelf prints the warning to stderr. Even though stderrs are not compared
# in tests, we comply with that behavior.
sys.stderr.write('readelf: Warning: Section \'%s\' was not dumped because it does not exist!\n' % (
section_spec))
return
if section['sh_type'] == 'SHT_NOBITS':
self._emitline("\nSection '%s' has no data to dump." % (
section_spec))
return
self._emitline("\nHex dump of section '%s':" % section.name)
self._note_relocs_for_section(section)
addr = section['sh_addr']
data = section.data()
dataptr = 0
while dataptr < len(data):
bytesleft = len(data) - dataptr
# chunks of 16 bytes per line
linebytes = 16 if bytesleft > 16 else bytesleft
self._emit(' %s ' % self._format_hex(addr, fieldsize=8))
for i in range(16):
if i < linebytes:
self._emit('%2.2x' % data[dataptr + i])
else:
self._emit(' ')
if i % 4 == 3:
self._emit(' ')
for i in range(linebytes):
c = data[dataptr + i : dataptr + i + 1]
if c[0] >= 32 and c[0] < 0x7f:
self._emit(bytes2str(c))
else:
self._emit(bytes2str(b'.'))
self._emitline()
addr += linebytes
dataptr += linebytes
self._emitline()
def display_string_dump(self, section_spec):
""" Display a strings dump of a section. section_spec is either a
section number or a name.
"""
section = self._section_from_spec(section_spec)
if section is None:
# readelf prints the warning to stderr. Even though stderrs are not compared
# in tests, we comply with that behavior.
sys.stderr.write('readelf.py: Warning: Section \'%s\' was not dumped because it does not exist!\n' % (
section_spec))
return
if section['sh_type'] == 'SHT_NOBITS':
self._emitline("\nSection '%s' has no data to dump." % (
section_spec))
return
self._emitline("\nString dump of section '%s':" % section.name)
found = False
data = section.data()
dataptr = 0
while dataptr < len(data):
while ( dataptr < len(data) and
not (32 <= data[dataptr] <= 127)):
dataptr += 1
if dataptr >= len(data):
break
endptr = dataptr
while endptr < len(data) and data[endptr] != 0:
endptr += 1
found = True
self._emitline(' [%6x] %s' % (
dataptr, bytes2str(data[dataptr:endptr])))
dataptr = endptr
if not found:
self._emitline(' No strings found in this section.')
else:
self._emitline()
def display_debug_dump(self, dump_what):
""" Dump a DWARF section
"""
self._init_dwarfinfo()
if self._dwarfinfo is None:
return
set_global_machine_arch(self.elffile.get_machine_arch())
if dump_what == 'info':
self._dump_debug_info()
elif dump_what == 'decodedline':
self._dump_debug_line_programs()
elif dump_what == 'frames':
self._dump_debug_frames()
elif dump_what == 'frames-interp':
self._dump_debug_frames_interp()
elif dump_what == 'aranges':
self._dump_debug_aranges()
elif dump_what in { 'pubtypes', 'pubnames' }:
self._dump_debug_namelut(dump_what)
elif dump_what == 'loc':
self._dump_debug_locations()
elif dump_what == 'Ranges':
self._dump_debug_ranges()
else:
self._emitline('debug dump not yet supported for "%s"' % dump_what)
def _format_hex(self, addr, fieldsize=None, fullhex=False, lead0x=True,
alternate=False):
""" Format an address into a hexadecimal string.
fieldsize:
Size of the hexadecimal field (with leading zeros to fit the
address into. For example with fieldsize=8, the format will
be %08x
If None, the minimal required field size will be used.
fullhex:
If True, override fieldsize to set it to the maximal size
needed for the elfclass
lead0x:
If True, leading 0x is added
alternate:
If True, override lead0x to emulate the alternate
hexadecimal form specified in format string with the #
character: only non-zero values are prefixed with 0x.
This form is used by readelf.
"""
if alternate:
if addr == 0:
lead0x = False
else:
lead0x = True
if fieldsize is not None:
fieldsize -= 2
s = '0x' if lead0x else ''
if fullhex:
fieldsize = 8 if self.elffile.elfclass == 32 else 16
if fieldsize is None:
field = '%x'
else:
field = '%' + '0%sx' % fieldsize
return s + field % addr
def _print_version_section_header(self, version_section, name, lead0x=True,
indent=1):
""" Print a section header of one version related section (versym,
verneed or verdef) with some options to accomodate readelf
little differences between each header (e.g. indentation
and 0x prefixing).
"""
if hasattr(version_section, 'num_versions'):
num_entries = version_section.num_versions()
else:
num_entries = version_section.num_symbols()
self._emitline("\n%s section '%s' contains %d %s:" % (
name, version_section.name, num_entries,
'entry' if num_entries == 1 else 'entries'))
self._emitline('%sAddr: %s Offset: %s Link: %i (%s)' % (
' ' * indent,
self._format_hex(
version_section['sh_addr'], fieldsize=16, lead0x=lead0x),
self._format_hex(
version_section['sh_offset'], fieldsize=8, lead0x=True),
version_section['sh_link'],
self.elffile.get_section(version_section['sh_link']).name
)
)
def _init_versioninfo(self):
""" Search and initialize informations about version related sections
and the kind of versioning used (GNU or Solaris).
"""
if self._versioninfo is not None:
return
self._versioninfo = {'versym': None, 'verdef': None,
'verneed': None, 'type': None}
for section in self.elffile.iter_sections():
if isinstance(section, GNUVerSymSection):
self._versioninfo['versym'] = section
elif isinstance(section, GNUVerDefSection):
self._versioninfo['verdef'] = section
elif isinstance(section, GNUVerNeedSection):
self._versioninfo['verneed'] = section
elif isinstance(section, DynamicSection):
for tag in section.iter_tags():
if tag['d_tag'] == 'DT_VERSYM':
self._versioninfo['type'] = 'GNU'
break
if not self._versioninfo['type'] and (
self._versioninfo['verneed'] or self._versioninfo['verdef']):
self._versioninfo['type'] = 'Solaris'
def _symbol_version(self, nsym):
""" Return a dict containing information on the
or None if no version information is available
"""
self._init_versioninfo()
symbol_version = dict.fromkeys(('index', 'name', 'filename', 'hidden'))
if (not self._versioninfo['versym'] or
nsym >= self._versioninfo['versym'].num_symbols()):
return None
symbol = self._versioninfo['versym'].get_symbol(nsym)
index = symbol.entry['ndx']
if not index in ('VER_NDX_LOCAL', 'VER_NDX_GLOBAL'):
index = int(index)
if self._versioninfo['type'] == 'GNU':
# In GNU versioning mode, the highest bit is used to
# store whether the symbol is hidden or not
if index & 0x8000:
index &= ~0x8000
symbol_version['hidden'] = True
if (self._versioninfo['verdef'] and
index <= self._versioninfo['verdef'].num_versions()):
_, verdaux_iter = \
self._versioninfo['verdef'].get_version(index)
symbol_version['name'] = next(verdaux_iter).name
else:
verneed, vernaux = \
self._versioninfo['verneed'].get_version(index)
symbol_version['name'] = vernaux.name
symbol_version['filename'] = verneed.name
symbol_version['index'] = index
return symbol_version
def _section_from_spec(self, spec):
""" Retrieve a section given a "spec" (either number or name).
Return None if no such section exists in the file.
"""
try:
num = int(spec)
if num < self.elffile.num_sections():
return self.elffile.get_section(num)
else:
return None
except ValueError:
# Not a number. Must be a name then
return self.elffile.get_section_by_name(spec)
def _get_symbol_shndx(self, symbol, symbol_index, symtab_index):
""" Get the index into the section header table for the "symbol"
at "symbol_index" located in the symbol table with section index
"symtab_index".
"""
symbol_shndx = symbol['st_shndx']
if symbol_shndx != SHN_INDICES.SHN_XINDEX:
return symbol_shndx
# Check for or lazily construct index section mapping (symbol table
# index -> corresponding symbol table index section object)
if self._shndx_sections is None:
self._shndx_sections = {sec.symboltable: sec for sec in self.elffile.iter_sections()
if isinstance(sec, SymbolTableIndexSection)}
return self._shndx_sections[symtab_index].get_section_index(symbol_index)
def _note_relocs_for_section(self, section):
""" If there are relocation sections pointing to the givne section,
emit a note about it.
"""
for relsec in self.elffile.iter_sections():
if isinstance(relsec, RelocationSection):
info_idx = relsec['sh_info']
if self.elffile.get_section(info_idx) == section:
self._emitline(' Note: This section has relocations against it, but these have NOT been applied to this dump.')
return
def _init_dwarfinfo(self):
""" Initialize the DWARF info contained in the file and assign it to
self._dwarfinfo.
Leave self._dwarfinfo at None if no DWARF info was found in the file
"""
if self._dwarfinfo is not None:
return
if self.elffile.has_dwarf_info():
self._dwarfinfo = self.elffile.get_dwarf_info()
else:
self._dwarfinfo = None
def _dump_debug_info(self):
""" Dump the debugging info section.
"""
if not self._dwarfinfo.has_debug_info:
return
self._emitline('Contents of the %s section:\n' % self._dwarfinfo.debug_info_sec.name)
# Offset of the .debug_info section in the stream
section_offset = self._dwarfinfo.debug_info_sec.global_offset
for cu in self._dwarfinfo.iter_CUs():
self._emitline(' Compilation Unit @ offset %s:' %
self._format_hex(cu.cu_offset, alternate=True))
self._emitline(' Length: %s (%s)' % (
self._format_hex(cu['unit_length']),
'%s-bit' % cu.dwarf_format()))
self._emitline(' Version: %s' % cu['version'])
if cu['version'] >= 5:
if cu.header.get("unit_type", ''):
unit_type = cu.header.unit_type
self._emitline(' Unit Type: %s (%d)' % (
unit_type, ENUM_DW_UT.get(cu.header.unit_type, 0)))
self._emitline(' Abbrev Offset: %s' % (
self._format_hex(cu['debug_abbrev_offset'], alternate=True)))
self._emitline(' Pointer Size: %s' % cu['address_size'])
if unit_type in ('DW_UT_skeleton', 'DW_UT_split_compile'):
self._emitline(' Dwo id: %s' % cu['dwo_id'])
elif unit_type in ('DW_UT_type', 'DW_UT_split_type'):
self._emitline(' Signature: 0x%x' % cu['type_signature'])
self._emitline(' Type Offset: 0x%x' % cu['type_offset'])
else:
self._emitline(' Abbrev Offset: %s' % (
self._format_hex(cu['debug_abbrev_offset'], alternate=True))),
self._emitline(' Pointer Size: %s' % cu['address_size'])
# The nesting depth of each DIE within the tree of DIEs must be
# displayed. To implement this, a counter is incremented each time
# the current DIE has children, and decremented when a null die is
# encountered. Due to the way the DIE tree is serialized, this will
# correctly reflect the nesting depth
#
die_depth = 0
current_function = None
for die in cu.iter_DIEs():
if die.tag == 'DW_TAG_subprogram':
current_function = die
self._emitline(' <%s><%x>: Abbrev Number: %s%s' % (
die_depth,
die.offset,
die.abbrev_code,
(' (%s)' % die.tag) if not die.is_null() else ''))
if die.is_null():
die_depth -= 1
continue
for attr in die.attributes.values():
name = attr.name
# Unknown attribute values are passed-through as integers
if isinstance(name, int):
name = 'Unknown AT value: %x' % name
attr_desc = describe_attr_value(attr, die, section_offset)
if 'DW_OP_fbreg' in attr_desc and current_function and not 'DW_AT_frame_base' in current_function.attributes:
postfix = ' [without dw_at_frame_base]'
else:
postfix = ''
self._emitline(' <%x> %-18s: %s%s' % (
attr.offset,
name,
attr_desc,
postfix))
if die.has_children:
die_depth += 1
self._emitline()
def _dump_debug_line_programs(self):
""" Dump the (decoded) line programs from .debug_line
The programs are dumped in the order of the CUs they belong to.
"""
if not self._dwarfinfo.has_debug_info:
return
self._emitline('Contents of the %s section:' % self._dwarfinfo.debug_line_sec.name)
self._emitline()
lineprogram_list = []
for cu in self._dwarfinfo.iter_CUs():
# Avoid dumping same lineprogram multiple times
lineprogram = self._dwarfinfo.line_program_for_CU(cu)
if lineprogram in lineprogram_list:
continue
lineprogram_list.append(lineprogram)
ver5 = lineprogram.header.version >= 5
cu_filename = bytes2str(lineprogram['file_entry'][0].name)
if len(lineprogram['include_directory']) > 0:
# GNU readelf 2.38 only outputs directory in wide mode
self._emitline('%s:' % cu_filename)
else:
self._emitline('CU: %s:' % cu_filename)
self._emitline('File name Line number Starting address Stmt')
# GNU readelf has a View column that we don't try to replicate
# The autotest has logic in place to ignore that
# Print each state's file, line and address information. For some
# instructions other output is needed to be compatible with
# readelf.
for entry in lineprogram.get_entries():
state = entry.state
if state is None:
# Special handling for commands that don't set a new state
if entry.command == DW_LNS_set_file:
file_entry = lineprogram['file_entry'][entry.args[0] - 1]
if file_entry.dir_index == 0:
# current directory
self._emitline('\n./%s:[++]' % (
bytes2str(file_entry.name)))
else:
self._emitline('\n%s/%s:' % (
bytes2str(lineprogram['include_directory'][file_entry.dir_index - 1]),
bytes2str(file_entry.name)))
elif entry.command == DW_LNE_define_file:
self._emitline('%s:' % (
bytes2str(lineprogram['include_directory'][entry.args[0].dir_index])))
elif lineprogram['version'] < 4 or self.elffile['e_machine'] == 'EM_PPC64':
self._emitline('%-35s %11s %18s %s' % (
bytes2str(lineprogram['file_entry'][state.file - 1].name),
state.line if not state.end_sequence else '-',
'0' if state.address == 0 else self._format_hex(state.address),
'x' if state.is_stmt and not state.end_sequence else ''))
else:
# In readelf, on non-VLIW machines there is no op_index postfix after address.
# It used to be unconditional.
self._emitline('%-35s %s %18s%s %s' % (
bytes2str(lineprogram['file_entry'][state.file - 1].name),
"%11d" % (state.line,) if not state.end_sequence else '-',
'0' if state.address == 0 else self._format_hex(state.address),
'' if lineprogram.header.maximum_operations_per_instruction == 1 else '[%d]' % (state.op_index,),
'x' if state.is_stmt and not state.end_sequence else ''))
if entry.command == DW_LNS_copy:
# Another readelf oddity...
self._emitline()
def _dump_frames_info(self, section, cfi_entries):
""" Dump the raw call frame info in a section.
`section` is the Section instance that contains the call frame info
while `cfi_entries` must be an iterable that yields the sequence of
CIE or FDE instances.
"""
self._emitline('Contents of the %s section:' % section.name)
for entry in cfi_entries:
if isinstance(entry, CIE):
self._emitline('\n%08x %s %s CIE' % (
entry.offset,
self._format_hex(entry['length'], fullhex=True, lead0x=False),
self._format_hex(entry['CIE_id'], fieldsize=8, lead0x=False)))
self._emitline(' Version: %d' % entry['version'])
self._emitline(' Augmentation: "%s"' % bytes2str(entry['augmentation']))
self._emitline(' Code alignment factor: %u' % entry['code_alignment_factor'])
self._emitline(' Data alignment factor: %d' % entry['data_alignment_factor'])
self._emitline(' Return address column: %d' % entry['return_address_register'])
if entry.augmentation_bytes:
self._emitline(' Augmentation data: {}'.format(' '.join(
'{:02x}'.format(ord(b))
for b in iterbytes(entry.augmentation_bytes)
)))
self._emitline()
elif isinstance(entry, FDE):
self._emitline('\n%08x %s %s FDE cie=%08x pc=%s..%s' % (
entry.offset,
self._format_hex(entry['length'], fullhex=True, lead0x=False),
self._format_hex(entry['CIE_pointer'], fieldsize=8, lead0x=False),
entry.cie.offset,
self._format_hex(entry['initial_location'], fullhex=True, lead0x=False),
self._format_hex(
entry['initial_location'] + entry['address_range'],
fullhex=True, lead0x=False)))
if entry.augmentation_bytes:
self._emitline(' Augmentation data: {}'.format(' '.join(
'{:02x}'.format(ord(b))
for b in iterbytes(entry.augmentation_bytes)
)))
else: # ZERO terminator
assert isinstance(entry, ZERO)
self._emitline('\n%08x ZERO terminator' % entry.offset)
continue
self._emit(describe_CFI_instructions(entry))
self._emitline()
def _dump_debug_frames(self):
""" Dump the raw frame info from .debug_frame and .eh_frame sections.
"""
if self._dwarfinfo.has_EH_CFI():
self._dump_frames_info(
self._dwarfinfo.eh_frame_sec,
self._dwarfinfo.EH_CFI_entries())
self._emitline()
if self._dwarfinfo.has_CFI():
self._dump_frames_info(
self._dwarfinfo.debug_frame_sec,
self._dwarfinfo.CFI_entries())
def _dump_debug_namelut(self, what):
"""
Dump the debug pubnames section.
"""
if what == 'pubnames':
namelut = self._dwarfinfo.get_pubnames()
section = self._dwarfinfo.debug_pubnames_sec
else:
namelut = self._dwarfinfo.get_pubtypes()
section = self._dwarfinfo.debug_pubtypes_sec
# readelf prints nothing if the section is not present.
if namelut is None or len(namelut) == 0:
return
self._emitline('Contents of the %s section:' % section.name)
self._emitline()
cu_headers = namelut.get_cu_headers()
# go over CU-by-CU first and item-by-item next.
for (cu_hdr, (cu_ofs, items)) in izip(cu_headers, itertools.groupby(
namelut.items(), key = lambda x: x[1].cu_ofs)):
self._emitline(' Length: %d' % cu_hdr.unit_length)
self._emitline(' Version: %d' % cu_hdr.version)
self._emitline(' Offset into .debug_info section: 0x%x' % cu_hdr.debug_info_offset)
self._emitline(' Size of area in .debug_info section: %d' % cu_hdr.debug_info_length)
self._emitline()
self._emitline(' Offset Name')
for item in items:
self._emitline(' %x %s' % (item[1].die_ofs - cu_ofs, item[0]))
self._emitline()
def _dump_debug_aranges(self):
""" Dump the aranges table
"""
aranges_table = self._dwarfinfo.get_aranges()
if aranges_table == None:
return
# Seems redundant, but we need to get the unsorted set of entries
# to match system readelf.
# Also, sometimes there are blank sections in aranges, but readelf
# dumps them, so we should too.
unordered_entries = aranges_table._get_entries(need_empty=True)
if len(unordered_entries) == 0:
self._emitline()
self._emitline("Section '.debug_aranges' has no debugging data.")
return
self._emitline('Contents of the %s section:' % self._dwarfinfo.debug_aranges_sec.name)
self._emitline()
prev_offset = None
for entry in unordered_entries:
if prev_offset != entry.info_offset:
if entry != unordered_entries[0]:
self._emitline(' %s %s' % (
self._format_hex(0, fullhex=True, lead0x=False),
self._format_hex(0, fullhex=True, lead0x=False)))
self._emitline(' Length: %d' % (entry.unit_length))
self._emitline(' Version: %d' % (entry.version))
self._emitline(' Offset into .debug_info: 0x%x' % (entry.info_offset))
self._emitline(' Pointer Size: %d' % (entry.address_size))
self._emitline(' Segment Size: %d' % (entry.segment_size))
self._emitline()
self._emitline(' Address Length')
if entry.begin_addr != 0 or entry.length != 0:
self._emitline(' %s %s' % (
self._format_hex(entry.begin_addr, fullhex=True, lead0x=False),
self._format_hex(entry.length, fullhex=True, lead0x=False)))
prev_offset = entry.info_offset
self._emitline(' %s %s' % (
self._format_hex(0, fullhex=True, lead0x=False),
self._format_hex(0, fullhex=True, lead0x=False)))
def _dump_frames_interp_info(self, section, cfi_entries):
""" Dump interpreted (decoded) frame information in a section.
`section` is the Section instance that contains the call frame info
while `cfi_entries` must be an iterable that yields the sequence of
CIE or FDE instances.
"""
self._emitline('Contents of the %s section:' % section.name)
for entry in cfi_entries:
if isinstance(entry, CIE):
self._emitline('\n%08x %s %s CIE "%s" cf=%d df=%d ra=%d' % (
entry.offset,
self._format_hex(entry['length'], fullhex=True, lead0x=False),
self._format_hex(entry['CIE_id'], fieldsize=8, lead0x=False),
bytes2str(entry['augmentation']),
entry['code_alignment_factor'],
entry['data_alignment_factor'],
entry['return_address_register']))
ra_regnum = entry['return_address_register']
elif isinstance(entry, FDE):
self._emitline('\n%08x %s %s FDE cie=%08x pc=%s..%s' % (
entry.offset,
self._format_hex(entry['length'], fullhex=True, lead0x=False),
self._format_hex(entry['CIE_pointer'], fieldsize=8, lead0x=False),
entry.cie.offset,
self._format_hex(entry['initial_location'], fullhex=True, lead0x=False),
self._format_hex(entry['initial_location'] + entry['address_range'],
fullhex=True, lead0x=False)))
ra_regnum = entry.cie['return_address_register']
# If the FDE brings adds no unwinding information compared to
# its CIE, omit its table.
if (len(entry.get_decoded().table) ==
len(entry.cie.get_decoded().table)):
continue
else: # ZERO terminator
assert isinstance(entry, ZERO)
self._emitline('\n%08x ZERO terminator' % entry.offset)
continue
# Decode the table.
decoded_table = entry.get_decoded()
if len(decoded_table.table) == 0:
continue
# Print the heading row for the decoded table
self._emit(' LOC')
self._emit(' ' if entry.structs.address_size == 4 else ' ')
self._emit(' CFA ')
# Look at the registers the decoded table describes.
# We build reg_order here to match readelf's order. In particular,
# registers are sorted by their number, so that the register
# matching ra_regnum is usually listed last with a special heading.
# (LoongArch is a notable exception in that its return register's
# DWARF register number is not greater than other GPRs.)
decoded_table = entry.get_decoded()
reg_order = sorted(decoded_table.reg_order)
if len(decoded_table.reg_order):
# Headings for the registers
for regnum in reg_order:
if regnum == ra_regnum:
self._emit('ra ')
continue
self._emit('%-6s' % describe_reg_name(regnum))
self._emitline()
for line in decoded_table.table:
self._emit(self._format_hex(
line['pc'], fullhex=True, lead0x=False))
if line['cfa'] is not None:
s = describe_CFI_CFA_rule(line['cfa'])
else:
s = 'u'
self._emit(' %-9s' % s)
for regnum in reg_order:
if regnum in line:
s = describe_CFI_register_rule(line[regnum])
else:
s = 'u'
self._emit('%-6s' % s)
self._emitline()
self._emitline()
def _dump_debug_frames_interp(self):
""" Dump the interpreted (decoded) frame information from .debug_frame
and .eh_frame sections.
"""
if self._dwarfinfo.has_EH_CFI():
self._dump_frames_interp_info(
self._dwarfinfo.eh_frame_sec,
self._dwarfinfo.EH_CFI_entries())
self._emitline()
if self._dwarfinfo.has_CFI():
self._dump_frames_interp_info(
self._dwarfinfo.debug_frame_sec,
self._dwarfinfo.CFI_entries())
def _dump_debug_locations(self):
""" Dump the location lists from .debug_loc/.debug_loclists section
"""
di = self._dwarfinfo
loc_lists_sec = di.location_lists()
if not loc_lists_sec: # No locations section - readelf outputs nothing
return
if isinstance(loc_lists_sec, LocationListsPair):
self._dump_debug_locsection(di, loc_lists_sec._loc)
self._dump_debug_locsection(di, loc_lists_sec._loclists)
else:
self._dump_debug_locsection(di, loc_lists_sec)
def _dump_debug_locsection(self, di, loc_lists_sec):
""" Dump the location lists from .debug_loc/.debug_loclists section
"""
ver5 = loc_lists_sec.version >= 5
section_name = (di.debug_loclists_sec if ver5 else di.debug_loc_sec).name
# To dump a location list, one needs to know the CU.
# Scroll through DIEs once, list the known location list offsets.
# Don't need this CU/DIE scan if all entries are absolute or prefixed by base,
# but let's not optimize for that yet.
cu_map = dict() # Loc list offset => CU
for cu in di.iter_CUs():
for die in cu.iter_DIEs():
for key in die.attributes:
attr = die.attributes[key]
if (LocationParser.attribute_has_location(attr, cu['version']) and
LocationParser._attribute_has_loc_list(attr, cu['version'])):
cu_map[attr.value] = cu
addr_size = di.config.default_address_size # In bytes, 4 or 8
addr_width = addr_size * 2 # In hex digits, 8 or 16
line_template = " %%08x %%0%dx %%0%dx %%s%%s" % (addr_width, addr_width)
loc_lists = list(loc_lists_sec.iter_location_lists())
if len(loc_lists) == 0:
# Present but empty locations section - readelf outputs a message
self._emitline("\nSection '%s' has no debugging data." % (section_name,))
return
self._emitline('Contents of the %s section:\n' % (section_name,))
self._emitline(' Offset Begin End Expression')
for loc_list in loc_lists:
self._dump_loclist(loc_list, line_template, cu_map)
def _dump_loclist(self, loc_list, line_template, cu_map):
in_views = False
has_views = False
base_ip = None
loc_entry_count = 0
cu = None
for entry in loc_list:
if isinstance(entry, LocationViewPair):
has_views = in_views = True
# The "v" before address is conditional in binutils, haven't figured out how
self._emitline(" %08x v%015x v%015x location view pair" % (entry.entry_offset, entry.begin, entry.end))
else:
if in_views:
in_views = False
self._emitline("")
# Readelf quirk: indexed loclists don't show the real base IP
if cu_map is None:
base_ip = 0
elif cu is None:
cu = cu_map.get(entry.entry_offset, False)
if not cu:
raise ValueError("Location list can't be tracked to a CU")
if isinstance(entry, LocationEntry):
if base_ip is None and not entry.is_absolute:
base_ip = _get_cu_base(cu)
begin_offset = (0 if entry.is_absolute else base_ip) + entry.begin_offset
end_offset = (0 if entry.is_absolute else base_ip) + entry.end_offset
expr = describe_DWARF_expr(entry.loc_expr, cu.structs, cu.cu_offset)
if has_views:
view = loc_list[loc_entry_count]
postfix = ' (start == end)' if entry.begin_offset == entry.end_offset and view.begin == view.end else ''
self._emitline(' %08x v%015x v%015x views at %08x for:' %(
entry.entry_offset,
view.begin,
view.end,
view.entry_offset))
self._emitline(' %016x %016x %s%s' %(
begin_offset,
end_offset,
expr,
postfix))
loc_entry_count += 1
else:
postfix = ' (start == end)' if entry.begin_offset == entry.end_offset else ''
self._emitline(line_template % (
entry.entry_offset,
begin_offset,
end_offset,
expr,
postfix))
elif isinstance(entry, LocBaseAddressEntry):
base_ip = entry.base_address
self._emitline(" %08x %016x (base address)" % (entry.entry_offset, entry.base_address))
# Pyelftools doesn't store the terminating entry,
# but readelf emits its offset, so this should too.
last = loc_list[-1]
self._emitline(" %08x <End of list>" % (last.entry_offset + last.entry_length))
def _dump_debug_ranges(self):
# TODO: GNU readelf format doesn't need entry_length?
di = self._dwarfinfo
range_lists_sec = di.range_lists()
if not range_lists_sec: # No ranges section - readelf outputs nothing
return
if isinstance(range_lists_sec, RangeListsPair):
self._dump_debug_rangesection(di, range_lists_sec._ranges)
self._dump_debug_rangesection(di, range_lists_sec._rnglists)
else:
self._dump_debug_rangesection(di, range_lists_sec)
def _dump_debug_rangesection(self, di, range_lists_sec):
# Last amended to match readelf 2.41
ver5 = range_lists_sec.version >= 5
section_name = (di.debug_rnglists_sec if ver5 else di.debug_ranges_sec).name
addr_size = di.config.default_address_size # In bytes, 4 or 8
addr_width = addr_size * 2 # In hex digits, 8 or 16
line_template = " %%08x %%0%dx %%0%dx %%s" % (addr_width, addr_width)
base_template = " %%08x %%0%dx (base address)" % (addr_width)
# In order to determine the base address of the range
# We need to know the corresponding CU.
cu_map = {die.attributes['DW_AT_ranges'].value : cu # Range list offset => CU
for cu in di.iter_CUs()
for die in cu.iter_DIEs()
if 'DW_AT_ranges' in die.attributes}
if ver5: # Dump by CUs - unsure at this point what does readelf do, ranges dump is buggy in 2.41
self._emitline('Contents of the %s section:\n\n\n' % section_name)
for cu in range_lists_sec.iter_CUs():
self._emitline(' Table at Offset: %s:' % self._format_hex(cu.cu_offset, alternate=True))
self._emitline(' Length: %s' % self._format_hex(cu.unit_length, alternate=True))
self._emitline(' DWARF version: %d' % cu.version)
self._emitline(' Address size: %d' % cu.address_size)
self._emitline(' Segment size: %d' % cu.segment_selector_size)
self._emitline(' Offset entries: %d\n' % cu.offset_count)
# Is the offset table dumped too?
for (i, range_list) in enumerate(range_lists_sec.iter_CU_range_lists_ex(cu)):
list_offset = range_list[0].entry_offset
range_list = list(range_lists_sec.translate_v5_entry(entry, cu_map[list_offset]) for entry in range_list)
self._emitline(' Offset: %s, Index: %d' % (self._format_hex(list_offset, alternate=True), i))
self._emitline(' Offset Begin End')
self._dump_rangelist(range_list, cu_map, ver5, line_template, base_template)
else: # Dump by DIE reference offset
range_lists = list(range_lists_sec.iter_range_lists())
if len(range_lists) == 0:
# Present but empty ranges section - readelf outputs a message
self._emitline("\nSection '%s' has no debugging data." % section_name)
return
self._emitline('Contents of the %s section:\n\n\n' % section_name)
self._emitline(' Offset Begin End')
for range_list in range_lists:
if len(range_list) == 0: # working around a bogus behavior in readelf 2.41
# No entries means no offset. Dirty hack: peek the stream position
range_list_offset = range_lists_sec.stream.tell() - self._dwarfinfo.config.default_address_size*2
self._emitline(' %08x <End of list>' % (range_list_offset))
else:
self._dump_rangelist(range_list, cu_map, ver5, line_template, base_template)
def _dump_rangelist(self, range_list, cu_map, ver5, line_template, base_template):
# Weird discrepancy in binutils: for DWARFv5 it outputs entry offset,
# for DWARF<=4 list offset.
first = range_list[0]
base_ip = _get_cu_base(cu_map[first.entry_offset])
for entry in range_list:
if isinstance(entry, RangeEntry):
postfix = ' (start == end)' if entry.begin_offset == entry.end_offset else ''
self._emitline(line_template % (
entry.entry_offset if ver5 else first.entry_offset,
(0 if entry.is_absolute else base_ip) + entry.begin_offset,
(0 if entry.is_absolute else base_ip) + entry.end_offset,
postfix))
elif isinstance(entry,RangeBaseAddressEntry):
base_ip = entry.base_address
self._emitline(base_template % (
entry.entry_offset if ver5 else first.entry_offset,
entry.base_address))
else:
raise NotImplementedError("Unknown object in a range list")
last = range_list[-1]
self._emitline(' %08x <End of list>' % (last.entry_offset + last.entry_length if ver5 else first.entry_offset))
def _display_attributes(self, attr_sec, descriptor):
""" Display the attributes contained in the section.
"""
for s in attr_sec.iter_subsections():
self._emitline("Attribute Section: %s" % s.header['vendor_name'])
for ss in s.iter_subsubsections():
h_val = "" if ss.header.extra is None else " ".join("%d" % x for x in ss.header.extra)
self._emitline(descriptor(ss.header.tag, h_val, None))
for attr in ss.iter_attributes():
self._emit(' ')
self._emitline(descriptor(attr.tag, attr.value, attr.extra))
def _display_arch_specific_arm(self):
""" Display the ARM architecture-specific info contained in the file.
"""
attr_sec = self.elffile.get_section_by_name('.ARM.attributes')
self._display_attributes(attr_sec, describe_attr_tag_arm)
def _display_arch_specific_riscv(self):
""" Display the RISC-V architecture-specific info contained in the file.
"""
attr_sec = self.elffile.get_section_by_name('.riscv.attributes')
self._display_attributes(attr_sec, describe_attr_tag_riscv)
def _emit(self, s=''):
""" Emit an object to output
"""
self.output.write(str(s))
def _emitline(self, s=''):
""" Emit an object to output, followed by a newline
"""
self.output.write(str(s).rstrip() + '\n')
SCRIPT_DESCRIPTION = 'Display information about the contents of ELF format files'
VERSION_STRING = '%%(prog)s: based on pyelftools %s' % __version__
def main(stream=None):
# parse the command-line arguments and invoke ReadElf
argparser = argparse.ArgumentParser(
usage='usage: %(prog)s [options] <elf-file>',
description=SCRIPT_DESCRIPTION,
add_help=False, # -h is a real option of readelf
prog='readelf.py')
argparser.add_argument('file',
nargs='?', default=None,
help='ELF file to parse')
argparser.add_argument('-v', '--version',
action='version', version=VERSION_STRING)
argparser.add_argument('-d', '--dynamic',
action='store_true', dest='show_dynamic_tags',
help='Display the dynamic section')
argparser.add_argument('-H', '--help',
action='store_true', dest='help',
help='Display this information')
argparser.add_argument('-h', '--file-header',
action='store_true', dest='show_file_header',
help='Display the ELF file header')
argparser.add_argument('-l', '--program-headers', '--segments',
action='store_true', dest='show_program_header',
help='Display the program headers')
argparser.add_argument('-S', '--section-headers', '--sections',
action='store_true', dest='show_section_header',
help="Display the sections' headers")
argparser.add_argument('-e', '--headers',
action='store_true', dest='show_all_headers',
help='Equivalent to: -h -l -S')
argparser.add_argument('-s', '--symbols', '--syms',
action='store_true', dest='show_symbols',
help='Display the symbol table')
argparser.add_argument('-n', '--notes',
action='store_true', dest='show_notes',
help='Display the core notes (if present)')
argparser.add_argument('-r', '--relocs',
action='store_true', dest='show_relocs',
help='Display the relocations (if present)')
argparser.add_argument('-au', '--arm-unwind',
action='store_true', dest='show_arm_unwind',
help='Display the armeabi unwind information (if present)')
argparser.add_argument('-x', '--hex-dump',
action='store', dest='show_hex_dump', metavar='<number|name>',
help='Dump the contents of section <number|name> as bytes')
argparser.add_argument('-p', '--string-dump',
action='store', dest='show_string_dump', metavar='<number|name>',
help='Dump the contents of section <number|name> as strings')
argparser.add_argument('-V', '--version-info',
action='store_true', dest='show_version_info',
help='Display the version sections (if present)')
argparser.add_argument('-A', '--arch-specific',
action='store_true', dest='show_arch_specific',
help='Display the architecture-specific information (if present)')
argparser.add_argument('--debug-dump',
action='store', dest='debug_dump_what', metavar='<what>',
help=(
'Display the contents of DWARF debug sections. <what> can ' +
'one of {info,decodedline,frames,frames-interp,aranges,pubtypes,pubnames,loc,Ranges}'))
argparser.add_argument('--traceback',
action='store_true', dest='show_traceback',
help='Dump the Python traceback on ELFError'
' exceptions from elftools')
args = argparser.parse_args()
if args.help or not args.file:
argparser.print_help()
sys.exit(0)
if args.show_all_headers:
do_file_header = do_section_header = do_program_header = True
else:
do_file_header = args.show_file_header
do_section_header = args.show_section_header
do_program_header = args.show_program_header
with open(args.file, 'rb') as file:
try:
readelf = ReadElf(file, stream or sys.stdout)
if do_file_header:
readelf.display_file_header()
if do_section_header:
readelf.display_section_headers(
show_heading=not do_file_header)
if do_program_header:
readelf.display_program_headers(
show_heading=not do_file_header)
if args.show_dynamic_tags:
readelf.display_dynamic_tags()
if args.show_symbols:
readelf.display_symbol_tables()
if args.show_notes:
readelf.display_notes()
if args.show_relocs:
readelf.display_relocations()
if args.show_arm_unwind:
readelf.display_arm_unwind()
if args.show_version_info:
readelf.display_version_info()
if args.show_arch_specific:
readelf.display_arch_specific()
if args.show_hex_dump:
readelf.display_hex_dump(args.show_hex_dump)
if args.show_string_dump:
readelf.display_string_dump(args.show_string_dump)
if args.debug_dump_what:
readelf.display_debug_dump(args.debug_dump_what)
except ELFError as ex:
sys.stdout.flush()
sys.stderr.write('ELF error: %s\n' % ex)
if args.show_traceback:
traceback.print_exc()
sys.exit(1)
def profile_main():
# Run 'main' redirecting its output to readelfout.txt
# Saves profiling information in readelf.profile
PROFFILE = 'readelf.profile'
import cProfile
cProfile.run('main(open("readelfout.txt", "w"))', PROFFILE)
# Dig in some profiling stats
import pstats
p = pstats.Stats(PROFFILE)
p.sort_stats('cumulative').print_stats(25)
#-------------------------------------------------------------------------------
if __name__ == '__main__':
main()
#profile_main()