dQddlmZddlmZmZmZddlmZddlm Z ddl m Z ddl Z Gd d e ZGd d eZGd deZGddeZGddeZGdde ZGddeZGddeZGddeZGdde ZGddeZGdd eZGd!d"eZGd#d$eZGd%d&eZGd'd(eZGd)d*eZGd+d,eZGd-d.eZ Gd/d0eZ!Gd1d2eZ"y)3)ELFCompressionError) struct_parse elf_assertparse_cstring_from_stream) defaultdict)SH_FLAGS) iter_notesNcdeZdZdZdZedZedZedZdZ dZ dZ d Z d Z y ) Sectiona Base class for ELF sections. Also used for all sections types that have no special functionality. Allows dictionary-like access to the section header. For example: > sec = Section(...) > sec['sh_type'] # section type c||_||_||_|jj|_|jj|_|dt j z|_|jrNt|jj|j|d}|d|_ |d|_ |d|_ y|d|_ |d|_ y) Nsh_flags sh_offset stream_posch_typech_size ch_addralignsh_size sh_addralign)headernameelffilestreamstructsr SHF_COMPRESSED _compressed compressedrElf_Chdr_compression_type_decompressed_size_decompressed_align)selfrrrs 7/usr/lib/python3/dist-packages/elftools/elf/sections.py__init__zSection.__init__s   ll)) ||++ !*-0G0GG ??"$,,"7"7"&++-1+->@F&,I%6D "&,Y&7D #'-n'=D $&,Y&7D #'-n'=D $c|jS)z% Is this section compressed? )rr$s r%rzSection.compressed/sr'c|jS)z Return the logical size for this section's data. This can be different from the .sh_size header field when the section is compressed. )r"r)s r% data_sizezSection.data_size5s&&&r'c|jS)z Return the logical alignment for this section's data. This can be different from the .sh_addralign header field when the section is compressed. )r#r)s r%data_alignmentzSection.data_alignment>s'''r'c|jddk(rd|jzS|jr |j}|dk(r|jj j }|jj|d|z|jj|d|z }tj}|j||j}ntdj|t||j k7r.tdjt||j |S|jj|d|jj|j }|S) z The section data from the file. Note that data is decompressed if the stored section data is compressed. sh_type SHT_NOBITSELFCOMPRESS_ZLIBrrz Unknown compression type: {:#0x}z;Decompressed data is {} bytes long, should be {} bytes long)rr+rr!rr sizeofrseekreadzlib decompressobj decompressrformatlenr")r$c_typehdr_sizerdecompresults r%dataz Section.dataGsN ;;y !\ 1' ' ??++F++ <<00779   k!2X!=>![[--d9o.HI ++-**:t~~F)6==fE6{d555)"F3v;0G0GH  KK  T+. /[[%%d&=&=>F r'cy)z! Is this a null section? Fr)s r%is_nullzSection.is_nullmsr'c |j|S)z6 Implement dict-like access to header entries rr$rs r% __getitem__zSection.__getitem__r{{4  r'cT |j|jk(S#t$rYywxYw)NF)rAttributeError)r$others r%__eq__zSection.__eq__ws, ;;%,,. .  s  ''c,t|jSN)hashrr)s r%__hash__zSection.__hash__}sDKK  r'N)__name__ __module__ __qualname____doc__r&propertyrr+r-r?rBrFrKrOrAr'r%r r sb>*  ''(($L !  !r'r ceZdZdZdZy) NullSectionz ELF NULL section cy)NTrAr)s r%rBzNullSection.is_nullsr'N)rPrQrRrSrBrAr'r%rVrVs r'rVceZdZdZdZy)StringTableSectionz ELF string table section. cl|d}t|j||z}|r|jddSdS)zI Get the string stored at the given offset in this string table. rutf-8replace)errors)rrdecode)r$offset table_offsetss r% get_stringzStringTableSection.get_strings=K( %dkk<&3H I67qxx x2?R?r'N)rPrQrRrSrcrAr'r%rYrYs @r'rYc(eZdZdZfdZdZxZS)SymbolTableIndexSectionas A section containing the section header table indices corresponding to symbols in the linked symbol table. This section has to exist if the symbol table contains an entry with a section header index set to SHN_XINDEX (0xffff). The format of the section is described at https://refspecs.linuxfoundation.org/elf/gabi4+/ch4.sheader.html c>tt| |||||_yrM)superrer& symboltabler$rrrrh __class__s r%r&z SymbolTableIndexSection.__init__ %t5fdGL&r'ct|jjjd|j|d||dzzS)z Get the section header table index for the symbol with index #n. The section contains an array of Elf32_word values with one entry for every symbol in the associated symbol table. r^r sh_entsize)rrrElf_wordr)r$ns r%get_section_indexz)SymbolTableIndexSection.get_section_indexsG DLL0099"=t{{ -D4F0FFH Hr')rPrQrRrSr&rp __classcell__rjs@r%reres 'Hr'rec:eZdZdZfdZdZdZdZdZxZ S)SymbolTableSectionzn ELF symbol table section. Has an associated StringTableSection that's passed in the constructor. ctt| |||||_t |ddkDd|zt |d|dzdk(d|zd|_y)Nrmrz+Expected entry size of section %r to be > 0rzBExpected section size to be a multiple of entry size in section %r)rgrtr& stringtabler_symbol_name_map)r$rrrrvrjs r%r&zSymbolTableSection.__init__sk  $0wG&4 %)=D F4 ?T,%771<TW[[ ] $r'c|d|dzS)( Number of symbols in the table rrmrAr)s r% num_symbolszSymbolTableSection.num_symbolssI$|"444r'c|d||dzz}t|jj|j|}|jj |d}t ||S)zC Get the symbol at index #n from the table (Symbol object) rrmrst_name)rrElf_SymrrvrcSymbolr$ro entry_offsetentryrs r% get_symbolzSymbolTableSection.get_symbolshK(1tL/A+AA  LL KK#% **5+;<eT""r'cZ|j]tt|_t|j D]-\}}|j|j j |/|jj|}|r|Dcgc]}|j|c}SdScc}w)za Get a symbol(s) by name. Return None if no symbol by the given name exists. N) rwrlist enumerate iter_symbolsrappendgetr)r$risymsymnumss r%get_symbol_by_namez%SymbolTableSection.get_symbol_by_names  ($/$5D !#D$5$5$78 :3%%chh/66q9 :''++D18?G4q"4ITI4s B(c#nKt|jD]}|j|yw), Yield all the symbols in the table Nrangerzrr$rs r%rzSymbolTableSection.iter_symbolss4t'')* %A//!$ $ %s35) rPrQrRrSr&rzrrrrqrrs@r%rtrts"%5 # J%r'rtceZdZdZdZdZy)r~z Symbol object - representing a single symbol entry from a symbol table section. Similarly to Section objects, allows dictionary-like access to the symbol entry. c ||_||_yrM)rr)r$rrs r%r&zSymbol.__init__s  r'c |j|S)z/ Implement dict-like access to entries )rrEs r%rFzSymbol.__getitem__szz$r'N)rPrQrRrSr&rFrAr'r%r~r~s  r'r~c4eZdZdZfdZdZdZdZxZS)SUNWSyminfoTableSectionzu ELF .SUNW Syminfo table section. Has an associated SymbolTableSection that's passed in the constructor. c>tt| |||||_yrM)rgrr&rhris r%r&z SUNWSyminfoTableSection.__init__rkr'c|d|dzdz S)ryrrmr rAr)s r%rzz#SUNWSyminfoTableSection.num_symbolssI$|"44q88r'c|d||dzz}t|jj|j|}|jj |j }t||S)z Get the symbol at index #n from the table (Symbol object). It begins at 1 and not 0 since the first entry is used to store the current version of the syminfo table. rrmr)rrElf_Sunw_Syminforrhrrr~rs r%rz"SUNWSyminfoTableSection.get_symbolsi K(1tL/A+AA  LL ) ) KK#% **1-22eT""r'c#vKtd|jdzD]}|j|yw)rr Nrrs r%rz$SUNWSyminfoTableSection.iter_symbolss;q$**,q01 %A//!$ $ %s79) rPrQrRrSr&rzrrrqrrs@r%rrs'9 #%r'rceZdZdZdZy) NoteSectionz1 ELF NOTE section. Knows how to parse notes. c<t|j|d|dS)z Yield all the notes in the section. Each result is a dictionary- like object with "n_name", "n_type", and "n_desc" fields, amongst others. rr)r rr)s r%r zNoteSection.iter_notess $,,[(94 ?KKr'N)rPrQrRrSr rAr'r%rrs Lr'rceZdZdZdZy) StabSectionz ELF stab section. c#0K|d}|d}||z}||kr~t|jj|j|}||d<||jjj z }|jj ||||kr}yyw)zG Yield all stab entries. Result type is ELFStructs.Elf_Stabs. rrrn_offsetN)rr Elf_Stabsrr3r4)r$r`sizeendstabss r% iter_stabszStabSection.iter_stabssk"Itmsl  && !#E!'E*  dll,,335 5F KK  V $Ksls BBBN)rPrQrRrSrrAr'r%rrs r'rc,eZdZdZdZedZdZy) AttributezE Attribute object - representing a build attribute of ELF files. c ||_d|_yrM)_tagextra)r$tags r%r&zAttribute.__init__0s  r'c |jdS)Nr)rr)s r%rz Attribute.tag4syyr'cd|jjd|jd|jd}||jd|jzz }|Sdz }|S)Nz %sr^)rjrPrvaluerr$rbs r%__repr__zAttribute.__repr__8sT ^^ $ $dhh  < 4::#9UTZZ A@BAr'N)rPrQrRrSr&rTrrrAr'r%rr-s%  r'rcJeZdZdZdZd dZedZedZdZ dZ y) AttributesSubsubsectionz= Subsubsection of an ELF attribute section's subsection. c||_||_||_||_|j|j|j|_|jj |_yrM)rr`r attributertell attr_start)r$rrr`rs r%r&z AttributesSubsubsection.__init__BsL   "nnT\\4;;? ++**,r'Nc#bK|jD]}||j|k(s|yw)z= Yield all attributes (limit to |tag| if specified). N)_make_attributesr)r$rrs r%iter_attributesz'AttributesSubsubsection.iter_attributesLs5..0 I{imms2 s%//cHtd|jDdzS)z4 Number of attributes in the subsubsection. c3 K|]}dywr NrA.0_s r% z9AttributesSubsubsection.num_attributes..Ws515 r )sumrr)s r%num_attributesz&AttributesSubsubsection.num_attributesSs#5d2245599r'cP|jgt|jzS)z6 List of all attributes in the subsubsection. )rrrr)s r% attributesz"AttributesSubsubsection.attributesYs# }tD$8$8$:;;;r'c#dK|j|jjz}|jj |j |jj |k7rG|j|j|j|jj |k7rFyyw)zl Create all attributes for this subsubsection except the first one which is the header. N) r`rrrr4rrrr)r$rs r%rz(AttributesSubsubsection._make_attributes_s{kkDKK--- )kk C'..t{{; ;kk C's B+B0.B0cd}||jj|jjdd|jjfzS)N<%s (%s): %d bytes>)rjrPrrrrs r%rz AttributesSubsubsection.__repr__jsC !DNN++KKOOAB'):):<< .s919r)rrr)s r%num_subsubsectionsz'AttributesSubsection.num_subsubsectionss9d668999r'c4t|jS)z7 List of all subsubsections in the subsection. )rrr)s r%subsubsectionsz#AttributesSubsection.subsubsectionssD,,.//r'c#K|j|dz}|jj|j|jj |k7r|j |j|j |jj }|jj|j|jjz||jj |k7ryyw)z8 Create all subsubsections for this subsection. lengthN) r`rr4rrrrrr)r$rrs r%rz)AttributesSubsection._make_subsubsectionsskkDN* --.kk C'**4;;+/<<+/;;+;+;+=?I KK  T11I4D4D4J4JJ KO kk C's C1C64C6c |j|S)z7 Implement dict-like access to header entries. rDrEs r%rFz AttributesSubsection.__getitem__rGr'crd}||jj|jd|jdfzS)Nr vendor_namer)rjrPrrs r%rzAttributesSubsection.__repr__s? !T^^,,[[/X1FHH Hr'rM) rPrQrRrSr&rrTrrrrFrrAr'r%rrpsI2 :: 00 ! Hr'rcPeZdZdZfdZddZedZedZdZ xZ S)AttributesSectionz ELF attributes section. c*tt| |||||_t |j j d|j|d}tt|dk(dt|z|jj|_ y)Nformat_versionrAz-Unknown attributes version %s, expecting 'A'.) rgrr& subsectionrrElf_byterrchrr subsec_start)r$rrrrfvrjs r%r&zAttributesSection.__init__s /gF$ $,,//0@A++{+- 3r7c>BSWL N!KK,,.r'c#TK|jD]}| |d|k(s|yw)zF Yield all subsections (limit to |vendor_name| if specified). Nr)_make_subsections)r$rsubsecs r%iter_subsectionsz"AttributesSection.iter_subsectionss7,,. F"f]&;{&J  s((cBtd|jDS)z/ Number of subsections in the section. c3 K|]}dywrrArs r%rz4AttributesSection.num_subsections..s616r)rrr)s r%num_subsectionsz!AttributesSection.num_subsectionss6d335666r'c4t|jS)z1 List of all subsections in the section. )rrr)s r% subsectionszAttributesSection.subsectionssD))+,,r'c#K|d|jz}|jj|j|jj |k7r|j |j|j |jj }|jj|j|dz||jj |k7ryyw)z2 Create all subsections for this section. rrN)r+rr4rrrr)r$rrs r%rz#AttributesSection._make_subsectionss;$..0 **+kk C'__T[[%)\\%)[[%5%5%79F KK  T..1AA BL kk C's C C%#C%rM) rPrQrRrSr&rrTrrrrqrrs@r%rrs? /77 -- r'rc"eZdZdZfdZxZS) ARMAttributezM ARM attribute object - representing a build attribute of ARM ELF files. ctt| t|j||j dvrt|j d||_|j dk7reg|_t|jd|}|dk7r=|jj|t|jd|}|dk7rtt| t|j||j dvrt|j d||_|j dk7reg|_t|jd|}|dk7r=|jj|t|jd|}|dk7rs *D: GV^ 5r'r rrs@r%rr;s55r'rc"eZdZdZfdZxZS)RISCVAttributesSubsectionz5 Subsection of an ELF .riscv.attributes section. cPtt| ||||jtyrM)rgr!r&rrrs r%r&z"RISCVAttributesSubsection.__init__Fs& '7 GV  . . ( *r'r rrs@r%r!r!Cs**r'r!c"eZdZdZfdZxZS)RISCVAttributesSectionz$ ELF .riscv.attributes section. c:tt| |||tyrM)rgr$r&r!rs r%r&zRISCVAttributesSection.__init__Ps $d4 D'#< >r'r rrs@r%r$r$Ms>>r'r$)#common.exceptionsr common.utilsrrr collectionsr constantsr notesr r6objectr rVrYrertr~rrrrrrrrr rrrrr!r$rAr'r%r,s34NN# l!fl!^'@@HgH(1%1%h V " %g %FL'L'&$..>r'