Ë
    åhi¿G  ã                   ó†   — d Z ddlZddlZddlZddlZddlZddlZddlZdZ	ej                  Z
dZ G d„ d«      Zd„ Zd„ Zd	„ Zy)
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                   óh   — e Zd ZdZdd„Zdd„Zdd„Z	 dd„Zdd„Zdd„Z	d	„ Z
dd
„Zdd„Zdd„Zdd„Zy)ÚSignatureDatabasea±  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                 ó  — t        j                  dt         j                  «      | _        t	        «       | _        d| _        t	        «       | _        d| _        t	        «       | _	        d| _
        d| _        | j                  ||¬«       y )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      ú3C:\des-py\Monitor\venv\Lib\site-packages\peutils.pyÚ__init__zSignatureDatabase.__init__)   so   € ô Ÿ™ØwÜ�D‰Dó
ˆŒô" +/«&ˆÔ'Ø+,ˆÔ(Ü+/«6ˆÔ(Ø,-ˆÔ)Ü,0«FˆÔ)Ø-.ˆÔ*ð ˆŒà�‰˜X¨DˆÕ1ó    c                 ó¸  — t        «       }t        |j                  «      D ]   \  }}|j                  |k  rŒ|j                  }d||dz   t        |j                  «      dj                  |j                  D �cg c]  }|t        j                  v sŒ|‘Œ c}«      fz  }	|j                  | j                  |||	dd|¬«      «       Œ¢ dj                  |«      dz   S c c}w )a  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_signaturesz-SignatureDatabase.generate_section_signaturesK   så   € ô "›VÐä% b§k¡kÓ2ò 	‰LˆC�à×$Ñ$ zÒ1Øð ×-Ñ-ˆFà-ØØ�a‘Ü�B—K‘KÓ Ø—‘ G§L¡LÖJ˜q°A¼×9IÑ9IÒ4IšÒJÓKð	1ñ ˆHð ×%Ñ%Ø×)Ñ)ØØØØ!Ø'+Ø)ð *ó õ	ð	ð4 �y‰yÐ+Ó,¨tÑ3Ð3ùò Ks   Á5CÂCc                 óx   — |j                  |j                  j                  «      }| j                  |||d|¬«      S )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   r.   r/   r    r3   s        r   Úgenerate_ep_signaturez'SignatureDatabase.generate_ep_signatureq   sC   € ð ×'Ñ'¨×(:Ñ(:×(NÑ(NÓOˆà×(Ñ(Ø�˜ d°zð )ó 
ð 	
r   c           	      óÐ   — |j                   |||z    }dj                  |D �cg c]  }dt        |«      z  ‘Œ c}«      }	|dk(  rd}nd}|dk(  rd}nd}d|›d|	›d|›d	|›d
�	}
|
S c c}w )Nú z%02xTÚtrueÚfalseú[z]
signature = z
ep_only = z
section_start_only = r!   )Ú__data__r(   Úord)r   r.   r3   r/   r   r   r    r   r4   Úsignature_bytesÚ	signatures              r   Ú__generate_signaturez&SignatureDatabase.__generate_signature~   sƒ   € ð �{‰{˜6 F¨ZÑ$7Ð8ˆàŸ(™(¸TÖ#B¸ F¬S°«V£OÒ#BÓCˆà�dŠ?Ø‰GàˆGà Ò%Ø!'Ñà!(Ðøò ÚÚÚð	
ˆ	ð Ðùò' $Cs   ¢A#c                 óˆ   — | j                  |||«      }|r(|dk(  r|D �cg c]  }|d   |d   d   f‘Œ c}S |d   d   S yc c}w )a  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   r.   r   r   ÚmatchesÚmatchs         r   rK   zSignatureDatabase.match™   s`   € ð —,‘,˜r 7Ð,>Ó?ˆñ
 Ø˜%Òð ?FÖF°U˜˜q™ 5¨¡8¨B¡<Ò0ÒFÐFà˜1‘:˜b‘>Ð!àùò	 Gs   Ÿ?c                 óF   — | j                  |||«      }|r|dk(  r|S |d   S y)z+Matches and returns all the likely matches.Fr   NrH   )r   r.   r   r   rJ   s        r   Ú	match_allzSignatureDatabase.match_all²   s6   € ð —,‘,˜r 7Ð,>Ó?ˆáØ˜%Òð �à˜1‘:Ðàr   c                 ó@  — |du r=	 |j                   }| j                  }|j                  D �cg c]  }|j                  ‘Œ }}ng|du r7	 |j                  «       }| j                  }|j                  j                  }	|	g}n,|j                   }| j                  }t        t        |«      «      }g }
