Non segnalare più bug slegati, soprattutto se relativi a pacchetti differenti, in un unico messaggio.
Si dovrebbe controllare che il bug non sia già stato segnalato da qualcun altro prima di inviare la segnalazione. L'elenco dei bug al momento irrisolti è disponibile sul World Wide Web e da altre fonti; si vedano gli altri documenti per dettagli. È possibile inviare i propri commenti a una segnalazione già esistente con numero <numero>@bugs.debian.org.
Se non si riesce a determinare quale pacchetto contiene il problema, spedire una e-mail alla mailing list Debian user chiedendo consigli. Se il problema non è legato a un solo pacchetto ma con un qualche generico servizio Debian, ci sono parecchi pseudo-pacchetti o anche mailing list tramite le quali è possibile effettuare la segnalazione.
Per spedire una copia della propria segnalazione ad altri (ad esempio a delle liste di messaggi), non si devono usare le solite intestazioni delle e-mail, ma un metodo differente, descritto in seguito.
Se si segnala un bug in Debian, non inviare una copia del bug anche a chi sviluppa il programma a monte dato che è possibile che il bug sia presente solo nel pacchetto per Debian. Se necessario, sarà il manutentore del pacchetto a informare gli sviluppatori del bug.
Il programma reportbug aiuta nella preparazione della segnalazione di bug
guidando passo dopo passo il processo di scrittura della segnalazione.
Il comando querybts, contenuto anch'esso nel pacchetto reportbug, fornisce una comoda interfaccia testuale al sistema di tracciamento dei bug.
Gli utenti di emacs possono anche usare il comando debian-bug fornito dal
pacchetto debian-el. Quando richiamato tramite M-x debian-bug,
richiede tutte le informazioni necessarie, similarmente a
reportbug.
Spedire un'e-mail a submit@bugs.debian.org, come descritto in seguito.
Naturalmente, come in ogni e-mail, si deve includere un chiaro e preciso
Oggetto fra le intestazioni principali della tua mail. L'oggetto
inserito diventa il titolo iniziale del bug nel sistema di gestione perciò
è importante che sia chiaro!
È necessario inserire una pseudo-intestazione all'inizio del testo del messaggio. Ciò significa che le prime righe del messaggio dovrebbero essere:
Package: <qualcosa>
Sostituire <qualcosa> con il nome del pacchetto con
il bug.
La seconda riga del messaggio dovrebbe essere:
Version: <qualsiasi>
Sostituire <qualsiasi> con la versione del pacchetto.
Non va incluso null'altro in questa riga poiché il sistema si affida
a quanto scritto per capire quali versioni sono affette dal bug.
È necessario fornire una corretta riga Package nella
pseudo-intestazione affinché il sistema di gestione dei bug possa inviare il
messaggio allo sviluppatore del pacchetto. Si veda questo esempio per informazioni su come rintracciare questo dato.
I campi contenenti pseudo-intestazioni devono cominciare all'inizio delle rispettive righe.
Si consiglia di includere nella segnalazione:
uname -a),
quale versione della libreria C (scrivere ls -l /lib/libc.so.6 o
dpkg -s libc6 | grep ^Version), e ogni altro dettaglio riguardo
il sistema Debian che sembra utile. Per esempio, nel caso di un problema con
uno script Perl, si dovrebbe fornire la versione del binario perl(scrivere
perl -v o dpkg -s perl | grep
^Version:).Includere ogni dettaglio che sembra rilevante, non ci sono pericoli nello scrivere una segnalazione troppo lunga includendo troppe informazioni. Se sono piccoli, includere nella segnalazione tutti i file utilizzati per riprodurre il problema (codificarli con uuencode nel caso in cui contengano strani caratteri etc.).
Per maggiori informazioni su come aiutare gli sviluppatori a risolvere il problema, si consiglia la lettura del How to Report Bugs Effectively.
Una segnalazione, comprensiva dell'intestazione del messaggio, assomiglia a quanto scritto sotto, ma è opportuno scriverla in inglese.
To: submit@bugs.debian.org From: diligent@testing.linux.org Subject: Hello stampa `goodbye' Package: hello Version: 1.3-16 Quando invio il programma `hello' senza argomenti dall'interprete dei comandi normale, questo stampa la stringa `goodbye', piuttosto che `hello, word'. Ecco l'esempio $ hello goodbye $ /usr/bin/hello goodbye $ Suggerirei di cambiare la stringa stampata nel file hello.c correggendola. Sto usando Debian GNU/Linux 2.2, kernel 2.2.17-pre-patch-13 e libc6 2.1.3-10.
Può capitare di dover mandare una copia della segnalazione a qualcuno
diverso da debian-bugs-dist e dal gestore del pacchetto,
che sono quelli cui normalmente è destinato il messaggio.
Si potrebbe fare inserendo gli indirizzi in più nel capo CC, ma poi
questi non riceverebbero il numero associato alla segnalazione nel
campo Reply-To e Subject. Quando gli altri
destinatari risponderanno al messaggio useranno l'indirizzo
submit@bugs.debian.org e il loro messaggio diventa una
nuova segnalazione di bug. Ciò genera molte segnalazioni duplicate.
Il modo corretto di fare questo è di usare il campo
X-Debbugs-CC dell'intestazione. Aggiungere una riga
simile a questa alla propria intestazione:
X-Debbugs-CC: other-list@cosmic.edu
Questo fa sì che il sistema di gestione dei bug mandi una copia della
segnalazione agli indirizzi specificati nel campo X-Debbugs-CC
oltre che a debian-bugs-dist.
Evitare di inviare questo tipo di copie ad altre segnalazioni di bug;
interferirebbero con i controlli che prevengono i mail loops
. Ci
anche altre piccole controindicazioni nell'usare X-Debbugs-CC
per questo scopo, considerando che il numero del bug aggiunto da questo
meccanismo viene semplicemente sostituito da uno nuovo; è preferibile
invece una normale intestazione CC.
Questa caratteristica può essere ben combinata con l'invio a
quiet; vedi oltre.
Una segnalazione può riguardare un bug serio oppure la richiesta di una aggiunta ad un pacchetto, è possibile selezionare il livello di gravità della segnalazione. Questo non è obbligatorio, ovviamente, e gli sviluppatori assegneranno il livello adeguato alle segnalazioni sprovviste.
Per assegnare un livello di gravità, inserire una riga come questa fra le pseudo-intestazione:
Severity: <qualsiasi>
Sostituisci <qualsiasi> con uno dei livelli disponibili, come descritto nella documentazione per gli sviluppatori.
Si possono assegnare dei tag durante la creazione di una segnalazione. Ad
esempio, se si sta includendo una patch alla segnalazione, si può pensare di
inserire il tag patch. Questo non è obbligatorio, e il manutentore
aggiungerà il tag al momento opportuno.
Per aggiungere il tag, si inserisca una riga come questa nella pseudo-intestazione:
Tags: <tags>
Sostituendo <tags> con uno o più dei tag disponibili descritti nella documentazione per gli sviluppatori. Tag multipli vanno separati con virgole, spazi o entrambi.
User: <username> Usertags: <usertags>
Sostituendo <usertags> con uno o più usertag. Tag multipli vanno separati con virgole, spazi o entrambi. Se si specifica un <username>, il tag user sarà impostato con esso. Altrimenti, l'indirizzo di posta elettronica del mittente sarà utilizzato come username.
Forwarded: foo@example.com
Segna il bug recentemente segnalato come inoltrato a foo@example.com. Si veda Recording that you have passed on a bug report nella documentazione per gli sviluppatori per i dettagli.
Owner: foo@example.com
Indica che foo@example.com è ora responsabile della soluzione di questo bug. Si veda Changing bug ownership nella documentazione degli sviluppatori per i dettagli.
Source: foopackage
L'equivalente di Package: per i bug presenti nel pacchetto
sorgente di foopackage; nel caso di molti bug presenti in molti pacchetti non
usare questa opzione.
Infine, se il priprio MUA non consente di modificare le intestazioni, si può impostare
le varie intestazioni X-Debbugs- nelle pseudo-intestazioni.
Se il bug non è grave (ad esempio, se c'è una svista nella documentazione o
un banale problema di compilazione), scegliere il giusto livello di gravità e
spedire il tutto a maintonly@bugs.debian.org invece che a
submit@bugs.debian.org. maintonly invia la
segnalazione solo a chi manutiene il pacchetto, e non la invia al contrario
alle mailing list del BTS.
Se si inviano molte segnalazioni in una volta, si dovrebbe assolutamente
utilizzare maintonly@bugs.debian.org così non si provoca
troppo traffico ridondante sulle mailing list del BTS. Prima di inviare
molte segnalazioni simili si dovrebbe comunicare le proprie intenzioni a
debian-bugs-dist.
Per inviare al sistema di gestione dei bug per la segnalazione
di un bug che il manutentore già conosce si può utilizzare
quiet@bugs.debian.org. Le segnalazioni spedite a
quiet@bugs.debian.org non sono inoltrate a nessuno,
vengono solo registrate.
Quando si utilizzano indirizzi differenti per segnalare bug, il sistema di
gestione dei bug imposta il Reply-To di ogni messaggio inoltrato
così le risposte saranno automaticamente elaborate allo stesso modo della
segnalazione originaria. Ciò significa che, per esempio, le risposte a
maintonly andranno a nnn-maintonly@bugs.debian.org
invece che a nnn@bugs.debian.org, a meno che ovviamente
qualcuno non sostituisca questi campi a mano.
Normalmente il sistema di tracciamento dei bug spedisce un'e-mail come
ricevuta quando si invia una segnalazione di bug o si fornisce spiegazioni
addizionali ad un bug esistente. Per evitare queste e-mail, includere
un'intestazione X-Debbugs-No-Ack nel messaggio (il contenuto
dell'intestazione non conta; comunque, deve essere nelle intestazioni
dell'e-mail e non nelle pseudo-intestazioni insieme al campo
Package). Se si invia una nuova segnalazione con questa
intestazione, si dovrà controllare l'interfaccia web per trovare il numero
del bug.
Nota che questa intestazione non elimina le ricevute provenienti dal
mailserver control@bugs.debian.org, visto che tali ricevute
potrebbero contenere dei messaggi d'errore che andrebbero letti e
considerati.
PackageSe il sistema di tracciamento non conosce chi sia il manutentore
del pacchetto, gira la segnalazione alla lista di messaggi
debian-bugs-dist anche se era stato usato il
maintonly.
Quando si invia a maintonly@bugs.debian.org o a
nnn-maintonly@bugs.debian.org si deve essere certi che
la segnalazione sia assegnata al pacchetto corretto, inserendo la voce
Package all'inizio della pseudo intestazione o usando
il robot control@bugs.debian.org
per (ri)assegnare la segnalazione nel caso non fosse stato fatto
correttamente in precedenza.
dpkg per trovare il pacchetto e
la versione per la segnalazioneSe si sta preparando la segnalazione di un bug in un comando, si può
scoprire in quale pacchetto sia distribuito usando il comando dpkg
--search. Per sapere la versione di un pacchetto installato si
possono usare i comandi dpkg --list e dpkg
--status.
Per esempio
$ which apt-get /usr/bin/apt-get $ type apt-get apt-get is /usr/bin/apt-get $ dpkg --search /usr/bin/apt-get apt: /usr/bin/apt-get $ dpkg --list apt Desired=Unknown/Install/Remove/Purge/Hold | Status=Not/Installed/Config-files/Unpacked/Failed-config/Half-installed |/ Err?=(none)/Hold/Reinst-required/X=both-problems (Status,Err: uppercase=bad) ||/ Name Version Description +++-==============-==============-============================================ ii apt 0.3.19 Advanced front-end for dpkg $ dpkg --status apt Package: apt Status: install ok installed Priority: standard Section: base Installed-Size: 1391 Maintainer: APT Development Team <deity@lists.debian.org> Version: 0.3.19 Replaces: deity, libapt-pkg-doc (<< 0.3.7), libapt-pkg-dev (<< 0.3.7) Provides: libapt-pkg2.7 Depends: libapt-pkg2.7, libc6 (>= 2.1.2), libstdc++2.10 Suggests: dpkg-dev Conflicts: deity Description: Advanced front-end for dpkg This is Debian's next generation front-end for the dpkg package manager. It provides the apt-get utility and APT dselect method that provides a simpler, safer way to install and upgrade packages. . APT features complete installation ordering, multiple source capability and several other unique features, see the Users Guide in /usr/doc/apt/guide.text.gz
Altre pagine BTS (sistema di gestione delle anomalie)
Debian bug tracking system
Copyright © 1999 Darren O. Benham, 1997, 2003 nCipher Corporation Ltd,
1994-1997 Ian Jackson.