Alerta! Esta tradução está muito desatualizada, por favor leia o original.
Como relatar um bug no Debian usando o reportbug
Nós recomendamos fortemente que você reporte bugs no Debian usando o
programa reportbug
.
Para realizar a instalação e iniciá-lo, simplesmente execute:
# apt-get install reportbug
$ reportbug
Ele guiará você, passo-a-passo, no processo de reportar um bug.
Se você tiver questões que as entradas interativas do reportbug não resolvam, você pode consultar o restante da documentação abaixo ou perguntar na lista de discussão dos usuários Debian (em português) ou, para a versão em inglês da lista de discussão dos usuários Debian.
Como relatar um bug no Debian usando o e-mail (e uso avançado do reportbug)
Pontos importantes a serem considerados antes de enviar ser relatório de bug
A qual pacote o seu relatório de bug pertence?
Você precisa saber a qual pacote o seu relatório de bug deveria ser vinculado. Veja este exemplo para informações sobre como encontrar esta informação. (Você usará esta informação para verificar se seu relatório de bug já foi relatado).
Se você não é capaz de determinar a qual pacote o ser relatório de bug deveria ser vinculado, favor envie uma mensagem para a lista de discussão dos usuários Debian (em português) ou, para a versão em inglês da lista de discussão de usuários Debian pedindo aconselhamento.
Se o seu problema não está relacionado somente a um pacote mas a algum serviço geral do Debian, existem diversos pseudo-pacotes ou mesmo listas de discussão que você pode usar para transmitir sua mensagem para nós.
Seu relatório de bug já foi relatado?
Você deveria verificar se seu relatório de bug já foi relatado antes de enviá-lo. Você pode ver quais bugs foram relatados em um pacote específico usando a opção de pacote no formulário de busca de bugs. Se há um relatório de bug existente #<número>, você deveria mandar seus comentários enviando um e-mail para <número>@bugs.debian.org ao invés de relatar um novo bug.
Enviando múltiplos relatórios para múltiplos bugs
Por favor, não relate múltiplos bugs não relacionados — especialmente os que são de pacotes diferentes — em um único relatório de bug.
Não relate bugs para o autor (upstream
)
Se você relatar um bug no Debian, não envie uma cópia para os mantenedores originais do software por conta própria, pois é possível que o bug exista apenas no Debian. Se necessário, o mantenedor do pacote irá encaminhar o bug para os mantenedores principais.
Enviando o relatório de bug via e-mail
Você pode relatar bugs no Debian enviando um e-mail para
submit@bugs.debian.org
com um formato especial descrito abaixo. reportbug
(veja acima) formatará os e-mails apropriadamente para
você; por favor, use-o!
Cabeçalhos
Como qualquer e-mail você deveria incluir uma linha de
Assunto
clara e descritiva no cabeçalho principal.
O assunto que você definir será usado como o título inicial
do bug no sistema de acompanhamento, portanto tente utilizar algo
informativo!
Se você quiser enviar uma cópia de seu relatório de bug para destinatários adicionais (como listas de discussão), você não deverá usar os cabeçalhos de e-mail tradicionais, mas um método diferente, descrito abaixo.
Pseudo-cabeçalhos
A primeira parte do relatório de bug são os pseudo-cabeçalhos que contêm informação sobre qual pacotes e versão o seu relatório de bug se aplica. A primeira linha do corpo da mensagem tem que incluir um pseudo-cabeçalho. Ela deveria ser:
Package: <nome-do-pacote>
Substitua <nome-do-pacote>
pelo nome do pacote que possui o bug.
A segunda linha da mensagem deve conter:
Version: <versão-do-pacote>
Substitua <versão-do-pacote>
pela versão do pacote.
Por favor, não inclua aqui qualquer texto que não seja a própria
versão, já que o sistema de acompanhamento de bugs se baseia neste
campo para determinar quais releases
são afetadas pelo bug.
Você precisa informar uma linha Package
correta no
pseudo-cabeçalho para que o sistema de acompanhamento de bugs entregue
a mensagem para o mantenedor do pacote. Consulte
este exemplo para informações sobre como
encontrar essa informação.
Para outros pseudo-cabeçalhos válidos, veja Pseudo-cabeçalhos adicionais.
O corpo do relatório
Por favor inclua em seu relatório:
- O texto exato e completo de quaisquer mensagens
impressas ou gravadas (
log
). Isto é muito importante! - Exatamente o que você digitou ou fez para demonstrar o problema.
- Uma descrição do comportamento incorreto: exatamente qual comportamento você estava esperando e o que você observou. Uma transcrição de uma sessão de exemplo é uma boa maneira de mostrar isso.
- Uma correção sugerida, ou até mesmo um patch, caso você tenha preparado um.
- Detalhes da configuração do programa com o problema. Inclua o texto completo dos arquivos de configuração do programa em questão.
- As versões de quaisquer pacotes dos quais o pacote com problemas dependa.
- Qual versão de kernel você está usando (digite
uname -a
), sua biblioteca C compartilhada (digitels -l /lib/*/libc.so.6
ouapt show libc6 | grep ^Version
) e quaisquer outros detalhes sobre seu sistema Debian, caso pareçam apropriados. Por exemplo, se você tiver um problema com um script Perl você pode informar a versão do binário `perl' (digiteperl -v
oudpkg -s perl | grep ^Version:
). - Detalhes apropriados do hardware em seu sistema. Caso você esteja
relatando um problema com um controlador de dispositivo (
device driver
) por favor liste todo hardware em seu sistema, uma vez que problemas são normalmente causados por conflitos de endereços de I/O e IRQ. - Se você tem o reportbug
instalado a saída de
reportbug --template -T none -s none -S normal -b --list-cc none -q <pacote>
também será útil, pois contém a saída dos scripts de mantenedor específicos e informação de versão.
Inclua qualquer detalhe que pareça relevante — você está correndo muito pouco risco de fazer o seu relatório muito longo por incluir muita informação. Se forem pequenos, por favor, inclua em seu relatório quaisquer arquivos que você esteja usando para reproduzir o problema. (Se eles forem grandes, considere torná-los disponível em algum site web publicamente acessível, se possível).
Para maiores informações sobre como ajudar os desenvolvedores a solucionar seu problema, por favor, leia o documento Como Relatar Bugs Efetivamente (em inglês).
Um Exemplo de Relatório de Bug
Um relatório de bug, com o cabeçalho e o pseudo-cabeçalho, se assemelha a este:
To: submit@bugs.debian.org From: diligent@testing.linux.org Subject: Hello diz `goodbye' Package: hello Version: 1.3-16 Quando eu invoco `hello' sem argumentos a partir de um shell comum o mesmo imprime `goodbye' ao invés do esperado `hello, world'. Aqui está uma transcrição: $ hello goodbye $ /usr/bin/hello goodbye $ Eu sugiro que a string de saída, em hello.c, seja corrigida. Estou usando GNU/Linux 2.2, kernel 2.2.17-pre-patch-13 e libc6 2.1.3-10.
Lembre-se de escrever o seu relatório de bug em inglês. Se precisar de ajuda você pode enviar uma mensagem para debian-devel-portuguese@lists.debian.org ou para debian-l10n-portuguese@lists.debian.org.
Enviando cópias de relatórios de bugs para outros endereços
Algumas vezes é necessário enviar uma cópia do relatório de bug para
algum outro endereço além de debian-bugs-dist
e
do mantenedor do pacote, que são os endereços para os quais o mesmo
é normalmente enviado.
Você poderia fazer isso enviando uma cópia de seu relatório de bug (usando
o campo CC) para o(s) outro(s) endereço(s), mas assim as outras cópias
não teriam o número do relatório de bug no campo Reply-To
e
na linha Assunto
.
Quando os destinatários responderem, eles provavelmente preservarão a
entrada submit@bugs.debian.org
no cabeçalho e terão suas
mensagens enviadas como um novo relatório de bug. Isto leva a muitos
relatórios duplicados.
A maneira correta de fazer isso é usar o cabeçalho
X-Debbugs-CC
. Adicione uma linha como essa ao cabeçalho
de sua mensagem:
X-Debbugs-CC: outra-lista@cosmic.edu
Isto fará com que o sistema de acompanhamento de bugs envie uma cópia
de seu relatório para o(s) endereço(s) na linha X-Debbugs-CC
e também para debian-bugs-dist
.
Evite enviar estas cópias para o endereço de outros relatórios de bugs,
já que elas serão pegas pela checagem que evita loops de mensagens. De qualquer
forma, não há um bom motivo em usar X-Debbugs-CC
para isto,
já que o número do bug adicionado por este mecanismo será substituído por um
outro; ao invés disso, use o campo CC
.
Este recurso pode geralmente ser combinado de maneira útil com
quiet
— veja abaixo.
Pseudo-cabeçalhos adicionais
Níveis de Severidade
Se um relatório é de um bug particularmente sério (serious
), ou
é meramente uma requisição de novo recurso, você pode definir o nível de
severidade no momento em que o relata. No entanto, isto não é requerido e
os mantenedores do pacote atribuirão um nível de severidade apropriado para
seu relatório caso você não o faça (ou escolha a severidade errada).
Para atribuir um nível de severidade, coloque uma linha como essa no pseudo-cabeçalho:
Severity: <severidade>
Substitua <severidade> por um dos níveis de severidade disponíveis, como descrito na documentação avançada.
Atribuindo tags
Você pode definir tags em um bug quando relata o mesmo. Por exemplo,
caso você esteja incluindo um patch junto ao seu relatório de bug você
pode desejar definir a tag patch
. Porém, isso não é
requerido e os desenvolvedores irão definir tags em seu relatório quando
apropriado.
Para definir tags, inclua uma linha como essa no pseudo-cabeçalho:
Tags: <tags>
Substitua <tags> por uma ou mais tags disponíveis, conforme descrito na documentação avançada. Separe múltiplas tags por vírgulas, espaços ou ambos.
User: <nome-de-usuário> Usertags: <tags-do-usuário>
Substitua <tags-do-usuário> com uma ou mais usertags
.
Separe várias tags com vírgulas, espaços ou ambos. Se você especificar um
<nome-de-usuário>, as tags deste usuário serão definidas.
Caso contrário, o endereço de e-mail do remetente será usado como nome de
usuário.
Forwarded: foo@example.com
marcará o novo relatório de bug submetido como encaminhado para foo@example.com. Veja Registrando que você encaminhou um relatório de bug na documentação dos desenvolvedores para detalhes.
Owner: foo@example.com
indicará que foo@example.com é agora o responsável por resolver este bug. Veja Alterando o responsável pelo bug na documentação dos desenvolvedores para detalhes.
Source: foopacote
o equivalente a Package:
para bugs presentes no pacote fonte
de foopacote; para a maioria dos bugs na maioria dos pacotes você não precisa
usar esta opção.
Finalmente, se seu
MUA
não permite que você edite os cabeçalhos das mensagens, você pode
definir os diversos cabeçalhos X-Debbugs-
nos
pseudo-cabeçalhos.
Informação adicional
Endereços de envio diferentes (relatórios de bugs menores ou em massa)
Caso um relatório de bug seja menor, por exemplo, um erro ortográfico na
documentação ou um problema de compilação trivial, por favor ajuste a
severidade apropriadamente e envie o mesmo para
maintonly@bugs.debian.org
ao invés de
submit@bugs.debian.org
.
maintonly
irá encaminhar o relatório somente para o mantenedor
do pacote e não irá encaminhá-lo para as listas de discussão do BTS.
Caso você esteja enviando muitos relatórios de uma vez, você deverá,
definitivamente, usar maintonly@bugs.debian.org
para que você não
cause muito tráfego redundante nas listas de discussão do BTS. Antes de enviar
muitos bugs similares, você pode também postar um sumário em
debian-bugs-dist
.
Caso deseje relatar um bug para o sistema de acompanhamento de bugs que
já tenha sido enviado para o mantenedor, você pode usar
quiet@bugs.debian.org
. Bugs enviados para
quiet@bugs.debian.org
não
serão encaminhados para lugar algum, somente registrados.
Quando você utiliza endereços de envio diferentes, o sistema de
acompanhamento de bugs irá definir o Reply-To
de quaisquer
mensagens encaminhadas para que as respostas sejam por padrão processadas
da mesma maneira que o relatório original. Isto significa que, por exemplo,
respostas para maintonly
irão para
nnn-maintonly@bugs.debian.org
ao invés de
nnn@bugs.debian.org
, a menos é claro que alguém
sobrescreva isso manualmente.
Confirmações
Normalmente, o sistema de acompanhamento de bugs retornará uma confirmação
para você por e-mail, após você relatar um novo bug ou enviar uma informação
adicional para um bug existente. Se você quiser suprimir esta confirmação,
inclua um cabeçalho X-Debbugs-No-Ack
no seu e-mail (o conteúdo
deste cabeçalho não importa; entretanto, ele precisa estar no cabeçalho da
mensagem e não no pseudo-cabeçalho com o campo Package
).
Se você relatar um novo bug com este cabeçalho, você precisará checar a
interface web para descobrir o número do bug.
Note que este cabeçalho não irá suprimir confirmações do servidor de e-mails
control@bugs.debian.org
, já que estas confirmações podem conter
mensagens de erro que devem ser lidas e trabalhadas imediatamente.
Relatórios de bugs para pacotes desconhecidos
Caso o sistema de acompanhamento de bugs não saiba quem é o mantenedor
do pacote em questão, o mesmo encaminhará o relatório para
debian-bugs-dist
mesmo se maintonly
for usado.
Ao enviar para maintonly@bugs.debian.org
ou
nnn-maintonly@bugs.debian.org
, você deve certificar-se
de atribuir o relatório de bug ao pacote correto, colocando um
Package
correto no topo de um envio original de um relatório ou
usando o serviço control@bugs
para
(re)atribuir o relatório apropriadamente.
Usando o dpkg
para encontrar o pacote e
versão para o relatório
Quando estiver usando o reportbug
para relatar um bug em
um comando, digamos o grep
, o seguinte automaticamente selecionará
o pacote correto e permitirá que você escreva o relatório na seqüência:
reportbug --file $(which grep)
Você também pode encontrar qual pacote instalou-lo usando dpkg
--search
. Você pode encontrar qual versão de um pacote você possui
instalada usando dpkg --list
ou dpkg --status
.
Por exemplo:
$ which apt-get /usr/bin/apt-get $ type apt-get apt-get is /usr/bin/apt-get $ dpkg --search /usr/bin/apt-get apt: /usr/bin/apt-get $ dpkg --list apt Desired=Unknown/Install/Remove/Purge/Hold | Status=Not/Installed/Config-files/Unpacked/Failed-config/Half-installed |/ Err?=(none)/Hold/Reinst-required/X=both-problems (Status,Err: uppercase=bad) ||/ Name Version Description +++-==============-==============-============================================ ii apt 0.3.19 Advanced front-end for dpkg $ dpkg --status apt Package: apt Status: install ok installed Priority: standard Section: base Installed-Size: 1391 Maintainer: APT Development Team <deity@lists.debian.org> Version: 0.3.19 Replaces: deity, libapt-pkg-doc (<< 0.3.7), libapt-pkg-dev (<< 0.3.7) Provides: libapt-pkg2.7 Depends: libapt-pkg2.7, libc6 (>= 2.1.2), libstdc++2.10 Suggests: dpkg-dev Conflicts: deity Description: Advanced front-end for dpkg This is Debian's next generation front-end for the dpkg package manager. It provides the apt-get utility and APT dselect method that provides a simpler, safer way to install and upgrade packages. . APT features complete installation ordering, multiple source capability and several other unique features, see the Users Guide in /usr/doc/apt/guide.text.gz
Outros comandos e pacotes úteis
A ferramenta querybts, disponível a partir do mesmo pacote que o reportbug, fornece uma interface conveniente em modo texto para o sistema de acompanhamento de bugs.
Usuários Emacs também podem usar o comando debian-bug fornecido pelo pacote
debian-el
. Quando chamado com M-x debian-bug,
ele perguntará por todas as informações necessárias de forma similar ao
reportbug
.
Other BTS pages:
- Página principal dos conteúdos do sistema de gerenciamento de bugs.
- Instruções para reportar bugs.
- Acessando os logs do sistema de gerenciamento de bugs.
- Informações para desenvolvedor no sistema de gerenciamento de bugs.
- Informações do desenvolvedor na manipulação de bugs usando a interface de controle de e-mail.
- Cartão de referência de servidores de mail.
- Requisitando reports de bug pelo e-mail.
Debian BTS administrators <owner@bugs.debian.org>
Debian bug tracking system
Copyright © 1999 Darren O. Benham, 1997, 2003 nCipher Corporation Ltd,
1994-1997 Ian Jackson.