— [ OpenBSD ] ~ Traduction française de la page OpenBSD: Report : (v1.53 ; 05/04/2021) —
Avant de rapporter un bogue/problème avec les versions release, passez en revue cette liste de contrôle :
Si rien ne ressemble à votre problème, veuillez vous familiariser avec sendbug(1) avant de soumettre un rapport de bogue.
Si votre problème est avec l'arborescence des sources -current plutôt que -release ou -stable,
Toujours fournir le plus d'informations possibles. Essayez de pointer le problème exact. Donnez des instructions claires pour reproduire le problème. Essayez de le décrire avec autant de précision que possible et avec des mots ne portant pas à confusion, spécifiquement si le problème n'est pas facile à reproduire. Décrire les problèmes en disant “Cela crashe” ou “J'ai un problème étrange avec cette construction” est inutile. Communiquez avec les autres (sur les listes de diffusion ou sur tout forum où des utilisateurs compétents se rassemblent) pour confirmer que le problème est nouveau et de préférence répété. SVP, essayez de vous assurer vous que ce ne soit pas un problème local par l'utilisation d'un matériel défectueux ou non supporté, ou par l'usage d'un logiciel ou d'une option de construction non supportée.
SVP, ne commencez pas à fixer des problèmes qui requiert un travail significatif à moins que vous ne soyez capable de les comprendre, spécialement durant les périodes de publication pendant lesquelles nous ne faisons aucun changement majeur de code. Si vous vous apprêtez à écrire des quantités importantes de code, mentionnez-le sur les listes de diffusion afin de vous assurer que personne d'autre ne travaille sur ce problème (cela économise les efforts).
Chaque rapport de bogue doit contenir les éléments suivants :
/var/run/dmesg.boot
. Dans ce cas, incluez les informations des deux. Veuillez inclure cela dans tous les rapports de bogue. trace
et ps
dans votre rapport de bogue telles que retournées. Si le machine se bloque, essayez d'activer sysctl ddb.console=1
et d'obtenir dans DDB via Ctl+Alt+Esc (en-dehors de X), ou d'envoyer BREAK si vous utilisez une console série. Si, pour une raison quelconque, le message panic n'est pas visible, vous pouvez l'obtenir à nouveau avec la commande show panic
. Ceci est essentiel chaque fois que possible. Les rapports de panic sans message panic, ni retour des sorties trace et ps sont inutiles. La sortie des show registers
pourrait être aussi intéressante. Vous pouvez ensuite redémarrer avec boot dump
afin que l'image du noyau soit sauvé par savecore(8) pour un débogage post-mortem ultérieur, tel que décrit dans la page de manuel crash(8)./var/log/Xorg.0.log
dans votre rapport en complément de l'information de dmesg.boot
. Ne soyez pas effrayé que votre rapport devient assez long. C'est un fait. Il est préférable de rapporter chaque chose dès la première fois plutôt que d'avoir à vous soutirer les informations. D'autre part, si vos fichiers d'entrées sont énormes, il vaut mieux demander en premier si quelqu'un est intéressé à les voir.
Si possible, utilisez la commande sendbug(1) pour aider à générer votre rapport de bogue. Il inclura automatiquement quelques informations utiles à-propos de votre matériel ce qui aide à diagnostiquer beaucoup de problèmes. Cet outil requiert que votre système puisse proprement envoyer un courriel. Si vous ne pouvez utiliser sendbug sur une machine OpenBSD fonctionnelle, veuillez envoyer votre rapport de bogue à bugs@openbsd.org.
Peut-être voulez vous envoyer une demande de fonctionnalité, pas nécessairement un bogue. Les nouvelles fonctionnalités sont acceptées, spécialement avec le code qui implémente votre nouvelle fonctionnalité suggérée.
Pour déboguer quelques problèmes, nous devons avoir le matériel sur lequel survient le problème. N'oubliez pas que les ressources du projet OpenBSD sont limitées. Vous pouvez donner quelques matériels.
Cette page est la traduction officieuse de la page “Problem Reports” officielle d'OpenBSD.
En cas de doute, merci de vous y référer !
Si vous voulez participer à l'effort de traduction, merci de lire ce topic.
Contribut(rice|eur)s :