✎ rapporter_un_bug [Wiki ubuntu-fr]

Vous affichez une ancienne révision du document ! Si vous l'enregistrez, vous créerez une nouvelle version avec ce contenu.

{{tag>tutoriel}}
----
======  Guide pour bien rapporter un bogue pour Ubuntu ======

Si vous rencontrez un incident lorsque vous utilisez votre système Ubuntu, ne restez pas les bras croisé : il est probable que d'autres personnes que vous l'ont aussi rencontré. Dans ce système communautaire qu'est Ubuntu, la méthode la plus sûre de faire corriger un tel comportement inopportun  est de faire remonter votre information aux développeurs de la distribution.

<note important>
**__Avant de soumettre un rapport d'incident__**

Veuillez ne pas utiliser le système de soumission et de suivi d'incident pour des requêtes de soutien technique. Si vous rencontrez un problème avec votre système Ubuntu, déterminez d'abord s'il s'agit réellement d'un bogue. Commencez par demander de l'assistance :
  * dans les forums [[http://forum.ubuntu-fr.org|francophone d'Ubuntu-FR]] et [[http://www.ubuntuforums.org|anglophone d'Ubuntuforums]] ;
  * dans les salons de discussions IRC [[http://www.ubuntu-fr.org/chat/|francophone]] et [[irc://irc.freenode.net/ubuntu|anglophone]] ;
  * et dans les listes de discussions [[http://lists.ubuntulinux.org/mailman/listinfo/ubuntu-users|anglophone]] et [[http://lists.ubuntulinux.org/mailman/listinfo/ubuntu-fr|francophone]].
Si votre problème est identifié comme un bogue, vous serez alors invité et assisté dans la soumission de votre rapport d'incident.

Avant de soumettre un rapport de bogue, prenez le temps de [[https://launchpad.net/ubuntu/+search|rechercher dans Launchpad]] des rapports précédemment soumis. Pour ce faire, aidez-vous du du nom du paquet concerné par le bogue //(voir ci-dessous pour identifier le paquet)//. Dans le cas où un rapport a précédemment été émis, complétez ce rapport plutôt que d'en créer un autre. Ceci évite les doublons.
</note>

===== Utiliser Apport =====
//**[[:Feisty|Ubuntu 7.04 Feisty Fawn]] et supérieur**//

Ubuntu intègre **Apport** qui est un outil permettant de signaler simplement les bogues en les accompagnant de diverses informations techniques.

Apport se lance automatique en cas d'erreur provocant l'arrêt inopiné de votre programme. Dans ce cas il suffit de suivre les indications à l'écran pour faire remonter des informations essentielles qui permettront une résolution rapide de l'erreur.

Mais vous pouvez également signaler des bogues sans que pour autant votre programme n'ai eu besoin de s'arrêter. Pour signaler un bogue dans un programme, à partir de celui-ci, allez dans le menu **Aide** où vous verrez une l'option **"Signaler un bogue"**

//**Apport** est désactivé par défaut dans les versions stable d'Ubuntu afin de ne pas ralentir les performances de votre machine. Ne l'activer qu'en cas de réelle nécessité.//\\
//Pour cela [[:tutoriel:comment_editer_un_fichier|éditez le fichier]] "**/etc/default/apport**" et passez la valeur "enabled" à 1.//

===== Identifier le paquet concerné =====
Avant d'aller plus loin, il vous faut savoir quel [[:gestionnaire_de_paquets#le_paquet|paquet]] est concerné par votre bogue.

Identifier le bon paquet concerné par un bogue est essentiel pour être sur que ce soient bien les personnes concernées qui le voit. Voici quelques astuces afin d'essayer d'identifier le bon paquet source.

==== Bogues du système ====

* Le LiveCD ne boot pas -> Problème avec le [[:linux|noyau]] (voir plus bas)
  * Le LiveCD ne lance pas l'environnement de travail -> **casper**([[https://bugs.launchpad.net/ubuntu/+source/casper/+filebug|signaler]])
  * L'installation à partir du LiveCD ne marche pas -> **ubiquity**([[https://bugs.launchpad.net/ubuntu/+source/ubiquity/+filebug|signaler]])
  * L'installation à partir de l'alternate CD ne marche pas -> **debian-installer** ([[https://bugs.launchpad.net/ubuntu/+source/debian-installer/+filebug|signaler]])

* Démarrage avant l'écran de connexion ou arrêt -> [[:usplash]] ([[https://bugs.launchpad.net/ubuntu/+source/usplash/+filebug|signaler]])
  * Écran de connexion ->
    * pour Ubuntu par défaut -> [[:gdm]] ([[https://launchpad.net/ubuntu/+source/gdm/+filebug|signaler]])
    * pour KUbuntu par défaut -> **kdm** contenu dans **kdebase**([[https://launchpad.net/ubuntu/+source/kdebase/+filebug|signaler]])
  * Environnement graphique -> [[:xorg]] ([[https://bugs.launchpad.net/ubuntu/+source/xorg/+filebug|signaler]])
  * Problèmes d'impression ->
    * Ubuntu 8.10 et suivants -> [[:cups]] ([[https://bugs.launchpad.net/ubuntu/+source/cups/+filebug|signaler]])
    * Versions précédentes -> **cupsys** ([[https://bugs.launchpad.net/ubuntu/+source/cupsys/+filebug|signaler]])
  * Problème de son ->  Problème avec le [[:linux|noyau]]
  * Problèmes avec le [[:linux|noyau]], commencez par identifier votre version avec la commande **"uname -r"** dans un [[:terminal]]
    * Ubuntu 8.04 et supérieur -> [[:linux]] ([[https://bugs.launchpad.net/ubuntu/+source/linux/+filebug|signaler]])
    * Unbuntu 7.10 -> **linux-source-2.6.22** ([[https://bugs.launchpad.net/ubuntu/+source/linux-source-2.6.22/+filebug|signaler]])
    * Ubuntu 7.04 -> **linux-source-2.6.20** ([[https://bugs.launchpad.net/ubuntu/+source/linux-source-2.6.20/+filebug|signaler]])
    * Ubuntu 6.06 -> **linux-source-2.6.15** ([[https://bugs.launchpad.net/ubuntu/+source/linux-source-2.6.15/+filebug|signaler]])
  * Mise en veille, veille prolongée, difficile à déterminer, peux concerner
    * **acpi-support** ([[https://bugs.launchpad.net/ubuntu/+source/acpi-support|signaler]])
    * **pm-utils** ([[https://bugs.launchpad.net/ubuntu/+source/pm-utils|signaler]])
    * **gnome-power-manager** ([[https://bugs.launchpad.net/ubuntu/+source/gnome-power-manager|signaler]])

==== Bogues d'un programme ====
Le nom qui apparait dans les menu ou de la commande tapée dans un terminal ne reflète pas nécessairement le nom du paquet concerné par le bogue.

Trouver le "Process ID" **PID** (numéro identifiant le processus) et le nom d'un programme en cours d'exécution en allant dans "**système > Administration > Moniteur système**" onglet **Processus**. Vous pouvez voir le nom du processus et son ID.
Vous pouvez également utiliser les commandes
<code>ps aux</code>
ou
<code>ps ax</code>
dans un [[:terminal]] pour avoir le même résultat.

Le PID est utilisable directement pour rapporter un bogue en ligne de commande (voir ci dessous).

Pour trouver le nom du paquet, le plus simple est d'aller sur le site [[http://packages.ubuntu.com/]] où vous pouvez faire une recherche sur le nom du processus (fichier) en filtrant suivant votre version d'Ubuntu, et vous pourrez même rapporter le bogue directement grâce au lien fourni dans la description du paquet une fois que vous l'aurez identifié.

Mais vous pouvez également en ligne de commande commencer par trouver le chemin complet de l'exécutable avec la commande
<code>locate <nom_du_processus></code>
et ensuite identifier le paquet avec la commande
<code>dpkg -S <chemin_complet_du_programme></code>

===== Utiliser la ligne de commande =====
//**Ubuntu 7.04 Feisty Fawn et supérieur**//

Vous n'avez pas toujours l'opportunité d'avoir un programme avec une interface graphique, comme dans le cas des services, des applets, des programmes en ligne de commande, ... Dans ce cas vous pouvez utilisez Apport en ligne de commande.

Avant tout, il vous faut identifier le paquet concerné (voir ci dessus) par le bogue ou le PID du programme en cours d'exécution qui pause problème.

Une fois identifié, ouvrez un [[:terminal]] et tapez simplement:
  * Dans le cas où vous avez le nom du paquet
<code>ubuntu-bug PAQUET</code>
  * Dans le cas où vous avez le PID
<code>ubuntu-bug PID</code>

===== Utilisez Launchpad.net =====
//**Toutes versions**//

Avant tout, il vous faut identifier le paquet concerné (voir ci dessus) par le bogue.

Si vous l'avez identifié à l'aide du site [[http://packages.ubuntu.com/]] vous avez un lien direct pour vous rendre dans le formulaire de soumission d'un nouveau bogue.

Sinon, rendez-vous sur le [[https://launchpad.net/ubuntu/+search|moteur de recherche du projet Ubuntu sur Launchpad]] pour trouver le paquet source, et soumettre le bogue.

Ou si vous avez déjà le nom du paquet l'adresse se construit de cette façon:
<code>https://bugs.launchpad.net/ubuntu/+source/nom_du_paquet/+filebug</code>

===== Apprendre à décrire un bogue =====
Décrivez votre bogue en mettant le maximum d'informations (versions des programmes, de la distribution, du matériel si besoin, ...), il vaut mieux en écrire trop que pas assez.

Décrivez précisément comment reproduire le bogue (si celui-ci est reproductible) afin que les développeurs puissent le confirmer rapidement.

Ne décrivez qu'un seul et unique problème par rapport. Si vous êtes confronté à plusieurs bogues, remplissez un rapport par bogue, cela facilite énormément le suivi des différentes soumissions.

Attachez des documents (extraits de logs, capture d'écran, vidéo, document de test servant à reproduire le bogue, ...) à votre rapport afin d'aider le plus possible à comprendre et reproduire le bogue.

Lisez ce document pour [[http://www.chiark.greenend.org.uk/~sgtatham/bugs-fr.html|apprendre à rapporter un bug en général]] afin de tout de suite prendre de bonnes habitudes.

==== Obtenir plus d'informations ====
Un programme lancé à l'aide d'un menu fourni très peu d'informations en cas d'erreurs. Vous pouvez souvent obtenir un complément d'informations sur ce qui cause l'erreur en lançant le programme à partir d'un terminal (il vous faut le nom de l'exécutable pour cela).

S'il s'agit d'un problème avec votre matériel, attachez à votre rapport ce que vous renvoient les commandes
<code>lspci -vvnn
dmesg</code>
que vous exécuterez juste après un démarrage complet de votre système.

==== Obtenir de l'aide ====
La communauté est toujours prête à vous aider pour identifier un bogue, rédiger un rapport, compléter une description.
Vous pourrez trouver de l'aide sur les serveurs IRC de Freenode en demandant sur le salon **#ubuntu-bugs** (en) et sur la [[https://lists.ubuntu.com/mailman/listinfo/Ubuntu-bugsquad|liste de diffusion de l'équipe bugsquad]] chargé de gérer (vérifier, trier, faire remonter l'information aux personnes concernées...) les bugs sur Ubuntu.

===== Liens utiles =====
//Cette page est basée sur les documents du wiki d'Ubuntu.//

* [[https://help.ubuntu.com/community/ReportingBugs|Reporting Bugs]] (en)
  * [[https://wiki.ubuntu.com/Apport|Apport]] (en)
  * [[https://wiki.ubuntu.com/Bugs/FindRightPackage|Finding the Right Package]] (en)
  * [[http://www.chiark.greenend.org.uk/~sgtatham/bugs-fr.html|apprendre à rapporter un bug en général]] (fr)

----
<note>Merci de votre aide ! Votre rapport de bogue est une excellente contribution au développement d'Ubuntu. Vous pouvez également aider en travaillant sur les rapports de bogue existants et en déterminant si oui ou non ils ont déjà été résolus, ou s'ils nécessitent un complément d'information.</note>
----

Merci de recopier le code ci-contre pour prouver que vous êtes humain : N N Q M R Merci de laisser ce champ vide :

Résumé

Note : En modifiant cette page, vous acceptez que le contenu soit placé sous les termes de la licence suivante : CC Paternité-Partage des Conditions Initiales à l'Identique 3.0 Unported