This version of the page http://www.debian.org.ua/Bugs/Reporting.sv.html (0.0.0.0) stored by archive.org.ua. It represents a snapshot of the page as of 2007-08-07. The original page over time could change.
Debian -- Debians felrapporteringssystem - rapportera fel

Hur man rapporterar fel (buggar) i Debian

Viktigt att tänka på innan du rapporterar

Rapportera inte flera orelaterade fel i samma meddelande, speciellt inte om de berör olika paket.

Kontrollera om felet har rapporterats av någon annan innan du skickar in en rapport. En lista över för närvarande ännu ej avhjälpta fel finns på webben och andra ställen – se andra dokument för detaljer. Du kan sända kommentarer till existerande felrapport <nummer> genom att sända e-post till <nummer>@bugs.debian.org

Om du inte kan avgöra vilket paket problemet har att göra med, skicka e-post till sändlistan för debiananvändare och fråga om hjälp. Om felet inte beror på ett särskilt paket, utan någon mer generell aspekt, så finns det flera pseudo-paket, alternativt sändlistor som du kan använda för att kontakta oss.

Om du vill sända en kopia av din felrapport till flera mottagare (t.ex sändlistor) bör du inte använda de vanliga e-posthuvudena, utan en annan metod som beskrivs nedan.

Om du sänder in en felrapport till Debian, sänd inte själv en kopia av rapporten till uppströmsförfattaren, då det är möjligt att felet bara finns i Debian. Om det är nödvändigt kommer den paketansvariga att vidaresända felrapporten uppströms.

Skicka rapporten med ett automatiskt felrapportsverktyg

Programmet reportbug kan göra det enklare att sända in felrapporter genom att steg för steg visa dig vägen genom felrapporteringsproceduren. Verktygen querybts, i samma paket som reportbug ger ett bekvämt textbaserat gränssnitt till felrapporteringssystemet.

Emacsanvändare kan även använda kommandot debian-bugs som finns i paketet debian-el. Det anropas med M-x debian-bug och ber om all information på ett liknande sätt som reportbug.

Skicka rapporten med e-post

Sänd e-post till submit@bugs.debian.org, enligt nedan.

Självklart bör du, som i alla annan e-post, ange en tydlig och beskrivande ärenderad i brevhuvudet. Ärenderaden används initialt som titel för rapporten i felhanteringssystemet, så försök göra den informativ!

Du måste lägga in ett ”pseudo-brevhuvud” i början av meddelandekroppen. Det betyder att första raden av meddelandet skall vara

Package: <någonting>

Byt ut <någonting> mot namnet på paketet som har ett fel.

Andra raden skall vara

Version: <någonting>

Byt ut <någonting> mot paketets version. Lägg inte in någon annan text än själva versionen här, eftersom felrapporteringssystemet är beroende av att detta fält är korrekt för att hålla reda på vilka utgåvor som påverkas av felet.

Du måste ha en korrekt Package-rad i ”pseudo-brevhuvudet” för att felrapporteringssystemet skall kunna skicka rapporten till paketets underhållare. Se ett exempel för att hitta de uppgifterna.

Raderna i ”pseudo-brevhuvudet” måste börja längst till vänster på varje rad.

Vad som bör inkluderas i rapporten

  • En exakt och komplett avskrift av det/de felmeddelanden som skrivs ut eller loggas. Detta är mycket viktigt!
  • Precis vad du skrev eller gjorde när problemet uppstod.
  • En beskrivning av felaktigheten: beskriv vad du förväntade dig skulle hända, och vad du såg faktiskt hände. En avskrift av en körning är ett bra sätt att visa detta.
  • Förslag på rättning, eller till och med en programfix, om du har någon.
  • Detaljer om hur du konfigurerat programmet i vilket felet uppstod. Inkludera hela konfigurationsfilen.
  • Versionsnumren på eventuella paket det felaktiga paketet är beroende på.
  • Vilken version av kärnan du använder (skriv uname -a), version på C-biblioteket (skriv ls -l /lib/libc.so.6 eller dpkg -s libc6 | grep ^Version), samt andra detaljer om ditt Linuxsystem om det verkar vara passande. Om du till exempel har problem med ett Perlskript, så bör du ange versionsnumret på perlbinären (skriv perl -v eller dpkg -s perl | grep ^Version:).
  • Lämpliga detaljer om din dators maskinvara. Om du rapporterar ett problem med en drivrutin, se till att lista all maskinvara i din dator, eftersom problem ofta beror på IRQ- eller I/O-adresskonflikter.