|D ]:  }| j                  ||||| j                  z    «      }|sŒ(|
j                  ||f«       Œ< |du r|
r|
d   S |
S # t        $ r}‚ d }~ww xY wc c}w # t        $ r}‚ d }~ww xY w)NTr   )rA   Ú	Exceptionr   r$   r&   Úget_memory_mapped_imager   r9   r:   r   Úranger'   Ú(_SignatureDatabase__match_signature_treer   r,   )r   r.   r   r   r   ÚexcpÚ
signaturesr2   Úscan_addressesÚeprJ   r1   Úresults                r   Ú__matchzSignatureDatabase.__matchÂ   sJ  € ð  Ñ%ð
Ø—{‘{�ð ×:Ñ:ˆJð GIÇkÁkÖR¸7˜g×6Ó6ÐRˆNÑRà˜‰_ð
Ø×1Ñ1Ó3�ð ×8Ñ8ˆJð
 ×#Ñ#×7Ñ7ˆBð !˜T‰Nð —;‘;ˆDà×9Ñ9ˆJä"¤3 t£9Ó-ˆNð ˆØ!ò 	.ˆCØ×0Ñ0Ø˜D  s¨T¯^©^Ñ';Ð<óˆFò Ø—‘  V˜}Õ-ð	.ð �d‰?ÙØ˜q‘zÐ!àˆøôy ò Øûðüò Søô ò Øûðús4   †C7 ¬D	ÁD Ã7	DÄ DÄDÄ	DÄDÄDc                 óê   — |}dg}|du r| j                   }n|du r| j                  }g }|D ]:  }| j                  |||| j                  z    «      }	|	sŒ(|j	                  ||	f«       Œ< |du r|r|d   S |S )Nr   T)r   r   rR   r   r,   )
r   Ú	code_datar   r   r   rU   rT   rJ   r1   rW   s
             r   Ú
match_datazSignatureDatabase.match_data  s¦   € àˆØ˜ˆð  Ñ%ð ×:Ñ:‰Jð
 ˜‰_ð ×8Ñ8ˆJð ˆØ!ò 	.ˆCØ×0Ñ0Ø˜D  s¨T¯^©^Ñ';Ð<óˆFò Ø—‘  V˜}Õ-ð	.ð �d‰?ÙØ˜q‘zÐ!àˆr   c           	      ó  — t        «       }|}t        |D �cg c]  }t        |t        «      r|n
t	        |«      ‘Œ! c}«      D ]Ó  \  }}|€ nÌ|j                  |d«      }	dt        |j                  «       «      v rSt        «       }
t        |j                  «       «      D ]  }|d   �Œ	|
j                  |d   «       Œ |j                  |
«       d|v rD|j                  dd«      }||dz   d }|r(|j                  | j                  ||||z   dz   «      «       |	}ŒÕ |�ndt        |j                  «       «      v rSt        «       }
t        |j                  «       «      D ]  }|d   �Œ	|
j                  |d   «       Œ |j                  |
«       |S c c}w )a
  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ÚintrB   ÚgetÚvaluesÚitemsr,   ÚextendrR   )r   Úsignature_treer   ÚdepthÚmatched_namesrK   Úbr1   ÚbyteÚ
match_nextÚnamesÚitemÚmatch_tree_alternateÚdata_remainings                 r   Ú__match_signature_treez(SignatureDatabase.__match_signature_tree9  s™  € ô ›ˆØˆô
 #ÐQUÖ#VÈA¬°A´sÔ);¡AÄÀQÃÑ$GÒ#VÓWò +	‰IˆC�ð ˆ}Ùð Ÿ™ 4¨Ó.ˆJð ”t˜EŸL™L›NÓ+Ñ+ô ›�ô ! §¡£Ó/ò .�DØ˜A‘w‘ØŸ™ T¨!¡WÕ-ð.ð ×$Ñ$ UÔ+ð
 �u‰}Ø',§y¡y°°tÓ'<Ð$Ø!% c¨A¡g i �Ù!Ø!×(Ñ(Ø×3Ñ3Ø0°.À#ÈÁ+ÐPQÁ/óôð ‰EðW+	ð` Ð ¬¨e¯l©l«nÓ)=Ñ!=ä“FˆEÜ˜UŸ[™[›]Ó+ò *�Ø˜‘7‘?Ø—L‘L  a¡Õ)ð*ð × Ñ  Ô'àÐùòq $Ws   –$F	c                 ó*   — | j                  ||¬«       y)znLoad a PEiD signature file.

        Invoking this method on different files combines the signatures.
        r   N)r   r   s      r   ÚloadzSignatureDatabase.load�  s   € ð 	�‰˜X¨DˆÕ1r   c                 ó¤  — |�Žt         j                  j                  |«      sA	 t        j                  j                  |«      }|j                  «       }|j                  «        n0	 t        |d«      }|j                  «       }|j                  «        n|}|sy d„ }| j                  j                  |«      }|D �]v  \  }}}	}
}|
j                  «       j                  «       }
|j                  dd«      j                  «       }|j                  «       D �cg c]
  } ||«      ‘Œ }}|
