ó
    ø®i¹G  ã                   óˆ   • S r SSKrSSKrSSKrSSKrSSKrSSKrSSKrSr	\R                  r
Sr " S S\5      rS rS rS	 rg)
z‚peutils, Portable Executable utilities module


Copyright (c) 2005-2023 Ero Carrera <ero.carrera@gmail.com>

All rights reserved.
é    NzEro Carrerazero.carrera@gmail.comc                   ó„   • \ rS rSrSrSS jrSS jrSS jr SS jrSS jr	SS	 jr
S
 rSS jrSS jrSS jrSS jrSrg)ÚSignatureDatabaseé   a�  This class loads and keeps a parsed PEiD signature database.

Usage:

    sig_db = SignatureDatabase('/path/to/signature/file')

and/or

    sig_db = SignatureDatabase()
    sig_db.load('/path/to/signature/file')

Signature databases can be combined by performing multiple loads.

The filename parameter can be a URL too. In that case the
signature database will be downloaded from that location.
Nc                 ó  • [         R                  " S[         R                  5      U l        [	        5       U l        SU l        [	        5       U l        SU l        [	        5       U l	        SU l
        SU l        U R                  XS9  g )Nzh\[(.*?)\]\s+?signature\s*=\s*(.*?)(\s+\?\?)*\s*ep_only\s*=\s*(\w+)(?:\s*section_start_only\s*=\s*(\w+)|)r   ©ÚfilenameÚdata)ÚreÚcompileÚSÚ	parse_sigÚdictÚsignature_tree_eponly_trueÚsignature_count_eponly_trueÚsignature_tree_eponly_falseÚsignature_count_eponly_falseÚsignature_tree_section_startÚsignature_count_section_startÚ	max_depthÚ_SignatureDatabase__load©Úselfr   r	   s      Ú4C:\des-py\RoboSAPF\venv\Lib\site-packages\peutils.pyÚ__init__ÚSignatureDatabase.__init__&   sm   € ô ŸšØvÜ�D‰Dó
ˆŒô" +/«&ˆÔ'Ø+,ˆÔ(Ü+/«6ˆÔ(Ø,-ˆÔ)Ü,0«FˆÔ)Ø-.ˆÔ*ð ˆŒà�‰˜XˆÒ1ó    c                 óÂ  • [        5       n[        UR                  5       H¤  u  pVUR                  U:  a  M  UR                  nSUUS-   [        UR                  5      SR                  UR                   Vs/ s H  oˆ[        R                  ;   d  M  UPM     sn5      4-  n	UR                  U R                  UUU	SSUS95        M¦     SR                  U5      S-   $ s  snf )zäGenerates signatures for all the sections in a PE file.

If the section contains any data a signature will be created
for it. The signature name will be a combination of the
parameter 'name' and the section number and its name.
z%s Section(%d/%d,%s)é   Ú FT)Úep_onlyÚsection_start_onlyÚ
sig_lengthÚ
)ÚlistÚ	enumerateÚsectionsÚSizeOfRawDataÚPointerToRawDataÚlenÚjoinÚNameÚstringÚ	printableÚappendÚ&_SignatureDatabase__generate_signature)
r   ÚpeÚnamer"   Úsection_signaturesÚidxÚsectionÚoffsetÚcÚsig_names
             r   Úgenerate_section_signaturesÚ-SignatureDatabase.generate_section_signaturesH   sà   € ô "›VÐä% b§k¡kÖ2‰LˆCà×$Ñ$ zÓ1Ùð ×-Ñ-ˆFà-ØØ�a‘Ü�B—K‘KÓ Ø—‘ G§L¢LÓJ¢L˜q¼×9IÑ9IÑ4IŸ¡LÑJÓKð	1ñ ˆHð ×%Ñ%Ø×)Ñ)ØØØØ!Ø'+Ø)ð *ð ö	ñ 3ð4 �y‰yÐ+Ó,¨tÑ3Ð3ùò Ks   Á6CÂCc                 óp   • UR                  UR                  R                  5      nU R                  XUSUS9$ )z˜Generate signatures for the entry point of a PE file.