Inkludera alla detaljer som verkar vara relevanta – faran är väldigt liten att du inkluderar för mycket information och rapporten därmed blir för stor. Om de är små bör du även inkludera eventuella filer som kan användas för att reproducera felet (om de innehåller konstiga tecken eller liknande är det säkrast att skicka dem uu-kodade).

För tips om hur du kan hjälpa utvecklarna att lösa dina problem ber vi dig läsa Hur man rapporterar fel effektivt.

Exempel

En felrapport, med brevhuvud, ser ut ungefär så här:

  To: submit@bugs.debian.org
  From: diligent@testing.linux.org
  Subject: Hello says `goodbye'

  Package: hello
  Version: 1.3-16

  When I invoke `hello' without arguments from an ordinary shell
  prompt it prints `goodbye', rather than the expected `hello, world'.
  Here is a transcript:

  $ hello
  goodbye
  $ /usr/bin/hello
  goodbye
  $

  I suggest that the output string, in hello.c, be corrected.

  I am using Debian GNU/Linux 2.2, kernel 2.2.17-pre-patch-13
  and libc6 2.1.3-10.

Skicka kopior av felrapporten till andra adresser

Ibland är det nödvändigt att skicka en kopia av rapporten, förutom till debian-bugs-dist och den som är ansvarig för paketet, vilket är vart den normalt skickas.

Du kan göra detta genom att skicka en kopia (Cc) av din felrapport till de andra adresserna, men i så fall kommer inte de andra kopiorna att ha felrapportens nummer i Reply-To-fältet och ärenderaden. När dessa mottagare sedan svarar kommer de antagligen att ha kvar submit@bugs.debian.org i brevhuvudet, vilket får till följd att deras svar anses som en ny felrapport. Detta leder till att det blir alltför många duplicerade rapporter.

Det rätta sättet att göra detta på är att använda raden X-Debbugs-CC i brevhuvudet. Lägg till en rad som den nedan till brevhuvudet:

 X-Debbugs-CC: other-list@cosmic.edu

Detta får till följd att felhanteringssystemet skickar en kopia av din felrapport till adressen/-rna på X-Debbugs-CC-raden, förutom debian-bugs-dist.

Undvik att sända sådana kopior till andra felrapporters adress, eftersom de kommer fångas upp av testerna som förhindrar att breven går i cirklar. Oavsett är det inte stor mening med att använda X-Debbugs-CC för det ändå, eftersom felnumret som läggs in av mekanismen bara kommer att ersättas med ett nytt; använd ett vanligt CC-fält istället.

Den här funktionen kan ofta kombineras med att skicka till quiet – se nedan.

Allvarlighetsgrad

Om rapporten handlar om ett speciellt allvarligt fel, eller bara är en önskan om en ny funktion, så kan du ange vilken allvarlighetsgrad du tycker att felrapporten ska ha. Det är dock inget krav att du gör det, och utvecklarna kommer att tilldela en allvarlighetsgrad till din rapport om du inte gör det.

För att ange hur allvarlig din rapport är lägger du raden

Severity: <allvarlighet>

i ditt pseudo-brevhuvud. Ersätt <allvarlighet> med en av graderna som finns angivna i utvecklardokumentationen.

Lägga in märken

Du kan lägga in märken på en felrapport när du sänder in den. Om du till exempel sänder med en patch med din rapport kan du märka den patch. Det är dock inget krav att du gör det, utvecklarna kommer att märka din rapport vid behov.

För att märka en rapport lägger du in en rad på denna form i pseudo-brevhuvudet:

Tags: <märken>

Ersätt <tags> med ett eller flera av de tillgängliga märkena, vilka beskrivs i utvecklardokumentationen. Avdela multipla märken med komman, blanksteg eller bådadera.

User: <användarnamn>
Usertags: <användarmärken>

Ersätt <användarmärken> med ett eller flera användarmärken. Avdela multipla märken med komman, blanksteg eller bådadera. Om du anger ett <användarnamn> kommer den användarens märken att sättas. I annat fall används avsändarens e-postadress som användarnamn.

