NOM¶

bts - Interface en ligne de commande pour le système de bogues de Debian (BTS)

SYNOPSIS¶

EXEMPLE¶

 $ bts severity 69042 normal
 $ bts merge 69042 43233
 $ bts retitle 69042 Ceci est une meilleure description du bug

 $ bts severity 69042 normal , merge with 43233 , retitle Un autre title

 $ bts severity 69042 normal , merge it 43233 , retitle it Another title
 $ bts severity 69042 normal , merge -1 43233 , retitle -1 Another title

 $ bts show 69042         # in a browser
 $ bts show --mbox 69042  # in a mailreader - all messages

 $ bts show wget          # all bugs in a package
 $ bts show from:$EMAIL   # reported by you

 $ bts show --mbox             # in packages maintenu par vous
 $ bts show --mbox deb@e.mail  # .. ou quelqu'un d'autre
 $ bts show --mbox src:wget    #dans un paquet source

 $ bts reply 43233            # répondre au bogue n° 43233
 $ bts reply 43233 , done     # .. et ajouter un pseudo-en-tête pour clôturer
 $ bts done 43233 , reply     # .. l'inverse fonctionne aussi
 # Référencer un message
 $ bts reply 43233#15         # répond au bug n° 43233 en référençant le message 15
 $ bts reply 43233#15 , done  # .. et ajoute un Control: pseudo en-tête pour clôturer

 $ bts reply -                  # répond et référence le message de bug passé en "pipe"
 $ bts reply - , close          #.. et clôture le bug
 $ bts severity normal , close  #.. 'reply -' est implicite dans un MUA supporté

 $ bts context , retitle 'flub: Does not nub!' , reassign flub

 $ bts subscribe 69042

 $ bugs=$(bts select src:libc6)
 $ for bug in $bugs; do echo $bug a besoin d'être corrigé; done

DESCRIPTION¶

bts est l'interface en ligne de commande du système de suivi des bugs de Debian (BTS). Il est prévu pour être utilisé par les contributeurs de Debian et donc *vous* puisque vous êtes en train de lire ce message.

bts facilite les nombreuses tâches courantes impliquant les bogues dans Debian et améliore le flux de travail grâce à des capacités hors ligne via un cache local.

 $ bts severity Bug#85942 normal
 $ bts severity \#85942 normal

 $ bts severity 30321 normal \#Pas aussi grave qu'annoncé

 $ bts severity 30321 normal '# Toujours pas si grave'

 $ bts severity 95672 normal , done 96642 0.38-7 \#Fixed by fix-it.patch

 $ bts severity 95672 normal , merge 95672 95673 \#Il s\'agit des mêmes !

 $ bts severity 95672 wishlist , retitle it "bts : veuillez ajouter une option --toto"

 $ bts done 95672 , fixed 0.1-3

 $ bts reopen 95672 , merge with 123456   # is equivalent to:
 $ bts reopen 95672 , merge -1 123456
 $ bts reopen 95672 , blocked by 123456   # is equivalent to:
 $ bts reopen 95672 , blocked -1 123456

 $ bts done 95672 , clone to -1 -2        # is equivalent to:
 $ bts done 95672 , clone 95672 to -1 -2

 $ bts done 95672 , clone -1 -1 -2        # expands to:
 $ bts done 95672 , clone 95672 -1 -2

 $ bts clone 95672 to -1 -2 , done        # expands to:
 $ bts clone 95672 to -1 -2 , done 95672

 $ bts clone 95672 to -1 -2 , done -1     # is already fully expanded.

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.

Options de mode de travail

Voir aussi « Méthodes de travail » dans DESCRIPTION.

-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 0 secondes par défaut.

--mailreader=COMMANDE

Une commande (shell) invoquée pour lire une boîte aux lettres de bogue.

The COMMAND must contain the replacement marker "%s" which is expanded to path to an mbox file.

Default depends on mailreaders available on the system. See BTS_MAIL_READER config option.

--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

