Utilitário para relatório de bugs

Contents

  1. Utilitário para relatório de bugs
    1. Instalação
    2. Uso
    3. Configuração
      1. Usando o seu cliente de e-mail regular
      2. Usando um cliente de e-mail específico
      3. Usando o servidor SMTP do Debian para relatórios de bug
      4. Usando um servidor SMTP personalizado
    4. Solução de problemas
    5. Veja também
    6. Links externos

reportbug é uma ferramenta projetada para fazer relatórios de bugs no Debian e em distribuições derivadas de maneira relativamente fácil.

Este pacote fornece acesso ao Sistema de rastreamento de bugs do Debian (Debian Bug Tracking System - BTS), que pode ser usado tanto para relatórios quanto para pesquisa de bugs por diferentes interfaces, incluindo e-mail, web e utilitários de linha de comando.

Instalação

Instale o pacote reportbug.

Uso

Também existe um robô em control@bugs.debian.org que aguarda por mensagens de controle especialmente criadas para o Sistema de rastreamento de bugs do Debian.

Configuração

Usando o seu cliente de e-mail regular

Esta opção está disponível desde reportbug 7.7.0 e o Debian bullseye.

/!\ Esta opção pode ser frágil ou não confiável, por favor teste-a antes de usá-la para relatórios de bugs reais. Por favor, primeiro leia a documentation para mais detalhes.

Certifique-se de ter configurado o seu cliente de e-mail preferido nas suas preferências de área de trabalho. Essa configuração será diferente para cada desktop. No GNOME, vá para "Configurações" e selecione "Aplicações padrão", "E-mail", e escolha o seu cliente desejado.

Instale o pacote xdg-utils para disponibilizar o comando xdg-email. 

apt install xdg-utils

Defina a opção mua em seu arquivo ~/.reportbugrc para xdg-email. 

mua xdg-email

Agora, sempre que você relatar um bug, o reportbug abrirá o modelo de relatório de bug na janela de composição de e-mail do seu cliente de e-mail e você pode enviar o e-mail via sua interface de envio normal.

Usando um cliente de e-mail específico

/!\ Esta opção pode ser frágil ou não confiável, por favor teste-a antes de usá-la para relatórios de bugs reais. Por favor, primeiro leia a documentation para mais detalhes.

Se o seu reportbug for velho demais para usar xdg-email, ou se você quiser usar um cliente de e-mail diferente do seu cliente de e-mail de desktop, ou se o manuseio do seu cliente de e-mail tem bugs e por isso você quer que o reportbug lide com seu cliente de e-mail, você pode fazer as mudanças definindo a opção mua no arquivo ~/.reportbugrc para selecionar a opção desejada: 

mua thunderbird

As opções atuais para mua incluem: mutt neomutt mh nmh gnus claws-mail alpine pine evolution kmail thunderbird sylpheed xdg-email xdg-email.

Para descobrir as opções mua disponíveis para a versão do reportbug que está usando, rode este comando em um terminal: 

sed -n '/^MUA/,/^]/p' /usr/lib/python*/*/reportbug/mailer.py

Usando o servidor SMTP do Debian para relatórios de bug

/!\ Esta opção pode ser frágil ou não confiável, por favor teste-a antes de usá-la para relatórios de bugs reais. Por favor, primeiro leia a documentation para mais detalhes.

O reportbug é frequentemente usado em sistemas com um Agente de Transporte de E-mail (Mail Transport Agent - MTA) instalado, como exim ou sendmail; no entanto, você pode editar o arquivo de configuração e enviar os relatórios usando o servidor de e-mail do Debian para relatórios de bug:

  1. Execute reportbug --configure como seu(sua) usuário(a) normal. Isso cria um arquivo ~/.reportbugrc que armazena todas as configurações.

  2. Siga as instruções e quando solicitado(a) Você tem um 'agente de transporte de e-mail' (MTA) configurado, escolha Não

  3. A seguir, não insira nada para host SMTP; o reportbug configurará o servidor de e-mail para relatórios de bugs do Debian (reportbug.debian.org) como seu host SMTP.

Usando um servidor SMTP personalizado

O reportbug é frequentemente usado em sistemas com um Agente de Transporte de E-mail (Mail Transport Agent - MTA) instalado, como o exim ou o sendmail; contudo, você pode editar o arquivo de configuração e enviar relatórios usando qualquer servidor de e-mail disponível. Aqui está um exemplo usando uma conta GMail:

  1. Execute reportbug --configure como um(a) usuário(a) normal. Isto cria um arquivo ~/.reportbugrc que armazena todas as configurações.

  2. Siga as instruções e, quando perguntado(a) Do you have a 'mail transport agent' (MTA) configured (Você tem um agente de transporte de e-mail (MTA) configurado), escolha Não

  3. A seguir, entre o host SMTP para o gmail: smtp.gmail.com:587

  4. Para o nome de usuário(a), entre: <nome-de-usuário(a)>@gmail.com

  5. Para a questão Does your SMTP host require TLS authentication? (O host SMTP requer autenticação TLS?), escolha Sim

Se tiver configurado a autenticação de dois fatores do Google para sua conta GMail, você pode criar uma senha específica por aplicação para usar com o reportbug.

Aviso: O procmail submit@bugs.debian.org tem uma regra que silenciosamente descarta e-mails de postmaster@<domínio>. Combinado com o fato de que o Google G-Suite altera o endereço MAIL FROM para postmaster@<domínio>, quando o MAIL FROM original está fora do seu domínio faz com que seus bugs sejam silenciosamente descartados.

Solução de problemas

Warning: unsupported locale setting: (Aviso: configuração de locale não suportada) Este erro relaciona-se à configuração de Locale. Para evitar esse problema, invoque o programa como LANG=C reportbug

Veja também

CategoryBugs | CategorySoftware