dk(  rd}
nd}
|dk(  rd}nd}d}|du r"| j                   }| xj"                  d	z  c_        nG|
du r"| j$                  }| xj&                  d	z  c_        n!| j(                  }| xj*                  d	z  c_        t-        |«      D ]c  \  }}|d	z   t/        |«      k(  r&|j1                  |t3        «       «      ||<   d ||   |<   n|j1                  |t3        «       «      ||<   ||   }|d	z  }Œe || j4                  kD  s�Œp|| _        �Œy y # t        $ r ‚ w xY w# t        $ r ‚ w xY wc c}w )
NÚrtc                 ó&   — d| v r| S t        | d«      S )Nú?é   )r^   )Úvalues    r   Úto_bytez)SignatureDatabase.__load.<locals>.to_byte«  s   € Ø�e‰|Ø�Ü�u˜b“>Ð!r   z\nr   r>   TFr   r   )ÚosÚpathÚexistsÚurllibÚrequestÚurlopenÚreadÚcloseÚOSErrorÚopenr   ÚfindallÚstripÚlowerÚreplaceÚsplitr   r   r   r   r   r   r#   r'   r_   r   r   )r   r   r   Úsig_fÚsig_datarv   rJ   Úpacker_namerD   Úsuperfluous_wildcardsr   r   rf   rC   rd   Útreer1   rg   s                     r   Ú__loadzSignatureDatabase.__load‰  sS  € àÐô —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ˆð ó6	'ñ 
ØØØ!ØØð —m‘m“o×+Ñ+Ó-ˆGà!×)Ñ)¨%°Ó4×:Ñ:Ó<ˆIà3<·?±?Ó3DÖE¨a™w q�zÐEˆ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�Ø˜‘
‘ðð �t—~‘~Ô%Ø!&�–ñm6	'øôI ò àðûô ò àðüòL Fs   £?H1 Á$,H? ÄIÈ1H<È?I
)NN)é   )FFrŒ   )TF)r   )Ú__name__Ú
__module__Ú__qualname__Ú__doc__r   r6   r;   r-   rK   rM   rI   r[   rR   ro   r   © r   r   r   r      sM   „ ñó" 2óD$4óL
ð UXóó6ó2ò IóV*óXFóP2ôd'r   r   c                  ó   — y)r   Nr‘   )r.   s    r   Úis_validr“   ð  s   € àr   c                 ój  — d}d}t        | d«      r�| j                  D ]~  }d}|j                  D ]k  }|j                  | j                  j
                  cxk  r|j                  dz   k  rn nd}|� ||j                  cxk  r|dz   k  rn n|dz  }|j                  }Œm Œ€ d}| j                  «       }|r| y)zp
    unusual locations of import tables
    non recognized section names
    presence of long ASCII strings
    Fr   ÚDIRECTORY_ENTRY_BASERELOCNé   Tr   )Úhasattrr•   ÚentriesÚrvar9   r:   Úget_warnings)r.   Ú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à%¨Ñ*Ð%à!&§¡‘ñ
+ð	+ð& #Ðð �‰Ó €HÙÙð 	r   c                 óä   — t        | j                  «       «      }|syd}d}| j                  D ]6  }|j                  «       }t        |j	                  «       «      }|dkD  sŒ2||z  }Œ8 ||z  dkD  rd}|S )a8  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)r.   Útotal_pe_data_lengthÚ)has_significant_amount_of_compressed_dataÚtotal_compressed_datar2   Ú	s_entropyÚs_lengths          r   Úis_probably_packedr¬   +  sŒ   € ô ˜rŸw™w›y›>ÐáØØ05Ð-ð
 ÐØ—;‘;ò .ˆØ×'Ñ'Ó)ˆ	Ü�w×'Ñ'Ó)Ó*ˆð �s‹?Ø! XÑ-Ñ!ð.ð 	Ð 4Ñ4¸Ò;Ø48Ð1à4Ð4r   )r�   rw   r	   r*   Úurllib.errorrz   Úurllib.parseÚurllib.requestÚpefileÚ
__author__Ú__version__Ú__contact__r   r“   r¢   r¬   r‘   r   r   ú<module>r´      sS   ðñó 
Û 	Û Û Û Û ã à€
Ø× Ñ €Ø%€÷V'ñ V'òr	ò
3	ól!5r   