Spécifie la commande du système de messagerie (compatible sendmail) à utiliser pour l'envoi de courriels.

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".

Conflicts with explicit --mutt, --smtp-hots and --smtp-reportbug. Overrides implicit --mutt and BTS_SMTP_HOST.

--mutt

Use interactive command line mail client (BTS_MUTT_COMMAND) for sending of mails instead of SMTP (--smtp-host) or system mailer (--sendmail).

Remarquez que $DEBEMAIL ou $EMAIL doivent être configurées dans l’environnement pour que mutt puisse envoyer des courriers.

If --mutt is given --interactive and --force-interactive are ineffective.

--mutt est implicite lorsque bts est appelé depuis un client mail en ligne de commande (déterminé par $_, voir BTS_MUTT_COMMAND) et le système de courriel est actif (--mail, BTS_WORKFLOW=mail).

--no-mutt

Cancel implicit or explicit --mutt reverting to sending with SMTP or system mailer instead.

--soap-timeout=secondes

Timeout when fetching bug status information from the BTS in --online mode.

Defaults to 5 seconds when --interactive or --mutt are active; 30 seconds otherwise (--no-interactive).

--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.

En conflit avec --mutt et --sendmail. Écrasé par --smtp-reportbug.

--smtp-reportbug

Utilise le serveur SMTP de reportbug.debian.org pour envoyer les rapports de bug et les requêtes de changement (ni enregistrement ni authentification requis).

Équivalent à --smtp-host=reportbug.debian.org:587 --interactive.

Note that reportbug.debian.org is rate limited to a small number of mails per hour and only email destined for bugs.debian.org is accepted. Consequently using --cc-addr, BTS_DEFAULT_CC, reply or reassign commands will likeley cause mails to be rejected while sending.

--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 celui par défaut 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, afficher son contenu et permettre de l’éditer ou d’annuler l’envoi.

--force-interactive

Force interactive editing immediately. Similar to --interactive, except editor is spawned before the send/cancel/edit prompt.

--no-interactive

Envoyer immédiatement les courriels de demande de modification de bogue sans confirmation.

This is the default behaviour except if --mutt is implicitly active and for some commands which require composing a written reply (done, reply).

-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>

bugs [options] [numéro_de_bogue | paquet | responsable | : ] [opt=val ...]

show [options] [numéro_de_bogue | paquet | responsable | : ] [opt=val ...]

bugs [options] [src:paquet | from:rapporteur] [opt=val ...]

show [options] [src:paquet | from:rapporteur] [opt=val ...]

bugs [options] [tag:étiquette | usertag:étiquette] [opt=val ...]

show [options] [tag:étiquette | usertag:étiquette] [opt=val ...]

bugs [release-critical | release-critical/... | RC]

show [release-critical | release-critical/... | RC]

Display selected bugs in a web browser (default or --web) or in a mail reader when --mbox is given.

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.

When using --mbox reading more than one bug report's mails at once using the argument syntax described below is possible.

Les significations des paramètres possibles sont les suivantes :

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.

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.

reply [bogue | numéro-bogue#numéro-message | -]

Composer une réponse à un bogue du BTS incluant les modifications du bogue.

A draft is prepared, quoting message-no or the latest non-automated message taken from either 1) the bug-number's online MBOX message archive or 2) the MBOX or single raw email message written to standard input (-).

All other bug change commands given are included in the mail as pseudoheader lines -- mostly 'Control:' but more idiomatic headers bts knows about may be used instead.

A reply command reading from STDIN is executed implicitly before other commands when bts is invoked from a supported MUA (see --mutt). The implicit command is cancelled when an explicit reply, context, show|bugs or status command is present.

context

Lire un courriel ou une boîte MBOX depuis l'entrée standard pour établir le contexte implicite du bogue.

Similar to reply but for sending plain control@ messages without including a written rationale.

clone [bug] [to] new_ID [new_ID ...]

La commande clone duplique un rapport de bogue.

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 [bug] [in|by|since] [version]

close [bug] [in|by|since] [version]

