d^ ddlZddlmZddlmZddlmZddlmZddl m Z m Z m Z dd l mZdd lmZdd lmZdd lmZdd lmZddlmZmZddlmZmZddlmZddlm Z ddl!m"Z"eddZ#eddZ$Gdde%Z&y)N) namedtuple) bisect_right) Container) DWARFError) struct_parse dwarf_assertparse_cstring_from_stream) DWARFStructs) CompileUnit) AbbrevTable) LineProgram) CallFrameInfo) LocationListsLocationListsPair) RangeListsRangeListsPair)ARanges)NameLUT)_get_base_offsetDebugSectionDescriptorz&stream name global_offset size address DwarfConfigz/little_endian machine_arch default_address_sizeceZdZdZdZedZdZddZdZ dZ d Z d Z d Z d Zd ZdZdZdZdZdZdZdZdZdZdZddZdZdZdZdZdZy) DWARFInfozw Acts also as a "context" to other major objects, bridging between various parts of the debug information. c||_||_||_||_||_||_||_||_| |_| |_ | |_ ||_ ||_ | |_ | |_||_||_||_||_d|_t)|jj*d|jj,|_i|_i|_g|_g|_y)a config: A DwarfConfig object debug_*_sec: DebugSectionDescriptor for a section. Pass None for sections that don't exist. These arguments are best given with keyword syntax. N ) little_endian dwarf_format address_size)configdebug_info_secdebug_aranges_secdebug_abbrev_secdebug_frame_sec eh_frame_sec debug_str_sec debug_loc_secdebug_ranges_secdebug_line_secdebug_addr_secdebug_str_offsets_secdebug_line_str_secdebug_pubtypes_secdebug_pubnames_secdebug_loclists_secdebug_rnglists_sec debug_sup_secgnu_debugaltlink_secsupplementary_dwarfinfor rdefault_address_sizestructs_abbrevtable_cache_linetable_cache _cu_cache_cu_offsets_map)selfr!r"r#r$r%r&r'r(r)r*r.r/r+r,r-r0r1r2r3s :/usr/lib/python3/dist-packages/elftools/dwarf/dwarfinfo.py__init__zDWARFInfo.__init__As: ,!2 0.(** 0,,%:""4"4"4"4"4*$8! (,$ $++3399; #% "!c,t|jS)z Return whether this contains debug information. It can be not the case when the ELF only contains .eh_frame, which is encoded DWARF but not actually for debugging. )boolr"r;s r<has_debug_infozDWARFInfo.has_debug_infosD''((r>cp|j|j}|j|j|S)z Get the DIE from the pubnames or putbtypes lookup table entry. lut_entry: A NameLUTEntry object from a NameLUT instance (see .get_pubmames and .get_pubtypes methods). ) get_CU_atcu_ofsget_DIE_from_refaddrdie_ofs)r; lut_entrycus r<get_DIE_from_lut_entryz DWARFInfo.get_DIE_from_lut_entrys1^^I,, -(():):B??r>NcJ||j|}|j|S)aG Given a .debug_info section offset of a DIE, return the DIE. refaddr: The refaddr may come from a DW_FORM_ref_addr attribute. cu: The compile unit object, if known. If None a search from the closest offset less than refaddr will be performed. )get_CU_containingrF)r;refaddrrIs r<rFzDWARFInfo.get_DIE_from_refaddrs* :''0B&&w//r>ct|jdtd|cxkxr|jjkncd|zt |j |}|dkDr|j |dz nd}|j |D]4}|j|cxkr |j|jzks0|cS6td|z)a Find the CU that includes the given reference address in the .debug_info section. refaddr: Either a refaddr of a DIE (possibly from a DW_FORM_ref_addr attribute) or the section offset of a CU (possibly from an aranges table). This function will parse and cache CUs until the search criteria is met, starting from the closest known offset lessthan or equal to the given address. #CU lookup but no debug info sectionrz"refaddr %s beyond .debug_info sizer z%CU for reference address %s not found) r rBr"sizerr:_parse_CUs_iter cu_offset ValueError)r;rMistartrIs r<rLzDWARFInfo.get_CU_containings     1 3   34..33 3 07 : < --w 7/01u$$QU+!&&u- B||w?)?? @ @7JKKr>ct|jdtd|cxkxr|jjkncd|z|j |S)a Given a CU header offset, return the parsed CU. offset: The offset may be from an accelerated access table such as the public names, public types, address range table, or prior use. This function will directly parse the CU doing no validation of the offset beyond checking the size of the .debug_info section. rOrz!offset %s beyond .debug_info size)r rBr"rP_cached_CU_at_offsetr;offsets r<rDzDWARFInfo.get_CU_atsV     1 3   2$--22 2 /& 8 :((00r>c"|jS)zM Yield all the compile units (CompileUnit objects) in the debug info )rQrAs r<iter_CUszDWARFInfo.iter_CUss##%%r>ct||jjkd|z||jvr9t |j |jj ||j|<|j|S)a Get an AbbrevTable from the given offset in the debug_abbrev section. The only verification done on the offset is that it's within the bounds of the section (if not, an exception is raised). It is the caller's responsibility to make sure the offset actually points to a valid abbreviation table. AbbrevTable objects are cached internally (two calls for the same offset will return the same object). z3Offset '0x%x' to abbrev table out of section bounds)r6streamrY)r r$rPr7rr6r]rXs r<get_abbrev_tablezDWARFInfo.get_abbrev_tablesz  T**// / AF J L 00 0.9 ,,33/D # #F +&&v..r>cBt|jj|Szm Obtain a string from the string table section, given an offset relative to the section. )r r'r]rXs r<get_string_from_tablezDWARFInfo.get_string_from_tables)););)B)BFKKr>cBt|jj|Sr`)r r-r]rXs r<get_string_from_linetablez#DWARFInfo.get_string_from_linetables))@)@)G)GPPr>c|j}d|jvr3|j|jdj|jSy)a Given a CU object, fetch the line program it points to from the .debug_line section. If the CU doesn't point to a line program, return None. Note about directory and file names. They are returned as two collections in the lineprogram object's header - include_directory and file_entry. In DWARFv5, they have introduced a different, extensible format for those collections. So in a lineprogram v5+, there are two more collections in the header - directories and file_names. Those might contain extra DWARFv5 information that is not exposed in include_directory and file_entry. DW_AT_stmt_listN) get_top_DIE attributes_parse_line_program_at_offsetvaluer6)r;CUtop_DIEs r<line_program_for_CUzDWARFInfo.line_program_for_CUsS.."  2 2 255&&'89??M Mr>c|jduS)z> Does this dwarf info have a dwarf_frame CFI section? N)r%rAs r<has_CFIzDWARFInfo.has_CFIs##4//r>ct|jj|jj|jj|j }|j S)zN Get a list of dwarf_frame CFI entries from the .debug_frame section. )r]rPaddress base_structs)rr%r]rPrpr6 get_entriesr;cfis r< CFI_entrieszDWARFInfo.CFI_entries"sQ''..%%**((00 '   r>c|jduS)z; Does this dwarf info have a eh_frame CFI section? N)r&rAs r< has_EH_CFIzDWARFInfo.has_EH_CFI,s  ,,r>ct|jj|jj|jj|j d}|j S)zH Get a list of eh_frame CFI entries from the .eh_frame section. T)r]rPrprq for_eh_frame)rr&r]rPrpr6rrrss r<EH_CFI_entrieszDWARFInfo.EH_CFI_entries1sT$$++""''%%--    r>c|jr?t|jj|jj|jSy)a Returns a NameLUT object that contains information read from the .debug_pubtypes section in the ELF file. NameLUT is essentially a dictionary containing the CU/DIE offsets of each symbol. See the NameLUT doc string for more details. N)r.rr]rPr6rAs r< get_pubtypeszDWARFInfo.get_pubtypes<C  " "42299++00LL" "r>c|jr?t|jj|jj|jSy)a Returns a NameLUT object that contains information read from the .debug_pubnames section in the ELF file. NameLUT is essentially a dictionary containing the CU/DIE offsets of each symbol. See the NameLUT doc string for more details. N)r/rr]rPr6rAs r< get_pubnameszDWARFInfo.get_pubnamesLr}r>c|jr?t|jj|jj|jSy)z Get an ARanges object representing the .debug_aranges section of the DWARF data, or None if the section doesn't exist N)r#rr]rPr6rAs r< get_arangeszDWARFInfo.get_aranges\sC  ! !41188&&++  r>c|jr8|j,t|jj|jd|S|jr8|j,t|jj|jd|S|jrL|jr@t |jj|jj|j|Sy)z Get a LocationLists object representing the .debug_loc/debug_loclists section of the DWARF data, or None if this section doesn't exist. If both sections exist, it returns a LocationListsPair. N)r0r(rr]r6rrAs r<location_listszDWARFInfo.location_listsgs  " "t'9'9'A !8!8!?!?qRVW W   D$;$;$C !3!3!:!:DLL!TR R   D$;$;$T%<%<%C%CTE\E\EcEceieqeqswx xr>c|jr8|j,t|jj|jd|S|jr8|j,t|jj|jd|S|jrL|jr@t |jj|jj|j|Sy)z Get a RangeLists object representing the .debug_ranges/.debug_rnglists section of the DWARF data, or None if this section doesn't exist. If both sections exist, it returns a RangeListsPair. Nrr)r1r)rr]r6rrAs r< range_listszDWARFInfo.range_listsvs  " "t'<'<'Dd55<'>'Fd33::DLL!TR R  " "t'>'>!$"7"7">">@W@W@^@^`d`l`lnrs sr>c|js tdt|d}t|jj d|jj |||jjzzS)zUProvided a CU and an index, retrieves an address from the debug_addr section zJThe file does not contain a debug_addr section for indirect address accessDW_AT_addr_base) r+rrrr6Dwarf_target_addrr]headerr )r;rI addr_index cu_addr_bases r<get_addrzDWARFInfo.get_addrs""ij j',=> BJJ88Q>Q>X>XZfistvt}t}uKuKjK[KL Lr>c#K|jy||jjkrS|j|}||dz|jj z}|||jjkrRyyw)a. Iterate CU objects in order of appearance in the debug_info section. offset: The offset of the first CU to yield. Additional iterations will return the sequential unit objects. See .iter_CUs(), .get_CU_containing(), and .get_CU_at(). N unit_length)r"rPrWr6initial_length_field_size)r;rYrIs r<rQzDWARFInfo._parse_CUs_iters    & t**///**62B=)* <<>?FHt**///s A8A=;A=ct|j|}|dk\r'||j|dz k(r|j|dz S|j|}|jj |||jj |||S)a Return the CU with unit header at the given offset into the debug_info section from the cache. If not present, the unit is header is parsed and the object is installed in the cache. offset: The offset of the unit header in the .debug_info section to of the unit to fetch from the cache. See get_CU_at(). r )rr:r9_parse_CU_at_offsetinsert)r;rYrTrIs r<rWzDWARFInfo._cached_CU_at_offsets --v 6 6f 4 4QU ;;>>!a%( (  % %f - ##Av. a$ r>c&t|jjd|jj|}|dk(rdnd}t |j j|dd}t|j|jj|}t |j j||d|d }|jjj}t|j|d d |d zt||||| S) zM Parse and return a CU at the given offset in the debug_info stream. rl@rrr)rrr dwarf_versionr versionz*Expected supported DWARF version. Got '%s')r dwarfinfor6rR cu_die_offset) rr6 Dwarf_uint32r"r]r r!rDwarf_CU_headertellr _is_supported_versionr )r;rYinitial_lengthr cu_structs cu_headerrs r<rzDWARFInfo._parse_CU_at_offsets& LL % %b )4+>+>+E+EvO+z9rr "++33%  !  & &(;(;(B(BFL "++33%">2#I. 0 ++22779   & &y'; < 89Y;O O Q " + - -r>c"d|cxkxrdkScS)z0 DWARF version supported by this parser rr)r;rs r<rzDWARFInfo._is_supported_versionsG q    r>cp||jvr|j|St|j|jj|}d}|||dd|||dd|j ddr!t d|jD|_|j ddr!t d|jD|_ ||d z|jz}t||jj||jjj| }||j|<|S) z Given an offset to the .debug_line section, parse the line program starting at this offset in the section and return it. structs is the DWARFStructs object used to do this parsing. c|j|dr||}||D]}d}|jdk(r|||j|j4|jdk(r|||j|jb|jdvrK|j r)|||j|j j |||jd|jdvstyy)NFc.|D]}|||||<yNr)data content_typereplacerentrys r< replace_valuezWDWARFInfo._parse_line_program_at_offset..resolve_strings..replace_values'%)PE2:5;N2OE,/Pr>DW_FORM_line_strp DW_FORM_strp)DW_FORM_strp_supDW_FORM_GNU_strp_altct|Sr)str)xs r<zRDWARFInfo._parse_line_program_at_offset..resolve_strings..s cRSfr>)r DW_FORM_strx DW_FORM_strx1 DW_FORM_strx2 DW_FORM_strx3 DW_FORM_strx4)getformrrcrar4get_string_fromtableNotImplementedError)r;lineprog_header format_field data_fieldrfieldrs r<resolve_stringsz@DWARFInfo._parse_line_program_at_offset..resolve_stringss""<7&z2,\:4EPzz%88%dE,>,>@^@^_~5%dE,>,>@Z@Z['SS77)$0B0BDD`D`DuDuv)$0B0BDTU(PP13348r>directory_entry_format directoriesfile_name_entry_format file_namesFc34K|]}|jywr) DW_LNCT_path).0ds r< z:DWARFInfo._parse_line_program_at_offset..s5jann5jsc 3K|]P}tdi|jd|jd|jd|jddRyw)rDW_LNCT_directory_indexDW_LNCT_timestamp DW_LNCT_size)name dir_indexmtimelengthNr)rr)res r<rz:DWARFInfo._parse_line_program_at_offset..s[/5  6550!"'@!AUU#67eeN3 56/5sAAr)rr]r6program_start_offsetprogram_end_offset)r8rDwarf_lineprog_headerr*r]rtuplerinclude_directoryr file_entryrrr)r;rYr6rr end_offset lineprograms r<rhz'DWARFInfo._parse_line_program_at_offsets@ T** *((0 0&  ) )    & &   4( o/GWo/GV   }e 4055joNiNi5j0jO -   |U 3)./5 )33 /5*5O &!??99;< ""&&--!%!4!4!;!;!@!@!B) + )4f%r>c|jy|jjjd|jjj |jj}|j dk(r |jS|jj|jjjd|jjj |jj}|jSy)zY Extract a filename from either .debug_sup or .gnu_debualtlink sections. Nr) r2r]seekr6Dwarf_debugsup parse_streamis_supplementary sup_filenamer3Dwarf_debugaltlink)r;suplinks r<parse_debugsupinfozDWARFInfo.parse_debugsupinfo3s    )    % % * *1 -ll11>>t?Q?Q?X?XYG''1,+++  $ $ 0  % % , , 1 1! 4ll55BB4C\C\CcCcdG'' 'r>r)r) __name__ __module__ __qualname____doc__r=propertyrBrJrFrLrDr[r^rarcrlrnrurwrzr|rrrrrrQrWrrrhrrr>r<rr=sF"P))@ 0 LD1(& /,L Q ,0 !- !    L,4,-\! >@ r>r)'os collectionsrbisectrconstruct.lib.containerrcommon.exceptionsr common.utilsrr r r6r compileunitr abbrevtablerrr callframer locationlistsrrrangesrrarangesrnamelutr dwarf_utilrrrobjectrrr>r<rsp "/*77!$$$$;.($$<,. 57 CCr>