BinDiffHelper

Extensão do Ghidra que usa o BinDiff no seu projeto Ghidra para encontrar funções correspondentes e renomeá-las automaticamente (BinDiff 6, 7, 8 suportados). Consulte o manual do BinDiff para ver como funciona e como ele faz a correspondência de funções / blocos básicos. No entanto, com esta extensão, o BinDiff é automatizado de dentro do Ghidra, então você não precisa fazer o diff dos seus binários manualmente.

Por favor, reporte bugs através do recurso de issues no github

Changelog

v0.7.1

• Atualização para Ghidra 12

v0.7.0 (versões do Ghidra >= 11.4)

• Sem alterações, exceto compatibilidade com a versão do Ghidra

v0.6.4 (versões do Ghidra < 11.4)

• Suporte à exportação de namespace
• Correção de travamento indefinido ao fazer diff

v0.6.3

• Permite ordenação da tabela

v0.6.2

• Correção de um bug em que o diff travava para sempre no BinDiff 8
• Ao clicar duas vezes em um símbolo, segui-lo tanto na listagem de código primária quanto na secundária

v0.6

• Atualização da biblioteca do driver sqlite, agora deve rodar em Apple silicon
• Suporte a diffs textuais externos entre funções descompiladas (veja https://github.com/ubfx/BinDiffHelper/pull/24)
• Atualizações de UI

v0.5

• Suporte ao BinDiff 8
• Lançamento para Ghidra 11.1

Alterações mais antigas

### v0.4.3 * Lançamento para Ghidra 11.0

v0.4.2

• Adiciona função para importar todas as funções (não apenas as marcadas na tabela)
• Adiciona função para alternar a caixa de seleção de múltiplos elementos na tabela
• Atualização para suportar Ghidra 10.3

v0.4.1

• Atualização para suportar Gradle 7.5 e Ghidra 10.1

v0.4.0

• Suporte ao BinDiff 7 e Ghidra 10

v0.3.2

• Correção de um bug em que o diff com um arquivo diferente do mesmo projeto não funcionava
• Correção de um bug em que arquivos com nomes curtos (< 3 caracteres>) não podiam ser comparados

v0.3.1

• Correção de um crash ao abrir um arquivo através da opção "from project"

v0.3

• Colore funções correspondentes na listagem
• Adiciona comentários às funções correspondentes na listagem com link para o outro binário
• Correção de um bug em que a biblioteca protobuf estava faltando em algumas builds
• Novo menu de carregamento de arquivo

v0.2

• Correção de um bug em que o arquivo de destino da importação precisava estar com checkout feito.
• Aumenta o tamanho do diálogo de seleção de arquivo do projeto

v0.1

• Faz o BinDiff do binário aberto no Ghidra com outro binário do mesmo projeto Ghidra, mostra os resultados e importa os nomes das funções
• Abre um arquivo BinDiff, criado com o BinDiff 6, a partir de dois arquivos .BinExport e importa os nomes das funções correspondentes no Ghidra

Como Instalar

Baixe o arquivo .zip da release, se for compatível com a sua versão do Ghidra, caso contrário veja Como compilar abaixo.

1. Abra o Ghidra
2. Na Main Window: Vá em File->Install Extensions...
3. Clique no botão + no canto superior direito e selecione o arquivo zip do BinDiffHelper
4. Feche o gerenciador de plugins. Reinicie o Ghidra para carregar o novo plugin
5. Veja Uso abaixo

Outras ferramentas recomendadas

• Plugin BinExport binários ou compilado a partir do código-fonte para a sua versão específica do Ghidra
• BinDiff (https://zynamics.com/software.html)

Sem esses, você só conseguirá importar arquivos .BinDiff e não exportar e fazer diff automaticamente a partir do seu projeto Ghidra

Uso

Certifique-se de que o plugin está carregado no Code Explorer abrindo um arquivo no Ghidra e, no Code Explorer, vá em File->Configure

Clique no pequeno ícone de plug no canto superior direito:

e certifique-se de que a caixa de seleção ao lado de BinDiffHelperPlugin está marcada.

Importar .BinDiff externo

Os arquivos .BinExport correspondentes precisam estar na mesma pasta.

Abra o arquivo no qual você deseja importar os nomes no code Browser, depois vá em Window->BinDiffHelper

Use o botão Open from BinDiff ou o item de menu e selecione o seu arquivo .BinDiff.

Selecione todos os nomes de funções que você deseja importar e clique no botão Import function names no canto superior direito ou no item de menu.

Comparar entre arquivos no projeto Ghidra

Vá em Window->BinDiffHelper, certifique-se de que não há avisos relacionados a BinExport ou BinDiff, depois clique no botão Open from project.

Selecione o outro arquivo na árvore e clique em OK.

Como compilar

Requisitos:

• Instalação do Ghidra (https://ghidra-sre.org) ou compilado a partir do código-fonte
• Algum jdk. Pode haver certas restrições dependendo de como o seu Ghidra foi compilado e quais outros plugins você está usando. Recomendo usar Temurin 21 LTS, pois atualmente parece funcionar tanto com BinExport quanto com BinDiffHelper.
• gradle (testado com 7.5, 8.10)

Clonar o repositório

Clone o repositório recursivamente, pois ele depende do BinExport para a definição de protocol buffer correspondente.

git clone --recurse-submodules https://github.com/ubfx/BinDiffHelper.git

Compilar

Você precisa definir a variável de ambiente GHIDRA_INSTALL_DIR para o diretório de instalação do Ghidra. Se você tem diferentes JDKs instalados, certifique-se de que a variável de ambiente JAVA_HOME aponta para aquele que a sua instalação do Ghidra usa.

A extensão será compilada especificamente para essa versão do Ghidra.

E então vá para a pasta BinDiffHelper no seu shell e execute

gradle

Isso compilará tanto o BinExport no submódulo correspondente quanto o BinDiffHelper no diretório pai. Deve ter sido criado um arquivo .zip no diretório dist. Use esse arquivo .zip para instalar de acordo com as instruções acima.

Configuração de Desenvolvimento / Depuração

Às vezes é útil poder depurar a extensão junto com o Ghidra, aqui estão algumas notas sobre isso: