reportbug(1) reportbug(1)
reportbug - Signaler un bogue auprs du serveur de bogues
reportbug [options] <paquet | pseudo-paquet | chemin-absolu>
reportbug a t initialement conu pour signaler les bogues de la distri-
bution Debian ; son comportement par dfaut est d'envoyer un courriel au
systme de suivi des bogues Debian (Debian Bug Tracking System) sub-
mit [AT] bugs.org comportant les informations sur le bogue que vous
avez dcouvert. Une copie vous est aussi envoye. Gnralement, vous devez
rdiger votre rapport en anglais(NdT).
Grce l'option --bts, vous pouvez aussi envoyer le rapport de bogue
d'autres serveurs qui utilisent debbugs, le systme de suivi des bogues
Debian (Debian Bug Tracking System).
Vous pouvez indiquer soit un nom de paquet, soit un fichier (avec son
chemin absolu) ; si vous indiquez un nom de fichier, il doit commencer
par un / pour tre compris. Si vous voulez que reportbug recherche un
fichier dans votre machine, consultez l'option --file ci-dessous.
Vous pouvez aussi indiquer un pseudo-paquet. Dans le systme de suivi de
bogues de Debian, les pseudo-paquets servent suivre les erreurs qui ne
sont pas lies un paquet prcis. Lancez reportbug sans aucun paramtre,
puis rpondez other ( autre ) la question du paquet, vous verrez alors
la liste des pseudo-paquets les plus couramment utiliss.
Ce programme utilise la syntaxe habituelle des commandes GNU, dans
laquelle les options longues (sous forme de mots) sont prcdes de deux
tirets (-- ). Un rsum des options est fourni ci-dessous.
-h, --help
Afficher un rsum des options.
--version
Afficher la version de reportbug et s'arrter.
-a, --af
Utiliser le lecteur de courriel af pour l'dition et l'envoi du
rapport de bogue, plutt que de lancer un diteur.
-A NOM_DE_FICHIER, --attach=NOM_DE_FICHIER
Joindre un fichier au rapport de bogue. Les fichiers textes et
les fichiers binaires sont tout deux accepts. Cette routine va
crer une pice jointe au format MIME qui contiendra le fichier.
Dans certains cas (notamment les fichiers textes), il est
prfrable d'utiliser l'option --include. (Notez bien que le
systme de suivi des bogues Debian ne supporte les attachements
MIME que d'une faon limite).
-b, --no-query-bts
Ne pas vrifier auprs du systme de suivi de bogues Debian si ce
problme a dj t signal. Cela est pratique lorsque vous n'tes pas
connect ou si vous tes vraiment sr que c'est un bogue.
--query-bts
Vrifier si ce problme a dj t signal au systme de suivi des
bogues Debian (comportement par dfaut).
-B SYSTME, --bts=SYSTME
Utiliser le serveur de bogues indiqu par SYSTME plutt que celui
de Debian (ou le serveur de bogues indiqu dans /etc/report-
bug.conf). Vous pouvez vous servir de help afin d'obtenir la
liste de serveurs supports.
--body=CORPS
Utiliser le CORPS spcifi comme corps du message. Le corps du
texte sera ajust 70 colonnes, et les enttes et pieds de page
standards de reportbug seront ajouts de faon approprie. Les
questions concernant l'diteur et les autres questions spciales
ne seront pas poses. Gnralement, vous devez rdiger votre rapport
en anglais(NdT).
--body-file=FICHIER-MESSAGE
Le contenu du fichier (suppos) texte FICHIER-MESSAGE servira de
corps de message. Ce fichier doit tre bien form (par exemple,
longueur des lignes raisonnable, etc.). Les enttes et pieds de
page habituels seront ajouts. Les questions concernant l'diteur
et toute autre question spciale ne seront pas poses.
(FICHIER-MESSAGE peut aussi tre un tube nomm ( named pipe ) ;
l'utilisation d'un fichier spcial de priphrique peut conduire
des rsultats tonnants). Gnralement, vous devez rdiger votre rap-
port en anglais(NdT).
-c, --no-config-files
Ne pas joindre les fichiers de configuration au rapport de
bogue, sans demander confirmation. Le comportement habituel est
de vous demander si vous voulez les inclure ; dans certains cas,
cela pourrait envoyer des informations sensibles via courriel.
--configure
Relancer la procdure de configuration de la premire excution de
reportbug, et crer un nouveau fichier .reportbugrc. Tous les
rglages dj dfinis dans ce fichier seront effacs ; cependant, une
sauvegarde sera enregistre dans .reportbugrc~.
--check-available
Vrifier les nouvelles versions du paquet sur packages.debian.org
(par dfaut). Dans les modes advanced et expert, vrifier aussi
sur incoming.debian.org et http://ftp-mas-
ter.debian.org/new.html.
--no-check-available
Pas de vrification de la prsence de nouvelles versions du paquet
sur packages.debian.org.
-d, --debug
Ne pas rellement envoyer le rapport de bogue Debian ; l'envoyer
seulement vous. Sert en premier lieu des fins de test pour le
responsable du paquet.
-e DITEUR, --editor=DITEUR
Dfinir l'diteur de texte utiliser, en outrepassant toutes les
variables d'environnement telles que VISUAL ou EDITOR.
--email=ADRESSE
Dfinir l'adresse de courriel de l'expditeur du rapport de bogue
(l'adresse qui apparat dans le champ From:). Cette adresse doit
correspondre votre adresse de courriel Internet en tant que
telle (sans votre nom complet ou tout autre commentaire). Ce
rglage outrepasse les variables d'environnement EMAIL et DEBE-
MAIL, mais pas REPORTBUGEMAIL.
--exit-prompt
Afficher un message avant de quitter. Pratique quand reportbug
n'est pas lanc par un vrai terminal ( transient terminal ) (
partir du menu Debian, par exemple).
-f NOM-FICHIER, --filename=NOM-FICHIER
Crer un rapport de bogue pour le paquet contenant NOM-FICHIER
afin d'viter de chercher le paquet auquel ce fichier appartient.
La recherche est d'abord effectue en utilisant NOM-FICHIER comme
un chemin complet, puis elle est tendue tous les fichiers du
chemin.
--path Si l'option -f est spcifie conjointement, ne rechercher le
fichier NOM-FICHIER que dans le chemin donn. Prciser un chemin
absolu (commenant par un /) avec l'option -f outrepassera cette
option.
-g, --gnupg, --gpg
Joindre une signature numrique au rapport de bogue de type GnuPG
(GNU Privacy Guard). Cet argument sera ignor si vous utilisez un
client de messagerie (un MUA ) pour diter et envoyer votre rap-
port de bogue.
-G, --gnus
Utiliser le lecteur de courriels et de nouvelles GNUS plutt que
l'diteur pour l'envoi de votre rapport de bogue.
-H ENTTE, --header=ENTTE
Ajouter un en-tte RFC 2822 personnalis votre courriel ; pour
envoyer une copie conforme de votre rapport de bogue
debian-68k [AT] lists.org par exemple, vous pouvez indi-
quer -H 'X-Debbugs-CC: debian-68k [AT] lists.org'.
-i FICHIER, --include=FICHIER
Include the specified file as part of the body of the message to
be edited. Can be used multiple times to add multiple files;
text-only please! From a suggestion by Michael Alan Dorman in
the bug mailing list. (See also the --attach option.)
-I, --no-check-installed
Ne pas vrifier si le paquet est install avant de remplir le rap-
port. Pratique en gnral pour remplir un rapport sur un paquet
dont vous savez qu'il n'est pas install sur votre systme.
--check-installed
Vrifier si le paquet indiqu est install lors de la cration du
rapport de bogue. (Comportement par dfaut).
-j JUSTIFICATION, --justification=JUSTIFICATION
Dans Debian, les bogues de niveau serious , grave , ou criti-
cal doivent remplir certains critres afin de justifier d'une
telle appellation. Cette option vous permet de prciser la justi-
fication du niveau critique du bogue, plutt que d'attendre qu'on
vous pose la question.
-k, --kudos
Envoyer un courriel de remerciement l'adresse du responsable
enregistr plutt que de crer un rapport de bogue. Vous pouvez
aussi envoyer des remerciements nom-du-paquet@pack-
ages.debian.org, pour les paquets de l'archive officielle
Debian ; dans tous les cas, cette option utilise l'adresse du
responsable indique dans le fichier de contrle du paquet. Cela
garantit son bon fonctionnement pour des paquets d'autres orig-
ines.
-K CL-PRIVE, --keyid=CL-PRIVE
Cl prive utiliser pour les signatures PGP/GnuPG. Sans cette
prcision, c'est la premire cl de votre trousseau secret corre-
spondant votre adresse de courriel qui sera utilise.
--license
Afficher le copyright de reportbug et les informations de
licence sur la sortie standard.
--list-cc=ADRESSE
Envoyer une copie conforme du rapport la liste indique ds qu'un
numro de rapport de bogue a t assign. quivalent l'option -H
'X-Debbugs-CC: ADDRESS'. Cette option ne fonctionnera comme prvu
qu'avec des systmes de type debbugs.
-m, --maintonly
N'envoyer le rapport de bogue qu'au responsable du paquet ; le
systme de suivi des bogues n'enverra pas de copie la liste de
distribution du rapport de bogue.
--mode=MODE
Dfinir le mode de fonctionnement de reportbug. reportbug a
actuellement quatre modes de fonctionnement : novice (par
dfaut), standard, advanced, et expert.
Le mode novice est conu pour rduire le nombre de questions por-
tant sur des points que les utilisateurs normaux ne connais-
sent pas trop, ou dont ils se moquent, reportant le travail
d'approfondissement sur les paules du responsable. Dans ce mode,
la vrification de l'existence de versions plus rcentes n'est
effectue que pour la distribution stable. C'est actuellement le
mode par dfaut.
Le mode standard correspond approximativement aux questions
poses par les versions de reportbug 1.50 et prcdentes ; cela
englobe un nombre de questions relativement important, et ce
afin de pousser les utilisateurs ne pas faire de rapport de
bogue en double ou farfelus.
Le mode advanced ressemble au mode standard, mais peut offrir
des raccourcis pratiques pour les utilisateurs avancs de Debian,
sans tre toutefois d'aussi bas niveau (et donc potentiellement
source de contreverses, prises de bec ) que le mode expert.
(Les seules diffrences avec le mode standard sont la connais-
sance suppose de la part de l'utilisateur de la file d'attente
incoming , la possibilit de recenser un bogue sur des paquets
en dpendance , et l'absence d'aide pour l'insertion du texte du
rapport de bogue dans l'diteur)
Le mode expert est conu pour rduire le nombre de questions qui
servent
limiter les rapports de bogues farfelus ou inutiles, les exa-
grations de la gravit et le reste. Dans le mode expert, report-
bug considre que l'utilisateur est plus que familier avec les
rgles Debian. Ce qui signifie dans la pratique que le rapporteur
n'a pas se justifier lors d'un choix de svrit leve pour son
rapport de bogue, et que certains automatismes de nettoyage du
message sont inactifs. L'utilisation du mode expert est forte-
ment dconseille aux personnes qui ne participent pas rgulirement
au projet Debian, car cela pourrait leur valoir une prise de bec
avec les responsables des paquets en cas de mauvaise utilisa-
tion.
-M, --mutt
Utiliser le lecteur de courriel mutt pour l'dition et l'envoi du
rapport de bogue plutt que d'invoquer un diteur.
--mta='<MTA>'
Spcifier un autre serveur de messagerie ( MTA ), la place de
/usr/sbin/sendmail (par dfaut). Toute dfinition de smtphost out-
repassera celui-ci.
--mua='<MUA> <option>'
Utiliser le client de messagerie ( MUA , Mail User Agent) indiqu
pour l'dition et l'envoi du rapport de bogue plutt que d'invo-
quer un diteur. Le paramtre option doit tre utilis pour prciser
votre lecteur de courriel qu'il doit interprter le rapport de
bogues en tant de message brouillon. Pour en savoir plus sur
cette faon de fonctionner, regardez comment les options --mutt,
--nmh et --af sont traites.
-n, --nmh, --mh
Utiliser la commande comp (qui fait partie des systmes de cour-
rier nmh et mh) pour l'dition et l'envoi du rapport de bogues
plutt que d'invoquer un diteur.
-o FICHIER, --output=FICHIER
Rediriger le courriel vers le fichier indiqu plutt que de
l'envoyer.
-O, --offline
Dsactiver toutes les requtes vers l'extrieur. A actuellement le
mme effet que --no-check-available --no-query-bts.
-p, --print
crire le rapport de bogue sur la sortie standard plutt que de
l'envoyer par courriel, afin de pouvoir le rediriger dans un
fichier ou le passer par un tube (pipe) un autre programme.
Cette option ne fournit qu'un modle (template) pour le rapport
de bogue. Vous devrez remplir la description dtaille.
--paranoid
Afficher le contenu du message avant son envoi, avec toutes ses
enttes. Cette option est automatiquement dsactive dans le mode
template (modle).
--no-paranoid
Ne pas afficher le contenu complet du message avant de l'envoyer
(mode par dfaut).
--pgp Joindre au rapport de bogue une signature numrique en utilisant
PGP (Pretty Good Privacy). Notez bien, cependant, que le projet
Debian abandonne l'emploi de PGP au profit de GnuPG. (Ce
paramtre sera ignor si vous utilisez un client de messagerie
pour l'dition et l'envoi de votre rapport).
--proxy=SERVEUR-MANDATAIRE, --http_proxy=SERVEUR-MANDATAIRE
Indiquer le serveur mandataire ( proxy ) utiliser pour la ges-
tion de la requte au systme de suivi des bogues. Ce paramtre
n'est utile que derrire un pare-feu ( firewall ). L'argument
SERVEUR-MANDATAIRE doit tre au format valide d'une URL HTTP, et
comporter (si ncessaire) un numro de port ;
http://192.168.1.1:3128/ par exemple.
-P PSEUDO-ENTTE, --pseudo-header=PSEUDO--ENTTE
Ajouter une pseudo entte votre courriel. Si vous voulez, par
exemple, ajouter au bogue le usertag mytag concernant l'utilsa-
teur humberto [AT] example.com, vous pouvez utiliser -P 'User: hum-
berto [AT] example.com' -P 'Usertags: mytag'
-q, --quiet
Ne plus envoyer les messages de type diagnostic sur la sortie
d'erreurs (standard error).
-Q, --query-only
Interroger simplement le BTS, sans soumettre de rapport de
bogue. Cette option est ignore si vous demandez --no-bts-query.
--query-source
Faire porter l'interrogation sur tous les paquets binaires con-
struits partir de la mme source, et pas seulement sur le paquet
binaire indiqu (comportement par dfaut depuis reportbug 2.0)
--no-query-source
La requte ne portera que sur le paquet binaire indiqu sur la
ligne de commande.
--realname=NOM
Dfinir le nom rel (un nom lisible par les gens) utiliser pour
votre rapport.
--report-quiet
Enregistrer le bogue dans le systme de suivi des bogues sans
envoyer de rapport au responsable du paquet ni qui que ce soit.
ne pas utiliser sauf si vous tes le responsable du paquet en
question, ou si vous savez vraiment ce que vous faites.
--reply-to=ADRESSE, --replyto=ADRESSE
Dfinir l'adresse du champ Reply-To de l'entte de votre rapport.
-s OBJET, --subject=OBJET
Dfinir l'objet du rapport de bogue (une rapide prsentation du
problme, de moins de 60 caractres). Si vous ne spcifiez pas ce
paramtre, l'objet du message vous sera demand.
-S GRAVIT, --severity=GRAVIT
Dfinir le niveau de gravit, choisi parmi critical, grave, seri-
ous, important, normal, minor, et wishlist (critique, grave,
srieux, important, normal, mineur, et souhait).
--smtphost=HTE[:PORT]
Utiliser le serveur de messagerie (MTA) de la machine HOST afin
d'envoyer votre rapport plutt que votre programme
/usr/sbin/sendmail local. En gnral, il s'agit du serveur de
courrier sortant de votre fournisseur d'accs Internet ; vous
pouvez aussi indiquer localhost si votre machine dispose d'un
serveur de courriel en tat de marche. Si vous ne prcisez pas le
PORT, c'est le port 25, port SMTP standard, qui sera utilis.
--tls En cas d'utilisation de SMTP, employer Transport Layer Security
(TLS) pour scuriser la connexion au serveur de courrier. Cer-
tains serveurs SMTP exigent parfois cette option.
--smtpuser=NOM_UTILISATEUR
En cas d'utilisation de SMTP, se servir du NOM_UTILISATEUR
indiqu pour l'authentification.
--smtppasswd=MOT_DE_PASSE
En cas d'utilisation de SMTP, se servir du MOT_DE_PASSE indiqu
pour l'authentification. Si le mot de passe n'est pas indiqu sur
la ligne de commande ou dans le fichier de configuration, un
message sera affich pour le demander.
L'utilisation de cette option est dangereuse sur les systmes
multi-utilisateurs. Vous devriez plutt dfinir ce rglage dans
.reportbugrc, puis vous assurer que celui-ci n'est lisible que
par votre utilisateur (grce chmod 600 $HOME/.reportbugrc, par
exemple).
-t TYPE, --type=TYPE
Dfinir le type de rapport soumettre ; accepte actuellement
aussi bien gnats que debbugs.
-T BALISE, --tag=BALISE
Dfinir une balise enregistrer dans le rapport, par exemple
--tag=patch. Plusieurs balises peuvent tre spcifies en utilisant
plusieurs paramtres -T ou --tag.
D'un autre ct, vous pouvez indiquer la balise none pour sauter
l'tape des questions sur les balises, sans avoir en fournir ;
toutes les balises indiques sur la ligne de commande seront
elles aussi ignores.
--template
Afficher un modle ( template ) de rapport de bogue sur la sortie
standard.
-v, --verify
Vrifier, grce debsums, l'intgrit du paquet (s'il est install)
avant de faire le rapport.
-V VERSION, --package-version=VERSION
Indiquer la version du paquet sur laquelle le problme a t ren-
contr. Ce sera probablement trs utile si vous tes en train de
signaler un bogue sur un paquet non installable ou install sur
un autre systme.
-x, --no-cc
Ne pas envoyer de copie cache (BCC) du rapport de bogue son
auteur (c.--d. vous-mme).
-z, --no-compress
Ne pas rduire la taille des fichiers de configuration par la
suppression des commentaires et des lignes blanches.
reportbug lynx-ssl
Signaler un bogue sur le paquet lynx-ssl.
reportbug --path --file=ls
Signaler un bogue sur le paquet install sur votre machine qui
contient un programme nomm ls prsent dans votre chemin de
recherche.
Depuis la version 0.22, reportbug utilise un contrle de la syntaxe des
fichiers en une seule passe. Les commandes sont lues dans /etc/report-
bug.conf et $HOME/.reportbugrc, les dernires valeurs remplaant les pre-
mires. Les commandes ne sont pas sensibles la casse, et acceptent
actuellement 0 ou 1 paramtre ; les paramtres qui contiennent des
espaces doivent tre protgs par des guillemets. Toute ligne commenant
par un # est considre comme un commentaire et sera donc ignore.
En gnral, les options correspondant aux options longues (type GNU) de
reportbug sont acceptes, sans les prfixer par la squence --. Consultez
le fichier reportbug.conf(5) pour connatre toutes les options acceptes.
VISUAL diteur utiliser pour l'dition du rapport de bogue.
EDITOR diteur utiliser pour l'dition du rapport de bogue (outrepass
par VISUAL).
REPORTBUGEMAIL, EMAIL, DEBEMAIL
Email address to use as your from address (in this order). If no
environment variable exists, the default is taken from your user
name and /etc/mailname.
DEBFULLNAME, DEBNAME, NAME
Nom complet utiliser : il est tir par dfaut de /etc/passwd.
REPLYTO
Adresse mettre dans le champ Rpondre (Reply-To) dans le
courrier mis.
MAILCC Adresse Copie (CC) utiliser dans votre courriel. Remarquez
que vous pouvez aussi utiliser l'option -H dans ce but, ainsi
que pour Copie Cache (BCC).
MAILBCC
Adresse Copie Cache (BCC) utiliser, plutt que votre adresse
de courriel. ( Copie et Copie Cache sont des options bases
sur les suggestions de Herbert Thielen dans la liste de souhaits
de bug).
http_proxy
Adresse du serveur mandataire (proxy) utiliser afin de raliser
la requte au BTS. Doit tre l'URL http valide d'un serveur man-
dataire, en prcisant le numro de port si ncessaire (n'indiquer
qu'un nom de machine ou omettre le numro de port s'il est
diffrent de 80 NE FONCTIONNERA PAS).
Le module getopt de Python est plus pointilleux sur l'ordre des
paramtres de la ligne de commande que le getopt() du GNU ; tous les
paramtres doivent tre crits avant le nom du paquet.
Il faudrait probablement que reportbug soit compatible avec d'autres
systmes de suivi des bogues, tels que bugzilla (utilis par les projets
GNOME et Mozilla) et jitterbug (utilis par Samba, AbiSource et
FreeCiv), mais il ne l'est pas.
reportbug.conf(5), http://www.debian.org/Bugs/Developer#tags lire pour
connatre les balises disponibles, querybts(1)
Chris Lawrence <lawrencc [AT] debian.org>.
Ce document est une traduction, ralise par Sylvain Cherrier <syl-
vain.cherrier [AT] free.fr> le 15 Nov 2004 et mise jour en 2006.
L'quipe de traduction a fait le maximum pour raliser une adaptation
franaise de qualit.
La version anglaise la plus jour de ce document est toujours con-
sultable via la commande : man -L C reportbug
N'hsitez pas signaler l'auteur ou au traducteur, selon le cas, toute
erreur dans cette page de manuel.
reportbug(1)