BTS.FR(1) BTS.FR(1)
NOM
bts - Interface en ligne de commande des dévelopeurs pour le système de
bogues de Debian (BTS)
SYNOPSIS
bts [options] commande [paramètres] [#commentaire] [.|, commande
[paramètres] [#commentaire]] ...
DESCRIPTION
C'est une interface au système de suivi de bogues en ligne de commande,
principalement destinée à l'usage des développeurs. Elle permet de
manipuler le BTS avec de simples commandes pouvant être lancées depuis
une invite de commandes ou depuis un script, effectue diverses
vérifications de la validité des données entrées, afin de créer et
d'envoyer pour vous un message à l'adresse de contrôle du BTS. Un cache
local des pages web et des messages du BTS peut aussi être créé et mis
à jour.
En général, cette interface en ligne de commande est la même que si
vous vouliez écrire un message à control@bugs.debian.org, simplement
précédée de "bts". Par exemple :
% bts severity 69042 normal
% bts merge 69042 43233
% bts retitle 69042 bla bla
Quelques commandes supplémentaires ont été ajoutées pour votre confort,
et ce programme est moins strict sur la validité des numéros de bogue.
Par exemple, "severity Bug#85942 normal" est compris, tout comme
"severity #85942 normal". (Bien sûr, votre interpréteur de commandes
peut comprendre "#" comme un caractère de commentaire, donc il faudra
probablement le mettre entre guillemets.)
De même, pour vous faciliter la vie, ce programme vous permet d'abréger
les commandes en la plus courte sous-chaîne unique (d'une manière
similaire à celle de cvs). Ainsi des choses comme "bts cl 85942" sont
comprises.
Il est aussi possible d'inclure un commentaire dans le message envoyé
au BTS. Si votre interpréteur de commandes ne supprime pas le
commentaire dans une commande telle que "bts severity 30321 normal
#sévérité augmentée", alors ce programme se débrouille pour trouver où
se situe le commentaire et pour l'inclure dans le message. Remarquez
que la plupart des interpréteurs de commandes ne tiennent pas compte de
ce type de commentaires avant d'exécuter le programme, à moins que ce
commentaire soit placé entre guillemets. (Quelque chose comme "bts
severity #85942 normal" ne sera pas traité comme un commentaire.)
Vous pouvez indiquer plusieurs commandes en les séparant par un simple
point, comme pour update-rc.d ; une simple virgule peut aussi être
utilisée ; toutes les commandes seront envoyées dans un seul message.
Il est nécessaire d'entourer les points et les virgules par des espaces
pour ne pas être confondus avec des portions de commandes. Par exemple
(en protégeant ce qui doit l'être de manière à ce que bts voie le
commentaire correctement) :
% bts severity 95672 normal , merge 95672 95673 \#Il s\'agit des mêmes !
L'abréviation "it" peut être utilisée pour désigner le dernier numéro
de bogue mentionné, donc vous pouvez écrire :
% bts severity 95672 wishlist , retitle it "bts : veuillez ajouter une option --toto"
Merci d'utiliser ce programme d'une façon raisonnable et de prendre nos
utilisateurs en considération.
OPTIONS
bts examine les fichiers de configuration de devscripts comme décrit
ci-dessous. Les options en ligne de commande permettent de remplacer
les paramètres des fichiers de configuration.
-o, --offline
Faire en sorte que bts utilise la mise en cache des bogues pour les
commandes show et bugs, si un cache est disponible pour les données
demandées. Veuillez vous reporter à la commande cache ci-dessous
pour plus d'informations sur la mise en place d'un cache.
--online, --no-offline
Contraire de l'option --offline ; écraser toute directive venant
d'un fichier de configuration afin de travailler hors ligne.
-n, --no-action
Ne pas envoyer le courrier, mais l'afficher sur la sortie standard.
--cache, --no-cache
Essayer ou non de mettre en cache de nouvelles versions des pages
du BTS lorsque des commandes show ou bugs sont lancées. Par défaut,
la mise en cache est activée.
--cache-mode={min|mbox|full}
Lors d'une utilisation de la commande bts cache, seulement faire un
miroir basic du bogue (min), inclure aussi la version mbox (mbox),
ou tout l'ensemble, à savoir la mbox et les différents fichiers
joints des pages du BTS, ainsi que les messages de confirmation
(full). Par défaut, min est utilisé.
--cache-delay=secondes
Délai (en secondes) entre deux téléchargements, afin d'éviter de
surcharger le serveur web du BTS. Il est de 5 secondes par défaut.
--mbox
Ouvrir un client de messagerie pour parcourir la boîte de
messagerie ("mbox") correspondant à un numéro de bogue donné, pour
les commandes show et bugs.
--mailreader=CLIENT_DE_MESSAGERIE
Indiquer la commande pour lire la boîte de messagerie ("mbox").
Doit contenir une chaîne "%s", qui sera remplacée par le nom du
fichier mbox. La commande sera découpée en fonction des espaces et
ne sera pas passée à un interpréteur de commandes ("shell"). Par
défaut, "mutt -f %s" sera utilisé (par ailleurs %% sera remplacé
par un simple % si nécessaire).
--cc-addr=CC_ADRESSES_ÉLECTRONIQUES
Envoyer une copie conforme du message à une liste d'utilisateurs.
CC_EMAIL_ADDRESS doit être une liste d'adresses séparées par des
virgules. Peut être utilisée plusieurs fois pour avoir davantage de
copies.
--use-default-cc
Ajouter les adresses indiquées par l'option BTS_DEFAULT_CC du
fichier de configuration à la liste indiquée en utilisant
--cc-addr. C'est le comportement par défaut.
--no-use-default-cc
Ne pas ajouter les adresses indiquées dans BTS_DEFAULT_CC dans la
liste des copies conformes.
--sendmail=COMMANDE_D_ENVOI_DE_MESSAGE
Indiquer la commande d'envoi de message à utiliser. La commande
sera séparée à chaque espace, et non passée à l'interpréteur de
commandes. La valeur par défaut est /usr/sbin/sendmail. L'option -t
est ajoutée automatiquement si la commande est /usr/sbin/sendmail
ou /usr/sbin/exim*. Pour les autres logiciels, l'option -t doit
être incluse dans COMMANDE_D_ENVOI_DE_MESSAGE si nécessaire, par
exemple : --sendmail="/usr/sbin/monutilitaire -t".
--mutt
Utiliser mutt pour l'envoi des messages. Par défaut, mutt n'est pas
utilisé, sauf pour certaines commandes.
Remarquez que $DEBEMAIL ou $EMAIL doivent être configurées dans
l'environnement pour que mutt puisse envoyer des courriers.
--no-mutt
Ne pas utiliser mutt pour l'envoi des messages.
--soap-timeout=secondes
Indiquez un temps limite pour les appels de SOAP tels qu'utilisés
par les commandes select and status.
--smtp-host=SERVEUR_SMTP
Indiquer un serveur SMTP. S'il est fourni, bts enverra les
courriers en utilisant directement ce serveur SMTP plutôt qu'en
utilisant la commande sendmail.
Le nom d'hôte peut être suivi d'un caractère deux-points (":") et
d'un numéro de port afin d'utiliser un port autre que le port par
défaut. Il peut également commencer par "ssmtp://" ou "smtps://"
pour indiquer que le protocole SMTPS doit être utilisé.
Si SMTPS n'est pas spécifié, bts essaiera encore d'utiliser
STARTTLS, s'il est annoncé par l'hôte SMTP.
Remarquez que $DEBEMAIL ou $EMAIL doivent être configurées dans
l'environnement pour l'envoi de courriers par connexion SMTP
directe.
Remarquez qu'en envoyant les courriers directement à un serveur
SMTP, si des adresses de --cc-addr ou BTS_DEFAULT_CC ne sont pas
relayées par le serveur SMTP, alors le serveur SMTP rejettera le
courrier en entier.
Remarquez également que la commande reassign peut, quand le mode
--interactive ou --force-interactive est activé, conduire à l'ajout
automatique d'un Cc pour $nouveau_paquet@packages.debian.org. Dans
ce cas, la note ci-dessus à propos des relais s'applique.
L'interface de soumission (port 587) de reportbug.debian.org ne
prend pas en charge les relais et ne devrait donc pas être utilisée
comme serveur SMTP pour bts dans les circonstances décrites dans ce
paragraphe.
--smtp-username=NOM_UTILISATEUR, --smtp-password=MOT_DE_PASSE
Indiquer les informations d'identification à utiliser pour la
connexion au serveur SMTP indiqué par --smtp-host. Si le serveur ne
nécessite pas d'identification, alors ces options ne devraient pas
être utilisées.
Si un nom d'utilisateur est indiqué mais pas de mot de passe, bts
demandera le mot de passe avant l'envoi du courrier.
--smtp-helo=HELO
Indiquer le nom à utiliser dans la commande HELO lors de la
connexion au serveur SMTP ; par défaut, c'est le contenu du fichier
/etc/mailname, s'il existe.
Remarquez que certains serveurs SMTP peuvent rejeter l'utilisation
d'un HELO qui ne peut pas être résolu ou qui ne semble pas
appartenir à l'hôte qui l'utilise.
--bts-server
Utiliser un serveur debbugs autre que https://bugs.debian.org.
-f, --force-refresh
Télécharger le rapport de bogue à nouveau, même s'il ne semble pas
avoir changé depuis la dernière commande cache. Utile si une option
--cache-mode=full est utilisée la première fois (sinon les rapports
de bogue inchangés ne seront pas téléchargés à nouveau, même si les
parties inintéressantes n'ont pas été téléchargées).
--no-force-refresh
Ne tenir compte d'aucune option --force-refresh venant d'un fichier
de configuration.
--only-new
Ne télécharger que les nouveaux bogues pour la mise en cache. Ne
pas vérifier si les bogues déjà téléchargés ont été modifiés.
--include-resolved
Lors de la mise en cache des rapports de bogue, inclure ceux qui
sont marqués comme étant résolus. C'est le comportement par défaut.
--no-include-resolved
Inverser le comportement de l'option précédente. C'est-à-dire, ne
pas mettre les bogues dans le cache s'ils sont marqués comme étant
résolus.
--no-ack
Supprimer les courriers de confirmation du BTS. Remarquez que cela
n'affectera que les copies des courriers en copie des bogues, pas
celles envoyées par le robot "control".
--ack
Ne pas supprimer les courriers de confirmation. C'est le
comportement par défaut.
-i, --interactive
Avant d'envoyer un courrier au robot "control", afficher son
contenu et permettre de l'éditer ou d'annuler l'envoi.
--force-interactive
Semblable à --interactive, à l'exception qu'un éditeur est lancé
avant de demander la confirmation de l'envoi du courrier.
--no-interactive
Envoyer des courrier à "control" sans confirmation. C'est le
comportement par défaut.
-q, --quiet
En lançant bts cache, n'afficher que les informations concernant
les pages nouvellement mises en cache, et non les messages
indiquant ce qui a déjà été mis en cache. Si cette option est
fournie deux fois, n'afficher que les messages d'erreur, vers la
sortie d'erreur ("stderr").
--no-conf, --noconf
Ne lire aucun fichier de configuration. L'option ne peut être
utilisée qu'en première position de la ligne de commande.
COMMANDES
Pour tous les détails sur les commandes, veuillez consulter la
documentation du BTS. <https://bugs.debian.org/Bugs/server-control>
show [options] [numéro_de_bogue | paquet | responsable | : ] [opt=val
...]
show [options] [src:paquet | from:rapporteur] [opt=val ...]
show [options] [tag:étiquette | usertag:étiquette] [opt=val ...]
show [release-critical | release-critical/... | RC]
C'est un synonyme pour bts bugs.
bugs [options] [numéro_de_bogue | paquet | responsable | : ] [opt=val
...]
bugs [options] [src:paquet | from:rapporteur] [opt=val ...]
bugs [options] [tag:étiquette | usertag:étiquette] [opt=val ...]
bugs [release-critical | release-critical/... | RC]
Afficher la page référençant les bogues demandés dans un navigateur
web en utilisant sensible-browser(1).
Des options peuvent être indiquées après la commande bugs en plus
ou à la place des options au début de la ligne de commande. Les
options reconnues pour l'instant sont : -o/--offline/--online,
-m/--mbox, --mailreader et --[no-]cache. Celles-ci sont expliquées
plus haut dans cette page de manuel. Si -o ou --offline est
utilisée, ou s'il y a déjà une copie à jour dans le cache local,
les versions mises en cache vont être utilisées.
Les significations des paramètres possibles sont les suivantes :
(aucune)
Si rien n'est indiqué, bts bugs va afficher vos bogues, en
supposant que soit DEBEMAIL, soit EMAIL (considérées dans
cet ordre) est définie à l'adresse électronique désirée.
numéro_de_bogue
Afficher le bogue de numéro numéro_de_bogue.
paquet Afficher les bogues du paquet paquet.
src:paquet
Afficher les bogues du paquet source paquet.
responsable
Afficher les bogues dont le responsable a pour adresse
électronique responsable.
from:rapporteur
Afficher les bogues dont le rapporteur a pour adresse
électronique rapporteur.
tag:étiquette
Afficher les bogues marqués avec étiquette.
usertag:étiquette
Afficher les bogues marqués avec l'étiquette utilisateur
étiquette. Veuillez consulter la documentation du BTS pour
plus d'informations sur les étiquettes utilisateur. Cela
nécessite d'utiliser une option users=adresse.
: Les détails concernant le système de suivi de bogues, ainsi
qu'une page de recherche dans les bogues contenant plus
d'options que ce script, peuvent être trouvés à
https://bugs.debian.org/. Cette page peut être ouverte par
la commande bts bugs:.
release-critical, RC
Afficher le sommaire des pages du BTS concernant les
rapports de bogues critiques pour la prochaine publication.
C'est un synonyme pour
https://bugs.debian.org/release-critical/index.html. Il est
aussi possible d'indiquer release-critical/debian/main.html
et de même RC est synonyme de
release-critical/other/all.html.
Après le paramètre indiquant quoi afficher, vous pouvez indiquer
des options facultatives pour formater la page ou changer ce qui
doit être affiché. Celles-ci sont passées au BTS dans l'URL
demandée. Par exemple, passez dist=stable pour afficher les bogues
touchant la version stable d'un paquet, version=1.0 pour voir les
bogues touchant cette version d'un paquet, ou reverse=yes pour
afficher d'abord les messages les plus récents dans le fichier
journal des bogues.
Si la mise en cache a été activée (c'est-à-dire si --no-cache n'a
pas été utilisée et si la variable BTS_CACHE ne vaut pas no), alors
toute page demandée par bts show va être automatiquement mise en
cache et sera donc disponible pour être visualisée plus tard tout
en étant hors ligne. Les pages mises en cache automatiquement de
cette manière seront supprimées lors d'invocations ultérieures de
"bts show|bugs|cache" si on n'y accède pas dans les 30 jours.
Attention : sur un système de fichiers monté avec l'option
"noatime", l'exécution de "bts show|bugs" ne met pas à jour les
heures et dates d'accès aux fichiers du cache ; un bogue mis en
cache sera donc nettoyé automatiquement 30 jours après son
téléchargement initial, même si on y accède entre temps.
Toute autre commande bts suivant cela sur la ligne de commande sera
exécutée après que le navigateur aura été fermé.
Le navigateur voulu peut être indiqué et configuré en définissant
la variable d'environnement BROWSER. Les conventions suivent celles
définies par Eric Raymond à l'adresse
http://www.catb.org/~esr/BROWSER/ ; nous reproduisons ici les
informations pertinentes.
La variable BROWSER peut être constituée d'une série de commandes
de navigateur séparées par des deux-points. Celles-ci devraient
être essayées successivement jusqu'à ce qu'il y en ait une qui
fonctionne. Chaque commande peut contenir la chaîne %s ; si c'est
le cas, celle-ci est remplacée par l'URL à afficher. Si une des
commandes ne contient pas %s, le navigateur est lancé comme si
l'URL avait été indiquée en tant que premier paramètre. La chaîne
%% doit être remplacée par un simple "%".
Justification : nous devons pouvoir indiquer plusieurs navigateurs
de manière à ce que les programmes suivant cette convention
puissent faire ce qu'il faut que ce soit dans un environnement
graphique ou console, en essayant un environnement graphique
d'abord. Indiquer plusieurs commandes peut être utile à ceux qui
partagent des fichiers, comme leur .profile, entre plusieurs
systèmes. %s est nécessaire parce que la plupart des navigateurs
ont une syntaxe qui l'exige. Enfin, %% doit être transformé en %,
sinon il ne serait pas possible d'avoir un %s littéral dans la
chaîne.
Par exemple, sur la plupart des systèmes Linux, une bonne chose à
faire serait :
BROWSER='mozilla -raise -remote "openURL(%s,new-window)":links'
select [clef:valeur ...]
Utiliser l'interface SOAP pour sortir une liste de bogues qui
correspondent à certains critères de recherche.
Les clefs suivantes sont autorisées, et peuvent être utilisées
plusieurs fois.
package Nom d'un paquet binaire.
source Nom d'un paquet source.
maintainer
Adresse électronique du responsable.
submitter
Adresse électronique de l'auteur du bogue.
severity
Sévérité du bogue.
status État du bogue. Soit open, done ou forwarded.
tag Étiquettes attachées au bogue. Si users est indiqué, les
étiquettes peuvent être des "usertags" en plus des
étiquettes traditionnelles.
owner Propriétaire du bogue.
correspondent
Adresse d'une personne qui a envoyé un courrier au journal.
affects Bogues qui affectent ce paquet.
bugs Liste de bogues dans lesquels chercher.
users Utilisateurs à utiliser pour la recherche d'étiquettes
utilisateur ("usertags").
archive Rechercher des bogues archivés ou des bogues normaux ; la
valeur par défaut est 0 (c'est-à-dire ne chercher que les
bogues normaux). Une valeur particulière, both, permet de
rechercher à la fois parmi les bogues archivés et non
archivés.
Par exemple, pour sélectionner l'ensemble des bogues envoyés par
undéveloppeur@example.com qui ont l'étiquette wontfix, on utilisera
bts select submitter:undéveloppeur@example.com tag:wontfix
Si une clef est utilisée plusieurs fois alors les bogues
sélectionnés sont ceux qui correspondent à une des valeurs
fournies ; par exemple
bts select package:toto severity:wishlist severity:minor
renvoie tous les bogues du paquet toto de sévérité wishlist ou
minor.
status [bogue | file:fichier | fields:champ[,champ ...] | verbose] ...
Utiliser l'interface SOAP pour fournir les informations d'état pour
les bogues indiqués (ou lus dans les fichiers fournis ; utilisez -
pour indiquer l'entrée standard).
Par défaut, tout les champs existants du bogue sont affichés.
Si verbose est fournie, les champs vides sont également affichés.
Si fields est fournie, seuls ces champs seront affichés. Aucune
vérification de validité n'est réalisée sur les champs indiqués.
clone bogue nouvel_ID [nouvel_ID ...]
La commande de contrôle clone vous permet de dupliquer un rapport
de bogue. C'est utile dans le cas où un rapport de bogue unique
indique en fait que plusieurs bogues distincts se produisent. Les
"nouveaux ID" sont des nombres négatifs, séparés par des espaces,
qui peuvent être utilisés dans les commandes de contrôle suivantes
pour se référer aux rapports de bogue nouvellement dupliqués. Un
nouveau rapport de bogue est produit pour chaque nouvel
identifiant.
done bogue [version]
Fermer le bogue. Le mode interactif est forcé puisqu'un message de
fermeture doit contenir une explication. La version du paquet dans
laquelle le bogue a été corrigé doit si possible être indiquée.
reopen bogue [rapporteur]
Réouvrir un bogue, avec rapporteur optionnel.
archive bogue
Archiver un bogue qui a déjà été archivé, mais ne l'est plus. Le
bogue doit satisfaire à tous les critères pour les bogues archivés,
à l'exception de ceux basés sur le temps.
unarchive bogue
Désarchiver un bogue qui est déjà archivé.
retitle bogue titre
Changer le titre du bogue.
summary bogue [numéro_message]
Sélectionner un numéro de message qui doit être utilisé comme
résumé d'un bogue.
Si aucun numéro de message n'est fourni, le résumé est supprimé.
submitter bogue [bogue ...] adresse-du-rapporteur
Changer l'adresse électronique du rapporteur du ou des bogues, où !
signifie "utiliser l'adresse électronique actuelle en tant que
nouvelle adresse du rapporteur".
reassign bogue [bogue ...] paquet [version]
Réassigner un bogue ou un ensemble de bogues à un paquet différent.
Le champ version est optionnel ; veuillez consulter les
explications sur <https://www.debian.org/Bugs/server-control>.
found bogue [version]
Indiquer qu'un bogue a été découvert dans une version particulière
d'un paquet. Sans version, la liste des versions corrigées est
effacée et le bogue est rouvert.
notfound bogue version
Enlever l'indication concernant la version dans laquelle ce bogue a
été découvert.
fixed bogue version
Indiquer qu'un bogue a été corrigé dans une version particulière
d'un paquet, sans changer l'état ouvert ou fermé du bogue.
notfixed bogue version
Enlever l'indication que ce bogue est corrigé dans une version
donnée.
Cette commande est équivalente à la séquence "found bogue version",
"notfound bogue version".
block bogue by|with bogue [bogue ...]
Enregistrer que la résolution d'un bogue est bloquée par un
ensemble d'autres bogues.
unblock bogue by|with bogue [bogue ...]
Enregistrer que la résolution d'un bogue n'est plus bloquée par un
ensemble d'autres bogues.
merge bogue bogue [bogue ...]
Fusionner plusieurs bogues.
forcemerge bogue bogue [bogue ...]
Forcer la fusion d'un ensemble de bogues entre eux. Le premier
bogue est le bogue maître et sa configuration (cette configuration
qui doit correspondre pour les fusions normales avec merge) est
donnée à tous les bogues qui suivent.
unmerge bogue
Annuler la fusion d'un bogue.
tag bogue [+|-|=] étiquette [étiquette ..]
tags bogue [+|-|=] étiquette [étiquette ..]
Ajouter ou retirer une étiquette à un bogue. L'étiquette peut être
indiquée par son nom exact ou être abrégée en la plus courte
sous-chaîne unique. (Ainsi fixed va ajouter l'étiquette fixed et
non fixed-upstream, par exemple, mais fix ne sera pas accepté.)
Plusieurs étiquettes peuvent être indiquées simultanément. Les deux
commandes (tag et tags) sont identiques. Il est nécessaire
d'indiquer au moins une étiquette, à moins que l'argument = ne soit
utilisé ; la commande
bts tags <bogue> =
va supprimer toutes les étiquettes du bogue indiqué.
L’ajout ou suppression de l’étiquette security ajoutera
"team\@security.debian.org" en copie du message de contrôle.
La liste des étiquettes valables et leur signification sont
disponibles à l'adresse
<https://www.debian.org/Bugs/Developer#tags>. Les étiquettes
valables actuellement sont les suivantes :
patch, wontfix, moreinfo, unreproducible, help, newcomer, pending,
security, upstream, confirmed, fixed, fixed-upstream, fixed-in-
experimental, d-i, ipv6, lfs, l10n, a11y
Il y aussi une étiquette pour chaque version de Debian depuis
"Potato". Remarquez que cette liste peut être obsolète, consultez
le site web pour avoir la source la plus à jour.
affects bogue [+|-|=] paquet [paquet ...]
Indiquer qu'un bogue affecte un paquet autre que celui pour lequel
il est enregistré ; le bogue sera listé par défaut dans la liste
des bogues de l'autre paquet. Ce n'est généralement à utiliser que
si le bogue est suffisamment important et si de nombreux bogues
sont remontés sur le mauvais paquet par des utilisateurs. Au moins
un paquet doit être indiqué, sauf si l'attribut = est utilisé, où
la commande
bts affects <bogue> =
va supprimer toutes les indications que le bogue affecte d'autres
paquets.
user adresse
Indiquer l'adresse électronique d'un utilisateur avant d'utiliser
la commande usertags.
usertag bogue [+|-|=] étiquette [étiquette ...]
usertags bogue [+|-|=] étiquette [étiquette ...]
Ajouter ou retirer une étiquette utilisateur à un bogue. Le nom
exact de celle-ci doit être utilisé ; il n'y a ni valeur par défaut
ni vérification de la validité des noms d'étiquette. Plusieurs
étiquettes peuvent être indiquées simultanément. Les deux commandes
(usertag et usertags) sont identiques. Il est nécessaire d'indiquer
au moins une étiquette utilisateur, à moins que l'argument = ne
soit utilisé ; la commande
bts usertags <bogue> =
va supprimer toutes les étiquettes utilisateur du bogue indiqué.
claim bogue [adresse]
Enregistrer que vous avez réclamé un bogue (par exemple pour une
bug squashing party). adresse doit être une chaîne unique
permettant d'identifier les bogues que vous avez réclamé ; une
adresse électronique est souvent utilisée.
Si aucune adresse n'est fournie, les variables d'environnement
DEBEMAIL et EMAIL sont utilisées (dans cet ordre).
unclaim bogue [adresse]
Supprimer votre revendication pour un bogue.
Si aucune adresse n'est fournie, les variables d'environnement
DEBEMAIL et EMAIL sont utilisées (dans cet ordre).
severity bogue sévérité
Changer la sévérité d'un bogue. Les sévérités possibles sont :
wishlist, minor, normal, important, serious, grave et critical.
Cette sévérité peut être abrégée en une sous-chaîne unique.
forwarded bogue adresse
Marquer le bogue comme transmis à l'adresse donnée (normalement une
adresse électronique ou une URL pour un système de suivi amont).
notforwarded bogue
Marquer le bogue comme n'ayant pas été transmis.
package [paquet ...]
Les commandes suivantes ne vont s'appliquer qu'aux bogues touchant
les paquets indiqués ; il s'agit d'un mécanisme de sûreté pour le
BTS. Si aucun paquet n'est listé, cette vérification est désactivée
à nouveau.
limit [clef[:valeur]] ...
Les commandes suivantes ne vont s'appliquer qu'aux bogues
correspondant aux critères indiqués ; il s'agit d'un mécanisme de
sûreté pour le BTS. Si aucune valeur n'est indiquée, les limites
pour cette clef sont désactivées. Si aucune clef n'est indiquée,
les limites sont remises à zéro.
submitter
Adresse électronique de l'auteur du bogue.
date Date à laquelle le bogue a été soumis.
subject Sujet du bogue.
msgid Identifiant du message du rapport de bogue initial.
package Nom d'un paquet binaire.
source Nom d'un paquet source.
tag Étiquettes du bogue.
severity
Sévérité du bogue.
owner Propriétaire du bogue.
affects Bogues qui affectent ce paquet.
archive Rechercher des bogues archivés ou des bogues normaux ; la
valeur par défaut est 0 (c'est-à-dire ne chercher que les
bogues normaux). Une valeur particulière, both, permet de
rechercher à la fois parmi les bogues archivés et non
archivés.
Par exemple, pour limiter l'ensemble des bogues pour lesquels vont
s'appliquer les commandes de contrôle qui suivent à ceux envoyés
par undéveloppeur@example.com qui ont l'étiquette wontfix, on
utilisera
bts limit submitter:undéveloppeur@example.com tag:wontfix
Si une clef est utilisée plusieurs fois alors les bogues
sélectionnés sont ceux qui correspondent à une des valeurs
fournies ; par exemple
bts limit package:toto severity:wishlist severity:minor
n'applique les commandes de contrôle qui suivent qu'aux bogues du
paquet toto avec pour sévérité wishlist ou minor.
owner bogue adresse-du-propriétaire
Changer l'adresse électronique du "propriétaire" du bogue, où !
signifie "utiliser l'adresse électronique actuelle comme nouvelle
adresse de propriétaire".
Le propriétaire d'un bogue accepte la responsabilité de s'en
occuper.
noowner bogue
Marquer un bogue comme n'ayant pas de "propriétaire".
subscribe bogue [adresse]
Abonner l'adresse électronique donnée au rapport de bogue indiqué.
Si aucune adresse n'a été fournie, la variable d'environnement
DEBEMAIL ou EMAIL (dans cet ordre) est utilisée. Si aucune n'est
définie, ou si ! est donné comme adresse électronique, votre
adresse par défaut va être utilisée.
Après avoir exécuté cette commande, vous allez recevoir une
confirmation d'abonnement à laquelle vous devez répondre. En étant
abonné à un rapport de bogue, vous allez recevoir tous les messages
et notifications pertinents. Utilisez la commande unsubscribe pour
vous désabonner.
unsubscribe bogue [adresse]
Désabonner l'adresse électronique utilisée du rapport de bogue
indiqué. Comme pour la commande subscribe décrite ci-dessus, si
aucune adresse n'a été fournie, la variable d'environnement
DEBEMAIL ou EMAIL (dans cet ordre) est utilisée. Si aucune n'est
définie, ou si ! est donné comme adresse électronique, votre
adresse par défaut va être utilisée.
Après avoir exécuté cette commande, vous allez recevoir une
confirmation de désabonnement à laquelle vous devez répondre.
Utilisez la commande subscribe, évidemment, pour vous abonner.
reportspam bogue ...
La commande reportspam vous permet de signaler un rapport de bogue
comme contenant du pourriel. Cela évite de passer par la page web
du rapport de bogue pour ce faire.
spamreport bogue ...
spamreport est synonyme de reportspam.
cache [options] [adresse_resp.] | paquet | src:paquet |
from:rapporteur]
cache [options] [release-critical | release-critical/... | RC]
Créer ou mettre à jour le cache des rapports de bogue pour
l'adresse électronique ou le paquet indiqué. Par défaut, cela
télécharge tous les bogues appartenant à l'adresse électronique
stockée dans la variable d'environnement DEBEMAIL (ou dans la
variable d'environnement EMAIL si DEBEMAIL n'est pas définie).
Cette commande peut être répétée pour mettre en cache des bogues
appartenant à plusieurs personnes ou touchant plusieurs paquets. Si
plusieurs paquets ou adresses sont fournis, les bogues
correspondant à l'un des paramètres seront mis en cache ; ceux
correspondant à plusieurs paramètres ne seront téléchargés qu'une
seule fois. Les bogues mis en cache sont stockés dans
$XDG_CACHE_HOME/devscripts/bts/ ou, si XDG_CACHE_HOME n'est pas
défini, dans ~/.cache/devscripts/bts/.
Vous pouvez utiliser le cache grâce à l'option -o. Par exemple :
bts -o bugs
bts -o show 12345
Ainsi, une fois que le cache est mis en place, bts va mettre à jour
les fichiers contenus dans celui-ci au coup par coup quand il
télécharge des informations depuis le BTS avec la commande show. Il
est donc possible de mettre en place un cache, et de le mettre à
jour une fois par semaine, tout en laissant les mises à jour
automatiques se faire pour les bogues auxquels vous accédez
fréquemment pendant la semaine.
Certaines options modifient le comportement de la commande cache.
La première est --cache-mode, qui contrôle à quel point bts
télécharge les liens référencés depuis la page du bogue, ce qui
inclut des choses pénibles comme les messages de confirmation, les
messages au robot de contrôle, et la version mbox du rapport de
bogue. Trois valeurs sont acceptées : min (le minimum), mbox
(télécharger le minimum plus la version mbox du rapport de bogue)
ou full. La seconde option qui modifie le comportement de la
commande cache est --force-refresh ou -f, qui force le
téléchargement, même si le rapport de bogue mis en cache est à
jour.L'option --include-resolved indique si les rapports de bogue
marqués comme étant résolus doivent être téléchargés lors de la
mise en cache.
Toutes ces options sont configurables dans le fichier de
configuration, comme décrit ci-dessous. Elles peuvent aussi bien
être indiquées après la commande cache qu'au début de la ligne de
commande.
Enfin, -q ou --quiet supprime les messages indiquant que le cache
est à jour et utiliser cette option deux fois va supprimer tous les
messages à propos du cache (à l'exception des messages d'erreur).
Attention à la mise en cache RC : cela met vraiment LONGTEMPS !
(Avec plus de mille bogues RC et un délai de 5 secondes entre
chaque bogue, vous allez avoir besoin d'un minimum d'une heure et
demie, et probablement bien plus que ça.)
cleancache paquet | src:paquet | responsable
cleancache from:rapporteur | tag:étiquette | usertag:étiquette | numéro
| ALL
Supprimer le cache du paquet, responsable, etc., indiqué, comme
décrit plus haut dans la commande bugs, ou supprimer tout le cache
si ALL est indiqué. C'est utile si vous avez un accès permanent au
réseau ou si la base de données a été corrompue pour une raison
quelconque. Remarquez que par sécurité, la commande ne prendra pas
la valeur de DEBEMAIL ou EMAIL par défaut.
listcachedbugs [numéro]
Lister les identifiants des bogues mis en cache (en prévision de la
prise en charge du complément pour bash). L'argument optionnel de
numéro limite la liste aux bogues dont l'identifiant débute par ce
numéro.
version
Afficher la version et le copyright.
help
Afficher un court résumé des commandes, de manière similaire à
certaines parties de cette page de manuel.
VARIABLES D'ENVIRONNEMENT
DEBEMAIL
Si cela est défini, la ligne From: du message va être configurée
pour utiliser cette adresse électronique au lieu de votre adresse
habituelle (qui serait déterminée par mail).
DEBFULLNAME
Si DEBEMAIL est définie, DEBFULLNAME est examinée pour déterminer
le nom complet à utiliser ; sinon bts essaie de déterminer un nom à
partir de votre entrée passwd.
BROWSER
Si elle est définie, elle indique le navigateur à utiliser pour les
options show et bugs. Consultez la description précédente.
VARIABLES DE CONFIGURATION
Les deux fichiers de configuration /etc/devscripts.conf et
~/.devscripts sont chargés dans cet ordre par un interpréteur de
commandes pour définir les variables de configuration. Des options de
ligne de commande peuvent être utilisées pour écraser les paramètres
des fichiers de configuration. Les paramètres des variables
d'environnement sont ignorés à cette fin. Les variables actuellement
reconnues sont :
BTS_OFFLINE
Lui attribuer la valeur yes équivaut à utiliser le paramètre en
ligne de commande --offline. Cela n'affecte que les commandes show
et bugs. La valeur par défaut est no. Veuillez consulter la
description de la commande show ci-dessus pour plus d'informations.
BTS_CACHE
Lui attribuer la valeur no, équivaut à utiliser le paramètre en
ligne de commande --nocache. Cela n'affecte que les commandes show
et bug. La valeur par défaut est yes. À nouveau, veuillez consulter
la commande show ci-dessus pour plus d'informations.
BTS_CACHE_MODE={min,mbox,full}
Quantité de données du BTS à récupérer quand le cache est demandé.
Seulement le minimum, ou alors la mbox ou bien encore le tout. La
valeur par défaut est min, ce qui a la même signification que le
paramètre de l'option de ligne commande --cache-mode. Cela
n'affecte que le cache. Consultez la documentation de la commande
cache pour plus d'informations.
BTS_FORCE_REFRESH
Lui attribuer la valeur yes, équivaut à utiliser le paramètre en
ligne de commande --force-refresh. Cela n'affecte que la commande
cache. La valeur par défaut est no. Veuillez consulter la commande
cache pour plus d'informations.
BTS_MAIL_READER
Si elle est définie, elle indique le client de messagerie à
utiliser à la place de mutt. Équivalent à l'option de ligne de
commande --mailreader.
BTS_SENDMAIL_COMMAND
Si elle est définie, elle indique la commande d'envoi de message à
utiliser à la place de /usr/sbin/sendmail. Équivaut à l'option de
ligne de commande --sendmail.
BTS_ONLY_NEW
Ne télécharger que les nouveaux bogues pour la mise en cache. Ne
pas vérifier si les bogues déjà téléchargés ont été modifiés. La
valeur par défaut est no. Identique à l'option en ligne de commande
--only-new.
BTS_SMTP_HOST
Si elle est définie, elle indique un serveur SMTP à utiliser pour
envoyer les courriers au lieu d'utiliser la commande sendmail.
Équivaut à l'option en ligne de commande --smtp-host.
Remarquez que cette option a la priorité par rapport à
BTS_SENDMAIL_COMMAND si les deux sont utilisées, à moins que
l'option --sendmail soit utilisée.
BTS_SMTP_AUTH_USERNAME, BTS_SMTP_AUTH_PASSWORD
Définir ces options équivaut à utiliser les options --smtp-username
et --smtp-password.
BTS_SMTP_HELO
Identique à l'option en ligne de commande --smtp-helo.
BTS_INCLUDE_RESOLVED
Lui attribuer la valeur no équivaut à utiliser le paramètre en
ligne de commande --no-include-resolved. Cela n'affecte que la
commande cache. La valeur par défaut est yes. Veuillez consulter la
commande cache pour plus d'informations.
BTS_SUPPRESS_ACKS
Lui attribuer la valeur yes équivaut à utiliser l'option --no-ack.
La valeur par défaut est no.
BTS_INTERACTIVE
Lui attribuer la valeur yes ou force équivaut à utiliser l'option
--interactive ou --force-interactive. La valeur par défaut est no.
BTS_DEFAULT_CC
Indiquer une liste d'adresses électroniques auxquelles une copie
conforme des courriers, créés pour le robot "control", doit être
envoyée automatiquement.
BTS_SERVER
Indiquer le nom d'un serveur debbugs qui doit être utilisé à la
place de https://bugs.debian.org.
VOIR AUSSI
Veuillez consulter <https://www.debian.org/Bugs/server-control> pour
plus de détails sur comment contrôler le BTS avec des courriers et
<https://www.debian.org/Bugs/> pour plus d'informations sur le BTS.
querybts(1), reportbug(1), pts-subscribe(1), devscripts.conf(5)
COPYRIGHT
Ce programme est Copyright (C) 2001-2003 by Joey Hess
<joeyh@debian.org>. De nombreuses modifications ont été effectuées,
Copyright (C) 2002-2005 Julian Gilbey <jdg@debian.org> et Copyright (C)
2007 Josh Triplett <josh@freedesktop.org>.
Il est publié sous les termes de la Licence Publique Générale (GPL)
version 2 ou toute version ultérieure (à votre discrétion).
TRADUCTION
Cyril Brulebois <cyril.brulebois@enst-bretagne.fr>, 2006
Thomas Huriaux <thomas.huriaux@gmail.com>, 2006
David Prévot <david@tilapin.org>, 2010-2013
Xavier Guimard <yadd@debian.org>, 2018-2021
Utilitaires Debian 2023-10-20 BTS.FR(1)
Generated by dwww version 1.15 on Sat Jun 29 01:54:42 CEST 2024.