.\" Automatically generated by Pod::Man 4.10 (Pod::Simple 3.35) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" Set up some character translations and predefined strings. \*(-- will .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left .\" double quote, and \*(R" will give a right double quote. \*(C+ will .\" give a nicer C++. Capital omega is used to do unbreakable dashes and .\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff, .\" nothing in troff, for use with C<>. .tr \(*W- .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' .ie n \{\ . ds -- \(*W- . ds PI pi . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch . ds L" "" . ds R" "" . ds C` "" . ds C' "" 'br\} .el\{\ . ds -- \|\(em\| . ds PI \(*p . ds L" `` . ds R" '' . ds C` . ds C' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" If the F register is >0, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .\" .\" Avoid warning from groff about undefined register 'F'. .de IX .. .nr rF 0 .if \n(.g .if rF .nr rF 1 .if (\n(rF:(\n(.g==0)) \{\ . if \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . if !\nF==2 \{\ . nr % 0 . nr F 2 . \} . \} .\} .rr rF .\" ======================================================================== .\" .IX Title "BTS.DE 1" .TH BTS.DE 1 "2021-07-18" "Debian-Hilfswerkzeuge" " " .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH "BEZEICHNUNG" .IX Header "BEZEICHNUNG" bts \- Befehlszeilenschnittstelle der Entwickler zum Debian Bug Tracking System .SH "ÜBERSICHT" .IX Header "ÜBERSICHT" \&\fBbts\fR [\fIOptionen\fR] \fIBefehl\fR [\fIArgumente\fR] [\fB#\fR\fIKommentar\fR] [\fB.\fR|\fB,\fR \&\fIBefehl\fR [\fIArgumente\fR] [\fB#\fR\fIKommentar\fR]] … .SH "BESCHREIBUNG" .IX Header "BESCHREIBUNG" Dies ist eine Befehlszeilenschnittstelle zur Debian-Fehlerdatenbank (\s-1BTS\s0), die hauptsächlich für den Gebrauch durch Entwickler gedacht ist. Sie ermöglicht die Manipulation des \s-1BTS\s0 durch einfache Befehle, die an der Eingabeaufforderung oder in einem Skript ausgeführt werden können, führt verschiedene Plausibilitätsprüfungen der Eingabe durch und konstruiert und sendet E\-Mails für Sie an die BTS-Steueradresse. Außerdem kann ein lokaler Zwischenspeicher von Webseiten und E\-Mails vom \s-1BTS\s0 erzeugt und aktualisiert werden. .PP Im Allgemeinen ist die Befehlszeilenschnittstelle das, was Sie in einer Mail an control@bugs.debian.org schreiben würden, nur mit vorangestelltem »bts«. Zum Beispiel: .PP .Vb 3 \& % bts severity 69042 normal \& % bts merge 69042 43233 \& % bts retitle 69042 blah blah .Ve .PP Für Ihren Komfort wurden ein paar zusätzliche Befehle hinzugefügt und dieses Programm ist ist weniger strikt in dem, was eine gültige Fehlernummer darstellt. Beispielsweise wird »severity Bug#85942 normal« wie auch »severity #85942 normal« verstanden. (Allerdings könnte Ihre Shell »#« als Kommentarzeichen ansehen, weswegen Sie es maskieren müssen!) .PP Außerdem ermöglicht Ihnen dieses Programm zu Ihrer Annehmlichkeit Befehle auf die kleinste eindeutige Teilzeichenkette abzukürzen (ähnlich wie Sie \s-1CVS\s0 Befehle abkürzen lässt). So versteht es Dinge wie »bts cl 85942«. .PP Es ist ebenfalls möglich, der E\-Mail an das \s-1BTS\s0 einen Kommentar beizufügen. Falls Ihre Shell nicht den Kommentar in einem Befehl wie »bts severity 30321 normal #inflated severity« streicht, dann ist dieses Programm schlau genug herauszufinden, wo der Kommentar ist und ihn in die E\-Mail einzufügen. Beachten Sie, dass die meisten Shells solche Kommentare streichen, bevor sie beim Programm ankommen, es sei denn, der Kommentar ist maskiert. (Etwas wie »bts severity #85942 normal« wird nicht als Kommentar angesehen!) .PP Sie können mehrere Befehle angeben, indem Sie sie durch einen einzelnen Punkt trennen, ungefähr wie \fBupdate\-rc.d\fR; ein einzelnes Komma könnte auch benutzt werden; alle die Befehle werden in einer einzigen E\-Mail gesandt. Es ist wichtig, dass der Punkt/das Komma von Leerzeichen umgeben ist, damit es nicht als Teil des Befehls missverstanden wird. Zum Beispiel (wo nötig maskieren, so dass \fBbts\fR den Kommentar sieht): .PP .Vb 1 \& % bts severity 95672 normal , merge 95672 95673 \e#sie sind identisch! .Ve .PP Die Abkürzung »it« könnte benutzt werden, um auf die zuletzt erwähnte Fehlernummer Bezug zu nehmen, daher können Sie schreiben: .PP .Vb 1 \& % bts severity 95672 wishlist , retitle it "bts: please add a \-\-foo option" .Ve .PP Bitte benutzen Sie dieses Programm verantwortungsvoll und berücksichtigen Sie unsere Benutzer. .SH "OPTIONEN" .IX Header "OPTIONEN" \&\fBbts\fR durchsucht die \fBdevscripts\fR\-Konfigurationsdateien wie oben beschrieben. Befehlszeilenoptionen setzen jedoch die Einstellungen der Konfigurationsdatei außer Kr. .IP "\fB\-o\fR, \fB\-\-offline\fR" 4 .IX Item "-o, --offline" sorgt dafür, dass \fBbts\fR zwischengespeicherte Fehler für die Befehle \fBshow\fR und \fBbugs\fR benutzt, falls für die angeforderten Daten ein Zwischenspeicher verfügbar ist. Im Nachstehenden finden Sie Informationen zum Befehl \&\fBcache\fR, wie Sie einen Zwischenspeicher einrichten. .IP "\fB\-\-online\fR, \fB\-\-no\-offline\fR" 4 .IX Item "--online, --no-offline" Gegenteil von \fB\-\-offline\fR; setzt alle Konfigurationsdatei-Direktiven außer Kraft, um offline zu arbeiten .IP "\fB\-n\fR, \fB\-\-no\-action\fR" 4 .IX Item "-n, --no-action" sendet keine E\-Mails, gibt sie aber auf der Standardausgabe aus. .IP "\fB\-\-cache\fR, \fB\-\-no\-cache\fR" 4 .IX Item "--cache, --no-cache" Soll versucht werden, neue Versionen der BTS-Seiten bei der Ausführung der Befehle \fBshow\fR/\fBbugs\fR zwischenzuspeichern? Vorgabe ist Zwischenspeicherung. .IP "\fB\-\-cache\-mode=\fR{\fBmin\fR|\fBmbox\fR|\fBfull\fR}" 4 .IX Item "--cache-mode={min|mbox|full}" Soll nur der reine Fehler (\fBmin\fR) oder auch die Mbox-Version (\fBmbox\fR) wiedergegeben werden oder soll das ganze Ding, einschließlich der Mbox, den langweiligen Anhängen an die BTS-Fehlerseiten und die Bestätigungs\-E\-Mails (\fBfull\fR) wiedergegeben werden, wenn ein \fBbts cache\fR\-Befehl ausgeführt wird? Vorgabe ist \fBmin\fR. .IP "\fB\-\-cache\-delay=\fR\fISekunden\fR" 4 .IX Item "--cache-delay=Sekunden" Zeit in Sekunden, die zwischen jedem Herunterladen gewartet wird, um zu verhindern, dass auf den BTS-Webserver eingehämmert wird. Vorgabe ist fünf Sekunden. .IP "\fB\-\-mbox\fR" 4 .IX Item "--mbox" öffnet ein E\-Mail-Programm, um die Mbox zu lesen, die zu einer gegebenen Fehlernummer für \fBshow\fR\- und \fBbugs\fR\-Befehle gehört. .IP "\fB\-\-mailreader=\fR\fIE\-MAIL-PROGRAMM\fR" 4 .IX Item "--mailreader=E-MAIL-PROGRAMM" gibt den Befehl zum Lesen der Mbox an; muss eine »\fB\f(CB%s\fB\fR«\-Zeichenkette (ohne Anführungszeichen) enthalten, die durch den Namen der Mbox-Datei ersetzt wird. Der Befehl wird bei Leerzeichen getrennt und nicht an eine Shell übergeben. Vorgabe ist »\fBmutt \-f \f(CB%s\fB\fR«. (Außerdem wird \fB%%\fR durch ein einzelnes \fB%\fR ersetzt, falls dies nötig ist.) .IP "\fB\-\-cc\-addr=\fR\fI\s-1CC_E\-MAIL_ADRESSE\s0\fR" 4 .IX Item "--cc-addr=CC_E-MAIL_ADRESSE" sendet Kopien an eine Liste von Benutzern. \fI\s-1CC_E\-MAIL_ADRESSE\s0\fR sollte eine durch Kommas getrennte Liste von E\-Mail-Adressen sein. .IP "\fB\-\-use\-default\-cc\fR" 4 .IX Item "--use-default-cc" fügt die in der Konfigurationsdateioption \fB\s-1BTS_DEFAULT_CC\s0\fR angegebenen Adressen der Liste hinzu, die mittels \fB\-\-cc\-addr\fR angegeben wurde. Dies ist die Vorgabe. .IP "\fB\-\-no\-use\-default\-cc\fR" 4 .IX Item "--no-use-default-cc" fügt der Liste der Kopien keine in \fB\s-1BTS_DEFAULT_CC\s0\fR angegebenen Adressen hinzu. .IP "\fB\-\-sendmail=\fR\fISENDMAIL-BEFEHL\fR" 4 .IX Item "--sendmail=SENDMAIL-BEFEHL" gibt den \fBsendmail\fR\-Befehl an. Der Befehl wird bei Leerzeichen getrennt und nicht an eine Shell übergeben. Vorgabe ist \fI/usr/sbin/sendmail\fR. Die Option \&\fB\-t\fR wird automatisch hinzugefügt, falls der Befehl \fI/usr/sbin/sendmail\fR oder \fI/usr/sbin/exim*\fR lautet. Für andere E\-Mail-Programme muss dies, falls sie eine \fB\-t\fR\-Option benötigen, in den \fISENDMAIL-BEFEHL\fR eingefügt werden, zum Beispiel: \fB\-\-sendmail=\*(L"/usr/sbin/mymailer \-t\*(R"\fR. .IP "\fB\-\-mutt\fR" 4 .IX Item "--mutt" benutzt \fBmutt\fR für den Versand von E\-Mails. Standardmäßig wird \fBmutt\fR nicht benutzt, außer für einige Befehle. .Sp Beachten Sie, dass \fB\f(CB$DEBEMAIL\fB\fR oder \fB\f(CB$EMAIL\fB\fR in der Umgebung gesetzt sein müssen, um \fBmutt\fR zum Senden von E\-Mails zu verwenden. .IP "\fB\-\-no\-mutt\fR" 4 .IX Item "--no-mutt" benutzt \fBmutt\fR nicht für den Versand von E\-Mails. .IP "\fB\-\-soap\-timeout=\fR\fI\s-1SEKUNDEN\s0\fR" 4 .IX Item "--soap-timeout=SEKUNDEN" gibt eine Zeitüberschreitung für SOAP-Aufrufe an, wie sie durch die Befehle \&\fBselect\fR und \fBstatus\fR benutzt wird. .IP "\fB\-\-smtp\-host=\fR\fI\s-1SMTPHOST\s0\fR" 4 .IX Item "--smtp-host=SMTPHOST" gibt einen SMTP-Rechner an. Falls angegeben wird \fBbts\fR E\-Mails versenden, indem es direkt mit diesem Rechner kommuniziert, statt den \&\fBsendmail\fR\-Befehl aufzurufen. .Sp Dem Rechnername könnte ein Doppelpunkt (»:«) und eine Port-Nummer folgen, um einen anderen Port als den vorgegebenen zu benutzen, Er könnte außerdem mit »ssmtp://« oder »ssmtps://« beginnen, um anzuzeigen, dass \s-1SMTPS\s0 benutzt werden soll. .Sp Falls \s-1SMTPS\s0 nicht angegeben wurde, wird \fBbts\fR weiterhin versuchen, \s-1STARTTLS\s0 zu verwenden, falls es vom SMTP-Server angezeigt wird. .Sp Beachten Sie, dass \fB\f(CB$DEBEMAIL\fB\fR oder \fB\f(CB$EMAIL\fB\fR in der Umgebung gesetzt sein müssen, um direkte SMTP-Verbindungen zum Senden von E\-Mails zu verwenden. .Sp Beachten Sie, wenn Sie direkt über einen SMTP-Rechner senden, dass die Angabe von Adressen in \fB\-\-cc\-addr\fR oder \fB\s-1BTS_DEFAULT_CC\s0\fR, für die der SMTP-Rechner keine Weiterleitung durchführt, dazu führt, dass der SMTP-Rechner die ganze E\-Mail abweist. .Sp Beachten Sie außerdem, dass die Benutzung des Befehls \fBreassign\fR, wenn entweder der Modus \fB\-\-interactive\fR oder \fB\-\-force\-interactive\fR aktiviert ist, dazu führen kann, dass ein Cc an \fI\f(CI$newpackage\fI\fR\f(CW@packages\fR.debian.org hinzugefügt wird. In diesen Fällen findet der Hinweis oben bezüglich Weiterleitung Anwendung. Die Übertragungsschnittstelle (Port 587) auf reportbug.debian.org unterstützt keine Weiterleitung und sollte als solche nicht als SMTP-Server für \fBbts\fR unter den in diesem Absatz beschriebenen Umständen genutzt werden. .IP "\fB\-\-smtp\-username=\fR\fI\s-1BENUTZERNAME\s0\fR, \fB\-\-smtp\-password=\fR\fI\s-1PASSWORT\s0\fR" 4 .IX Item "--smtp-username=BENUTZERNAME, --smtp-password=PASSWORT" gibt die Anmeldedaten an, die benutzt werden, wenn eine Verbindung zu dem durch \fB\-\-smtp\-host\fR angegebenen SMTP-Server hergestellt wird. Falls der Server keine Authentifizierung verlangt, dann sollten diese Optionen nicht verwendet werden. .Sp Falls ein Benutzername aber kein Passwort angegeben wurde, wird \fBbts\fR vor dem Senden der E\-Mail nach dem Passwort fragen. .IP "\fB\-\-smtp\-helo=\fR\fI\s-1HELO\s0\fR" 4 .IX Item "--smtp-helo=HELO" gibt den Namen an, der im Befehl \fI\s-1HELO\s0\fR benutzt wird, wenn eine Verbindung zu dem SMTP-Server hergestellt wird; Vorgabe ist der Inhalt der Datei \&\fI/etc/mailname\fR, falls sie existiert. .Sp Beachten Sie, dass einige STMP-Server die Benutzung eines \fI\s-1HELO\s0\fR möglicherweise abweisen, die sie entweder nicht auflösen oder die nicht zum benutzenden Rechner gehören. .IP "\fB\-\-bts\-server\fR" 4 .IX Item "--bts-server" benutzt einen anderen Debbugs-Server als https://bugs.debian.org. .IP "\fB\-f\fR, \fB\-\-force\-refresh\fR" 4 .IX Item "-f, --force-refresh" lädt einen Fehlerbericht erneut herunter, sogar dann, wenn er sich seit dem letzten \fBcache\fR\-Befehl nicht geändert zu haben scheint; nützlich, falls ein \&\fB\-\-cache\-mode=full\fR zum ersten Mal angefragt wurde (andernfalls werden unveränderte Fehlerberichte nicht erneut heruntergeladen, nicht einmal, wenn die langweiligen Teile nicht heruntergeladen wurden. .IP "\fB\-\-no\-force\-refresh\fR" 4 .IX Item "--no-force-refresh" unterdrückt jegliche \fB\-\-force\-refresh\fR\-Konfigurationsdateioptionen. .IP "\fB\-\-only\-new\fR" 4 .IX Item "--only-new" lädt nur neue Fehler beim Zwischenspeichern herunter; prüft nicht, ob es in bereits vorhandenen Fehlern Aktualisierungen gibt. .IP "\fB\-\-include\-resolved\fR" 4 .IX Item "--include-resolved" wenn Fehlerberichte zwischengespeichert werden, die einbeziehen, die als gelöst markiert sind. Dies ist das Standardverhalten. .IP "\fB\-\-no\-include\-resolved\fR" 4 .IX Item "--no-include-resolved" kehrt das Verhalten der vorherigen Option um. Sprich, Fehler, die als gelöst markiert sind, werden nicht zwischengespeichert. .IP "\fB\-\-no\-ack\fR" 4 .IX Item "--no-ack" unterdrückt Bestätigungs\-E\-Mails vom \s-1BTS.\s0 Beachten Sie, dass dies nur die CC-Kopien der Nachrichten beeinflusst, die Kopien für Fehler sind, die nicht an das Steuerungsprogramm gesandt wurden. .IP "\fB\-\-ack\fR" 4 .IX Item "--ack" unterdrückt keine Bestätigungs\-E\-Mails. Dies ist das Standardverhalten. .IP "\fB\-i\fR, \fB\-\-interactive\fR" 4 .IX Item "-i, --interactive" zeigt vor dem Senden einer E\-Mail an das Steuerungsprogramm den Inhalt an und ermöglicht, ihn zu bearbeiten oder das Versenden abzubrechen. .IP "\fB\-\-force\-interactive\fR" 4 .IX Item "--force-interactive" ähnlich wie \fB\-\-interactive\fR, mit der Ausnahme, dass sich ein Editor öffnet bevor nach der Bestätigung gefragt wird, ob die Nachricht versandt werden soll. .IP "\fB\-\-no\-interactive\fR" 4 .IX Item "--no-interactive" sendet Steuerungs-E-Mails ohne Bestätigung. Dies ist das Standardverhalten. .IP "\fB\-q\fR, \fB\-\-quiet\fR" 4 .IX Item "-q, --quiet" zeigt, wenn \fBbts cache\fR ausgeführt wird, nur Informationen über neu zwischengespeicherte Seiten an, keine Nachrichten, die aussagen, was bereits zwischengespeichert ist. Falls diese Option zweimal angegeben wurde, werden nur Fehlermeldungen (an die Standardfehlerausgabe) ausgegeben. .IP "\fB\-\-no\-conf\fR, \fB\-\-noconf\fR" 4 .IX Item "--no-conf, --noconf" keine Konfigurationsdateien lesen, Dies kann nur als erste auf der Befehlszeile angegebene Option benutzt werden. .SH "BEFEHLE" .IX Header "BEFEHLE" Sämtliche Einzelheiten über die Befehle finden Sie in der BTS-Dokumentation. .IP "\fBshow\fR [\fIOptionen\fR] [\fIFehlernummer\fR | \fIPaket\fR | \fIPaketbetreuer\fR | \fB:\fR ] [\fIOpt\fR\fB=\fR\fIWert\fR …]" 4 .IX Item "show [Optionen] [Fehlernummer | Paket | Paketbetreuer | : ] [Opt=Wert …]" .PD 0 .IP "\fBshow\fR [\fIOptionen\fR] [\fBsrc:\fR\fIPaket\fR | \fBfrom:\fR\fIAbsender\fR] [\fIOpt\fR\fB=\fR\fIWert\fR …]" 4 .IX Item "show [Optionen] [src:Paket | from:Absender] [Opt=Wert …]" .IP "\fBshow\fR [\fIOptionen\fR] [\fBtag:\fR\fIMarkierung\fR | \fBusertag:\fR\fIMarkierung\fR ] [\fIOpt\fR\fB=\fR\fIWert\fR …]" 4 .IX Item "show [Optionen] [tag:Markierung | usertag:Markierung ] [Opt=Wert …]" .IP "\fBshow\fR [\fBrelease-critical\fR | \fBrelease\-critical/\fR … | \fB\s-1RC\s0\fR]" 4 .IX Item "show [release-critical | release-critical/ … | RC]" .PD Dies ist ein Synonym für \fBbts bugs\fR. .IP "\fBbugs\fR [\fIOptionen\fR] [\fIFehlernummer\fR | \fIPaket\fR | \fIPaketbetreuer\fR | \fB:\fR ] [\fIOpt\fR\fB=\fR\fIWert\fR …]" 4 .IX Item "bugs [Optionen] [Fehlernummer | Paket | Paketbetreuer | : ] [Opt=Wert …]" .PD 0 .IP "\fBbugs\fR [\fIOptionen\fR] [\fBsrc:\fR\fIPaket\fR | \fBfrom:\fR\fIAbsender\fR] [\fIOpt\fR\fB=\fR\fIWert\fR …]" 4 .IX Item "bugs [Optionen] [src:Paket | from:Absender] [Opt=Wert …]" .IP "\fBbugs\fR [\fIOptionen\fR] [\fBtag:\fR\fIMarkierung\fR | \fBusertag:\fR\fIMarkierung\fR ] [\fIOpt\fR\fB=\fR\fIWert\fR …]" 4 .IX Item "bugs [Optionen] [tag:Markierung | usertag:Markierung ] [Opt=Wert …]" .IP "\fBbugs\fR [\fBrelease-critical\fR | \fBrelease\-critical/\fR … | \fB\s-1RC\s0\fR]" 4 .IX Item "bugs [release-critical | release-critical/ … | RC]" .PD zeigt die Seite, die die angefragten Fehler in einem Webbrowser auflistet, unter Benutzung von \fBsensible\-browser\fR\|(1). .Sp Optionen könnten nach dem Befehl \fBbugs\fR zusätzlich oder anstelle von Optionen am Anfang der Befehlszeile angegeben werden: An diesem Punkt erkannte Optionen sind: \fB\-o\fR/\fB\-\-offline\fR/\fB\-\-online\fR, \fB\-m\fR/\fB\-\-mbox\fR, \&\fB\-\-mailreader\fR und \fB\-\-\fR[\fBno\-\fR]\fBcache\fR. Diese wurden an früherer Stelle in dieser Handbuchseite beschrieben. Falls Sie entweder die Option \fB\-o\fR oder \fB\-\-offline\fR benutzt haben oder es bereits eine aktuelle Kopie des lokalen Zwischenspeichers gibt, wird die zwischengespeicherte Version benutzt. .Sp Die möglichen Argumente haben folgende Bedeutung: .RS 4 .IP "(keins)" 8 .IX Item "(keins)" Falls keins angegeben wurde, wird \fBbts bugs\fR Ihre Fehler unter der Annahme anzeigen, dass entweder \fB\s-1DEBEMAIL\s0\fR oder \fB\s-1EMAIL\s0\fR (in dieser Reihenfolge geprüft) auf die geeignete E\-Mail-Adresse gesetzt ist. .IP "\fIFehlernummer\fR" 8 .IX Item "Fehlernummer" zeigt Fehler Nummer \fIFehlernummer\fR. .IP "\fIPaket\fR" 8 .IX Item "Paket" zeigt die Fehler des Pakets \fIPaket\fR. .IP "\fBsrc:\fR\fIPaket\fR" 8 .IX Item "src:Paket" zeigt die Fehler des Quellpakets \fIPaket\fR. .IP "\fIPaketbetreuer\fR" 8 .IX Item "Paketbetreuer" zeigt die Fehler für die Paketbetreuer-E-Mail-Adresse \fIPaketbetreuer\fR .IP "\fBfrom:\fR\fIAbsender\fR" 8 .IX Item "from:Absender" zeigt die Fehler für die Absender-E-Mail-Adresse \fIAbsender\fR .IP "\fBtag:\fR\fIMarkierung\fR" 8 .IX Item "tag:Markierung" zeigt die Fehler, die mit \fIMarkierung\fR gekennzeichnet sind. .IP "\fBusertag:\fR\fIMarkierung\fR" 8 .IX Item "usertag:Markierung" zeigt die Fehler, die mit der Benutzermarkierung \fIMarkierung\fR gekennzeichnet sind. Weitere Informationen über Benutzermarkierungen finden Sie in der BTS-Dokumentation. Dies wird die Verwendung der Option \&\fBusers=\fR\fIE\-Mail\fR erfordern. .IP "\fB:\fR" 8 .IX Item ":" Einzelheiten der Fehlerdatenbank selbst können, neben einer Fehlermeldeseite mit mehr Optionen als diesem Skript, unter https://bugs.debian.org/ gefunden werden. Diese Seite selbst wird geöffnet, falls der Befehl »bts bugs :« benutzt wird. .IP "\fBrelease-critical\fR, \fB\s-1RC\s0\fR" 8 .IX Item "release-critical, RC" zeigt die Einstiegssseite der release-kritischen Seiten des \s-1BTS.\s0 Dies ist ein Synonym für https://bugs.debian.org/release\-critical/index.html. Es ist außerdem möglich, release\-critical/debian/main.html und dergleichen zu sagen. \s-1RC\s0 ist ein Synonym für release\-critical/other/all.html. .RE .RS 4 .Sp Nach dem Argument, das spezifiziert, was angezeigt wird, können Sie wahlweise Optionen angeben, um die Seite zu formatieren oder um zu ändern, was angezeigt wird. Diese werden in der heruntergeladenen \s-1URL\s0 an das \s-1BTS\s0 übergeben. Übergeben Sie zum Beispiel »dist=stable«, um Fehler zu sehen, die die stabile Version des Pakets beeinflussen, »version=1.0«, um Fehler zu sehen, die diese Version des Pakets beeinflussen oder »reverse=yes«, um die neuesten Nachrichten im Fehlerprotokoll zuerst zu sehen. .Sp Falls Zwischenspeicherung aktiviert wurde (sprich \fB\-\-no\-cache\fR wurde nicht benutzt und \fB\s-1BTS_CACHE\s0\fR wurde nicht auf \fBno\fR gesetzt), dann wird automatisch jede durch \fBbts show\fR angeforderte Seite zwischengespeichert und danach offline verfügbar sein. Seiten, die automatisch auf diese Weise zwischengespeichert wurden, werden bei nachfolgenden Aufrufen von »\fBbts show\fR|\fBbugs\fR|\fBcache\fR« gelöscht, falls nicht innerhalb von 30 Tagen darauf zugegriffen wurde. Warnung: Auf einem Dateisystem, das mit der Option »noatime« eingehängt wurde, aktualisiert die Ausführung von »\fBbts show\fR|\fBbugs\fR« nicht die Zugriffszeiten der Zwischenspeicherdateien; ein zwischengespeicherter Fehler wird dann Gegenstand der automatischen Bereinigung 30 Tage nach seinem anfänglichen Herunterladen, sogar dann, wenn auf ihn in der Zwischenzeit zugegriffen wurde. .Sp Alle anderen \fBbts\fR\-Befehle, die dieser Befehlszeile folgen, werden nach dem Beenden des Browsers ausgeführt. .Sp Der gewünschte Browser kann durch Setzen der Umgebungsvariable \fB\s-1BROWSER\s0\fR angegeben und konfiguriert werden. Die Konventionen folgen denen, die Eric Raymond auf http://www.catb.org/~esr/BROWSER/ definiert hat; hier wird der maßgebliche Teil wiedergegeben. .Sp Der Wert von \fB\s-1BROWSER\s0\fR kann aus einer Reihe von durch Doppelpunkt getrennten Browser-Befehlsteilen bestehen. Diese sollten nacheinander durchprobiert werden, bis einer erfolgreich ist. Jeder Befehlsteil kann optional die Zeichenkette \fB\f(CB%s\fB\fR enthalten; ist dies der Fall, wird die \s-1URL,\s0 die betrachtet werden soll, dort ersetzt. Falls der Befehlsteil kein \fB\f(CB%s\fB\fR enthält, wird der Browser gestartet, als ob die \s-1URL\s0 als sein erstes Argument bereitgestellt worden wäre. Die Zeichenkette \fB%%\fR muss durch ein einzelnes % ersetzt werden. .Sp Begründung: Es muss möglich sein, mehrere Browser-Befehle anzugeben, damit Programme, die dieser Konvention folgen, in X\- oder Konsolenumgebungen das Richtige tun können. Dabei wird X zuerst probiert. Die Angabe mehrerer Befehle kann außerdem für Leute nützlich sein, die Dateien wie \fI.profile\fR über mehrere Systeme hinweg gemeinsam benutzen. \fB\f(CB%s\fB\fR wird benötigt, da einige populäre Browser eine Aufrufsyntax aus der Ferne haben, die dies erfordern. Falls \fB%%\fR nicht auf % verkürzt würde, wäre es unmöglich, ein Buchstabensymbol \fB\f(CB%s\fB\fR in der Zeichenkette zu haben. .Sp Auf den meisten Linux-Systemen wäre zum Beispiel Folgendes ein gute Sache: .Sp BROWSER='mozilla \-raise \-remote \*(L"openURL(%s,new\-window)\*(R":links' .RE .IP "\fBselect\fR [\fISchlüssel\fR\fB:\fR\fIWert\fR …]" 4 .IX Item "select [Schlüssel:Wert …]" benutzt die SOAP-Schnittstelle, um eine Liste von Fehlern auszugeben, die zu den gegebenen Auswahlanforderungen passen. .Sp Die folgenden Schlüssel sind erlaubt und können mehrmals abgegeben werden. .RS 4 .IP "\fBpackage\fR" 8 .IX Item "package" Name des Binärpakets .IP "\fBsource\fR" 8 .IX Item "source" Name des Quellpakets .IP "\fBmaintainer\fR" 8 .IX Item "maintainer" E\-Mail-Adresse des Paketbetreuers .IP "\fBsubmitter\fR" 8 .IX Item "submitter" E\-Mail-Adresse des Absenders .IP "\fBseverity\fR" 8 .IX Item "severity" Schweregrad des Fehlers .IP "\fBstatus\fR" 8 .IX Item "status" Status des Fehlers; entweder \fBopen\fR, \fBdone\fR oder \fBforwarded\fR .IP "\fBtag\fR" 8 .IX Item "tag" auf den Fehler bezogene Markierungen. Falls \fBusers\fR angegeben ist, könnten zusätzlich zu den Standardmarkierungen Benutzermarkierungen enthalten sein. .IP "\fBowner\fR" 8 .IX Item "owner" Besitzer des Fehlers .IP "\fBcorrespondent\fR" 8 .IX Item "correspondent" Adresse von jemandem, der E\-Mail an das Protokoll sandte .IP "\fBaffects\fR" 8 .IX Item "affects" Fehler, die dieses Paket beeinflussen .IP "\fBbugs\fR" 8 .IX Item "bugs" Liste von Fehlern, in der gesucht wird .IP "\fBusers\fR" 8 .IX Item "users" Namen von Benutzern, die beim Abfragen von Benutzermarkierungen benutzt werden .IP "\fBarchive\fR" 8 .IX Item "archive" gibt an, ob archivierte oder normale Fehler gesucht werden; Vorgabe ist \fB0\fR (d.h. nur normale Fehler werden gesucht). Als Sonderfall werden, falls »archive« \fBboth\fR ist, archivierte und nicht archivierte Fehler zurückgegeben. .RE .RS 4 .Sp Um zum Beispiel die Sammlung von Fehlern auszuwählen, die von jrandomdeveloper@example.com versandt und mit \fBwontfix\fR markiert würde, könnte Folgendes benutzt werden: .Sp bts select submitter:jrandomdeveloper@example.com tag:wontfix .Sp Falls ein Schlüssel mehrfach benutzt wird, dann enthält die ausgewählte Fehlerzusammenstellung jene, die auf einen der bereitgestellten Werte passen, zum Beispiel gibt .Sp bts select package:foo severity:wishlist severity:minor .Sp alle Fehler des Pakets Foo zurück, die entweder den Schweregrad »wishlist« oder »minor« haben. .RE .IP "\fBstatus\fR [\fIFehler\fR | \fBfile:\fR\fIDatei\fR | \fBfields:\fR\fIFeld\fR[\fB,\fR\fIFeld\fR …] | \fBverbose\fR] …" 4 .IX Item "status [Fehler | file:Datei | fields:Feld[,Feld …] | verbose] …" benutzt die SOAP-Schnittstelle, um Informationen über die angegebenen Fehler auszugeben (oder die, die aus den aufgelisteten Dateien gelesen wurden – verwenden Sie \fB\-\fR, um die Standardeingabe auszuwählen). .Sp Standardmäßig werden alle ausgefüllten Felder für einen Fehler angezeigt. .Sp Falls \fBverbose\fR angegeben ist, werden außerdem leere Felder angezeigt. .Sp Falls \fBfields\fR angegeben ist, werden nur diese Felder angezeigt. Es wird keine Gültigkeitsprüfung für irgendwelche angegebenen Felder durchgeführt. .IP "\fBclone\fR \fIFehler\fR \fIneue_Kennung\fR [\fIneue_Kennung\fR …]" 4 .IX Item "clone Fehler neue_Kennung [neue_Kennung …]" Der Steuerbefehl \fBclone\fR ermöglicht es Ihnen, einen \fIFehler\fRbericht zu kopieren. Das ist in dem Fall nützlich, in dem ein einziger Bericht tatsächlich anzeigt, dass mehrere eigenständige Fehler aufgetreten sind. »Neue Kennungen« sind durch Leerzeichen getrennte negative Zahlen, die in nachfolgenden Steuerbefehlen benutzt werden können, um auf die neu kopierten Fehler Bezug zu nehmen. Für jede neue Kennung wird ein neuer Fehler erzeugt. .IP "\fBdone\fR \fIFehler\fR [\fIVersion\fR]" 4 .IX Item "done Fehler [Version]" markiert einen Fehler als erledigt. Dies erzwingt einen interaktiven Modus, da erledigt-Nachrichten eine Erklärung enthalten sollten, weshalb der Fehler geschlossen wird. Sie sollten angeben, welche Version des Pakets den Fehler schließt, falls möglich. .IP "\fBreopen\fR \fIFehler\fR [\fIAbsender\fR]" 4 .IX Item "reopen Fehler [Absender]" öffnet einen \fIFehler\fR mit optionalem \fIAbsender\fR erneut. .IP "\fBarchive\fR \fIFehler\fR" 4 .IX Item "archive Fehler" archiviert einen \fIFehler\fR, der vorher archiviert war, es gegenwärtig aber nicht ist. Der \fIFehler\fR muss alle Anforderungen für die Archivierung außer den zeitbasierten erfüllen. .IP "\fBunarchive\fR \fIFehler\fR" 4 .IX Item "unarchive Fehler" nimmt einen derzeit archivierten \fIFehler\fR aus dem Archiv heraus. .IP "\fBretitle\fR \fIFehler\fR \fITitel\fR" 4 .IX Item "retitle Fehler Titel" ändert den \fITitel\fR des \fIFehler\fRs. .IP "\fBsummary\fR \fIFehler\fR [\fINachrichtennummer\fR]" 4 .IX Item "summary Fehler [Nachrichtennummer]" wählt eine Nachrichtennummer, die als Zusammenfassung von \fIFehler\fR benutzt werden soll. .Sp Falls keine Nachrichtennummer angegeben ist, wird die Zusammenfassung geleert. .IP "\fBsubmitter\fR \fIFehler\fR [\fIFehler\fR] … \fIAbsender-E-Mail-Adresse\fR" 4 .IX Item "submitter Fehler [Fehler] … Absender-E-Mail-Adresse" ändert die Adresse des Einreichenden eines \fIFehler\fRs oder einer Reihe von Fehlern. \fB!\fR bedeutet »die Adresse der aktuellen E\-Mail als neue Adresse des Einreichenden verwenden«. .IP "\fBreassign\fR \fIFehler\fR [\fIFehler\fR …] \fIPaket\fR [\fIVersion\fR]" 4 .IX Item "reassign Fehler [Fehler …] Paket [Version]" weist einem \fIFehler\fR oder einer Reihe von Fehlern einem anderen \fIPaket\fR zu. Das Feld \fIVersion\fR ist optional; lesen Sie die Erklärung auf . .IP "\fBfound\fR \fIFehler\fR [\fIVersion\fR]" 4 .IX Item "found Fehler [Version]" zeigt an, dass ein \fIFehler\fR in einer bestimmten Paketversion gefunden wurde. Ohne \fIVersion\fR wird die Liste reparierter Versionen bereinigt und der Fehler wird erneut geöffnet. .IP "\fBnotfound\fR \fIFehler\fR \fIVersion\fR" 4 .IX Item "notfound Fehler Version" entfernt den Datensatz, mit dem \fIFehler\fR in der gegebenen Version des Pakets, dem er zugewiesen ist, vorgefunden wurde. .IP "\fBfixed\fR \fIFehler\fR \fIVersion\fR" 4 .IX Item "fixed Fehler Version" zeigt an, dass ein \fIFehler\fR in einer bestimmten Paketversion behoben wurde ohne den Offen\-/Geschlossenstatus des \fIFehler\fRs zu beeinflussen. .IP "\fBnotfixed\fR \fIFehler\fR \fIVersion\fR" 4 .IX Item "notfixed Fehler Version" entfernt den Datensatz mit dem ein \fIFehler\fR in der gegebenen Version des Pakets, dem er zugewiesen ist, behoben wurde. .Sp Dies ist gleichbedeutend mit der Abfolge der Befehle »\fBfound\fR \fIFehler\fR \&\fIVersion\fR«, »\fBnotfound\fR \fIFehler\fR \fIVersion\fR«. .IP "\fBblock\fR \fIFehler\fR \fBby\fR|\fBwith\fR \fIFehler\fR [\fIFehler\fR …]" 4 .IX Item "block Fehler by|with Fehler [Fehler …]" weist darauf hin, dass ein \fIFehler\fR von der Behebung durch einen Satz anderer Fehler blockiert ist. .IP "\fBunblock\fR \fIFehler\fR \fBby\fR|\fBwith\fR \fIFehler\fR [\fIFehler\fR …]" 4 .IX Item "unblock Fehler by|with Fehler [Fehler …]" weist darauf hin, dass ein \fIFehler\fR nicht länger von der Behebung durch einen Satz anderer Fehler blockiert ist. .IP "\fBmerge\fR \fIFehler\fR \fIFehler\fR [\fIFehler\fR …]" 4 .IX Item "merge Fehler Fehler [Fehler …]" fügt einen Satz Fehler zusammen. .IP "\fBforcemerge\fR \fIFehler\fR \fIFehler\fR [\fIFehler\fR …]" 4 .IX Item "forcemerge Fehler Fehler [Fehler …]" fügt einen Satz Fehler mit Gewalt zusammen. Der erste aufgeführte \fIFehler\fR ist der Hauptfehler und seine Einstellungen (diejenigen, die denen in einem normalen \fBmerge\fR entsprechen müssen) werden den nachfolgend aufgeführten Fehlern zugewiesen. .IP "\fBunmerge\fR \fIFehler\fR" 4 .IX Item "unmerge Fehler" macht das Zusammenführen eines \fIFehler\fRs rückgängig. .IP "\fBtag\fR \fIFehler\fR [\fB+\fR|\fB\-\fR|\fB=\fR] \fIMarkierung\fR [\fIMarkierung\fR …]" 4 .IX Item "tag Fehler [+|-|=] Markierung [Markierung …]" .PD 0 .IP "\fBtags\fR \fIFehler\fR [\fB+\fR|\fB\-\fR|\fB=\fR] \fIMarkierung\fR [\fIMarkierung\fR …]" 4 .IX Item "tags Fehler [+|-|=] Markierung [Markierung …]" .PD setzt oder entfernt eine \fIMarkierung\fR für einen \fIFehler\fR. Die Markierung kann entweder der exakte Markierungsname sein oder er kann auf eine eindeutige Teilzeichenkette abgekürzt werden. (Daher wird \fBfixed\fR beispielsweise die Markierung \fBfixed\fR, nicht \fBfixed-upstream\fR setzen, aber \&\fBfix\fR wäre nicht zulässig.) Mehrere Markierungen können ebenfalls angegeben werden. Die beiden Befehle (»tag« und »tags«) sind identisch. Wenn der Schalter \fB=\fR nicht benutzt wird, muss mindestens eine Markierung angegeben werden, wobei der Befehl .Sp .Vb 1 \& bts tags = .Ve .Sp alle Markierungen vom angegebenen \fIFehler\fR entfernen wird. .Sp Das Hinzufügen/Entfernen der \fBsecurity\fR\-Markierung wird der Cc-Liste der Steuerungs-E-Mail »team\e@security.debian.org« hinzufügen. .Sp Die Liste gültiger Markierungen und ihre Bedeutung ist unter verfügbar. Derzeit sind folgende Markierungen gültig: .Sp patch, wontfix, moreinfo, unreproducible, fixed, help, security, upstream, pending, d\-i, confirmed, ipv6, lfs, fixed-upstream, l10n, newcomer, a11y, ftbfs .Sp Es gibt auch eine Markierung für jede Veröffentlichung von Debian seit »Potato«. Beachten Sie, dass diese Liste möglicherweise nicht aktuell ist, die aktuellste Quelle bietet die Website. .IP "\fBaffects\fR \fIFehler\fR [\fB+\fR|\fB\-\fR|\fB=\fR] \fIPaket\fR [\fIPaket\fR …]" 4 .IX Item "affects Fehler [+|-|=] Paket [Paket …]" zeigt an, dass ein \fIFehler\fR ein anderes \fIPaket\fR betrifft, als das, gegen das er eingereicht wurde, was dazu führt, dass der \fIFehler\fR standardmäßig in der \fIPaket\fRliste des anderen Pakets aufgeführt wird. Dies sollte üblicherweise benutzt werden, wo der \fIFehler\fR ernst genug ist, um mehrere Berichte von Benutzern dem falschen Paket zuzuweisen. Es muss mindestens ein \&\fIPaket\fR angegeben werden, sogar, wenn der Schalter \fB=\fR benutzt wird, wobei der Befehl .Sp .Vb 1 \& bts affects = .Ve .Sp alle Hinweise entfernt, dass \fIFehler\fR andere Pakete beeinflusst. .IP "\fBuser\fR \fIE\-Mail-Adresse\fR" 4 .IX Item "user E-Mail-Adresse" gibt eine Benutzer\-\fIE\-Mail\fR\-Adresse an, bevor der Befehl \fBusertags\fR verwendet wird. .IP "\fBusertag\fR \fIFehler\fR [\fB+\fR|\fB\-\fR|\fB=\fR] \fIMarkierung\fR [\fIMarkierung\fR …]" 4 .IX Item "usertag Fehler [+|-|=] Markierung [Markierung …]" .PD 0 .IP "\fBusertags\fR \fIFehler\fR [\fB+\fR|\fB\-\fR|\fB=\fR] \fIMarkierung\fR [\fIMarkierung\fR …]" 4 .IX Item "usertags Fehler [+|-|=] Markierung [Markierung …]" .PD setzt oder entfernt eine Benutzermarkierung für einen \fIFehler\fR. Die \&\fIMarkierung\fR muss exakt den gewünschten Markierungsnamen haben; es gibt dort keine Vorgaben oder Prüfungen von Markierungsnamen. Mehrere Markierungen können ebenfalls angegeben werden. Die beiden Befehle (\fBusertag\fR und \fBusertags\fR) sind identisch. Wenn der Schalter \fB=\fR nicht benutzt wird, muss mindestens eine Markierung angegeben werden, wobei der Befehl .Sp .Vb 1 \& bts usertags = .Ve .Sp alle Benutzermarkierungen vom angegebenen \fIFehler\fR entfernt. .IP "\fBclaim\fR \fIFehler\fR [\fIAnspruch\fR]" 4 .IX Item "claim Fehler [Anspruch]" zeichnet auf, dass Sie Anspruch auf einen Fehler erheben (z.B. für ein Fehlerbearbeitungstreffen, eine »Bug Squashing Party«). \fIAnspruch\fR sollte ein eindeutiges Kürzel sein, das es ermöglicht, die Fehler, auf die Sie Anspruch erheben, zu identifizieren; oft wird eine E\-Mail-Adresse benutzt. .Sp Falls kein \fIAnspruch\fR angegeben wurde, wird die Umgebungsvariable \&\fB\s-1DEBEMAIL\s0\fR oder \fB\s-1EMAIL\s0\fR (in dieser Reihenfolge geprüft) benutzt. .IP "\fBunclaim\fR \fIFehler\fR [\fIAnspruch\fR]" 4 .IX Item "unclaim Fehler [Anspruch]" entfernt den Datensatz, mit dem Sie Anspruch auf einen Fehler erheben. .Sp Falls kein \fIAnspruch\fR angegeben wurde, wird die Umgebungsvariable \&\fB\s-1DEBEMAIL\s0\fR oder \fB\s-1EMAIL\s0\fR (in dieser Reihenfolge geprüft) benutzt. .IP "\fBseverity\fR \fIFehler\fR \fISchweregrad\fR" 4 .IX Item "severity Fehler Schweregrad" ändert den \fISchweregrad\fR eines \fIFehler\fRs. Verfügbare Schweregrade sind: \&\fBwishlist\fR, \fBminor\fR, \fBnormal\fR, \fBimportant\fR, \fBserious\fR, \fBgrave\fR und \&\fBcritical\fR. Der Schweregrad kann auf irgendeine eindeutige Teilzeichenkette abgekürzt werden. .IP "\fBforwarded\fR \fIFehler\fR \fIAdresse\fR" 4 .IX Item "forwarded Fehler Adresse" markiert den \fIFehler\fR als an die angegebene \fIAdresse\fR weitergeleitet (üblicherweise eine E\-Mail-Adresse oder eine \s-1URL\s0 für eine Fehlerdatenbank der Originalautoren). .IP "\fBnotforwarded\fR \fIFehler\fR" 4 .IX Item "notforwarded Fehler" markiert einen \fIFehler\fR als nicht weitergeleitet. .IP "\fBpackage\fR [\fIPaket\fR …]" 4 .IX Item "package [Paket …]" Die folgenden Befehle werden nur auf Fehler gegen die aufgeführten \fIPaket\fRe angewendet; dies dient als Sicherheitsmechanismus für die Fehlerdatenbank. Falls keine Pakete aufgeführt sind, wird die Prüfung wieder ausgeschaltet. .IP "\fBlimit\fR [\fISchlüssel\fR[\fB:\fR\fIWert\fR]] …" 4 .IX Item "limit [Schlüssel[:Wert]] …" Die folgenden Befehle werden nur auf Fehler angewendet, die dem angegebenen Kriterium entsprechen; dies dient als Sicherheitsmechanismus für die Fehlerdatenbank. Falls keine \fIWert\fRe aufgeführt sind, werden die Beschränkungen für diesen \fISchlüssel\fR wieder ausgeschaltet. Falls keine \&\fISchlüssel\fR angegeben wurden, werden alle Beschränkungen zurückgesetzt. .RS 4 .IP "\fBsubmitter\fR" 8 .IX Item "submitter" E\-Mail-Adresse des Absenders .IP "\fBdate\fR" 8 .IX Item "date" Datum, an dem der Fehler versandt wurde .IP "\fBsubject\fR" 8 .IX Item "subject" Betreff dieses Fehlers .IP "\fBmsgid\fR" 8 .IX Item "msgid" Nachrichtenkennung des anfänglichen Fehlerberichts .IP "\fBpackage\fR" 8 .IX Item "package" Name des Binärpakets .IP "\fBsource\fR" 8 .IX Item "source" Name des Quellpakets .IP "\fBtag\fR" 8 .IX Item "tag" auf den Fehler bezogene Markierungen .IP "\fBseverity\fR" 8 .IX Item "severity" Schweregrad des Fehlers .IP "\fBowner\fR" 8 .IX Item "owner" Besitzer des Fehlers .IP "\fBaffects\fR" 8 .IX Item "affects" Fehler, die dieses Paket beeinflussen .IP "\fBarchive\fR" 8 .IX Item "archive" gibt an, ob archivierte oder normale Fehler gesucht werden; Vorgabe ist \fB0\fR (d.h. nur normale Fehler werden gesucht). Als Sonderfall werden, falls »archive« \fBboth\fR ist, archivierte und nicht archivierte Fehler zurückgegeben. .RE .RS 4 .Sp Um zum Beispiel die Zusammenstellung von Fehlern, die von nachfolgenden Steuerbefehlen beeinflusst werden, auf diejenigen zu beschränken, die von jrandomdeveloper@example.com versandt und mit \fBwontfix\fR markiert wurden, könnte Folgendes verwendet werden: .Sp bts limit submitter:jrandomdeveloper@example.com tag:wontfix .Sp Falls ein Schlüssel mehrfach benutzt wird, dann enthält die ausgewählte Fehlerzusammenstellung jene, die auf einen der bereitgestellten Werte passen, zum Beispiel gibt .Sp bts limit package:foo severity:wishlist severity:minor .Sp wird nur auf nachfolgende Steuerbefehle für Fehler des Pakets Foo angewendet, die entweder den Schweregrad \fBwishlist\fR oder \fBminor\fR aufweisen. .RE .IP "\fBowner\fR \fIFehler\fR \fIBesitzer-E-Mail-Adresse\fR" 4 .IX Item "owner Fehler Besitzer-E-Mail-Adresse" ändert die »Besitzer«\-Adresse eines \fIFehler\fRs, wobei \fB!\fR »benutze die Adresse der aktuellen E\-Mail als neue Besitzeradresse« bedeutet. .Sp Der Besitzer eines Fehlers akzeptiert die Verantwortung, ihn zu erledigen. .IP "\fBnoowner\fR \fIFehler\fR" 4 .IX Item "noowner Fehler" markiert, dass ein Fehler keinen »Besitzer« hat. .IP "\fBsubscribe\fR \fIFehler\fR [\fIE\-Mail\fR]" 4 .IX Item "subscribe Fehler [E-Mail]" abonniert die gegebene \fIE\-Mail\fR\-Adresse für den angegebenen \&\fIFehler\fR. Falls keine E\-Mail-Adresse angegeben wurde, wird die Umgebungsvariable \fB\s-1DEBEMAIL\s0\fR oder \fB\s-1EMAIL\s0\fR (in dieser Reihenfolge) benutzt. Falls diese nicht gesetzt sind oder \fB!\fR als E\-Mail-Adresse angegeben ist, wird Ihre Standard-E-Mail-Adresse verwendet. .Sp Nach der Ausführung dieses Befehls wird ihnen eine Abonnement\-Bestätigung gesandt, auf die Sie antworten müssen. Wenn Sie einen Fehlerbericht abonniert haben, erhalten Sie alle relevanten E\-Mails und Benachrichtigungen, Benutzen Sie den Befehl unsubscribe, um das Abonnement zu beenden. .IP "\fBunsubscribe\fR \fIFehler\fR [\fIE\-Mail\fR]" 4 .IX Item "unsubscribe Fehler [E-Mail]" beendet das Abonnement der angegebenen E\-Mail-Adresse für den angegebenen Fehlerbericht. Wie beim vorhergehenden Abonnieren werden, falls keine E\-Mail-Adresse angegeben wurde, die Umgebungsvariablen \fB\s-1DEBEMAIL\s0\fR oder \&\fB\s-1EMAIL\s0\fR (in dieser Reihenfolge) benutzt. Falls diese nicht gesetzt sind oder \fB!\fR als E\-Mail-Adresse angegeben ist, wird Ihre Standard-E-Mail-Adresse verwendet. .Sp Nach der Ausführung dieses Befehls wird Ihnen eine Bestätigung für das Beenden des Abonnements gesandt, auf die Sie antworten müssen. Benutzen Sie zum Abonnieren den Befehl \fBsubscribe\fR. .IP "\fBreportspam\fR \fIFehler\fR …" 4 .IX Item "reportspam Fehler …" Der Befehl \fBreportspam\fR ermöglicht es Ihnen, zu melden, dass ein \&\fIFehler\fRbericht Spam enthält. Er bewahrt davor, auf die Fehler-Website gehen zu müssen, um dies zu tun. .IP "\fBspamreport\fR \fIFehler\fR …" 4 .IX Item "spamreport Fehler …" \&\fBspamreport\fR ist ein Synonym für \fBreportspam\fR. .IP "\fBcache\fR [\fIOptionen\fR] [\fIBetreuer-E-Mail-Adresse\fR | \fIPaket\fR | \fBsrc:\fR\fIPaket\fR | \fBfrom:\fR\fIAbsender\fR]" 4 .IX Item "cache [Optionen] [Betreuer-E-Mail-Adresse | Paket | src:Paket | from:Absender]" .PD 0 .IP "\fBcache\fR [\fIOptionen\fR] [\fBrelease-critical\fR | \fBrelease\-critical/\fR … | \fB\s-1RC\s0\fR]" 4 .IX Item "cache [Optionen] [release-critical | release-critical/ … | RC]" .PD erzeugt oder aktualisiert einen Zwischenspeicher von Fehlerberichten für die angegebene E\-Mail-Adresse oder das gegebene Paket. Standardmäßig lädt es alle Fehler herunter, die zu der E\-Mail-Adresse in der Umgebungsvariable \&\fB\s-1DEBEMAIL\s0\fR gehören (oder der Umgebungsvariable \fB\s-1EMAIL\s0\fR, falls \fB\s-1DEBEMAIL\s0\fR nicht gesetzt ist). Dieser Befehl kann wiederholt werden, um Fehler zwischenzuspeichern, die zu mehreren Personen oder Paketen gehören. Falls mehrere Pakete oder Adressen mitgegeben werden, werden Fehler zwischengespeichert, die zu allen Argumenten gehören; diejenigen, die zu mehr als einem Argument gehören, werden nur einmal heruntergeladen. Die zwischengespeicherten Fehler werden in \fI\f(CI$XDG_CACHE_HOME\fI/devscripts/bts/\fR gespeichert oder, falls \fB\s-1XDG_CACHE_HOME\s0\fR nicht gesetzt ist, in \&\fI~/.cache/devscripts/bts/\fR. .Sp Sie können die zwischengespeicherten Fehler mit dem Schalter \fB\-o\fR verwenden. Zum Beispiel: .Sp .Vb 2 \& bts \-o bugs \& bts \-o show 12345 .Ve .Sp Außerdem wird \fBbts\fR die Dateien darin auf unsystematische Weise aktualisieren, da es Informationen von der Fehlerdatenbank unter Benutzung des Befehls \fBshow\fR herunterlädt. Sie könnten daher den Zwischenspeicher einrichten, indem Sie die automatischen Zwischenspeicheraktualisierungen die Fehler aktualisieren lassen, auf die Sie häufig während der Woche Bezug nehmen. .Sp Einige Optionen beeinflussen das Verhalten des Befehls \fBcache\fR. Die erste ist die Einstellung von \fB\-\-cache\-mode\fR, die steuert, wieviel \fBbts\fR von den referenzierten Verweisen von der Fehlerseite herunterlädt, einschließlich langweiliger Teile, wie den Bestätigungs\-E\-Mails, E\-Mails an den Steuer-Bot und der Mbox-Version des Fehlerberichts. Sie kann drei Werte annehmen: \&\fBmin\fR (das Minimum), \fBmbox\fR (das Minimum plus der Mbox-Version des Fehlerberichts herunterladen) oder \fBfull\fR (alles). Die zweite ist \&\fB\-\-force\-refresh\fR oder \fB\-f\fR. Sie erzwingt das Herunterladen sogar dann, wenn der zwischengespeicherte Fehler aktuell ist. Die Option \&\fB\-\-include\-resolved\fR zeigt an, ob Fehlerberichte, die als behoben markiert sind, während des Zwischenspeicherns heruntergeladen werden sollen. .Sp Jedes davon ist, wie nachfolgend beschrieben, in der Konfigurationsdatei einstellbar. Dies könnte außerdem nach dem Befehl \fBcache\fR, ebenso wie am Anfang der Befehlszeile angegeben werden. .Sp Schlussendlich wird \fB\-q\fR oder \fB\-\-quiet\fR Nachrichten darüber, ob der Zwischenspeicher aktuell ist, unterdrücken. Wird diese Option zweimal angegeben, werden alle Zwischenspeichernachrichten (mit Ausnahme von Fehlermeldungen) unterdrückt. .Sp Vorsicht allerdings beim Zwischenspeichern von RC-Fehlern: Es wird \s-1LANGE\s0 dauern! (Mit über 1000 RC-Fehlern und einer Verzögerung von fünf Sekunden zwischen Fehlern, sehen Sie sich mindestens 1,5 Stunden und wahrscheinlich bedeutend mehr als dem gegenüber.) .IP "\fBcleancache\fR \fIPaket\fR | \fBsrc:\fR\fIPaket\fR | \fIPaketbetreuer\fR" 4 .IX Item "cleancache Paket | src:Paket | Paketbetreuer" .PD 0 .IP "\fBcleancache from:\fR\fIAbsender\fR | \fBtag:\fR\fIMarkierung\fR | \fBusertag:\fR\fIMarkierung\fR | \fIZahl\fR | \fB\s-1ALL\s0\fR" 4 .IX Item "cleancache from:Absender | tag:Markierung | usertag:Markierung | Zahl | ALL" .PD bereinigt den Zwischenspeicher für das angegebene \fIPaket\fR, den \&\fIPaketbetreuer\fR. etc., wie oben für den Befehl \fBbugs\fR beschrieben oder bereinigt den kompletten Zwischenspeicher, falls \fB\s-1ALL\s0\fR angegeben wurde. Dies ist nützlich, falls Sie einen permanenten Netzwerkzugang haben oder falls Ihre Datenbank aus irgend einem Grund beschädigt wurde. Beachten Sie, dass dieser Befehl aus Sicherheitsgründen nicht standardmäßig den Wert \&\fB\s-1DEBEMAIL\s0\fR oder \fB\s-1EMAIL\s0\fR hat. .IP "\fBlistcachedbugs\fR [\fIZahl\fR]" 4 .IX Item "listcachedbugs [Zahl]" listet zwischengespeicherte Fehlerkennungen auf (für die Unterstützung der Bash\-Vervollständigung gedacht). Das optionale Argument »Zahl« beschränkt die Liste auf jene Fehlerkennungen, die mit dieser Zahl beginnen. .IP "\fBversion\fR" 4 .IX Item "version" zeigt Version und Copyright-Information an. .IP "\fBhelp\fR" 4 .IX Item "help" zeigt eine kurze Zusammenfassung der Befehle, verdächtig ähnlich zu Teilen dieser Handbuchseite. .SH "UMGEBUNGSVARIABLEN" .IX Header "UMGEBUNGSVARIABLEN" .IP "\fB\s-1DEBEMAIL\s0\fR" 4 .IX Item "DEBEMAIL" Falls diese gesetzt ist, wird die Von:\-Zeile in der E\-Mail gesetzt, um diese E\-Mail-Adresse anstelle Ihrer normalen E\-Mail-Adresse zu benutzen (als wäre sie durch \fBmail\fR festgelegt). .IP "\fB\s-1DEBFULLNAME\s0\fR" 4 .IX Item "DEBFULLNAME" Falls \fB\s-1DEBEMAIL\s0\fR gesetzt ist, wird \fB\s-1DEBFULLNAME\s0\fR geprüft, um den vollständigen Namen, der verwendet wird, zu bestimmen; falls dies nicht gesetzt ist, versucht \fBbts\fR einen Namen von Ihrem \fIpasswd\fR\-Eintrag zu bestimmen. .IP "\fB\s-1BROWSER\s0\fR" 4 .IX Item "BROWSER" Falls gesetzt, gibt es den Browser an, der für die Optionen \fBshow\fR und \&\fBbugs\fR verwendet wird. Lesen Sie die vorhergehende Beschreibung. .SH "KONFIGURATIONSVARIABLEN" .IX Header "KONFIGURATIONSVARIABLEN" Die beiden Konfigurationsdateien \fI/etc/devscripts.conf\fR und \&\fI~/.devscripts\fR werden in dieser Reihenfolge durch eine Shell eingelesen, um Konfigurationsvariablen zu setzen. Befehlszeilenoptionen können benutzt werden, um Einstellungen aus Konfigurationsdateien außer Kraft zu setzen. Einstellungen aus Umgebungsvariablen werden zu diesem Zweck ignoriert. Die derzeit bekannten Variablen sind: .IP "\fB\s-1BTS_OFFLINE\s0\fR" 4 .IX Item "BTS_OFFLINE" Falls dies auf \fByes\fR gesetzt ist, dann ist es genauso, als wenn der Befehlszeilenparameter \fB\-\-offline\fR benutzt würde. Es hat nur Auswirkungen auf die Befehle \fBshow\fR und \fBbugs\fR. Vorgabe ist \fBno\fR. Weitere Informationen finden Sie in der vorhergehenden Beschreibung des Befehls \&\fBshow\fR. .IP "\fB\s-1BTS_CACHE\s0\fR" 4 .IX Item "BTS_CACHE" Falls dies auf \fBno\fR gesetzt ist, dann ist es genauso, als wenn der Befehlszeilenparameter \fB\-\-no\-cache\fR benutzt würde. Es hat nur Auswirkungen auf die Befehle \fBshow\fR und \fBbug\fR. Vorgabe ist \fByes\fR. Weitere Informationen finden Sie wieder beim Befehl \fBshow\fR weiter oben. .IP "\fBBTS_CACHE_MODE=\fR{\fBmin\fR,\fBmbox\fR,\fBfull\fR}" 4 .IX Item "BTS_CACHE_MODE={min,mbox,full}" Wieviel von der Fehlerdatenbank sollte gespiegelt werden, wenn danach gefragt wird, etwas zwischenzuspeichern? Nur das Minimum oder auch die Mbox oder das Ganze? Vorgabe ist \fBmin\fR, was die gleiche Bedeutung hat wie der Befehlszeilenparameter \fB\-\-cache\-mode\fR. Dies hat nur Auswirkungen auf den Zwischenspeicher. Weitere Informationen finden Sie beim Befehl \fBcache\fR. .IP "\fB\s-1BTS_FORCE_REFRESH\s0\fR" 4 .IX Item "BTS_FORCE_REFRESH" Falls dies auf \fByes\fR gesetzt ist, dann ist es genauso, als wenn der Befehlszeilenparameter \fB\-\-force\-refresh\fR benutzt würde. Es hat nur Auswirkungen auf den Befehl \fBcache\fR. Vorgabe ist \fBno\fR. Weitere Informationen finden Sie beim Befehl \fBcache\fR. .IP "\fB\s-1BTS_MAIL_READER\s0\fR" 4 .IX Item "BTS_MAIL_READER" Falls dies gesetzt ist, gibt es ein E\-Mail-Programm an, der anstelle von \&\fBmutt\fR benutzt wird. Entspricht der Befehlszeilenoption \fB\-\-mailreader\fR. .IP "\fB\s-1BTS_SENDMAIL_COMMAND\s0\fR" 4 .IX Item "BTS_SENDMAIL_COMMAND" Falls dies gesetzt ist, gibt es einen \fBsendmail\fR\-Befehl an, der anstelle von \fI/usr/sbin/sendmail\fR verwendet wird. Entspricht der Befehlszeilenoption \&\fB\-\-sendmail\fR. .IP "\fB\s-1BTS_ONLY_NEW\s0\fR" 4 .IX Item "BTS_ONLY_NEW" lädt beim Zwischenspeichern nur neue Fehler herunter; prüft nicht auf Aktualisierungen in Fehlern, die bereits vorliegen. Vorgabe ist \&\fBno\fR. Entspricht der Befehlszeilenoption \fB\-\-only\-new\fR. .IP "\fB\s-1BTS_SMTP_HOST\s0\fR" 4 .IX Item "BTS_SMTP_HOST" Falls dies gesetzt ist, gibt es einen SMTP-Host an, der für den Versand von E\-Mail gegenüber dem Befehl \fBsendmail\fR den Vorzug bekommt. Entspricht der Befehlszeilenoption \fB\-\-smtp\-host\fR. .Sp Beachten Sie, dass diese Option eine höhere Priorität hat als \&\fB\s-1BTS_SENDMAIL_COMMAND\s0\fR, falls beide gesetzt sind, außer wenn die Option \&\fB\-\-sendmail\fR verwendet wird. .IP "\fB\s-1BTS_SMTP_AUTH_USERNAME\s0\fR, \fB\s-1BTS_SMTP_AUTH_PASSWORD\s0\fR" 4 .IX Item "BTS_SMTP_AUTH_USERNAME, BTS_SMTP_AUTH_PASSWORD" Falls diese Optionen gesetzt sind, ist es, als ob die Optionen \&\fB\-\-smtp\-username\fR und \fB\-\-smtp\-password\fR benutzt würden. .IP "\fB\s-1BTS_SMTP_HELO\s0\fR" 4 .IX Item "BTS_SMTP_HELO" entspricht der Befehlszeilenoption \fB\-\-smtp\-helo\fR. .IP "\fB\s-1BTS_INCLUDE_RESOLVED\s0\fR" 4 .IX Item "BTS_INCLUDE_RESOLVED" Falls dies auf \fBno\fR gesetzt ist, ist es, als ob der Befehlszeilenparameter \&\fB\-\-no\-include\-resolved\fR benutzt würde. Es hat nur Auswirkungen auf den Befehl \fBcache\fR. Vorgabe ist \fByes\fR. Weitere Informationen finden Sie beim Befehl \fBcache\fR. .IP "\fB\s-1BTS_SUPPRESS_ACKS\s0\fR" 4 .IX Item "BTS_SUPPRESS_ACKS" Falls dies auf \fByes\fR gesetzt ist, dann ist es, als ob der Befehlszeilenparameter \fB\-\-no\-ack\fR benutzt würde. Vorgabe ist \fBno\fR. .IP "\fB\s-1BTS_INTERACTIVE\s0\fR" 4 .IX Item "BTS_INTERACTIVE" Falls dies auf \fByes\fR oder \fBforce\fR gesetzt ist, dann ist es, als ob die Befehlszeilenparameter \fB\-\-interactive\fR oder \fB\-\-force\-interactive\fR benutzt würden. Vorgabe ist \fBno\fR. .IP "\fB\s-1BTS_DEFAULT_CC\s0\fR" 4 .IX Item "BTS_DEFAULT_CC" gibt eine Liste von E\-Mail-Adressen an, an die eine Kopie der erzeugten E\-Mail an den Steuer-Bot automatisch gesandt werden sollte. .IP "\fB\s-1BTS_SERVER\s0\fR" 4 .IX Item "BTS_SERVER" gibt den Namen des Debbugs-Servers an, der anstelle von https://bugs.debian.org benutzt werden soll. .SH "SIEHE AUCH" .IX Header "SIEHE AUCH" Bitte lesen Sie , um weitere Einzelheiten zu erhalten, wie die Fehlerdatenbank unter Benutzung von E\-Mails gesteuert wird und , um weitere Informationen über die Fehlerdatenbank zu erhalten. .PP \&\fBpts\-subscribe\fR\|(1), \fBquerybts\fR\|(1), \fBreportbug\fR\|(1), \fBdevscripts.conf\fR\|(5) .SH "COPYRIGHT" .IX Header "COPYRIGHT" Dieses Programm unterliegt dem Copyright (C) 2001\-2003 von Joey Hess . Es wurden viele Änderungen vorgenommen unter dem Copyright (C) 2002\-2005 von Julian Gilbey und dem Copyright (C) 2007 von Josh Triplett . .PP Es ist lizensiert unter den Bedingungen der \s-1GPL,\s0 entweder Version 2 der Lizenz oder (nach Ihrer Wahl) irgendeiner späteren Version.