Ceci est une ancienne révision du document !
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és : 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.
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 francophone d'Ubuntu-FR et anglophone d'Ubuntuforums ;
- dans les salons de discussions IRC francophone et anglophone ;
- et dans les listes de discussions anglophone et 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 rechercher dans Launchpad des rapports précédemment soumis. Pour ce faire, aidez-vous 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.
Utiliser Apport
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 automatiquement lors d'une 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'ait eu besoin de s'arrêter. Pour signaler un bogue dans un programme, à partir de celui-ci, allez dans le menu Aide où vous trouverez l'option "Signaler un bogue"
Apport est désactivé par défaut dans les versions stables d'Ubuntu afin de ne pas ralentir les performances de votre machine. Ne l'activez qu'en cas de réelle nécessité.
Pour cela, é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 paquet est concerné par votre bogue.
Identifier le bon paquet concerné par un bogue est essentiel pour être sûr que ce soient bien les personnes concernées qui le voient. 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 noyau (voir plus bas)
- Le LiveCD ne lance pas l'environnement de travail → casper(signaler)
- L'installation à partir du LiveCD ne marche pas → ubiquity(signaler)
- L'installation à partir de l'alternate CD ne marche pas → debian-installer (signaler)
Bogues d'un programme
Le nom qui apparait dans les menus ou la commande tapée dans un terminal ne reflète pas nécessairement le nom du paquet concerné par le bogue.
Recherchez 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
ps aux
ou
ps ax
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
locate <nom_du_processus>
et ensuite identifier le paquet avec la commande
dpkg -S <chemin_complet_du_programme>
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 utiliser 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 pose problème.
Une fois identifié, ouvrez un terminal et tapez simplement:
- Dans le cas où vous avez le nom du paquet
ubuntu-bug PAQUET
- Dans le cas où vous avez le PID
ubuntu-bug PID
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 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 construira de cette façon:
https://bugs.launchpad.net/ubuntu/+source/nom_du_paquet/+filebug
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 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 fournit 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
lspci -vvnn dmesg
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 liste de diffusion de l'équipe bugsquad chargée 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.
- Reporting Bugs (en)
- Apport (en)