Creates a signature whose name will be the parameter 'name'
and the section number and its name.
T)r    r"   )Úget_offset_from_rvaÚOPTIONAL_HEADERÚAddressOfEntryPointr/   )r   r0   r1   r"   r5   s        r   Úgenerate_ep_signatureÚ'SignatureDatabase.generate_ep_signaturen   sA   € ð ×'Ñ'¨×(:Ñ(:×(NÑ(NÓOˆà×(Ñ(Ø˜ d°zð )ð 
ð 	
r   c           	      óà   • UR                   X"U-    nSR                  U Vs/ s H  nS[        U5      -  PM     sn5      n	US:X  a  SnOSnUS:X  a  SnOSnSU< SU	< SU< S	U< S
3	n
U
$ s  snf )NÚ z%02xTÚtrueÚfalseÚ[z]
signature = z
ep_only = z
section_start_only = r#   )Ú__data__r*   Úord)r   r0   r5   r1   r    r!   r"   r	   r6   Úsignature_bytesÚ	signatures              r   Ú__generate_signatureÚ&SignatureDatabase.__generate_signature{   s…   € ð �{‰{˜6¨ZÑ$7Ð8ˆàŸ(™(¹TÓ#BºT¸ F¬S°«V¤O¹TÑ#BÓCˆà�d‹?Ø‰GàˆGà Ó%Ø!'Ñà!(Ðøó ÛÛÛð	
ˆ	ð Ðùò' $Cs   ¡A+c                 ó–   • U R                  XU5      nU(       a+  US:X  a  U Vs/ s H  oUS   US   S   4PM     sn$ US   S   $ gs  snf )zèMatches and returns the exact match(es).

If ep_only is True the result will be a string with
the packer name. Otherwise it will be a list of the
form (file_offset, packer_name) specifying where
in the file the signature was found.
Fr   r   éÿÿÿÿN©Ú_SignatureDatabase__match)r   r0   r    r!   ÚmatchesÚmatchs         r   rP   ÚSignatureDatabase.match–   s`   € ð —,‘,˜rÐ,>Ó?ˆö
 Ø˜%Óñ ?FÓFºg°U˜q™ 5¨¡8¨B¡<Ó0¹gÑFÐFà˜1‘:˜b‘>Ð!àùò	 Gs   ¤Ac                 óP   • U R                  XU5      nU(       a  US:X  a  U$ US   $ g)z+Matches and returns all the likely matches.Fr   NrM   )r   r0   r    r!   rO   s        r   Ú	match_allÚSignatureDatabase.match_all¯   s4   € ð —,‘,˜rÐ,>Ó?ˆæØ˜%Óð �à˜1‘:Ðàr   c                 ób  • USL a?   UR                   nU R                  nUR                   Vs/ s H  owR                  PM     nnOhUSL a7   UR                  5       nU R                  nUR                  R                  n	U	/nO,UR                   nU R                  n[        [        U5      5      n/ n
U H>  nU R                  XdX»U R                  -    5      nU(       d  M,  U
R                  X¼45        M@     USL a  U
(       a  U
S   $ U
$ ! [         a  ne S nAff = fs  snf ! [         a  ne S nAff = f)NTr   )rE   Ú	Exceptionr   r&   r(   Úget_memory_mapped_imager   r<   r=   r   Úranger)   Ú(_SignatureDatabase__match_signature_treer   r.   )r   r0   r    r!   r	   ÚexcpÚ
signaturesr4   Úscan_addressesÚeprO   r3   Úresults                r   Ú__matchÚSignatureDatabase.__match¿   sB  € ð  Ò%ð
Ø—{‘{�ð ×:Ñ:ˆJð GIÇkÂkÓRÂk¸7×6Ô6ÁkˆNÐRˆNà˜Š_ð
Ø×1Ñ1Ó3�ð ×8Ñ8ˆJð
 ×#Ñ#×7Ñ7ˆBð !˜T‰Nð —;‘;ˆDà×9Ñ9ˆJä"¤3 t£9Ó-ˆNð ˆÛ!ˆCØ×0Ñ0Ø ¨T¯^©^Ñ';Ð<óˆF÷ ˆvØ—‘ ˜}Ö-ñ "ð �dŠ?ÞØ˜q‘zÐ!àˆøôy ó Øûðüò Søô ó Øûðús4   ‡D ­DÁD Ä
DÄDÄDÄ
D.Ä(D)Ä)D.c                 ó  • UnS/nUSL a  U R                   nOUSL a  U R                  n/ nU H>  nU R                  WXHX€R                  -    5      n	U	(       d  M,  UR	                  X‰45        M@     USL a  U(       a  US   $ U$ )Nr   T)r   r   rY   r   r.   )
r   Ú	code_datar    r!   r	   r\   r[   rO   r3   r^   s
             r   Ú
match_dataÚSignatureDatabase.match_data
  s�   € àˆØ˜ˆð  Ò%ð ×:Ñ:‰Jð
 ˜Š_ð ×8Ñ8ˆJð ˆÛ!ˆCØ×0Ñ0Ø˜D s¯^©^Ñ';Ð<óˆF÷ ˆvØ—‘ ˜}Ö-ñ "ð �dŠ?ÞØ˜q‘zÐ!àˆr   c           	      óR  • [        5       nUn[        U Vs/ s H%  n[        U[        5      (       a  UO
[	        U5      PM'     sn5       HÞ  u  pxUc    OØUR                  US5      n	S[        UR                  5       5      ;   aW  [        5       n
[        UR                  5       5       H  nUS   b  M  U
R                  US   5        M!     UR                  U
5        SU;   aF  UR                  SS5      nX'S-   S nU(       a&  UR                  U R                  XÍXs-   S-   5      5        U	nMà     Ubt  S[        UR                  5       5      ;   aW  [        5       n
[        UR                  5       5       H  nUS   b  M  U
R                  US   5        M!     UR                  U
5        U$ s  snf )zêRecursive function to find matches along the signature tree.

signature_tree  is the part of the tree left to walk
data    is the data being checked against the signature tree
depth   keeps track of how far we have gone down the tree
Nr   r   z??)r$   r%   Ú
isinstanceÚintrF   ÚgetÚvaluesÚitemsr.   ÚextendrY   )r   Úsignature_treer	   ÚdepthÚmatched_namesrP   Úbr3   ÚbyteÚ
match_nextÚnamesÚitemÚmatch_tree_alternateÚdata_remainings                 r   Ú__match_signature_treeÚ(SignatureDatabase.__match_signature_tree6  sŒ  € ô ›ˆØˆô
 #ÑQUÓ#VÒQUÈA¬°A´s×);Ñ);¡AÄÀQÃÒ$GÑQUÑ#VÖW‰IˆCð ‰}Ùð Ÿ™ 4¨Ó.ˆJð ”t˜EŸL™L›NÓ+Ó+ô ›�ô ! §¡£Ö/�DØ˜A‘w“ØŸ™ T¨!¡WÖ-ñ 0ð ×$Ñ$ UÔ+ð
 �u‹}Ø',§y¡y°°tÓ'<Ð$Ø!%¨A¡g i �Þ!Ø!×(Ñ(Ø×3Ñ3Ø0À#Á+ÐPQÁ/óôð ŠEñW Xð` Ñ ¬¨e¯l©l«nÓ)=Ó!=ä“FˆEÜ˜UŸ[™[›]Ö+�Ø˜‘7“?Ø—L‘L  a¡Ö)ñ ,ð × Ñ  Ô'àÐùòq $Ws   –,F$c                 ó"   • U R                  XS9  g)z^Load a PEiD signature file.