Indiquer qu'aucune action supplémentaire n'est attendue sur bogue.

Changes bug's completion state to "done", closing it for now. Optionally add a version tracking record that it was fixed in version.

The BTS will record who completed a bug. You can see this in the bug status 'done' field:

    $ bts status 123456 fields:done
    

The done command always asks you to compose a mail interactively. Please document why the bug is being closed in your message.

While you should specify which version of the package fixed the bug if possible you can also do this later with the fixed command.

Bugs which remain closed for about a month without email activity are archived (made read-only). Use unarchive to undo this.

Closed, but non-archived bugs can be reopened with the found command.

reopen [bug] [submitter]

(Obsolète) Indique qu'un bogue (bug) précédemment marqué comme résolu (done) doit être traité à nouveau par le responsable. Il est possible de modifier submitter – l'utilité de cette modification dans ce contexte n'est pas évidente.

Clears all fixed version tracking records only if bug is currently closed -- not very predictable behaviour and it is somewhat rude.

Instead prefer the more predictable found command (without arguments) if you really want to do this, but also consider the more respectful approach documented there.

archive [bug]

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 [bug]

Désarchiver un bogue qui est déjà archivé.

retitle [bug] title

Changer le titre du bogue.

summary [bug] [messagenum]

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 ...] 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".

assign [bug ...] [to] package[,package ...] [version]

reassign [bug ...] [to] package[,package ...] [version]

Change the assigned package set for all bugs given. This indicates all the specified bugs are presumed to need fixing in one of these packages.

Clears all existing version tracking records (found and fixed) for each bug. If the optional version is given a 'found' record for the new packages is added. If the affected version is is not yet known use the found command once an analysis is available.

If other packages are merely receiving unactionable reports use the affects command to make the bug show up in their bug listings.

If the bug is likeley to need individual fixes across several packages you should instead clone the bug and reassign the clone to the other package(s). For example:

 $ bts clone 69042 to -1 , assign -1 to other-package
    

The command adds the maintainers of the new package to CC if --mutt or --force-interactive are active.

found [bug] [in] [source-package/]version

Ajouter un enregistrement de suivi de version pour indiquer que bogue a été trouvé dans la version donnée du paquet binaire auquel bogue est actuellement assigné ou paquet-source si indiqué.

This implicitly changes bug's completion state to not done indicating it should be acted upon by the maintainer unless version is less than the current highest fixed version on record, see:

    $ bts status 123456 fields:fixed_versions
    

found [bug]

(Expert) Clear all fixed version tracking records in bug and change it's completion state to indicate that it is not done and should be acted upon my the maintainer -- this is somewhat rude so you better be sure.

To be respectful consider using the reply command and appeal to the maintainer for why they should still act on the bug. You can simultaniously use additional found commands to record which versions you can demonstrate to be affected in the BTS.

notfound [bug] [in] [source-package/]version

Supprimer un enregistrement erroné indiquant que bogue est présent dans la version donnée du paquet binaire auquel il est actuellement assigné ou paquet-source si indiqué.

Do not use this if changes were actively made in Debian to address bug. Use done or fixed instead as appropriate.

Version tracking records for a bug are cleared entirely by the reassign command.

fixed [bug] [in|by|since] [source-package/]version

Add a version tracking record to indicate a closed bug was also fixed in version of the binary package bug is currently assigned to or source-package if given.

This does not affect bug's completion state. Use the done command to indicate no further action is expected on a bug instead.

notfixed [bug] [in|by|since] [source-package/]version

Supprimer un enregistrement de suivi de version ajouté par erreur indiquant que bogue est corrigé dans la version donnée du paquet binaire auquel il est actuellement assigné ou paquet-source si indiqué.

This does not affect bug's completion state. Use the found command to reopen a bug that was erroniously marked done and fixed in version.

If the bug is not assigned to the correct package use the reassign command instead which also removes all version tracking records.

Cette commande est équivalente à la séquence "found bogue version", "notfound bogue version".

block [bug] [by|with] blocker-bug [blocker-bug ...]

