Copyright 2011-2026 Google LLC.

BinDiff

Este repositório contém o código-fonte do BinDiff. O BinDiff é uma ferramenta de comparação de código aberto para ficheiros binários que permite encontrar rapidamente diferenças e semelhanças em código desassemblado.

Table of Contents

• Sobre o BinDiff
• Início Rápido
• Documentação
• Mapa de Código
• Construir a partir do Código Fonte
• Licença
• Como Participar

About BinDiff

BinDiff é uma ferramenta de comparação de código aberto para ficheiros binários, que ajuda investigadores e engenheiros de vulnerabilidades a encontrar rapidamente diferenças e semelhanças em código desassemblado.

Com o BinDiff, os investigadores podem identificar e isolar correções para vulnerabilidades em patches fornecidos por fornecedores. Também pode ser usado para transferir símbolos e comentários entre desassemblagens de múltiplas versões do mesmo binário. Isto facilita o acompanhamento de alterações ao longo do tempo e permite que as organizações retenham resultados de análise e possibilita a transferência de conhecimento entre analistas de binários.

Casos de Uso

• Comparar ficheiros binários para x86, MIPS, ARM, PowerPC e outras arquiteturas suportadas por desassembladores populares.
• Identificar funções idênticas e semelhantes em diferentes binários
• Transferir nomes de funções, comentários e nomes locais de uma desassemblagem para outra
• Detetar e realçar alterações entre duas variantes da mesma função

Quickstart

Se quiser apenas começar a usar o BinDiff, descarregue os pacotes de instalação pré-construídos a partir da página de lançamentos.

Nota: O BinDiff depende de um desassemblador separado. De fábrica, ele vem com suporte para IDA Pro, Binary Ninja e Ghidra. A página de desassembladores lista as configurações suportadas.

Documentation

Um subconjunto do manual existente está disponível no diretório docs/.

Codemap

O BinDiff contém os seguintes componentes:

• cmake - Ficheiros de compilação CMake que declaram dependências externas
• fixtures - Uma coleção de ficheiros de teste para exercitar o motor principal do BinDiff
• ida - Integração com o desassemblador IDA Pro
• java - Código-fonte Java. Contém a interface de utilizador de diff visual do BinDiff e a sua biblioteca de utilitários correspondente.
• match - Algoritmos de correspondência para o motor principal do BinDiff
• packaging - Fontes de pacotes para os pacotes de instalação
• tools - Executáveis auxiliares que são enviados com o produto

Building from Source

As instruções abaixo devem ser suficientes para construir tanto o código nativo como os componentes baseados em Java.

Instruções de construção mais detalhadas serão adicionadas numa data posterior. Isto inclui Dockerfiles pré-construídos e scripts para construir os pacotes de instalação.

Código nativo

O BinDiff usa CMake para gerar os seus ficheiros de compilação para os componentes que consistem em código C++ nativo.

As seguintes dependências de compilação são necessárias:

• BinExport 12, o plugin companheiro do BinDiff que também contém muito código partilhado
• Boost 1.83.0 ou superior (uma cópia parcial do 1.83.0 acompanha o BinExport e será usada automaticamente)
• CMake 3.14 ou superior
• Ninja para compilações rápidas
• GCC 15 ou uma versão recente do Clang no Linux/macOS. No Windows, use o compilador Visual Studio 2022 e o Windows SDK para Windows 11.
• Git 1.8 ou superior
• Dependências que serão descarregadas:
  • Abseil, GoogleTest, Protocol Buffers (3.14) e SQLite3
  • SDK do Binary Ninja
  • IDA SDK

Os passos gerais de compilação são os mesmos no Windows, Linux e macOS. O seguinte mostra os comandos para Linux.

De seguida, configure o diretório de compilação e gere os ficheiros de compilação:

cmake -S . -B build -G Ninja -DCMAKE_BUILD_TYPE=Release

Finalmente, invoque a compilação propriamente dita. Os binários serão colocados em build/:

cmake --build build --config Release
(cd build; ctest --build-config Release --output-on-failure)
cmake --install build --config Release

Construir sem IDA

Para construir sem IDA, simplesmente altere o passo de configuração acima para

cmake -S . -B build/out -G Ninja -DCMAKE_BUILD_TYPE=Release \
  -DBINEXPORT_ENABLE_IDAPRO=OFF

GUI Java e yFiles

Construir a GUI baseada em Java requer a biblioteca comercial de visualização de grafos de terceiros yFiles para exibição e layout de grafos. Esta biblioteca é imensamente poderosa e não é facilmente substituível.

Para construir, o BinDiff usa Gradle 6.x e Java 11 LTS. Consulte o seu guia de instalação para instruções sobre como instalar.

Assumindo que é um detentor de licença yFiles, defina a variável de ambiente YFILES_DIR para um diretório que contenha os ficheiros y.jar e ysvg.jar do yFiles.

Nota: O BinDiff ainda usa o ramo mais antigo 2.x do yFiles.

Depois invoque o Gradle para descarregar dependências externas e construir:

Windows:

set YFILES_DIR=<path\to\yfiles_2.17>
cd java
gradle shadowJar

Linux ou macOS:

export YFILES_DIR=<path/to/yfiles_2.17>
cd java
gradle shadowJar

Posteriormente, o diretório ui/build/libs no subdiretório java deve conter o artefacto auto-contido bindiff-ui-all.jar, que pode ser executado usando o comando padrão java -jar.

Leitura adicional / Ferramentas semelhantes

Os artigos originais que descrevem as ideias gerais por trás do BinDiff:

• Thomas Dullien and Rolf Rolles. Graph-Based Comparison of Executable Objects. bindiffsstic05-1.pdf. SSTIC ’05, Symposium sur la Sécurité des Technologies de l’Information et des Communications. 2005.
• Halvar Flake. Structural Comparison of Executable Objects. dimva_paper2.pdf. pp 161-173. Detection of Intrusions and Malware & Vulnerability Assessment. 2004.3-88579-375-X.

Outras ferramentas no mesmo espaço de problema:

• Diaphora, uma ferramenta avançada de diffing de programas que implementa muitas das mesmas ideias.
• TurboDiff, um plugin de diffing de programas agora extinto para IDA Pro.

Projetos que usam BinDiff:

• VxSig, uma ferramenta para gerar automaticamente assinaturas de bytes de antivírus a partir de conjuntos de binários semelhantes.

License

O BinDiff está licenciado sob os termos da licença Apache. Consulte LICENSE para mais informações.

Getting Involved