snare/voltronKit de ferramentas de IU de depurador extensível que fornece visualizações personalizáveis de registradores, desmontagem, pilha, memória, pontos de interrupção e rastreio de pilha para LLDB, GDB, VDB e WinDbg.
Voltron é um kit de ferramentas de interface de depurador extensível escrito em Python. Ele tem como objetivo melhorar a experiência do utilizador de vários depuradores (LLDB, GDB, VDB e WinDbg) permitindo a anexação de visualizações de utilitários que podem recuperar e exibir dados do host do depurador. Ao executar essas visualizações em outros TTYs, você pode construir uma interface de depurador personalizada de acordo com suas necessidades.
Voltron não pretende ser tudo para todos. Não é uma substituição total da CLI do seu depurador. Em vez disso, pretende complementar sua configuração existente e permitir que você estenda seu depurador CLI tanto ou tão pouco quanto desejar. Se você quer apenas uma visualização do conteúdo dos registradores em uma janela ao lado do seu depurador, você pode fazer isso. Se você quer ir ao extremo e ter algo que se pareça mais com o OllyDbg, você também pode fazer isso.
Visualizações integradas são fornecidas para:
A configuração do autor é algo assim:
Qualquer comando do depurador pode ser separado em uma visualização e destacado com um analisador Pygments especificado:
Mais capturas de tela estão aqui.
O Voltron suporta LLDB, GDB, VDB e WinDbg/CDB (via PyKD) e roda em macOS, Linux e Windows.
O suporte ao WinDbg ainda é bastante novo, por favor abra uma issue se tiver problemas.
As seguintes arquiteturas são suportadas:
Nota: Apenas macOS e derivados Debian são totalmente suportados pelo script de instalação. Ele não deve falhar em outras distribuições Linux, mas não tentará instalar dependências de pacotes. Se você estiver usando outra distribuição, dê uma olhada em install.sh para descobrir quais dependências você pode precisar instalar antes de executá-lo.
Baixe o código-fonte e execute o script de instalação:
$ git clone https://github.com/snare/voltron
$ cd voltron
$ ./install.sh
Por padrão, o script de instalação instalará no diretório site-packages do usuário. Se você quiser instalar no site-packages do sistema, use a flag -s:
$ ./install.sh -s
Você também pode instalar em um ambiente virtual (apenas para LLDB) assim:
$ ./install.sh -v /caminho/para/venv -b lldb
Se você estiver no Windows sem um shell, tiver problemas para instalar ou preferir instalar manualmente, consulte a documentação de instalação manual.
Se o seu depurador possui um script de inicialização (.lldbinit para LLDB ou .gdbinit para GDB), configure-o para carregar o Voltron quando iniciar, usando o script de ponto de entrada entry.py. O caminho completo estará dentro do pacote voltron. Por exemplo, no macOS pode ser /Library/Python/2.7/site-packages/voltron/entry.py. O script install.sh adicionará isso ao seu .gdbinit ou .lldbinit automaticamente se detectar GDB ou LLDB no seu caminho.
LLDB:
command script import /caminho/para/voltron/entry.py
GDB:
source /caminho/para/voltron/entry.py
Inicie seu depurador e inicialize o Voltron manualmente, se necessário.
Em versões recentes do LLDB, você não precisa inicializar o Voltron manualmente:
$ lldb binary_alvo
Em versões mais antigas do LLDB, você precisa chamar voltron init após carregar o inferior:
Veja a wiki no github.
P. Por que estou recebendo um ImportError ao carregar o Voltron?
R. Você pode ter várias versões do Python instaladas e ter instalado o Voltron usando a versão errada. Veja as instruções de instalação mais detalhadas.
P. GEF? PEDA? PwnDbg? gdbinit do fG?
R. Todas são extensões excelentes para GDB. Essas ferramentas fornecem principalmente conjuntos de comandos adicionais para tarefas de exploração, mas cada uma também fornece uma exibição de "contexto" com uma visão dos registradores, pilha, código, etc, como o Voltron. Essas ferramentas imprimem sua exibição de contexto no console do depurador cada vez que o depurador para. O Voltron adota uma abordagem diferente, incorporando um implante de servidor RPC no depurador e permitindo a anexação de visualizações de outros terminais (ou até navegadores web, ou agora sincronizando com o Binary Ninja), o que permite ao usuário construir uma interface de várias janelas mais limpa para seu depurador. O Voltron funciona muito bem junto com todas essas ferramentas. Você pode simplesmente desabilitar a exibição de contexto em sua extensão GDB de escolha e conectar algumas visualizações do Voltron, enquanto ainda obtém todos os benefícios dos comandos úteis adicionados por essas ferramentas.
Veja o rastreador de issues no github para mais informações ou para enviar issues.
Se você está enfrentando um ImportError ao carregar o Voltron, certifique-se de ter seguido as instruções de instalação para sua plataforma.
Em versões mais antigas do LLDB, o comando voltron init deve ser executado manualmente após carregar o alvo de depuração, pois um alvo deve ser carregado antes que os ganchos do Voltron possam ser instalados. O Voltron tentará registrar automaticamente seu manipulador de eventos e informará o usuário se voltron init for necessário.
Mais informações sobre suporte ao WinDbg/CDB aqui.
Os autores usam principalmente o Voltron com a versão mais recente do LLDB no macOS. Tentaremos testar tudo em quantas plataformas e arquiteturas for possível antes dos lançamentos, mas LLDB/macOS/x64 será de longe a combinação mais usada. Esperamos que o Voltron não coloque fogo em seus animais de estimação, mas os resultados podem variar.
Veja o arquivo LICENSE.
Se você usar isso e não odiar, me compre uma cerveja em uma conferência algum dia. Esta licença também se estende a outros contribuidores - richo definitivamente merece algumas cervejas por suas contribuições.
Agradecimentos aos meus ex-empregadores Assurance e Azimuth Security por me darem tempo para trabalhar nisso.
Props para richo por todas as suas contribuições para o Voltron.
O gdbinit do fG! foi a inspiração original para este projeto.
Obrigado ao Willi por implementar o suporte ao VDB.
O Voltron agora usa Capstone para desmontagem, além do mecanismo de desmontagem interno dos hosts de depuradores. Capstone é um desmontador poderoso, de código aberto e multi-arquitetura sobre o qual a próxima geração de ferramentas de engenharia reversa e depuração está sendo construída. Confira.
Obrigado ao grazfather por contribuições contínuas.
| lldb | gdb | vdb | windbg |
|---|
| x86 | ✓ | ✓ | ✓ | ✓ |
| x86_64 | ✓ | ✓ | ✓ | ✓ |
| arm | ✓ | ✓ | ✓ | ✗ |
| arm64 | ✓ | ✗ | ✗ | ✗ |
| powerpc | ✗ | ✓ | ✗ | ✗ |
$ lldb binary_alvo
(lldb) voltron init
GDB:
$ gdb binary_alvo
VDB:
$ ./vdbbin binary_alvo
> script /caminho/para/voltron/entry.py
WinDbg/CDB só é suportado quando executado via Bash com um userland Linux. O autor testa com Git Bash e ConEmu. PyKD e Voltron podem ser carregados em um único comando ao iniciar o depurador:
$ cdb -c '.load C:\caminho\para\pykd.pyd ; !py --global C:\caminho\para\voltron\entry.py' binary_alvo
Em outro terminal (eu uso painéis do iTerm) inicie uma das visualizações da interface. No LLDB, WinDbg e GDB, as visualizações serão atualizadas imediatamente. No VDB, elas não serão atualizadas até que o inferior pare (em um ponto de parada, após um passo, etc):
$ voltron view register
$ voltron view stack
$ voltron view disasm
$ voltron view backtrace
Defina um ponto de parada e execute seu inferior.
(*db) b main
(*db) run
Quando o depurador atingir o ponto de parada, as visualizações serão atualizadas para refletir o estado atual dos registradores, pilha, memória, etc. As visualizações são atualizadas após cada comando ser executado na CLI do depurador, usando o mecanismo de "gancho de parada" do depurador. Então, cada vez que você avança passo a passo, ou continua e atinge um ponto de parada, as visualizações serão atualizadas.