-#-------------------------------------------------------------------------------\r
-# elftools: dwarf/descriptions.py\r
-#\r
-# Textual descriptions of the various values and enums of DWARF\r
-#\r
-# Eli Bendersky (eliben@gmail.com)\r
-# This code is in the public domain\r
-#-------------------------------------------------------------------------------\r
-from collections import defaultdict\r
-\r
-from .constants import *\r
-\r
-\r
-def describe_attr_value(attrname, attr, die, section_offset):\r
- """ Given an attribute (attrname is the name, attr is the AttributeValue),\r
- return the textual representation of its value, suitable for tools like\r
- readelf.\r
- \r
- To cover all cases, this function needs some extra arguments:\r
-\r
- die: the DIE this attribute was extracted from\r
- section_offset: offset in the stream of the section the DIE belongs to\r
- """\r
- descr_func = _ATTR_DESCRIPTION_MAP[attr.form]\r
- val_description = descr_func(attr, die, section_offset)\r
- \r
- # For some attributes we can display further information\r
- extra_info_func = _EXTRA_INFO_DESCRIPTION_MAP[attrname]\r
- extra_info = extra_info_func(attr, die, section_offset)\r
- return str(val_description) + '\t' + extra_info \r
-\r
-\r
-#-------------------------------------------------------------------------------\r
-\r
+#-------------------------------------------------------------------------------
+# elftools: dwarf/descriptions.py
+#
+# Textual descriptions of the various values and enums of DWARF
+#
+# Eli Bendersky (eliben@gmail.com)
+# This code is in the public domain
+#-------------------------------------------------------------------------------
+from collections import defaultdict
+
+from .constants import *
+
+
+def describe_attr_value(attrname, attr, die, section_offset):
+ """ Given an attribute (attrname is the name, attr is the AttributeValue),
+ return the textual representation of its value, suitable for tools like
+ readelf.
+
+ To cover all cases, this function needs some extra arguments:
+
+ die: the DIE this attribute was extracted from
+ section_offset: offset in the stream of the section the DIE belongs to
+ """
+ descr_func = _ATTR_DESCRIPTION_MAP[attr.form]
+ val_description = descr_func(attr, die, section_offset)
+
+ # For some attributes we can display further information
+ extra_info_func = _EXTRA_INFO_DESCRIPTION_MAP[attrname]
+ extra_info = extra_info_func(attr, die, section_offset)
+ return str(val_description) + '\t' + extra_info
+
+
+#-------------------------------------------------------------------------------
+
def _describe_attr_ref(attr, die, section_offset):
- return '<0x%x>' % (attr.value + die.cu.cu_offset - section_offset)\r
-\r
+ return '<0x%x>' % (attr.value + die.cu.cu_offset - section_offset)
+
def _describe_attr_value_passthrough(attr, die, section_offset):
- return attr.value\r
-\r
+ return attr.value
+
def _describe_attr_hex(attr, die, section_offset):
- return '0x%x' % (attr.value)\r
-\r
-def _describe_attr_hex_addr(attr, die, section_offset):\r
- return '<0x%x>' % (attr.value)\r
-\r
+ return '0x%x' % (attr.value)
+
+def _describe_attr_hex_addr(attr, die, section_offset):
+ return '<0x%x>' % (attr.value)
+
def _describe_attr_split_64bit(attr, die, section_offset):
- low_word = attr.value & 0xFFFFFFFF\r
- high_word = (attr.value >> 32) & 0xFFFFFFFF\r
- return '0x%x 0x%x' % (low_word, high_word)\r
-\r
+ low_word = attr.value & 0xFFFFFFFF
+ high_word = (attr.value >> 32) & 0xFFFFFFFF
+ return '0x%x 0x%x' % (low_word, high_word)
+
def _describe_attr_strp(attr, die, section_offset):
- return '(indirect string, offset: 0x%x): %s' % (attr.raw_value, attr.value)\r
-\r
-def _describe_attr_debool(attr, die, section_offset):\r
- """ To be consistent with readelf, generate 1 for True flags, 0 for False\r
+ return '(indirect string, offset: 0x%x): %s' % (attr.raw_value, attr.value)
+
+def _describe_attr_debool(attr, die, section_offset):
+ """ To be consistent with readelf, generate 1 for True flags, 0 for False
flags.
- """\r
- return '1' if attr.value else '0'\r
-\r
+ """
+ return '1' if attr.value else '0'
+
def _describe_attr_block(attr, die, section_offset):
- s = '%s byte block: ' % len(attr.value)\r
- s += ' '.join('%x' % item for item in attr.value)\r
- return s\r
- \r
-\r
-_ATTR_DESCRIPTION_MAP = defaultdict(\r
- lambda: _describe_attr_value_passthrough, # default_factory\r
- \r
- DW_FORM_ref1=_describe_attr_ref,\r
- DW_FORM_ref2=_describe_attr_ref,\r
- DW_FORM_ref4=_describe_attr_ref,\r
- DW_FORM_ref8=_describe_attr_split_64bit,\r
- DW_FORM_ref_udata=_describe_attr_ref, \r
- DW_FORM_ref_addr=_describe_attr_hex_addr,\r
- DW_FORM_data4=_describe_attr_hex,\r
- DW_FORM_data8=_describe_attr_split_64bit,\r
- DW_FORM_addr=_describe_attr_hex,\r
- DW_FORM_sec_offset=_describe_attr_hex,\r
- DW_FORM_flag=_describe_attr_debool,\r
- DW_FORM_data1=_describe_attr_value_passthrough,\r
- DW_FORM_data2=_describe_attr_value_passthrough,\r
- DW_FORM_sdata=_describe_attr_value_passthrough,\r
- DW_FORM_udata=_describe_attr_value_passthrough,\r
- DW_FORM_string=_describe_attr_value_passthrough,\r
- DW_FORM_strp=_describe_attr_strp,\r
- DW_FORM_block1=_describe_attr_block,\r
- DW_FORM_block2=_describe_attr_block,\r
- DW_FORM_block4=_describe_attr_block,\r
- DW_FORM_block=_describe_attr_block,\r
-)\r
-\r
-\r
-\r
-def _describe_empty(attr, die, section_offset):
- return ''\r
-\r
-def _describe_dw_inl_extra(attr, die, section_offset):
- return _DESCR_DW_INL.get(\r
- attr.value,\r
- ' (Unknown inline attribute value: %x)' % attr.value)\r
-\r
-def _describe_dw_lang_extra(attr, die, section_offset):\r
- return _DESCR_DW_LANG.get(\r
- attr.value,\r
- ' (Unknown: %x)' % attr.value)\r
-\r
-def _describe_dw_ate_extra(attr, die, section_offset):
- return _DESCR_DW_ATE.get(\r
- attr.value,\r
- ' (unknown type)')\r
-\r
-\r
-_EXTRA_INFO_DESCRIPTION_MAP = defaultdict(\r
- lambda: _describe_empty, # default_factory\r
- \r
- DW_AT_inline=_describe_dw_inl_extra,\r
- DW_AT_language=_describe_dw_lang_extra,\r
- DW_AT_encoding=_describe_dw_ate_extra,\r
-)\r
-\r
-\r
-_DESCR_DW_INL = {\r
- DW_INL_not_inlined: '(not inlined)',\r
- DW_INL_inlined: '(inlined)',\r
- DW_INL_declared_not_inlined: '(declared as inline but ignored)',\r
- DW_INL_declared_inlined: '(declared as inline and inlined)',\r
-}\r
-\r
-_DESCR_DW_LANG = {\r
- DW_LANG_C89: '(ANSI C)',\r
- DW_LANG_C: '(non-ANSI C)',\r
- DW_LANG_Ada83: '(Ada)',\r
- DW_LANG_C_plus_plus: '(C++)',\r
- DW_LANG_Cobol74: '(Cobol 74)',\r
- DW_LANG_Cobol85: '(Cobol 85)',\r
- DW_LANG_Fortran77: '(FORTRAN 77)',\r
- DW_LANG_Fortran90: '(Fortran 90)',\r
- DW_LANG_Pascal83: '(ANSI Pascal)',\r
- DW_LANG_Modula2: '(Modula 2)',\r
- DW_LANG_Java: '(Java)',\r
- DW_LANG_C99: '(ANSI C99)',\r
- DW_LANG_Ada95: '(ADA 95)',\r
- DW_LANG_Fortran95: '(Fortran 95)',\r
- DW_LANG_PLI: '(PLI)',\r
- DW_LANG_ObjC: '(Objective C)',\r
- DW_LANG_ObjC_plus_plus: '(Objective C++)',\r
- DW_LANG_UPC: '(Unified Parallel C)',\r
- DW_LANG_D: '(D)',\r
- DW_LANG_Python: '(Python)',\r
- DW_LANG_Mips_Assembler: '(MIPS assembler)',\r
- DW_LANG_Upc: '(nified Parallel C)',\r
- DW_LANG_HP_Bliss: '(HP Bliss)',\r
- DW_LANG_HP_Basic91: '(HP Basic 91)',\r
- DW_LANG_HP_Pascal91: '(HP Pascal 91)',\r
- DW_LANG_HP_IMacro: '(HP IMacro)',\r
- DW_LANG_HP_Assembler: '(HP assembler)',\r
-}\r
-\r
-_DESCR_DW_ATE = {\r
- DW_ATE_void: '(void)',\r
- DW_ATE_address: '(machine address)',\r
- DW_ATE_boolean: '(boolean)',\r
- DW_ATE_complex_float: '(complex float)',\r
- DW_ATE_float: '(float)',\r
- DW_ATE_signed: '(signed)',\r
- DW_ATE_signed_char: '(signed char)',\r
- DW_ATE_unsigned: '(unsigned)',\r
- DW_ATE_unsigned_char: '(unsigned char)',\r
- DW_ATE_imaginary_float: '(imaginary float)',\r
- DW_ATE_decimal_float: '(decimal float)',\r
- DW_ATE_packed_decimal: '(packed_decimal)',\r
- DW_ATE_numeric_string: '(numeric_string)',\r
- DW_ATE_edited: '(edited)',\r
- DW_ATE_signed_fixed: '(signed_fixed)',\r
- DW_ATE_unsigned_fixed: '(unsigned_fixed)',\r
- DW_ATE_HP_float80: '(HP_float80)',\r
- DW_ATE_HP_complex_float80: '(HP_complex_float80)',\r
- DW_ATE_HP_float128: '(HP_float128)',\r
- DW_ATE_HP_complex_float128: '(HP_complex_float128)',\r
- DW_ATE_HP_floathpintel: '(HP_floathpintel)',\r
- DW_ATE_HP_imaginary_float80: '(HP_imaginary_float80)',\r
- DW_ATE_HP_imaginary_float128: '(HP_imaginary_float128)',\r
-}\r
-\r
+ s = '%s byte block: ' % len(attr.value)
+ s += ' '.join('%x' % item for item in attr.value)
+ return s
+
+
+_ATTR_DESCRIPTION_MAP = defaultdict(
+ lambda: _describe_attr_value_passthrough, # default_factory
+
+ DW_FORM_ref1=_describe_attr_ref,
+ DW_FORM_ref2=_describe_attr_ref,
+ DW_FORM_ref4=_describe_attr_ref,
+ DW_FORM_ref8=_describe_attr_split_64bit,
+ DW_FORM_ref_udata=_describe_attr_ref,
+ DW_FORM_ref_addr=_describe_attr_hex_addr,
+ DW_FORM_data4=_describe_attr_hex,
+ DW_FORM_data8=_describe_attr_split_64bit,
+ DW_FORM_addr=_describe_attr_hex,
+ DW_FORM_sec_offset=_describe_attr_hex,
+ DW_FORM_flag=_describe_attr_debool,
+ DW_FORM_data1=_describe_attr_value_passthrough,
+ DW_FORM_data2=_describe_attr_value_passthrough,
+ DW_FORM_sdata=_describe_attr_value_passthrough,
+ DW_FORM_udata=_describe_attr_value_passthrough,
+ DW_FORM_string=_describe_attr_value_passthrough,
+ DW_FORM_strp=_describe_attr_strp,
+ DW_FORM_block1=_describe_attr_block,
+ DW_FORM_block2=_describe_attr_block,
+ DW_FORM_block4=_describe_attr_block,
+ DW_FORM_block=_describe_attr_block,
+)
+
+
+_DESCR_DW_INL = {
+ DW_INL_not_inlined: '(not inlined)',
+ DW_INL_inlined: '(inlined)',
+ DW_INL_declared_not_inlined: '(declared as inline but ignored)',
+ DW_INL_declared_inlined: '(declared as inline and inlined)',
+}
+
+_DESCR_DW_LANG = {
+ DW_LANG_C89: '(ANSI C)',
+ DW_LANG_C: '(non-ANSI C)',
+ DW_LANG_Ada83: '(Ada)',
+ DW_LANG_C_plus_plus: '(C++)',
+ DW_LANG_Cobol74: '(Cobol 74)',
+ DW_LANG_Cobol85: '(Cobol 85)',
+ DW_LANG_Fortran77: '(FORTRAN 77)',
+ DW_LANG_Fortran90: '(Fortran 90)',
+ DW_LANG_Pascal83: '(ANSI Pascal)',
+ DW_LANG_Modula2: '(Modula 2)',
+ DW_LANG_Java: '(Java)',
+ DW_LANG_C99: '(ANSI C99)',
+ DW_LANG_Ada95: '(ADA 95)',
+ DW_LANG_Fortran95: '(Fortran 95)',
+ DW_LANG_PLI: '(PLI)',
+ DW_LANG_ObjC: '(Objective C)',
+ DW_LANG_ObjC_plus_plus: '(Objective C++)',
+ DW_LANG_UPC: '(Unified Parallel C)',
+ DW_LANG_D: '(D)',
+ DW_LANG_Python: '(Python)',
+ DW_LANG_Mips_Assembler: '(MIPS assembler)',
+ DW_LANG_Upc: '(nified Parallel C)',
+ DW_LANG_HP_Bliss: '(HP Bliss)',
+ DW_LANG_HP_Basic91: '(HP Basic 91)',
+ DW_LANG_HP_Pascal91: '(HP Pascal 91)',
+ DW_LANG_HP_IMacro: '(HP IMacro)',
+ DW_LANG_HP_Assembler: '(HP assembler)',
+}
+
+_DESCR_DW_ATE = {
+ DW_ATE_void: '(void)',
+ DW_ATE_address: '(machine address)',
+ DW_ATE_boolean: '(boolean)',
+ DW_ATE_complex_float: '(complex float)',
+ DW_ATE_float: '(float)',
+ DW_ATE_signed: '(signed)',
+ DW_ATE_signed_char: '(signed char)',
+ DW_ATE_unsigned: '(unsigned)',
+ DW_ATE_unsigned_char: '(unsigned char)',
+ DW_ATE_imaginary_float: '(imaginary float)',
+ DW_ATE_decimal_float: '(decimal float)',
+ DW_ATE_packed_decimal: '(packed_decimal)',
+ DW_ATE_numeric_string: '(numeric_string)',
+ DW_ATE_edited: '(edited)',
+ DW_ATE_signed_fixed: '(signed_fixed)',
+ DW_ATE_unsigned_fixed: '(unsigned_fixed)',
+ DW_ATE_HP_float80: '(HP_float80)',
+ DW_ATE_HP_complex_float80: '(HP_complex_float80)',
+ DW_ATE_HP_float128: '(HP_float128)',
+ DW_ATE_HP_complex_float128: '(HP_complex_float128)',
+ DW_ATE_HP_floathpintel: '(HP_floathpintel)',
+ DW_ATE_HP_imaginary_float80: '(HP_imaginary_float80)',
+ DW_ATE_HP_imaginary_float128: '(HP_imaginary_float128)',
+}
+
+_DESCR_DW_ACCESS = {
+ DW_ACCESS_public: '(public)',
+ DW_ACCESS_protected: '(protected)',
+ DW_ACCESS_private: '(private)',
+}
+
+_DESCR_DW_VIS = {
+ DW_VIS_local: '(local)',
+ DW_VIS_exported: '(exported)',
+ DW_VIS_qualified: '(qualified)',
+}
+
+_DESCR_DW_VIRTUALITY = {
+ DW_VIRTUALITY_none: '(none)',
+ DW_VIRTUALITY_virtual: '(virtual)',
+ DW_VIRTUALITY_pure_virtual: '(pure virtual)',
+}
+
+_DESCR_DW_ID_CASE = {
+ DW_ID_case_sensitive: '(case_sensitive)',
+ DW_ID_up_case: '(up_case)',
+ DW_ID_down_case: '(down_case)',
+ DW_ID_case_insensitive: '(case_insensitive)',
+}
+
+_DESCR_DW_CC = {
+ DW_CC_normal: '(normal)',
+ DW_CC_program: '(program)',
+ DW_CC_nocall: '(nocall)',
+}
+
+_DESCR_DW_ORD = {
+ DW_ORD_row_major: '(row major)',
+ DW_ORD_col_major: '(column major)',
+}
+
+
+def _make_extra_mapper(mapping, default, default_interpolate_value=False):
+ """ Create a mapping function from attribute parameters to an extra
+ value that should be displayed.
+ """
+ def mapper(attr, die, section_offset):
+ if default_interpolate_value:
+ d = default % attr.value
+ else:
+ d = default
+ return mapping.get(attr.value, d)
+ return mapper
+
+
+def _make_extra_string(s=''):
+ """ Create an extra function that just returns a constant string.
+ """
+ def extra(attr, die, section_offset):
+ return s
+ return extra
+
+_location_list_extra = _make_extra_string('(location list)')
+
+
+_EXTRA_INFO_DESCRIPTION_MAP = defaultdict(
+ lambda: _make_extra_string(''), # default_factory
+
+ DW_AT_inline=_make_extra_mapper(
+ _DESCR_DW_INL, '(Unknown inline attribute value: %x',
+ default_interpolate_value=True),
+ DW_AT_language=_make_extra_mapper(
+ _DESCR_DW_LANG, '(Unknown: %x)', default_interpolate_value=True),
+ DW_AT_encoding=_make_extra_mapper(_DESCR_DW_ATE, '(unknown type)'),
+ DW_AT_accessibility=_make_extra_mapper(
+ _DESCR_DW_ACCESS, '(unknown accessibility)'),
+ DW_AT_visibility=_make_extra_mapper(
+ _DESCR_DW_VIS, '(unknown visibility)'),
+ DW_AT_virtuality=_make_extra_mapper(
+ _DESCR_DW_VIRTUALITY, '(unknown virtuality)'),
+ DW_AT_identifier_case=_make_extra_mapper(
+ _DESCR_DW_ID_CASE, '(unknown case)'),
+ DW_AT_calling_convention=_make_extra_mapper(
+ _DESCR_DW_CC, '(unknown convention)'),
+ DW_AT_ordering=_make_extra_mapper(
+ _DESCR_DW_ORD, '(undefined)'),
+ DW_AT_frame_base=_location_list_extra,
+ DW_AT_location=_location_list_extra,
+ DW_AT_string_length=_location_list_extra,
+ DW_AT_return_addr=_location_list_extra,
+ DW_AT_data_member_location=_location_list_extra,
+ DW_AT_vtable_elem_location=_location_list_extra,
+ DW_AT_segment=_location_list_extra,
+ DW_AT_static_link=_location_list_extra,
+ DW_AT_use_location=_location_list_extra,
+)
+
+
projects / pyelftools.git / commitdiff