Introdução

Seer - uma interface gráfica para gdb no Linux. (Ernie Pasveer [email protected])

Este projeto está sendo ativamente desenvolvido. O objetivo é uma interface gráfica simples e agradável para o gdb.

Por favor, reporte quaisquer bugs ou funcionalidades desejadas para meu e-mail ou crie uma tarefa na minha página do projeto no GitHub.

Instalação

O Seer pode ser instalado a partir de um gerenciador de pacotes ou a partir do código fonte.

[!NOTE] Certifique-se de que os requisitos sejam atendidos antes de instalar.

Requisitos

• Linux

• C++17

• gdb com interpretador "mi" (verifique executando: gdb --interpreter=mi)

• CMake (3.5.0 ou mais recente)

• QT6

  • Ao compilar o Seer a partir do código fonte, você precisará dos pacotes "devel" do QT6 instalados no seu sistema para sua distribuição.
    • Core
    • Gui
    • Widgets
    • PrintSupport
    • Charts
    • Svg
  • As instruções de compilação para Qt6 estão aqui: https://github.com/epasveer/seer/wiki/Building-Seer---Qt6

• QT5

  • O Seer não compila mais com Qt5. A árvore de fontes 2.3 é a última que compila.
  • As instruções de compilação para Qt5 estão aqui: https://github.com/epasveer/seer/wiki/Building-Seer---Qt5

Instalar a partir de pacote

Disponível através dos seguintes gerenciadores de pacotes:

Pamac (Manjaro)

$ pamac install seer

zypper (openSUSE Tumbleweed)

$ zypper install seergdb

Flathub

Site do Flathub. Aqui

$ flatpak install flathub io.github.epasveer.seer

Flatpak

Versões beta do Seer. Página de lançamentos do Seer no github.

Importante: flatpak-spawn --host, necessário no GDB Launcher para executar o gdb. Veja https://github.com/epasveer/seer/issues/377#issuecomment-3620844808.

Baixe seer.flatpak. Instale-o:

$ flatpak install -y --bundle --user seer.flatpak

Instalar a partir do código fonte

(Recomendado) O Seer pode ser compilado com Qt6 seguindo as instruções abaixo.

https://github.com/epasveer/seer/wiki/Building-Seer---Qt6

Ele ainda pode ser compilado com Qt5, por enquanto, seguindo as instruções abaixo.

https://github.com/epasveer/seer/wiki/Building-Seer---Qt5

NOTÍCIAS

Confira a página Wiki do Seer no github.

• A versão v1.17 será o último lançamento Qt5.
• O próximo lançamento será v2.0 e será baseado em Qt6. No entanto, por enquanto, ele ainda pode ser compilado com Qt5.
• Se você quiser o código fonte Qt5 estável mais recente, pegue a v1.17 aqui: https://github.com/epasveer/seer/releases/tag/v1.17

Iniciando o Seer

O Seer foi projetado para iniciar facilmente o programa a ser depurado a partir da linha de comando. O gdb possui múltiplos métodos para depurar um programa. Portanto, o Seer naturalmente também os possui.

Vá para a Wiki para ver todas as maneiras de executar o Seer.

https://github.com/epasveer/seer/wiki/Starting-Seer

Visão geral da GUI

Exemplos das várias visualizações e diálogos do Seer.

Visão Principal

A visão principal do Seer se parece com isto:

• Source/Function/Types/Variables/Libraries

  • A lista de arquivos fonte/cabeçalho que foram usados no programa.
  • Pesquise por Funções, Tipos e Variáveis Estáticas. Clicar duas vezes abrirá o arquivo fonte.
  • A lista de bibliotecas compartilhadas referenciadas pelo programa.
  • A lista de arquivos fonte/cabeçalho pode ser pesquisada. Isso "encolherá" a lista de arquivos exibidos.
  • Clicar duas vezes em um arquivo o abrirá no Gerenciador de Código.

• Informações de Variável/Registrador

  • Mostra valores de variáveis e registradores.
  • "Logger" - registra o valor de uma variável. Insira manualmente ou clique duas vezes na variável no arquivo aberto no gerenciador de código.
  • "Tracker" - cria uma lista de variáveis para mostrar o valor sempre que o gdb atingir um ponto de parada (step, next, finish, etc.). Quando o ponto de parada é atingido, todas as variáveis na lista mostrarão seu valor potencialmente novo.
  • "Registers" - mostra os valores de todos os registradores da CPU.

