Aviso

O projeto RetDec está atualmente em um modo de manutenção limitada devido à falta de recursos:

• Pull Requests são bem-vindos. Eles são revisados com prioridade, se possível sem atrasos.
• As issues são respondidas com atrasos de até um trimestre. As issues não são resolvidas ativamente, a menos que estejam relacionadas à manutenção básica do projeto.
• A manutenção básica do projeto continua.
• Apenas um desenvolvimento muito limitado está sendo realizado.

RetDec

))/statusIcon)

RetDec é um descompilador de código de máquina reorientável baseado no LLVM.

O descompilador não está limitado a nenhuma arquitetura de destino, sistema operacional ou formato de arquivo executável específico:

• Formatos de arquivo suportados: ELF, PE, Mach-O, COFF, AR (arquivo), Intel HEX e código de máquina bruto
• Arquiteturas suportadas:
  • 32 bits: Intel x86, ARM, MIPS, PIC32 e PowerPC
  • 64 bits: x86-64, ARM64 (AArch64)

Recursos:

• Análise estática de arquivos executáveis com informações detalhadas.
• Detecção de compiladores e empacotadores.
• Carregamento e decodificação de instruções.
• Remoção baseada em assinaturas de código de biblioteca vinculado estaticamente.
• Extração e utilização de informações de depuração (DWARF, PDB).
• Reconstrução de expressões idiomáticas de instruções.
• Detecção e reconstrução de hierarquias de classes C++ (RTTI, vtables).
• Desofuscação de símbolos de binários C++ (GCC, MSVC, Borland).
• Reconstrução de funções, tipos e construções de alto nível.
• Desmontador integrado.
• Saída em duas linguagens de alto nível: C e uma linguagem semelhante a Python.
• Geração de grafos de chamada, grafos de fluxo de controle e várias estatísticas.

Para mais informações, confira nosso

• Wiki (em andamento)
• Palestra Botconf 2017: slides, vídeo
• Palestra REcon Montreal 2018: slides
• Publicações

Instalação

Existem duas maneiras de obter e instalar o RetDec:

1. Baixe e descompacte um pacote pré-construído estável ou bleeding-edge e siga as instruções na seção Uso do arquivo retdec/share/retdec/README.md após descompactar.
2. Construa o RetDec por conta própria a partir das fontes seguindo a seção Construção e Instalação. Após a instalação, siga as instruções abaixo.

Atualmente, oferecemos suporte ao Windows (7 ou superior), Linux, macOS e (experimentalmente) FreeBSD. Uma versão instalada do RetDec requer aproximadamente 5 a 6 GB de espaço livre em disco.

Uso

Por favor, certifique-se de estar lendo as instruções correspondentes à versão do RetDec utilizada. Em caso de dúvida, consulte o arquivo retdec/share/retdec/README.md na instalação.

Windows

1. Após instalar o RetDec, instale o Microsoft Visual C++ Redistributable para Visual Studio 2017.

2. Instale os seguintes programas:

   • UPX (Opcional: se desejar usar o desempacotador UPX na etapa de pré-processamento)
   • Graphviz (Opcional: se desejar gerar grafos de chamada ou fluxo de controle)

3. Para descompilar um arquivo binário chamado test.exe, execute

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

   Para mais informações, execute retdec-decompiler.exe com --help.

Linux

1. Após instalar o RetDec, instale os seguintes pacotes através do gerenciador de pacotes da sua distribuição:

   • UPX (Opcional: se desejar usar o desempacotador UPX na etapa de pré-processamento)
   • Graphviz (Opcional: se desejar gerar grafos de chamada ou fluxo de controle)

2. Para descompilar um arquivo binário chamado test.exe, execute

   $RETDEC_INSTALL_DIR/bin/retdec-decompiler test.exe
   

   Para mais informações, execute retdec-decompiler com --help.

macOS

1. Após instalar o RetDec, instale os seguintes pacotes:

   • UPX (Opcional: se desejar usar o desempacotador UPX na etapa de pré-processamento)
   • Graphviz (Opcional: se desejar gerar grafos de chamada ou fluxo de controle)

2. Para descompilar um arquivo binário chamado test.exe, execute

   $RETDEC_INSTALL_DIR/bin/retdec-decompiler test.exe
   

   Para mais informações, execute retdec-decompiler com --help.

FreeBSD (Experimental)

1. Atualmente, não existem pacotes "ports" pré-construídos para FreeBSD. Você terá que construir e instalar o descompilador por conta própria. O processo está descrito abaixo.

2. Para descompilar um arquivo binário chamado test.exe, execute

   $RETDEC_INSTALL_DIR/bin/retdec-decompiler test.exe
   

   Para mais informações, execute retdec-decompiler com --help.

Uso das bibliotecas do RetDec

Você pode usar facilmente várias bibliotecas do RetDec em seus projetos - se eles forem construídos com CMake. A instalação do RetDec contém todos os cabeçalhos, bibliotecas e scripts CMake necessários.

Se você instalou o RetDec em um local de instalação padrão do seu sistema (por exemplo, /usr, /usr/local), tudo o que você precisa fazer para usar seus componentes é:```cmake find_package(retdec 5.0 REQUIRED COMPONENTS [...] ) target_link_libraries(your-project PUBLIC retdec:: [...] )

Se você não instalou o RetDec em um local onde ele possa ser descoberto automaticamente, você precisa ajudar o CMake a encontrá-lo antes que `find_package()` seja usado. Geralmente, há duas maneiras de fazer isso (escolha e use apenas uma):

1. Adicione o diretório de instalação do 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. Defina o caminho para os scripts CMake instalados do RetDec como `retdec_DIR`:
    ```cmake
    set(retdec_DIR ${RETDEC_INSTALL_DIR}/share/retdec/cmake)
    ```

Veja a página wiki [Repository Overview](https://github.com/avast/retdec/wiki/Repository-Overview) para a lista de componentes disponíveis do RetDec, ou o [retdec-build-system-tests](https://github.com/avast/retdec-build-system-tests) para demonstrações de como usá-los.

## Construção e Instalação

Esta seção descreve uma construção e instalação local do RetDec. As instruções para Docker são fornecidas na próxima seção.

### Requisitos

#### Linux