Avviso

Il progetto RetDec è attualmente in modalità di manutenzione limitata a causa della mancanza di risorse:

• Le Pull Request sono benvenute. Vengono revisionate con priorità, se possibile senza ritardi.
• Le segnalazioni (issues) vengono gestite con ritardi fino a un trimestre. Le segnalazioni non vengono risolte attivamente a meno che non riguardino la manutenzione di base del progetto.
• La manutenzione di base del progetto continua.
• Viene portato avanti solo uno sviluppo molto limitato.

RetDec

))/statusIcon)

RetDec è un decompilatore di codice macchina retargetable basato su LLVM.

Il decompilatore non è limitato a nessuna architettura target, sistema operativo o formato di file eseguibile particolare:

• Formati di file supportati: ELF, PE, Mach-O, COFF, AR (archivio), Intel HEX e codice macchina grezzo
• Architetture supportate:
  • 32 bit: Intel x86, ARM, MIPS, PIC32 e PowerPC
  • 64 bit: x86-64, ARM64 (AArch64)

Caratteristiche:

• Analisi statica dei file eseguibili con informazioni dettagliate.
• Rilevamento del compilatore e del packer.
• Caricamento e decodifica delle istruzioni.
• Rimozione basata su firme del codice di libreria collegato staticamente.
• Estrazione e utilizzo delle informazioni di debug (DWARF, PDB).
• Ricostruzione di idiomi di istruzioni.
• Rilevamento e ricostruzione delle gerarchie di classi C++ (RTTI, vtables).
• Demangling dei simboli da binari C++ (GCC, MSVC, Borland).
• Ricostruzione di funzioni, tipi e costrutti di alto livello.
• Disassemblatore integrato.
• Output in due linguaggi di alto livello: C e un linguaggio simile a Python.
• Generazione di grafi delle chiamate, grafi di flusso di controllo e varie statistiche.

Per maggiori informazioni, consulta

• Wiki (in corso)
• Talk Botconf 2017: slides, video
• Talk REcon Montreal 2018: slides
• Pubblicazioni

Installazione

Ci sono due modi per ottenere e installare RetDec:

1. Scaricare e decomprimere un pacchetto pre-compilato stabile o bleeding-edge e seguire le istruzioni nella sezione Use del file retdec/share/retdec/README.md dopo averlo decompresso.
2. Compilare RetDec da soli dai sorgenti seguendo la sezione Build and Installation. Dopo l'installazione, seguire le istruzioni qui sotto.

Supportiamo attualmente Windows (7 o successivo), Linux, macOS e (sperimentalmente) FreeBSD. Una versione installata di RetDec richiede circa 5 a 6 GB di spazio libero su disco.

Utilizzo

Assicurati di leggere le istruzioni corrispondenti alla versione di RetDec utilizzata. In caso di dubbio, fai riferimento al file retdec/share/retdec/README.md nell'installazione.

Windows

1. Dopo aver installato RetDec, installa Microsoft Visual C++ Redistributable per Visual Studio 2017.

2. Installa i seguenti programmi:

   • UPX (Opzionale: se vuoi usare l'unpacker UPX nella fase di preprocessing)
   • Graphviz (Opzionale: se vuoi generare grafi delle chiamate o di flusso di controllo)

3. Per decompilare un file binario chiamato test.exe, esegui

   $RETDEC_INSTALL_DIR\bin\retdec-decompiler.exe test.exe
   

   Per maggiori informazioni, esegui retdec-decompiler.exe con --help.

Linux

1. Dopo aver installato RetDec, installa i seguenti pacchetti tramite il gestore pacchetti della tua distribuzione:

   • UPX (Opzionale: se vuoi usare l'unpacker UPX nella fase di preprocessing)
   • Graphviz (Opzionale: se vuoi generare grafi delle chiamate o di flusso di controllo)

2. Per decompilare un file binario chiamato test.exe, esegui

   $RETDEC_INSTALL_DIR/bin/retdec-decompiler test.exe
   

   Per maggiori informazioni, esegui retdec-decompiler con --help.

macOS

1. Dopo aver installato RetDec, installa i seguenti pacchetti:

   • UPX (Opzionale: se vuoi usare l'unpacker UPX nella fase di preprocessing)
   • Graphviz (Opzionale: se vuoi generare grafi delle chiamate o di flusso di controllo)

2. Per decompilare un file binario chiamato test.exe, esegui

   $RETDEC_INSTALL_DIR/bin/retdec-decompiler test.exe
   

   Per maggiori informazioni, esegui retdec-decompiler con --help.

FreeBSD (Sperimentale)

1. Attualmente non ci sono pacchetti "ports" pre-compilati per FreeBSD. Dovrai compilare e installare il decompilatore da solo. Il processo è descritto di seguito.

2. Per decompilare un file binario chiamato test.exe, esegui

   $RETDEC_INSTALL_DIR/bin/retdec-decompiler test.exe
   

   Per maggiori informazioni, esegui retdec-decompiler con --help.

Utilizzo delle librerie RetDec

Puoi facilmente utilizzare varie librerie RetDec nei tuoi progetti - se sono compilate con CMake. L'installazione di RetDec contiene tutti gli header, le librerie e gli script CMake necessari.

Se hai installato RetDec in una posizione di installazione standard del tuo sistema (es. /usr, /usr/local), tutto ciò che devi fare per usare i suoi componenti è:```cmake find_package(retdec 5.0 REQUIRED COMPONENTS [...] ) target_link_libraries(your-project PUBLIC retdec:: [...] )

Se non hai installato RetDec in un luogo in cui possa essere scoperto automaticamente, devi aiutare CMake a trovarlo prima di utilizzare `find_package()`. Ci sono generalmente due modi per farlo (scegline e usa solo uno):

1. Aggiungi la directory di installazione di RetDec a [`CMAKE_PREFIX_PATH`](https://cmake.org/cmake/help/latest/variable/CMAKE_PREFIX_PATH.html):
    ```cmake
    list(APPEND CMAKE_PREFIX_PATH ${RETDEC_INSTALL_DIR})
    ```

2. Imposta il percorso degli script CMake di RetDec installati su `retdec_DIR`:
    ```cmake
    set(retdec_DIR ${RETDEC_INSTALL_DIR}/share/retdec/cmake)
    ```

Consulta la pagina wiki [Repository Overview](https://github.com/avast/retdec/wiki/Repository-Overview) per l'elenco dei componenti RetDec disponibili, o [retdec-build-system-tests](https://github.com/avast/retdec-build-system-tests) per esempi su come utilizzarli.

## Compilazione e Installazione

Questa sezione descrive una compilazione e installazione locale di RetDec. Le istruzioni per Docker sono fornite nella sezione successiva.

### Requisiti

#### Linux