blocked [bug] [by|with] blocker-bug [blocker-bug ...]

Enregistrer que la résolution d’un bogue est bloquée par un ensemble d’autres bogues.

unblock [bug] [from|with|by] blocker-bug [blocker-bug ...]

Supprimer les enregistrements indiquant que la résolution de bogue est bloquée par chacun des bogues bloquants.

merge [bug] [with] bug [bug ...]

Fusionner plusieurs bogues.

forcemerge [bug] [with] bug [bug ...]

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 [bug]

Annuler la fusion d’un bogue.

tag [bug] [+|-|=] tag [tag ...]

tags [bug] [+|-|=] tag [tag ...]

Add or remove a tags on a bug. The tag must be from the predefined list of valid tags below or abbreviated to a unique substring of one.

affects [bug] [+|-|=] package [package ...]

Record that a bug affects a package other than the bug's assigned package.

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 [bug] [+|-|=] [tag-libre ...]

usertags [bug] [+|-|=] [tag-libre ...]

Mirrors tags command, but with freeform tags namespaced by preceding user command or $EMAIL/$DEBEMAIL (in that order) from the environment.

Add or remove freeform "usertags" on a bug. The name of freeform-tags must be exact, there is no pre-defined list of valid tag names unlike with the tags command.

See tags command for detailed usage. TODO: check usage is exactly the same regarding '+moreinfo' vs '+ moreinfo'.

claim [bug] [for] [claim]

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).

See <https://lists.debian.org/msgid-search/20050908170731.GA20584@cyan.localnet>.

unclaim [bug] [for] [claim]

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 [bug] severity

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 [bug] address

Marquer le bogue comme transmis à l’adresse donnée (normalement une adresse électronique ou une URL pour un système de suivi amont).

notforwarded [bug]

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.

propriétaire [bug] courriel-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 [bug]

disown [bug]

Marquer un bogue comme n’ayant pas de "propriétaire".

subscribe [bug] [email] [email]

Abonne l'adresse mail donnée aux rapports du bogue indiqué.

Si aucune adresse électronique n'est indiquée, 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.

Utiliser la commande unsubscribe pour annuler l'abonnement.

unsubscribe [bug ...] [email] [email]

Désabonne l'adresse mail donnée des rapports du bogue indiqué.

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.

Vous allez recevoir une confirmation de désabonnement à laquelle vous devez répondre.

Currently there is no self-service mechanism to list all your subscriptions or to unsubscribe from all bugs. Contact the Debian Listmaster Team <https://wiki.debian.org/Teams/ListMaster> who are responsible for the bug subscription infrastructure.

spamreport [bug] ...

reportspam [bug] ...

Record that bug constains SPAM messages. A Debian contributor will review the bug log and remove the offending message(s).

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_WORKFLOW={mail,web}

Définir le mode de travail par défaut. Remplacé par les « Options de mode de travail » --mail et --web, voir OPTIONS. Voir aussi « Méthodes de travail » dans DESCRIPTION.

Lorsque défini à mail, débloque l'activation implicite de --mutt.

BTS_MAIL_READER

Client de messagerie interactif en ligne de commande (MUA) à utiliser pour lire les fichiers de boîte aux lettres avec le mode courriel (--mail, BTS_WORKFLOW=mail).

La valeur par défaut dépend des lecteurs de courrier disponibles sur le système. Les suivants sont essayés dans l'ordre (le premier correspondant gagne) :

BTS_MUTT_COMMAND

Interactive command-line mail client (MUA) to use for interactively composing and sending mails when --mutt is active or implied.

Default depends on mail clients available on the system. The following are tried in order:

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_REPORTBUG

If set to yes use Debian's open submission reportbug.debian.org SMTP server to send bug reports and change requests. No account registration or authentication is needed but submissions are rate-limited to a couple per hour.

If set to yes it is equivalent to setting both BTS_SMTP_HOST=reportbug.debian.org:587 and BTS_INTERACTIVE=yes.

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-2024