Забележка: Оригиналният документ има по-нова версия от превода.
Съобщаване за проблем в Дебиан с reportbug
Силно препоръчваме да съобщавате за откритите от вас проблеми в Дебиан чрез програмата reportbug
.
При повечето системи reportbug е инсталирана по подразбиране. Ако при вас това не е така, може да я инсталирате с използвания от вас инструмент за инсталиране на пакети.
Стартирането на reportbug може да стане от раздела Система
на менюто на графичното
обкръжение или чрез въвеждане на reportbug
на командния ред.
Програмата ще ви преведе през целия процес на съобщаване за проблема.
Ако имате въпроси, които интерактивната система на reportbug не успява да отговори, можете да се консултирате с тази документация или да попитате в пощенския списък за потребители на Дебиан.
Съобщаване за открита грешка в Дебиан по електронна поща (и reportbug за напреднали)
Важни неща, които трябва да изясните преди да изпратите доклада
В кой пакет е проблемът?
Трябва да знаете за кой пакет се отнася открития проблем. Вижте този пример за това как да откриете тази информация. (Можете да използвате тази информация за да проверите дали проблемът не е вече докладван.)
Ако не можете да определите кой пакет е отговорен за проблема, изпратете имейл до пощенския списък за потребители на Дебиан и помолете за съвет.
Ако проблемът засяга не просто някой пакет, а някоя основна услуга на Дебиан, съществуват няколко псевдо-пакета и пощенски списъка, които можете да използвате за да препратите съобщението си до нас.
Дали за проблема вече е съобщено?
Преди да изпратите доклада е добре да проверите дали вече е съобщено за подобен проблем. Всички доклади за даден пакет можете да видите чрез полето за филтриране по пакет на формуляра за търсене на доклади за грешки. Ако за проблема вече е съобщено под #<номер>, изпратете съобщението до <номер>@bugs.debian.org, вместо да създавате нов доклад.
Изпращане на множество доклади за множество проблеми
Не изпращайте доклади за несвързани помежду си проблеми (особено такива от различни пакети) в едно съобщение.
Не изпращайте доклади за проблеми на оригиналните автори
Ако съобщавате за проблем, открит в Дебиан, не изпращайте копие до оригиналните автори на програмата, тъй като е възможно проблемът да съществува само в Дебиан. Ако е нужно, отговорникът на пакета ще препрати доклада.
Изпращане на доклади по имейл
Изпращането на доклад за проблем става чрез изпращане на съобщение до
submit@bugs.debian.org
и
използване на специален формат, описан по-долу. Програмата reportbug
(виж по-горе) ще използва правилния формат за съобщенията.
Използвайте я!
Заглавки
Разбира се, както при всяко съобщение, трябва да укажете ясна, описателна
тема (Subject
) в заглавките на писмото. Темата ще бъде
използвана като начално заглавие на доклада в системата за проследяване.
Опитайте се да я направите съдържателна.
Ако желаете да изпратите копие на вашия доклад към други получатели (например пощенски списъци), не използвайте стандартните заглавки, а метода, описан по-долу.
Псевдо-заглавки
Първата част на съобщението съдържа псевдо-заглавки, които съдържат информация за това за кой пакет и версия е доклада. Псевдо-заглавките трябва да започват от първия ред на съобщението. Например:
Package: <име на пакет>
Заместете <име на пакет>
с името
на пакета, в който е проблема.
Вторият ред на съобщението трябва да бъде:
Version: <версия на пакета>
Заместете <версия на пакета>
с версията на пакета.
Моля не добавяйте друг текст освен версията, тъй като системата за проследяване
разчита именно на това поле, за да разбере кои версии на Дебиан са
засегнати.
За да може системата за проследяване на проблеми да достави съобщението до
отговорника на пакета е необходимо редът Package
да съдържа
правилно име на пакет. Вижте този пример за
съвет как да откриете тази информация.
За други псевдо-заглавки, вижте Допълнителни псевдо-заглавки
Текст на доклада
Включете в доклада си:
- Точният и пълен текст на всички съобщения за грешка, изписани на екрана или записани в журналните файлове. Това е много важно!
- Точно какво сте написали или направили, за да се появи проблема.
- Описание на неправилното поведение: точно какво сте очаквали и какво сте наблюдавали. Запис на примерна сесия е един добър начин за покажете това.
- Предложение за поправка или дори кръпка, ако имате такава.
- Подробности за настройките на проблемната програма, Включително пълния текст от нейните конфигурационни файлове.
- Версиите на пакетите, от които зависи тази програма.
- Коя версия на използваното ядро (
uname -a
), споделена C библиотека (изпълнете в терминалls -l /lib/*/libc.so.6
илиapt show libc6 | grep ^Version
) и всякакви други подробности за системата, ако сметнете, че са нужни. Например, ако сте имали проблем със скрипт, писан на Perl, би трябвало да предоставите версията на интерпретатора на Perl (изпълнете в терминалperl -v
илиdpkg -s perl | grep ^Version:
). - Информация за хардуера в системата, който може да е свързан с проблема. Ако съобщавате за проблем свързан с драйвер за дадено устройство, опишете всички хардуерни компоненти в системата, тъй като проблемите с тях често са предизвикани от конфликти между IRQ или входно-изходни адреси.
- Ако имате инсталиран пакета
reportbug,
изходът на командата
reportbug --template -T none -s none -S normal -b --list-cc none -q <пакет>
би бил полезен, тъй като съдържа информация, подготвена от отговорника на пакета и точна информация за версията.
Включете всякаква информация, които смятате за важна. Няма опасност да направите доклада си твърде дълъг като включите прекалено много информация. Ако са малки, включете всички файлове, които сте използвали, за да предизвикате грешката. (Ако са големи и е възможно, обмислете публикуването им на общодостъпен сайт.)
За повече съвети за това как да помогнете на програмистите да решат проблема, прочетете документа Ефективно съобщаване за грешки.
Примерен доклад за проблем
Доклад за проблем със заглавки и псевдо-заглавки изглежда по следния начин:
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.
Изпращане на копие на доклада до други адреси
Понякога е нужно да се изпрати копие на доклада до допълнителни
получатели, освен debian-bugs-dist
и отговорника на пакета,
където обикновено биват изпращани.
Това би могло да стане с изпращане на копия (CC) на съобщението до
допълнителните адреси, но тогава заглавките Reply-To
и
Subject
няма да съдържат номера на доклада.
Когато получателите отговорят, много вероятно е да запазят
submit@bugs.debian.org
в заглавките и като резултат съобщението
им ще отвори нов доклад за проблем. Това води до дублирани доклади.
Правилният начин да изпратите копия е да използвате
заглавката X-Debbugs-CC
. Добавете следния ред към заглавките на
съобщението:
X-Debbugs-CC: other-list@cosmic.edu
Това ще инструктира системата за проследяване на проблеми да изпрати копие на
доклада до адресите, описане в заглавката X-Debbugs-CC
, както и до
debian-bugs-dist
.
За изпращане на копие до повече от един адрес се използва само един ред
X-Debbugs-CC
, като адресите се разделят със запетая.
Избягвайте да изпращате такива копия до адреси на други доклади. Те ще бъдат
прихванати от проверките за избягване на зацикляне на писма. Използването на
X-Debbugs-CC
за тази цел е безсмислено, защото номерът на
доклада все едно ще бъде заместен с номера на новосъздадения доклад.
Използвайте обикновена CC
заглавка за изпращане на копия до други
доклади.
Тази функция може често да бъде пълноценно комбинирана с
дискретно
изпращане на писмо (виж по-долу).
Допълнителни псевдо-заглавки
Степени на критичност
Дали докладът е за сравнително сериозна грешка или просто молба за въвеждане на функция, можете да укажете степента на критичност. Това не е задължително. Отговорникът на пакета ще укаже или промени степента на критичност, ако вие го пропуснете или изберете неподходяща степен.
За да отбележите критичността на проблема, добавете следния ред в псевдо-заглавките:
Severity: <критичност>
Заместете <критичност> с едно от възможните нива, както е описано в документацията за напреднали.
Добавяне на етикети
Можете да поставите етикети в доклада за открит проблем. Например, ако
съобщението включвате кръпка, може да добавите етикета
patch
. Това не е задължително. Разработчиците ще зададат
етикети на доклада когато това е уместно.
За да добавите етикети, добавете следния ред в псевдо-заглавките:
Tags: <етикети>
Заместете <етикети> с един или повече от възможните етикети, както е описано в документацията за програмисти. Разделяйте отделните етикети със запетайки, интервали или и двете.
User: <потребител> Usertags: <потребителски етикети>
Заместете <потребителски етикети> с един или повече потребителски етикети. Разделяйте отделните етикети със запетайки, интервали или и двете. Ако укажете <потребител>, ще бъдат зададени етикетите за въпросния потребител. В противен случай за потребител ще бъде използван адресът на подателя на съобщението.
Допуска се поставянето на потребителски етикети за повече от един потребител. За целта добавете няколко псевдо-заглавки User. Всяка псевдо-заглавка Usertags указва потребителските етикети за потребителя от последната псевдо-заглавка User. Това е особено полезно при поставяне на етикети за екип с множество членове, за няколко екипа или при използване на потребителските етикети, засягащи различните хардуерни архитектури.
User: <first-username> Usertags: <first-username usertags> User: <second-username> Usertags: <second-username usertags>
Отбелязване на препратени доклади
Forwarded: foo@example.com
ще маркира доклада като препратен към foo@example.com. За повече информация прочетете Отчитане на предаването на доклада за проблем в документацията за разработчици.
Поемане на отговорност
Owner: foo@example.com
показва, че foo@example.com вече е отговорен за отстраняването на проблема. За повече информация прочетете Промяна на собственика на доклада за проблем в документацията за разработчици.
Указване на пакет-източник
Source: foopackage
е равносилно на Package:
за проблеми, намиращи се в пакета-източник
на foopackage. Използването на тази псевдо-заглавка рядко е необходимо.
Вградени команди
Control: команда
Позволява използването на всички команди, поддържани от адреса
control@bugs.debian.org
при използване на
submit@bugs.debian.org
или nnn@bugs.debian.org
.
За означаване на текущия доклад (този, създаван с писмото до submit@ или докладът, до който се изпраща допълнителна информация на nnn@) може да използвате „-1“.
Вижте страницата за управляващите команди за
повече информация.
Например, следните псевдо-заглавки в съобщение, изпратено до
12345@bugs.debian.org
:
Control: retitle -1 this is the title Control: severity -1 normal Control: summary -1 0 Control: forwarded -1 https://bugs.debian.org/nnn
ще променят заглавието на доклад 12345, ще променят нивото му на критичност, описващото съобщение и ще го маркират като препратен.
Заглавки от вида X-Debbugs-нещо
И най-накрая, ако вашата пощенска програма
не позволява промяната на заглавките, можете зададете различни заглавки
X-Debbugs-
като псевдо-заглавки.
Допълнителна информация
Различни адреси за изпращане на докладите (за маловажни проблеми или за проблеми, засягащи повече от един пакет)
Ако даден проблем е маловажен, например правописна грешка в документацията
или тривиален проблем при компилиране, променете критичността и изпратете
доклада до maintonly@bugs.debian.org
вместо на
submit@bugs.debian.org
.
maintonly
ще препрати доклада само към отговорника на пакета,
без копие до пощенските списъци на системата са следене на проблеми.
Ако изпращате много доклади наведнъж, определено трябва да използвате
maintonly@bugs.debian.org
, за да не предизвикате излишен трафик
в пощенските списъци. Преди да изпратите съобщения за множество подобни проблеми,
може да изпратите резюме до debian-bugs-dist
.
Ако желаете да съобщите за проблем, който вече е изпратен до отговорника,
може да използвате quiet@bugs.debian.org
. Докладите, изпратени до
quiet@bugs.debian.org
няма да бъдат препратени никъде.
Когато използвате различни адреси за изпращане, системата за проследяване на
проблеми ще настрои заглавката Reply-To
на всички препратени
съобщения така, че отговорите да бъдат обработвани по същия начин както
първоначалния доклад.
Това означава, че например отговорите до maintonly
ще отидат при
nnn-maintonly@bugs.debian.org
вместо при
nnn@bugs.debian.org
, освен ако някой не промени това
ръчно.
Потвърждения
Обикновено системата за проследяване на проблеми връща потвърждения при подаване
на нов доклад или изпращане на допълнителна информация към
съществуващ доклад. Ако искате да предотвратите изпращането на потвържденията, добавете заглавка
или псевдо-заглавка X-Debbugs-No-Ack
в изпращаното съобщение. Ако
използвате тази заглавка при изпращане на нов доклад, ще се наложи да
проверите за номера на доклада в уеб-страницата на системата за следене на
грешките.
Тази заглавка няма да потисне потвържденията от контролния адрес
control@bugs.debian.org
, защото тези потвърждения може да съдържат
съобщения за грешки, на които да трябва да се реагира.
Борба с нежелана поща и липсващи съобщения
Системата за проследяван на проблеми използва обширна система от правила,
проектирани да спрат нежеланата поща. Въпреки усилията, понякога нормални съобщения са считани за нежелана поща. Ако подозирате, че ваше съобщение е погрешно
разпознато като нежелана поща, пишете до owner@bugs.debian.org
за
съдействие. Друга честа причина за липсващи съобщения е използването на адреси,
които съвпадат със списъка на procmail FROM_DAEMON, който включва адреси от
вида mail@foobar.com
. Ако подозирате, че вашият адрес е спрян
поради тази причина, проверете procmailrc(5) и изпратете съобщението наново, от адрес,
който не е сред адресите във FROM_DAEMON.
Съобщения за грешки в неизвестни пакети
Ако системата за следене на грешките не разпознава кой е отговорника на
съответния пакет, съобщението ще бъде препратено към
debian-bugs-dist
дори ако е изпратено до maintonly
.
Когато изпращате до maintonly@bugs.debian.org
или
nnn-maintonly@bugs.debian.org
трябва да сте сигурни, че
съобщението е адресирано до правилния пакет, като поставите точната
псевдо-заглавка Package
в началото на първоначалния доклад
или като използвате услугата
control@bugs.debian.org
за да прикачите доклада към правилния
пакет.
Използване на dpkg
за намиране на пакета и версията
Когато използвате reportbug
за да докладвате за грешка в някоя
команда, например grep
, следната команда автоматично ще избере
правилния пакет и ще ви даде възможност да опишете проблема:
reportbug --file $(which grep)
Може да откриете кой пакет е инсталирал програмата с командата dpkg
--search
. Версията на пакета може да разберете с
dpkg --list
или dpkg --status
.
Например:
$ 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
Други полезни команди и пакети
Инструментът querybts, наличен от същия пакет като reportbug, предлага удобен текстово ориентиран интерфейс към системата за проследяване на проблеми.
Потребителите на Emacs могат да се възползват от командата debian-bug,
налична в пакета debian-el
.
Когато бъде извикана с M-x debian-bug, тя предоставя възможност за
въвеждане на необходимата информация подобно на reportbug
.
Други страници за системата за следене на грешки:
- Начална страница на Системата за следене на грешки.
- Инструкции за докладване на грешки.
- Достъп до журналите на системата за следене на грешки.
- Информация за програмисти.
- Управление на доклади за грешки чрез e-mail.
- Кратка справочна информация за пощенските сървъри.
- Достъп до доклади за грешки по e-mail.
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.