Signaler les bogues

Comme il est impossible pour nos développeurs de tester toutes les combinaisons de matériel, ni tous les cas de figure pouvant interagir avec le système d'exploitation, nous comptons sur les utilisateurs pour nous dire si les choses fonctionnent pour eux. puisque Haiku est encore tout jeune, il est très probable que vous rencontriez des bogues. Nous vous remercions de bien vouloir prendre le temps de nous les signaler. Ensemble, nous pourrons, petit à petit, améliorer Haiku.

Afin que le suivi de nos bogues reste efficace, il est essentiel de respecter l'Étiquette de suivi des bogues.

Obtenir un compte Trac

Pour remplir un rapport (ticket), vous aurez besoin d’un compte utilisateur sur le Traqueur de bogues de Haiku.
Lors de la création d’un nouveau compte, pensez à indiquer votre adresse e-mail afin d’obtenir les privilèges basiques de gestions des tickets. N’oubliez pas de Vérifier votre dossier de pourriel après, car les e-mails de vérifications s’y retrouvent souvent.

Créer un rapport de bogue

Avant de rapporter un bogue, veuillez vérifier qu’il n’est pas déjà répertorié. Vous pouvez aussi utiliser la fonction de recherche pour cela.
Après vous être assuré que votre bogue est unique, obtenez des informations précises sur votre environnement :

Indiquez comment vous testez Haiku (sur machine réelle, dans VMware, dans Qemu…)
Indiquez quelle révision SVN de Haiku vous utilisez. Vous pouvez trouver des informations à ce sujet dans le menu « About This System… » de la Deskbar.
Décrivez le problème que vous rencontrez. soyez aussi précis que possible : décrivez le comportement réel, et celui que vous attendiez.
Décrivez les actions que vous avez effectuées avant de faire ressortir le bogue. Cela permettra aux développeurs de le reproduire.
Attachez au rapport le plus d’informations possibles. Si le bogue concerne l’interface graphique ou une application, essayez de faire une capture d’écran (la touche IMPR ÉCRAN créera une image PNG dans le dossier /boot/home/).

Bogues logiciels

Lorsqu'une application se plante, vous devez appeler le débogueur depuis le message d'alerte qui s'affiche. Saisissez bt dans le Terminal de débogage qui est lancé. Vous obtiendrez ainsi une trace de la « pile d'appel » (backtrace) que vous devez joindre à votre rapport de bogue.

Bogues matériels

Lorsque le bogue concerne un matériel ou son pilote, vous devez fournir les renseignements suivants :

listdev - fait une liste détaillée de votre matériel, en y incluant les identifiants PCI des fournisseurs, à la manière de lshw ou lspci dans GNU/Linux .
listusb -v - en supposant que c'est un problème lié à l'USB, comme le fait lsusb.
open /var/log/syslog - le système de journal d’événements principal de Haiku, similaire au déboguage sur écran durant le démarrage. En l’ouvrant dabs un éditeur de texte avec la commande open vous pourrez n’en conserver que la partie utile.
listimage | grep drivers/ - liste tous les drivers utilisés.
ints - seulement disponible dans le mode débogage du noyau (voir ci-dessous). Montre l'utilisation des interruptions. Il ne devrait pas y avoir trop d'interruptions partagées par plusieurs périphériques.

Ces commandes peuvent être entrées dans le Terminal. Si vous ajoutez > sortie.txt après une commande, sa sortie sera redirigée dans un fichier texte nommé « sortie.txt » que vous pourrez attachez à votre rapport de bogue ou e-mail.

Le mode débogage noyau - KDL

Lorsque certains composants systèmes de bas niveau se plantent, vous pouvez être envoyé dans le débogueur du noyau. Vous pouvez également y entrer volontairement avec ALTSYSTD (SYST correspond à IMPR ÉCRAN sur la plupart des claviers). Attention : l'ordre des touches compte.

co - sortira du KDL et reprendra l’exécution normale, si possible.
int - affichera l’utilisation des interruptions (comme décrit ci-dessus).
bt - affiche une trace de déboguage (backtrace), indiquant exactement comment le plantage s’est produit.

Et après ?

Une fois le bogue rapporté, un développeur le consultera et essayera de le cataloguer. Retenez que tous les développeurs sont des volontaires; un long délai avant réponse peut s’écouler après le rapport de bogue. L’ajout de nouvelles informations une fois celles-ci disponibles peut généralement permettre à un bogue d’être analysé plus rapidement. Néanmoins, n’essayez pas de « faire remonter » un bogue en ajoutant des commentaires non pertinents.

N’oubliez pas, le rapport d’un bogue ne se limite pas à sa soumission. Une fois cette tâche faite, vous ferez partie du processus de développement de Haiku. Les développeurs pourront vous poser des question pour essayer de résoudre votre bogue. Merci de rester disponible pour y répondre. Vous pourrez considérer votre travail « terminé » quand le bogue sera marqué comme étant « corrigé ».