• Gerenciador de Código.

  • A grande área na parte central da interface do Seer.
  • Arquivos fonte são abertos nesta visualização.
  • O texto em um arquivo pode ser pesquisado com ^F.
  • Variáveis podem ser adicionadas ao "Logger" clicando duas vezes no nome da variável. Clicar duas vezes com a tecla CTRL pressionada prefixará a variável com "". Clicar duas vezes com a tecla SHIFT pressionada prefixará a variável com "&". Clicar duas vezes com as teclas CTRL+SHIFT pressionadas prefixará a variável com "&".
  • Variáveis podem ser adicionadas ao "Tracker" selecionando o nome da variável, clicando com o botão direito (RMB) e selecionando "Add variable to Tracker".
  • Variáveis podem ser adicionadas ao "Visualizador de Memória" selecionando o nome da variável, clicando com o botão direito e selecionando "Add variable to Memory Visualizer".
  • Um breakpoint/printpoint pode ser criado clicando com o botão direito em uma linha específica.
  • Pode executar até uma linha específica clicando com o botão direito em uma linha específica.
  • As abas nesta visualização podem ser destacadas clicando duas vezes em uma aba.

• Breakpoints, Watchpoints, Catchpoints, Printpoints, comandos manuais do gdb e logs.

  • A área abaixo do Gerenciador de Código.
  • Comandos manuais. Insira manualmente um comando gdb ou gdbmi. Os comandos são lembrados para o próximo uso do Seer.
  • Gerenciador de breakpoints. Crie e gerencie breakpoints.
  • Gerenciador de watchpoints. Crie e gerencie watchpoints. Um watchpoint monitora quando uma variável é acessada (leitura, escrita, leitura/escrita).

Diálogo Abrir

Quando o diálogo de abrir executável é invocado, ele se parece com isto:

Console do Seer

Toda a saída de texto do executável irá para o console do Seer. A entrada de texto para o executável também pode ser inserida através do console.

Visualização de Assembly

Normalmente, o Seer mostra apenas o código fonte como abas no Gerenciador de Código. O assembly do programa também pode ser exibido como uma aba.

Selecione "View->Assembly View" e uma aba extra será exibida junto com as abas de código fonte, mostrando o assembly atual sendo executado. Aqui está um exemplo.

Assim como nas abas de código fonte, breakpoints podem ser definidos na aba de assembly. A instrução atual é destacada.

Clicar duas vezes em entradas na aba "Breakpoints" e na aba "Stack frames" mostrará o assembly para esses endereços.

Existem teclas de atalho "Nexti" e "Stepi", conforme definido nas suas configurações. Normalmente "Ctrl+F5" e "CTRL+F6". Usar "^F" na aba de assembly mostrará uma barra de pesquisa poderosa.

O recurso de assembly no Seer é novo. Sinta-se à vontade para sugerir mudanças/recursos.

Visualizador de Memória

Ao visualizar o conteúdo da memória bruta no Visualizador de Memória, ele se parece com isto :

Memory	Disassembly

Visualizador de Array

Ao visualizar o conteúdo de arrays no Visualizador de Array, ele se parece com isto :

Normal	Spline	Scatter

Dois arrays podem ser usados como um gráfico X-Y. Por exemplo, este array simples 'points' forma o contorno X-Y de uma forma.

    int main() {
        int points[] = {50,1,20,91,97,35,2,35,79,91,50,1};
        return 0;
    }

Valores X	Valores Y	Valores XY

Visualizador de Estrutura

Ao visualizar o conteúdo de uma struct C/C++ ou de uma classe C++ no Visualizador de Estrutura, ele se parece com isto. Este exemplo mostra o conteúdo de "*this" para a classe C++ atual em que o Seer está. Todos os membros da estrutura que são tipos básicos podem ser editados.

Há também um Visualizador de Estrutura Básico que é mais leve, mas não pode seguir ponteiros e não pode ser editado.

Visualizador de Imagem

Ao visualizar o conteúdo da memória bruta que é uma imagem, o Visualizador de Imagem pode ser usado.

Suporte/Contato

Envie um e-mail para [email protected] para quaisquer bugs ou funcionalidades. Ou crie uma tarefa na minha página do projeto no GitHub.

Stargazers

É um mundo maravilhoso.