Como relatar um bug

We maintain a list of common issues. Check this site first to see if your issue has been reported — and if a solution exists.

Conforme os bugs são relatados e corrigidos, os desenvolvedores coletam um conjunto de correções e lançam periodicamente versões aprimoradas de seus softwares. Portanto, antes de relatar um problema, é útil verificar se você está usando a versão mais recente de um software. A maneira mais simples de obter a última versão do software no Fedora é atualizar regularmente o seu sistema. Os usuários do GNOME/KDE e outros ambientes gráficos podem usar seus aplicativos padrão para fazer isso. Eles verificam periodicamente se há atualizações e notificam os usuários. Você também pode usar o gerenciador de pacotes padrão dnf para verificar e atualizar seu sistema. Apenas usuários com privilégios de administrador podem fazer isso:

Se você estiver usando a versão mais recente do software disponível no Fedora, é provável que o bug não tenha sido relatado ou tenha sido relatado, mas uma correção ainda não foi lançada. Portanto, é útil pesquisar a lista de bugs já relatados antes de preencher um novo relatório. O Aplicativos Web Fedora Packages fornece um link para os bugs abertos para um pacote. Há também um atalho conveniente que pode ser usado.

Aqui, o nome do pacote deve ser o nome formal do pacote.

Se um relatório de bug já foi preenchido descrevendo o problema, você deve fornecer qualquer informação extra que possa ter. Se não houver mais nada a acrescentar ao relatório, você deve adicionar a si mesmo em "CC" (cópia carbono) no relatório para receber quaisquer atualizações. Isso pode ser feito clicando no botão "Save changes" (salvar alterações) quando a opção "Add me to CC list" (Adicionar-me à lista de CC) estiver marcada, conforme mostrado abaixo:

Os bugs são relatados na instância do bugzilla do Fedora, e você deve ter uma conta lá para registrar os bugs ou interagir com eles. Uma conta requer um endereço de e-mail válido e pode ser criada aqui (clique em "Register"). O rastreador de bugs só enviará notificações por e-mail sobre bugs em que o usuário esteja envolvido. Nenhum outro e-mail será enviado.

Se um relatório de bug para o problema específico ainda não tiver sido arquivado, você deve arquivar um novo. A maneira mais fácil de registrar um novo relatório é usando o menu suspenso "File a new bug" na barra lateral direita do Aplicativo web Fedora Packages.

This redirects to a new bug report template on the bug tracker. The image below shows a new bug template:

The following fields need to be set:

Description of problem:

Explain the issue in more detail here.

Version-Release number of selected component (if applicable):

The version of the package should be specified here. Once the package name is known, the version can be obtained by using the rpm command:

Por exemplo:

How reproducible:

How often is the issue observed? Usually, a good answer to this field is one of:

Issues that occur always are easiest for developers to diagnose, since they may also be able to replicate it on their machines to collect more information. If an issue only happens sometimes, developers must spend more time and effort to understand what causes the problem. If an issue was only observed once, it is even harder to debug.

Steps to Reproduce:

These enable other users to verify the bug, and they also inform the developers of what specific steps cause the issue. It makes it much easier for them to look at the source code and pick out the bits that may be faulty.

Actual results:

What is observed when the issue occurs?

Expected results:

What does the user expect that should happen if the software behaved correctly?

Additional info:

Any additional information that may be useful to the maintainer should be added here.

After a bug has been filed, you should keep an eye out for any updates. The bug status workflow documentation describes the different statuses a bug may have. An e-mail notification of any new comments to the report will be sent to everyone involved in the bug report---the reporter, other users, and the maintainer. Often, maintainers will comment with queries to gather more information on the issue. Sometimes other users that experience the same issue may also add more information.

A well reported bug will often be fixed, and the maintainer will make an improved version of the software available to Fedora users. Bodhi will add a comment to the report when this happens. You can help the maintainer by confirming if the improved version works better in the Bodhi.

Once the improved version of the software has passed the QA process, the bug will automatically be closed. Congratulations!

If you have experienced a program crash, it will almost certainly be necessary to include a stack trace with your bug report. Crashes are often difficult to reproduce and even more difficult to fix, so the more information you can provide, the better. You will probably need to install -debuginfo RPMs so your stack trace will have useful debugging symbols. See the following pages for more information:

If you are having trouble with a graphical user interface (GUI), it often helps to include a screenshot or a screencast showing the bug in action. This helps developers find the exact place in the code which is causing the bug, and helps communicate what is going wrong when it is difficult to reproduce (for example, machine-specific layout problems).

A strong indication of a hardware-specific bug is that other people with different hardware should be able to reproduce the bug, but can’t. They also usually involve code that specifically interacts with a peripheral, such a webcam, video card, printer, or sound card (so for instance, it is uncommon for bugs affecting the user interface of a word processor or desktop calculator to be hardware-specific).

If you suspect your bug has something to do with the specific hardware you have, it will be necessary to identify the hardware so targeted action can be taken.

PCI and PCI-E devices found by the kernel can be listed with lspci.

USB devices found by the kernel can be listed with lsusb.

You may also find mention of specific devices or drivers in your system logs (run journalctl).

We pay special attention to security-sensitive bugs. Read the Reporting a Security Vulnerability] page to understand the special process of opening a security bug.