diff options
Diffstat (limited to 'chromium/third_party/pyelftools/elftools/dwarf/structs.py')
| -rw-r--r-- | chromium/third_party/pyelftools/elftools/dwarf/structs.py | 102 |
1 files changed, 37 insertions, 65 deletions
diff --git a/chromium/third_party/pyelftools/elftools/dwarf/structs.py b/chromium/third_party/pyelftools/elftools/dwarf/structs.py index 39e4815b2f4..cfb2515a0ab 100644 --- a/chromium/third_party/pyelftools/elftools/dwarf/structs.py +++ b/chromium/third_party/pyelftools/elftools/dwarf/structs.py @@ -11,7 +11,7 @@ from ..construct import ( UBInt8, UBInt16, UBInt32, UBInt64, ULInt8, ULInt16, ULInt32, ULInt64, SBInt8, SBInt16, SBInt32, SBInt64, SLInt8, SLInt16, SLInt32, SLInt64, Adapter, Struct, ConstructError, If, RepeatUntil, Field, Rename, Enum, - Array, PrefixedArray, CString, Embed, StaticField + Array, PrefixedArray, CString, Embed, ) from ..common.construct_utils import RepeatUntilExcluding @@ -19,39 +19,39 @@ from .enums import * class DWARFStructs(object): - """ Exposes Construct structs suitable for parsing information from DWARF + """ Exposes Construct structs suitable for parsing information from DWARF sections. Each compile unit in DWARF info can have its own structs - object. Keep in mind that these structs have to be given a name (by + object. Keep in mind that these structs have to be given a name (by calling them with a name) before being used for parsing (like other Construct structs). Those that should be used without a name are marked by (+). - + Accessible attributes (mostly as described in chapter 7 of the DWARF spec v3): - + Dwarf_[u]int{8,16,32,64): Data chunks of the common sizes - + Dwarf_offset: 32-bit or 64-bit word, depending on dwarf_format - + Dwarf_target_addr: 32-bit or 64-bit word, depending on address size - + Dwarf_initial_length: "Initial length field" encoding section 7.4 - + Dwarf_{u,s}leb128: ULEB128 and SLEB128 variable-length encoding - + Dwarf_CU_header (+): Compilation unit header - + Dwarf_abbrev_declaration (+): Abbreviation table declaration - doesn't include the initial code, only the contents. - + Dwarf_dw_form (+): A dictionary mapping 'DW_FORM_*' keys into construct Structs that parse such forms. These Structs have already been given @@ -62,7 +62,7 @@ class DWARFStructs(object): Dwarf_lineprog_file_entry (+): A single file entry in a line program header or instruction - + Dwarf_CIE_header (+): A call-frame CIE @@ -71,27 +71,22 @@ class DWARFStructs(object): See also the documentation of public methods. """ - def __init__(self, - little_endian, dwarf_format, address_size, dwarf_version=2): - """ dwarf_version: - Numeric DWARF version - - little_endian: + def __init__(self, little_endian, dwarf_format, address_size): + """ little_endian: True if the file is little endian, False if big - + dwarf_format: DWARF Format: 32 or 64-bit (see spec section 7.4) - + address_size: - Target machine address size, in bytes (4 or 8). (See spec + Target machine address size, in bytes (4 or 8). (See spec section 7.5.1) """ assert dwarf_format == 32 or dwarf_format == 64 assert address_size == 8 or address_size == 4 self.little_endian = little_endian - self.dwarf_format = dwarf_format + self.dwarf_format = dwarf_format self.address_size = address_size - self.dwarf_version = dwarf_version self._create_structs() def initial_length_field_size(self): @@ -136,7 +131,7 @@ class DWARFStructs(object): def _create_initial_length(self): def _InitialLength(name): # Adapts a Struct that parses forward a full initial length field. - # Only if the first word is the continuation value, the second + # Only if the first word is the continuation value, the second # word is parsed from the stream. # return _InitialLengthAdapter( @@ -157,13 +152,13 @@ class DWARFStructs(object): self.Dwarf_uint16('version'), self.Dwarf_offset('debug_abbrev_offset'), self.Dwarf_uint8('address_size')) - + def _create_abbrev_declaration(self): self.Dwarf_abbrev_declaration = Struct('Dwarf_abbrev_entry', Enum(self.Dwarf_uleb128('tag'), **ENUM_DW_TAG), Enum(self.Dwarf_uint8('children_flag'), **ENUM_DW_CHILDREN), RepeatUntilExcluding( - lambda obj, ctx: + lambda obj, ctx: obj.name == 'DW_AT_null' and obj.form == 'DW_FORM_null', Struct('attr_spec', Enum(self.Dwarf_uleb128('name'), **ENUM_DW_AT), @@ -172,12 +167,12 @@ class DWARFStructs(object): def _create_dw_form(self): self.Dwarf_dw_form = dict( DW_FORM_addr=self.Dwarf_target_addr(''), - + DW_FORM_block1=self._make_block_struct(self.Dwarf_uint8), DW_FORM_block2=self._make_block_struct(self.Dwarf_uint16), DW_FORM_block4=self._make_block_struct(self.Dwarf_uint32), DW_FORM_block=self._make_block_struct(self.Dwarf_uleb128), - + # All DW_FORM_data<n> forms are assumed to be unsigned DW_FORM_data1=self.Dwarf_uint8(''), DW_FORM_data2=self.Dwarf_uint16(''), @@ -185,29 +180,19 @@ class DWARFStructs(object): DW_FORM_data8=self.Dwarf_uint64(''), DW_FORM_sdata=self.Dwarf_sleb128(''), DW_FORM_udata=self.Dwarf_uleb128(''), - + DW_FORM_string=CString(''), DW_FORM_strp=self.Dwarf_offset(''), DW_FORM_flag=self.Dwarf_uint8(''), - + DW_FORM_ref1=self.Dwarf_uint8(''), DW_FORM_ref2=self.Dwarf_uint16(''), DW_FORM_ref4=self.Dwarf_uint32(''), DW_FORM_ref8=self.Dwarf_uint64(''), DW_FORM_ref_udata=self.Dwarf_uleb128(''), DW_FORM_ref_addr=self.Dwarf_offset(''), - + DW_FORM_indirect=self.Dwarf_uleb128(''), - - # New forms in DWARFv4 - DW_FORM_flag_present = StaticField('', 0), - DW_FORM_sec_offset = self.Dwarf_offset(''), - DW_FORM_exprloc = self._make_block_struct(self.Dwarf_uleb128), - DW_FORM_ref_sig8 = self.Dwarf_offset(''), - - DW_FORM_GNU_strp_alt=self.Dwarf_offset(''), - DW_FORM_GNU_ref_alt=self.Dwarf_offset(''), - DW_AT_GNU_all_call_sites=self.Dwarf_uleb128(''), ) def _create_lineprog_header(self): @@ -230,7 +215,7 @@ class DWARFStructs(object): self.Dwarf_int8('line_base'), self.Dwarf_uint8('line_range'), self.Dwarf_uint8('opcode_base'), - Array(lambda ctx: ctx['opcode_base'] - 1, + Array(lambda ctx: ctx['opcode_base'] - 1, self.Dwarf_uint8('standard_opcode_lengths')), RepeatUntilExcluding( lambda obj, ctx: obj == b'', @@ -241,27 +226,14 @@ class DWARFStructs(object): ) def _create_callframe_entry_headers(self): - # The CIE header was modified in DWARFv4. - if self.dwarf_version == 4: - self.Dwarf_CIE_header = Struct('Dwarf_CIE_header', - self.Dwarf_initial_length('length'), - self.Dwarf_offset('CIE_id'), - self.Dwarf_uint8('version'), - CString('augmentation'), - self.Dwarf_uint8('address_size'), - self.Dwarf_uint8('segment_size'), - self.Dwarf_uleb128('code_alignment_factor'), - self.Dwarf_sleb128('data_alignment_factor'), - self.Dwarf_uleb128('return_address_register')) - else: - self.Dwarf_CIE_header = Struct('Dwarf_CIE_header', - self.Dwarf_initial_length('length'), - self.Dwarf_offset('CIE_id'), - self.Dwarf_uint8('version'), - CString('augmentation'), - self.Dwarf_uleb128('code_alignment_factor'), - self.Dwarf_sleb128('data_alignment_factor'), - self.Dwarf_uleb128('return_address_register')) + self.Dwarf_CIE_header = Struct('Dwarf_CIE_header', + self.Dwarf_initial_length('length'), + self.Dwarf_offset('CIE_id'), + self.Dwarf_uint8('version'), + CString('augmentation'), + self.Dwarf_uleb128('code_alignment_factor'), + self.Dwarf_sleb128('data_alignment_factor'), + self.Dwarf_uleb128('return_address_register')) self.Dwarf_FDE_header = Struct('Dwarf_FDE_header', self.Dwarf_initial_length('length'), @@ -270,7 +242,7 @@ class DWARFStructs(object): self.Dwarf_target_addr('address_range')) def _make_block_struct(self, length_field): - """ Create a struct for DW_FORM_block<size> + """ Create a struct for DW_FORM_block<size> """ return PrefixedArray( subcon=self.Dwarf_uint8('elem'), |