Bugzilla
Материал из Mandriva Russian Community Wiki.
Эта страница содержит информацию о том, как правильно регистрировать сообщения об ошибках в дистрибутиве Mandriva Linux. Прочтите её и следуйте ей при регистрации ошибок: это поможет повысить эффективность работы при разборе сообщений об ошибках.
Содержание |
[править] Система отслеживания ошибок
Централизованное место регистрации сообщений об ошибках Mandriva — qa.mandriva.com. Оно использует популярную систему отслеживания ошибок, основанную на открытом программном обеспечении — Bugzilla.
[править] Прежде, чем представить новую ошибку
Во-первых, вам нужно зарегистрировать учётную запись на стартовой странице Bugzilla. Bugzilla не использует учётные записи my.mandriva, которые используются в некоторых службах Mandriva.
Во-вторых, попытайтесь определить, сообщал ли кто-нибудь о возникшей ошибке до вас. Для этого потребуется воспользоваться поиском.
[править] Поиск в Bugzilla
Поиск в Bugzilla позволит убедиться в отсутствии подобной ошибки, а также что ошибка по-прежнему не исправлена.
По умолчанию, Bugzilla не производит поиск в списке RESOLVED (РЕШЁННЫХ) ошибок. Чтобы сделать это принудительно, достаточно в начале поискового запроса указать заглавными буквами ALL (ВСЕ), например: ALL rpmdrake. При этом возможно вы обнаружите, что ошибка уже была решена и исправлена в более поздней версии программы.
Если вы не знакомы с Bugzilla, по крайней мере составьте список всех постоянно возникающих ошибок в программе (с использованием «компонентного» списка), и изучите полученный итоговый список ошибок.
Также взгляните на страницу списка известных проблем используемого вами релиза Mandriva Linux и проверьте имеются ли там список решений.
Если вы нашли проблему аналогичную вашей, добавьте себя в поле почтового сообщения CC, а также в комментариях описания проблемы. Это позволит избежать дублирующих сообщениях об ошибках; одно исчерпывающее сообщение об ошибке даёт наилучшее представление о возникшей проблеме, нежели несколько разных.
[править] Используйте последнюю версию пакета
Убедитесь в том, что вы используете последнюю версию пакета. Если вы используете Cooker-версию, то вы должны знать, как поддерживать свою систему в актуальном состоянии. Если же вы используете стабильный выпуск, следуйте инструкции установке обновлений, чтобы быть уверенным в актуальности вашей системы, затем убедитесь, что проблема по-прежнему не разрешена.
[править] Необходимо ли это?
Убедитесь в том, что решение возникшей ошибки должно быть найдено через систему решения ошибок Mandriva. Существуют два типа вопросов, которые могут рассматриваться здесь. Во-первых, когда компоненты дистрибутива Mandriva Linux не работают должным образом, в этом случае команда разработчиков Mandriva решит проблему наиболее эффективно. Во-вторых, это вопросы связанные с дополнительными запросами к приложениям, разработанными командой разработчиков Mandriva или связанные со сборкой пакетов приложений.
В случае, если возникшая проблема наиболее эффективно может быть устранена разработчиком приложения, не нужно отправлять её в систему решения ошибок Mandriva. Также вопросы, связанные с расширением программ сторонних производителей должны быть отправлены разработчикам данного приложения.
[править] Это поддерживается?
Все сообщения об ошибках должны быть относительно поддерживаемых выпусков. В списке карты сроков поддержки приведены сроки поддержки всех выпусков. Если выпуск отсутствует в списке, значит он более не поддерживается. Сообщения об ошибках относительно более неподдерживаемых продуктов вряд ли будут решены.
[править] Отправка нового отчёта об ошибке
Если вы закончили поиск и убедились в том, что ваше сообщение об ошибке первое, то необходимо предоставить следующую информацию:
[править] Правильный дистрибутив
Выбор соответствующего релиза дистрибутива — это первый шаг к внесению отчёта об ошибке. Дистрибутив должен быть выбран такой, на котором присутствуют проблемы с программным обеспечением.
Имейте в виду, что выпуски snapshot, alpha, beta и RC считаются выпуском Cooker-версии. Ошибки в этих выпусках должны быть размещены как Cooker-дистрибутив. Помимо этого, в отчёте укажите, какой именно релиз вы используете.
[править] Правильные продукт, компонент, версия
Также постарайтесь определить и указать правильный продукт, компонент и версию:
- определите какой RPM-пакет «владеет» программой с ошибкой;
- попробуйте выяснить какой именно RPM-пакет программы «владеет» файлом. Для этого используйте команду: rpm -qf проблемный-файл;
- расширенную информацию о RPM-пакете можно получить используя следующую команду: rpm -qi имя-пакета.
Если вы не смогли определить пакет для указания его в отчёте об ошибке, укажите в описании ошибки предполагаемое название пакета, при этом сообщив, что вы не уверены в правильности его названия. В этом случае фильтрационная команда поможет вам в правильном определении названия пакета, содержащего описываемую ошибку.
[править] Подробности
Подробности имеют большее значение. При сомнениях много информации не бывает.
- Найдите версию RPM-пакета программы: rpm -q имя-пакета
- Опишите ваше аппаратное обеспечение, если ошибка связана с неправильной работой аппаратной части:
- lspcidrake -v предоставит полезную информацию о PCI, PCI-E и AGP аппаратном обеспечении.
- lsusb предоставит полезную информацию об USB-устройствах.
- lsmod предоставит полный список модулей ядра, загруженных в системе.
- Обязательно укажите архитектуру используемого дистрибутива: i586 или x86-64.
- Опишите точно, что вы делали, чтобы появилась ошибка.
- Распишите по шагам порядок действий и их результаты, которые повлекли неисправность.
- Вложите изменённые настройки, которые вы делали.
Когда отчёт об ошибке подаётся без достаточной информации, фильтрационная команда установит его статус в NEEDINFO (требуется информация) и разместит комментарий в отчёте об ошибке с пояснением, что необходима дополнительная информация. В этом случае для успешного разрешения ошибки необходимо предоставить требуемую информацию.
[править] Вложения к отчёту об ошибках
К сожалению, веб-интерфейс системы отслеживания ошибок имеет ограниченные размеры форм. В связи с чем, вам возможно придётся разделить отчёт об ошибке на несколько частей либо прикрепить вложения к отчёту об ошибке.
Если у вас имеется какой-либо файл с данными, относящийся к возникшей ошибке (например, mp3-файл, который не воспроизводится в xmms), вы можете прикрепить его к отчёту об ошибке. Это предпочтительно делать с файлами настроек, когда их длина достаточно велика, чтобы усложнить их набор руками.
[править] После того, как вы отправите отчёт об ошибке
После того, как сообщение отправлено, оно будет обрабатываться в соответствии с политикой обработки ошибок. Это означает, что член сортировочной команды проверит достаточность предоставленной информации. В случае её нехватки, от вас попросят предоставить дополнительные данные, в ином случае исправление ошибки будет возложено на ответственного за её решение.
[править] Решите свою проблему самостоятельно
Всеми возможными средствами попробуйте найти решение и исправьте ошибку! Особенностью открытого программного обеспечения является то, что вам нет необходимости ждать, когда вашу проблему решат, вы сами можете её решить (либо нанять кого-нибудь, кто решат её за вас).
Завершённые исправления к исходникам программ приветствуются, но при этом не нужно сомневаться при добавлении незаконченных предположений или частичных исправлений по вашей проблеме. Они позволят более точно определить причину возникшей проблемы.
В случае успешного устранения возникшей ошибки, добавьте свои исправления к отчёту об ошибке (либо добавьте решение последним комментарием).
