Advertencia

El proyecto RetDec se encuentra actualmente en un modo de mantenimiento limitado debido a la falta de recursos:

• Se aceptan Pull Requests. Se revisan con prioridad, si es posible sin demoras.
• Los Issues se atienden con demoras de hasta un trimestre. Los Issues no se resuelven activamente a menos que estén relacionados con el mantenimiento básico del proyecto.
• El mantenimiento básico del proyecto continúa.
• Solo se lleva a cabo un desarrollo muy limitado.

RetDec

))/statusIcon)

RetDec es un descompilador de código máquina reorientable basado en LLVM.

El descompilador no se limita a ninguna arquitectura de destino, sistema operativo o formato de archivo ejecutable en particular:

• Formatos de archivo admitidos: ELF, PE, Mach-O, COFF, AR (archivo), Intel HEX y código máquina sin procesar.
• Arquitecturas admitidas:
  • 32 bits: Intel x86, ARM, MIPS, PIC32 y PowerPC
  • 64 bits: x86-64, ARM64 (AArch64)

Características:

• Análisis estático de archivos ejecutables con información detallada.
• Detección de compiladores y empaquetadores.
• Carga y decodificación de instrucciones.
• Eliminación basada en firmas de código de biblioteca enlazado estáticamente.
• Extracción y utilización de información de depuración (DWARF, PDB).
• Reconstrucción de modismos de instrucciones.
• Detección y reconstrucción de jerarquías de clases de C++ (RTTI, tablas virtuales).
• Desmangling de símbolos de binarios C++ (GCC, MSVC, Borland).
• Reconstrucción de funciones, tipos y constructos de alto nivel.
• Desensamblador integrado.
• Salida en dos lenguajes de alto nivel: C y un lenguaje similar a Python.
• Generación de grafos de llamadas, grafos de flujo de control y varias estadísticas.

Para obtener más información, consulte:

• Wiki (en progreso)
• Charla en Botconf 2017: diapositivas, video
• Charla en REcon Montreal 2018: diapositivas
• Publicaciones

Instalación

Hay dos formas de obtener e instalar RetDec:

1. Descargar y descomprimir un paquete precompilado estable o en desarrollo (bleeding-edge) y seguir las instrucciones en la sección Uso de su archivo retdec/share/retdec/README.md después de descomprimirlo.
2. Compilar RetDec usted mismo a partir del código fuente siguiendo la sección Compilación e instalación. Después de la instalación, siga las instrucciones a continuación.

Actualmente soportamos Windows (7 o posterior), Linux, macOS y (experimentalmente) FreeBSD. Una versión instalada de RetDec requiere aproximadamente 5 a 6 GB de espacio libre en disco.

Uso

Asegúrese de leer las instrucciones correspondientes a la versión de RetDec que utiliza. En caso de duda, consulte el archivo retdec/share/retdec/README.md en la instalación.

Windows

1. Después de instalar RetDec, instale Microsoft Visual C++ Redistributable para Visual Studio 2017.

2. Instale los siguientes programas:

   • UPX (Opcional: si desea usar el desempacador UPX en la etapa de preprocesamiento)
   • Graphviz (Opcional: si desea generar grafos de llamadas o de flujo de control)

3. Para descompilar un archivo binario llamado test.exe, ejecute

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

   Para más información, ejecute retdec-decompiler.exe con --help.

Linux

1. Después de instalar RetDec, instale los siguientes paquetes mediante el administrador de paquetes de su distribución:

   • UPX (Opcional: si desea usar el desempacador UPX en la etapa de preprocesamiento)
   • Graphviz (Opcional: si desea generar grafos de llamadas o de flujo de control)

2. Para descompilar un archivo binario llamado test.exe, ejecute

   $RETDEC_INSTALL_DIR/bin/retdec-decompiler test.exe
   

   Para más información, ejecute retdec-decompiler con --help.

macOS

1. Después de instalar RetDec, instale los siguientes paquetes:

   • UPX (Opcional: si desea usar el desempacador UPX en la etapa de preprocesamiento)
   • Graphviz (Opcional: si desea generar grafos de llamadas o de flujo de control)

2. Para descompilar un archivo binario llamado test.exe, ejecute

   $RETDEC_INSTALL_DIR/bin/retdec-decompiler test.exe
   

   Para más información, ejecute retdec-decompiler con --help.

FreeBSD (Experimental)

1. Actualmente no hay paquetes "ports" precompilados para FreeBSD. Tendrá que compilar e instalar el descompilador por su cuenta. El proceso se describe a continuación.

2. Para descompilar un archivo binario llamado test.exe, ejecute

   $RETDEC_INSTALL_DIR/bin/retdec-decompiler test.exe
   

   Para más información, ejecute retdec-decompiler con --help.

Uso de las bibliotecas de RetDec

Puede usar fácilmente varias bibliotecas de RetDec en sus proyectos, siempre que estén compiladas con CMake. La instalación de RetDec contiene todos los encabezados, bibliotecas y scripts de CMake necesarios.

Si instaló RetDec en una ubicación de instalación estándar de su sistema (por ejemplo, /usr, /usr/local), todo lo que necesita hacer para usar sus componentes es:```cmake find_package(retdec 5.0 REQUIRED COMPONENTS [...] ) target_link_libraries(your-project PUBLIC retdec:: [...] )

Si no instaló RetDec en algún lugar donde pueda ser descubierto automáticamente, necesita ayudar a CMake a encontrarlo antes de usar `find_package()`. Generalmente hay dos formas de hacerlo (elija y use solo una):

1. Agregue el directorio de instalación de 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. Establezca la ruta a los scripts CMake de RetDec instalados en `retdec_DIR`:
    ```cmake
    set(retdec_DIR ${RETDEC_INSTALL_DIR}/share/retdec/cmake)
    ```

Vea la página wiki de [Resumen del Repositorio](https://github.com/avast/retdec/wiki/Repository-Overview) para la lista de componentes disponibles de RetDec, o [retdec-build-system-tests](https://github.com/avast/retdec-build-system-tests) para demostraciones sobre cómo usarlos.

## Compilación e Instalación

Esta sección describe la compilación e instalación local de RetDec. Las instrucciones para Docker se dan en la siguiente sección.

### Requisitos

#### Linux