Andra pseudohuvuden (primärt intressanta för paketansvariga

Forwarded: foo@example.com

Markerar den nya felrapporten som vidaresänd till foo@example.com. Se Ange att du har skickat vidare en felrapport i utvecklardokumentationen för detaljer.

Owner: foo@example.com

Ställer in att foo@example.com nu är ansvarig för att rätta felet. Se Byta ägare till ett fel i utvecklardokumentationen för detaljer.

Source: paketfoo

Motsvarigheten till Package: i fel som finns i källkoden för paketet paketfoo. För de allra flesta paket vill du inte använda det här alternativet.

Slutligen kan du, om ditt e-postprogram inte tillåter dig att redigera brevhuvudet, sätta in de olika X-Debbugs--brevhuvudena i pseudohuvudet.

Skicka till olika adresser (mindre felrapporter och massrapporter)

Om felrapporten är mindre, till exempel ett stavfel i dokumentationen, eller andra triviala problem, sätt då allvarligheten därefter och skicka dem till maintonly@bugs.debian.org istället för submit@bugs.debian.org. maintonly skickar rapporten till paketets underhållare, och inte till den allmänna sändlistan för felrapporteringar.

Om du skickar in många rapporter samtidigt skall du definitivt använda maintonly@bugs.debian.org så att du inte skapar för mycket onödig trafik på sändlistan. Innan du skickar in många liknande felrapporter kan du också skicka en summering till debian-bugs-dist.

Om du vill rapportera ett fel till felrapporteringssystemet som redan har skickats till underhållaren så kan du använda quiet@bugs.debian.org. Rapporter skickade till quiet@bugs.debian.org skickas inte vidare någonstans, de arkiveras bara.

Om du gör detta kommer felrapporteringssystemet att sätta Reply-To i eventuella vidaresända meddelanden så att de som standard hanteras på samma sätt som den ursprungliga rapporten. Det betyder till exempel att svar till maintonly går till nnn-maintonly@bugs.debian.org istället för nnn@bugs.debian.org, så länge ingen ändrar det manuellt förstås.

Bekräftelser

Normalt sänder felrapporteringssystemet tillbaka en bekräftelse per e-post till dig när du sänder in ett nytt fel eller ytterligare information om ett tidigare rapporterat. Om du vill undvika bekräftelsen lägger du in brevhuvudet X-Debbugs-No-Ack i ditt brev (innehållet i huvudet spelar ingen roll; det måste dock finnas i brevhuvudet och inte i pseudohuvudet som innehåller Package-fältet). Om du rapporterar ett nytt fel med det här brevhuvudet måste du själv ta reda på felnumret via webbgränssnittet.

Observera att huvudet inte undviker bekräftelser från brevserven control@bugs.debian.org eftersom dessa bekräftelser kan innehålla felmeddelanden som bör läsas och lämpliga åtgärder vidtagas.

Felrapporter mot okända paket

Om felrapporteringssystemet inte vet vem som är ansvarig för det paket som anges kommer det att skicka rapporten till debian-bugs-dist även om maintonly användes.

När du skickar till maintonly@bugs.debian.org eller nnn-maintonly@bugs.debian.org så måste du vara säker på att felrapporten tilldelas rätt paket, genom att lägga in en korrekt Package-rad i början av den ursprungliga felrapporten, eller genom att använda control@bugs.debian.org för att flytta över rapporten till rätt paket, om det inte är rätt från början.

Använda dpkg för att hitta paket och version till rapporten

Om du rapporterar ett fel i ett kommando kan du ta reda på vilket paket som installerade det genom att använda dpkg --search. Du kan ta reda på vilken version av paketet du har installerat genom att använda dpkg --list eller dpkg --status.

Exempelvis:

$ 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
Önskat=Okänd(U)/Installera(I)/Radera(R)/Rensa(P)/Håll(H)
| Status=Ej(N)/Installerad(I)/Konf.(C)/Uppackad(U)/Misslyckad(F)/Delvis(H)
|/ Fel?Inget(=)/Håll(H)/Ominstallera(R)/Båda(X) (Status,Fel: versaler=illa)
||/ Namn           Version        Beskrivning
+++-==============-==============-============================================
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

Andra sidor i felrapporteringssystemet:

  • Framsida för felrapporteringssystemet.
  • Instruktioner om hur man rapporterar fel.
  • Komma åt loggarna på andra sätt än via webben.
  • Utvecklarinformation om hur systemet används.
  • Utvecklarinformation om hur felrapporter kan manipuleras per e-post.
  • E-postserverns referenskort.
  • Begära felrapporter per e-post.

Debian BTS administrators <owner@bugs.debian.org>

Debian bug tracking system
Copyright © 1999 Darren O. Benham, 1997, 2003 nCipher Corporation Ltd, 1994-1997 Ian Jackson.