pefile è un modulo Python per leggere e lavorare con i file PE (Portable Executable)
pefile è un modulo Python multipiattaforma per analizzare e lavorare con i file Portable Executable (PE). La maggior parte delle informazioni contenute nelle intestazioni dei file PE è accessibile, così come tutti i dettagli e i dati delle sezioni.
Le strutture definite nei file di intestazione di Windows saranno accessibili come attributi nell'istanza PE. La denominazione dei campi/attributi cercherà di aderire allo schema di denominazione di tali intestazioni. Solo le scorciatoie aggiunte per comodità si discosteranno da tale convenzione.
pefile richiede una comprensione di base della struttura di un file PE — con essa, è possibile esplorare quasi ogni singola caratteristica del formato di file PE.
Per installare pefile tramite pip:
pip3 install pefile
questo repository contiene un ampio corpus di test compresso, e la sua cronologia git conserva versioni precedenti di tale corpus. Un clone completo può quindi essere molto più grande della libreria stessa. Usa l'installazione tramite pip sopra riportata se hai bisogno solo della libreria.
per lavorare sul codice sorgente senza scaricare il corpus di test o la sua cronologia:
git clone --depth 1 --filter=blob:none --sparse https://github.com/erocarrera/pefile.git
cd pefile
git sparse-checkout set ordlookup
questo effettua il checkout della libreria e delle sue tabelle di ricerca ordinale. per includere i test, esegui git sparse-checkout set ordlookup tests; questo scarica anche il vasto corpus di test. --depth 1 omette la cronologia precedente, e i cloni filtrati scaricano contenuti aggiuntivi dei file quando necessario.
Alcune delle attività che pefile rende possibili sono:
Consulta gli Esempi di utilizzo per alcuni frammenti di codice che mostrano come usare pefile.
Ecco alcuni esempi di come appare un dump prodotto con pefile per diversi tipi di file:
Per lavorare con binari autenticati, incluse le firme Authenticode, consulta il progetto verify-sigs.
pefile viene eseguito in diverse pipeline che scansionano centinaia di migliaia di nuovi file PE ogni giorno e, pur non essendo perfetto, è diventato piuttosto robusto nel tempo. Detto ciò, di tanto in tanto vengono scoperti piccoli difetti. Se ti imbatti in un PE che non sembra essere elaborato correttamente, segnalalo, per favore! Aiuterà a rendere pefile un po' più potente.
pefile è autonomo. Il modulo non ha dipendenze; è indipendente dall'endianness; e funziona su Windows, macOS e Linux.
Il test runner si trova in tests/pefile_test.py. I suoi campioni PE e i dump attesi provengono dal repository separato pefile-tests. Clona quel repository in pefile-tests/ nella radice di questo checkout, poi esegui:
python -m pip install -e ".[dev]"
python -m pytest tests
CI estrae il corpus nella stessa posizione ed esegue questo modulo di test tramite tox. Il corpus rimane nel proprio repository, così i campioni binari e i dump attesi possono essere aggiornati in modo indipendente.
PDF di poster che illustrano il formato dei file PE:
I seguenti link forniscono informazioni dettagliate sul formato PE e sulle sue strutture.