Avertissement

Le projet RetDec est actuellement en mode maintenance limité en raison d'un manque de ressources :

• Les Pull Requests sont les bienvenues. Elles sont examinées en priorité, si possible sans délais.
• Les issues reçoivent une réponse avec des délais pouvant aller jusqu'à un trimestre. Les issues ne sont pas activement résolues sauf si elles concernent la maintenance de base du projet.
• La maintenance de base du projet se poursuit.
• Seul un développement très limité est effectué.

RetDec

))/statusIcon)

RetDec est un désassembleur de code machine reconfigurable basé sur LLVM.

Le désassembleur n'est pas limité à une architecture cible, un système d'exploitation ou un format de fichier exécutable particulier :

• Formats de fichiers pris en charge : ELF, PE, Mach-O, COFF, AR (archive), Intel HEX et code machine brut
• Architectures prises en charge :
  • 32 bits : Intel x86, ARM, MIPS, PIC32 et PowerPC
  • 64 bits : x86-64, ARM64 (AArch64)

Fonctionnalités :

• Analyse statique des fichiers exécutables avec des informations détaillées.
• Détection de compilateurs et de packers.
• Chargement et décodage d'instructions.
• Suppression basée sur les signatures du code de bibliothèque lié statiquement.
• Extraction et utilisation des informations de débogage (DWARF, PDB).
• Reconstruction des idiomes d'instructions.
• Détection et reconstruction des hiérarchies de classes C++ (RTTI, vtables).
• Démangling des symboles des binaires C++ (GCC, MSVC, Borland).
• Reconstruction des fonctions, types et constructions de haut niveau.
• Désassembleur intégré.
• Sortie dans deux langages de haut niveau : C et un langage de type Python.
• Génération de graphes d'appels, de graphes de flot de contrôle et de diverses statistiques.

Pour plus d'informations, consultez :

• Wiki (en cours)
• Conférence Botconf 2017 : diapositives, vidéo
• Conférence REcon Montreal 2018 : diapositives
• Publications

Installation

Il existe deux façons d'obtenir et d'installer RetDec :

1. Téléchargez et décompressez un package pré-construit stable ou bleeding-edge et suivez les instructions dans la section Utilisation de son fichier retdec/share/retdec/README.md après décompression.
2. Construisez RetDec vous-même à partir des sources en suivant la section Build and Installation. Après l'installation, suivez les instructions ci-dessous.

Nous supportons actuellement Windows (7 ou ultérieur), Linux, macOS et (expérimentalement) FreeBSD. Une version installée de RetDec nécessite environ 5 à 6 Go d'espace disque libre.

Utilisation

Assurez-vous de lire les instructions correspondant à la version de RetDec utilisée. En cas de doute, reportez-vous au fichier retdec/share/retdec/README.md dans l'installation.

Windows

1. Après installation de RetDec, installez Microsoft Visual C++ Redistributable for Visual Studio 2017.

2. Installez les programmes suivants :

   • UPX (Optionnel : si vous souhaitez utiliser le décompresseur UPX lors de l'étape de prétraitement)
   • Graphviz (Optionnel : si vous souhaitez générer des graphes d'appels ou de flot de contrôle)

3. Pour décompiler un fichier binaire nommé test.exe, exécutez

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

   Pour plus d'informations, exécutez retdec-decompiler.exe avec --help.

Linux

1. Après installation de RetDec, installez les paquets suivants via le gestionnaire de paquets de votre distribution :

   • UPX (Optionnel : si vous souhaitez utiliser le décompresseur UPX lors de l'étape de prétraitement)
   • Graphviz (Optionnel : si vous souhaitez générer des graphes d'appels ou de flot de contrôle)

2. Pour décompiler un fichier binaire nommé test.exe, exécutez

   $RETDEC_INSTALL_DIR/bin/retdec-decompiler test.exe
   

   Pour plus d'informations, exécutez retdec-decompiler avec --help.

macOS

1. Après installation de RetDec, installez les paquets suivants :

   • UPX (Optionnel : si vous souhaitez utiliser le décompresseur UPX lors de l'étape de prétraitement)
   • Graphviz (Optionnel : si vous souhaitez générer des graphes d'appels ou de flot de contrôle)

2. Pour décompiler un fichier binaire nommé test.exe, exécutez

   $RETDEC_INSTALL_DIR/bin/retdec-decompiler test.exe
   

   Pour plus d'informations, exécutez retdec-decompiler avec --help.

FreeBSD (expérimental)

1. Il n'existe actuellement aucun paquet ports pré-construit pour FreeBSD. Vous devrez construire et installer le désassembleur vous-même. Le processus est décrit ci-dessous.

2. Pour décompiler un fichier binaire nommé test.exe, exécutez

   $RETDEC_INSTALL_DIR/bin/retdec-decompiler test.exe
   

   Pour plus d'informations, exécutez retdec-decompiler avec --help.

Utilisation des bibliothèques RetDec

Vous pouvez facilement utiliser diverses bibliothèques RetDec dans vos projets - s'ils sont construits avec CMake. L'installation de RetDec contient tous les en-têtes, bibliothèques et scripts CMake nécessaires.

Si vous avez installé RetDec dans un emplacement d'installation standard de votre système (par exemple /usr, /usr/local), tout ce que vous devez faire pour utiliser ses composants est :```cmake find_package(retdec 5.0 REQUIRED COMPONENTS [...] ) target_link_libraries(your-project PUBLIC retdec:: [...] )

Si vous n'avez pas installé RetDec à un endroit où il peut être automatiquement découvert, vous devez aider CMake à le trouver avant que `find_package()` ne soit utilisé. Il existe généralement deux façons de procéder (choisissez-en une seule) :

1. Ajoutez le répertoire d'installation de RetDec à [`CMAKE_PREFIX_PATH`](https://cmake.org/cmake/help/latest/variable/CMAKE_PREFIX_PATH.html) :
    ```cmake
    list(APPEND CMAKE_PREFIX_PATH ${RETDEC_INSTALL_DIR})
    ```

2. Définissez le chemin vers les scripts CMake installés de RetDec dans `retdec_DIR` :
    ```cmake
    set(retdec_DIR ${RETDEC_INSTALL_DIR}/share/retdec/cmake)
    ```

Consultez la page wiki [Repository Overview](https://github.com/avast/retdec/wiki/Repository-Overview) pour la liste des composants RetDec disponibles, ou [retdec-build-system-tests](https://github.com/avast/retdec-build-system-tests) pour des démonstrations sur la façon de les utiliser.

## Compilation et installation

Cette section décrit une compilation et installation locale de RetDec. Les instructions pour Docker sont données dans la section suivante.

### Prérequis

#### Linux