# A Interface do Depurador

Para o C e C++, o &kdevelop; contém um depurador interno que está integrado directamente com o editor. Do ponto de vista técnico, está implementado como uma interface para o depurador multi-plataforma da &GNU; gdb através de um 'pipe'. O depurador poderá ser iniciado de várias formas:

- Com a opção Depurar Iniciar, o programa principal do seu projecto é carregado no depurador.

- Se usar a opção Depurar Iniciar (outro) Examinar o ficheiro 'core', poderá carregar um ficheiro de 'core' para a memória, o qual é gerado pelo 'kernel' do sistema operativo, quando o programa tiver estoirado (A geração de ficheiros 'core' poderá estar desligada no seu sistema; veja o ulimit(1)). Isto é útil para uma análise 'post-mortem' de um programa.

- Com a opção Depurar Iniciar (outro) Anexar a um processo, poderá invocar o depurador sobre um programa já em execução. Irá ver uma lista de processos onde poderá seleccionar o processo que o depurador deverá capturar.

- Lembre-se que a depuração só é possível se o seu projecto tiver sido compilado com as informações de depuração activas. Poderá ser activada na janela de Opções do compilador. Quando esta opção estiver activa, o compilador gera dados adicionais que permitem ao depurador associar nomes de ficheiros e números de linha aos endereços do executável.

A interface do depurador oferece várias vistas dentro do processo:

Se tentar depurar um projecto sem informação de depuração, irá obter a mensagem `Sem código...` na barra de estado. Se tentar definir um ponto de paragem, é mostrado como `Pendente (adicionar)` na janela do ponto de paragem (ver abaixo).

Variáveis

  Esta janela lista os valores de todas as variáveis locais no ponto de execução actual do programa. Ela cobre as variáveis na pilha de chamadas completa, &ie; a função onde o processo foi interrompido, a função que chamou esta função, e assim por diante até à função `main()`.

  Outra ramificação nas variáveis contém as variáveis de vigia. Poderá configurar por si próprio as variáveis que são aqui mostradas. Tanto poderão ser vigiadas as variáveis locais como as globais. Poderá adicionar as variáveis se carregar no botão Adicionar ou carregar em Return, enquanto o item Vigia estiver seleccionado. Eles poderão ser removidos de novo, através do menu de contexto.

Pilha de Chamadas

  (... ainda não escrito ...)

Pontos de Paragem

  Esta janela permite-lhe ver e manipular os pontos de paragem. Lembre-se que o &kdevelop; usa o GDB, como tal, para compreender por completo as funcionalidades de depuração do &kdevelop;, deverá ler um pouco sobre o GDB.

  Se quiser olhar para o código-fonte, os pontos de paragem estão definidos no `kdevelop/languages/cpp/debugger/breakpoint.h`.

  Do lado esquerdo, a janela tem botões para:

  - Adicionar um ponto de paragem vazio

  - Editar o ponto de paragem seleccionado

  - Remover o ponto de paragem seleccionado

  - Remover todos os pontos de paragem

  A parte principal da janela é uma tabela com 7 colunas. Cada linha da tabela é um ponto de paragem. As colunas são:

  1. Opção de selecção

  2. Tipo: um dos seguinte: Inválido, Ficheiro:Linha, Ponto de Vigia, Endereço, Função

  3. Estado. Os valores são:

     - Activo

     - Inactivo: Cada ponto de paragem poderá estar activo ou inactivo; no último caso, não fará efeito no seu programa até que o active de novo.

     - Pendente (adicionar): um ponto de paragem fica marcado desta forma se não estiver disponível nenhuma informação de depuração. Na página do 'info' do GDB:

       > Se a localização de um dado ponto de paragem não puder ser encontrada, poder-se-á dever ao facto que a localização esteja numa biblioteca dinâmica ainda por carregar. Nesse caso, poderá querer que o GDB crie um ponto de paragem especial (conhecido por ponto de paragem pendente) que tentará resolver-se a si próprio no futuro, quando for carregada a biblioteca dinâmica adequada.

  4. Pendente (limpar)

  5. Pendente (modificar)

  6. Localização no formato nome-ficheiro:número-linha

  7. Condição

  8. Ignorar a Contagem: Se este for um número `QUANTIDADE` maior que zero, as próximas `QUANTIDADE` vezes que o ponto de paragem for atingido, a execução do seu programa não irá parar; para além de decrementar o número de vezes a ignorar, o gdb não irá fazer nada.

  9. Contagem: indica quantas vezes foi atingido um ponto de paragem.

Descodificação

  (... ainda não escrito ...)

## Definir Pontos de Paragem

(... ainda não escrito ...)

## Opções

Mostrar os Nomes Codificados

  No C++, os nomes das funções no executável são codificados, &ie; os nomes das funções incluem a informação sobre os tipos de argumentos recebidos. Isto é necessário para suportar a sobreposição ('overloading') de funções. O algoritmo de codificação não é normalizado e difere mesmo entre várias versões do compilador de C++ da &GNU;.

  Na janela de descodificação, são mostrados os nomes normalmente descodificados, como tal as assinaturas das funções irão aparecer como existem no código-fonte, por isso são fáceis de ler. Em alternativa, poderá querer ver os nomes codificados.

Tentar Definir Pontos de Paragem ao Carregar as Bibliotecas

  A infra-estrutura do depurador gdb não permite definir pontos de paragem em código que ainda não está carregado de momento. Numa aplicação altamente modular, onde muitas vezes o código só é carregado a pedido, como um 'plugin' (com a função da 'libc' `dlopen(3)`), isto poderá ser inconveniente. Como tal, o &kdevelop; contém o seu próprio suporte para os pontos de paragem em bibliotecas dinâmicas. Se definir esta opção, ela permitir-lhe-á definir pontos de paragem nas bibliotecas que ainda não estão carregada. Aí, sempre que o gdb notificar que uma biblioteca vai ser carregada, o &kdevelop; tentará definir os pontos de paragem pendentes.

Activar a Barra de Ferramentas Flutuante

  (... ainda não escrito ...)