Invoking this method on different files combines the signatures.
r   N)r   r   s      r   ÚloadÚSignatureDatabase.load~  s   € ð 	�‰˜XˆÒ1r   c                 óÔ  • Ub“  [         R                  R                  U5      (       dA   [        R                  R                  U5      nUR                  5       nUR                  5         O0 [        US5      nUR                  5       nUR                  5         OUnU(       d  g S nU R                  R                  U5      nU GH€  u  nnn	n
nU
R                  5       R                  5       n
UR                  SS5      R                  5       nUR                  5        Vs/ s H
  oÅ" U5      PM     nnU
S:X  a  Sn
OSn
US:X  a  SnOSnSnUSL a"  U R                   nU =R"                  S	-  sl        OHU
SL a"  U R$                  nU =R&                  S	-  sl        O!U R(                  nU =R*                  S	-  sl        [-        U5       He  u  nnUS	-   [/        U5      :X  a&  UR1                  U[3        5       5      UU'   S UU   U'   OUR1                  U[3        5       5      UU'   UU   nUS	-  nMg     XàR4                  :”  d  GMz  Xàl        GMƒ     g ! [         a    e f = f! [         a    e f = fs  snf )
NÚrtc                 ó*   • SU ;   a  U $ [        U S5      $ )NÚ?é   )rg   )Úvalues    r   Úto_byteÚ)SignatureDatabase.__load.<locals>.to_byte¨  s   € Ø�e‹|Ø�Ü�u˜b“>Ð!r   z\nr   rB   TFr   r   )ÚosÚpathÚexistsÚurllibÚrequestÚurlopenÚreadÚcloseÚIOErrorÚopenr   ÚfindallÚstripÚlowerÚreplaceÚsplitr   r   r   r   r   r   r%   r)   rh   r   r   )r   r   r	   Úsig_fÚsig_datar�   rO   Úpacker_namerH   Úsuperfluous_wildcardsr    r!   ro   rG   rm   Útreer3   rp   s                     r   Ú__loadÚSignatureDatabase.__load†  sK  € àÑô —7‘7—>‘> (×+Ñ+ðÜ"ŸN™N×2Ñ2°8Ó<�EØ$Ÿz™z›|�HØ—K‘K•MðÜ  ¨4Ó0�EØ$Ÿz™z›|�HØ—K‘K•Mð
 ˆHö
 Øò	"ð —.‘.×(Ñ(¨Ó2ˆô ñ
ØØØ!ØØð —m‘m“o×+Ñ+Ó-ˆGà!×)Ñ)¨%°Ó4×:Ñ:Ó<ˆIà3<·?±?Ô3DÓEÒ3D¨a˜w qžzÑ3DˆOÐEà˜&Ó Ø‘à�à! VÓ+Ø%)Ñ"à%*Ð"àˆEà! TÒ)à×8Ñ8�Ø×2Ò2°aÑ7Ö2ð ˜d’?Ø×:Ñ:�DØ×4Ò4¸Ñ9Ö4à×;Ñ;�DØ×5Ò5¸Ñ:Õ5ä& Ö7‘	��Tà˜‘7œc /Ó2Ó2à!%§¡¨$´³Ó!7�D˜‘JØ.2�D˜‘J˜{Ò+ð "&§¡¨$´³Ó!7�D˜‘Jà˜D‘z�Ø˜‘
’ñ 8ð —~‘~Ö%Ø!&—òa øôU ó àðûô ó àðüòL Fs   ©?I Á*,I ÄI%ÉIÉI")r   r   r   r   r   r   r   r   )NN)é   )FFr™   )TF)r   )Ú__name__Ú
__module__Ú__qualname__Ú__firstlineno__Ú__doc__r   r8   r>   r/   rP   rS   rN   rc   rY   ry   r   Ú__static_attributes__© r   r   r   r      sM   † ñô" 2ôD$4ôL
ð UXôô6ô2ò IôV*ôXFôP2÷d'r   r   c                 ó   • g)r   Nr    )r0   s    r   Úis_validr¢   í  s   € àr   c                 óŽ  • SnSn[        U S5      (       a•  U R                   H…  nSnUR                   Hp  nUR                  U R                  R
                  s=::  a  UR                  S-   ::  a  O  OSnUb!  XER                  s=::  a	  US-   ::  a  O  OUS-  nUR                  nMr     M‡     SnU R                  5       nU(       a  U  g)z`
unusual locations of import tables
non recognized section names
presence of long ASCII strings
Fr   ÚDIRECTORY_ENTRY_BASERELOCNé   Tr   )Úhasattrr¤   ÚentriesÚrvar<   r=   Úget_warnings)r0   Úrelocations_overlap_entry_pointÚsequential_relocsÚ
base_relocÚlast_reloc_rvaÚrelocÚwarnings_while_parsingÚwarningss           r   Úis_suspiciousr±   ò  sÂ   € ð ',Ð#ØÐô ˆrÐ.×/Ñ/Ø×6Ô6ˆJØ!ˆNØ#×+Ô+�Ø—9‘9 × 2Ñ 2× FÑ FÕWÈ%Ï)É)ÐVWÉ-ÖWØ6:Ð3ð #Ñ.Ø&¯)©)ÕI°~ÈÑ7IÖIà%¨Ñ*Ð%à!&§¡’ó ,ñ 7ð& #Ðð �‰Ó €HÞÙð 	r   c                 óô   • [        U R                  5       5      nU(       d  gSnSnU R                   H8  nUR                  5       n[        UR	                  5       5      nUS:”  d  M4  X6-  nM:     X1-  S:”  a  SnU$ )a$  Returns True is there is a high likelihood that a file is packed or contains compressed data.

The sections of the PE file will be analyzed, if enough sections
look like containing compressed data and the data makes
up for more than 20% of the total file size, the function will
return True.
TFr   gš™™™™™@gš™™™™™É?)r)   Útrimr&   Úget_entropyÚget_data)r0   Útotal_pe_data_lengthÚ)has_significant_amount_of_compressed_dataÚtotal_compressed_datar4   Ú	s_entropyÚs_lengths          r   Úis_probably_packedr»   (  s‚   € ô ˜rŸw™w›y›>ÐæØØ05Ð-ð
 ÐØ—;”;ˆØ×'Ñ'Ó)ˆ	Ü�w×'Ñ'Ó)Ó*ˆð �s�?Ø!Ñ-Ò!ñ ð 	Ñ4¸Ó;Ø48Ð1à4Ð4r   )rž   rƒ   r
   r,   Úurllib.requestr†   Úurllib.parseÚurllib.errorÚpefileÚ
__author__Ú__version__Ú__contact__Úobjectr   r¢   r±   r»   r    r   r   Ú<module>rÄ      sR   ðñó 
Û 	Û ß 1Ó 1Û à€
Ø× Ñ €Ø%€ôV'˜ô V'òr	ò
3	ól!5r   