Как доложить о проблеме

Проблема в релизе OpenBSD

1. Исправления и примечания относительно этого релиза.
2. Имеется ли более новый релиз.
3. Изменения сделанные между версиями OpenBSD.

Если вы, так и не нашли ничего схожего с вашей проблемой, ознакомьтесь с утилитой sendbug(1) перед написанием доклада об ошибке.

Читайте далее о возможных типах доклада.

Проблема в текущей версии

1. Протестируйте проблему по крайней мере дважды, с обновлёнными исходными текстами.
2. Не сообщайте об ошибках при компиляции дерева. В большинстве случаев это ваши ошибки или возможно вы получили версию, над которой производилась работа. Люди работающие над проектом выполняют make build по крайней мере раз в день, и несколько раз в день на различных платформах.
3. Запомните, что AnonCVS сервера обновляются значительно позже рабочего дерева исходных текстов.
4. Проверьте изменения сделанные между версиями OpenBSD, чтобы посмотреть была ли проблема указана.
5. Особая осторожность нужна при создании снапшотов. Но иногда допускаются ошибки, затем следуют наши извинения. При этом чтение/участие в списках рассылки более предпочтительнее, чем написание доклада об ошибке.

Как сформировать доклад

Пожалуйста, не начинайте самостоятельно устранять проблему, для которой нужна существенная работа пока вы не будете в точности уверены из-за чего она возникла. Особенно это касается релиза, так как мы не должны вносить большие изменения в код. Если вы все-таки решили написать существенное исправление, проверьте различные форумы и удостоверьтесь, что никто, кроме вас, больше не работает над этой проблемой.

Следующие постановки должны содержатся в каждом докладе об ошибке:

1. Воспроизведите точную последовательность шагов, при которых возникает ошибка от самого запуска системы. Если ошибка при запуске программы, укажите все параметры переданные ей. Если ошибка возникает при специфических обстоятельствах перечислите их. Если ошибка не воспроизводима, мы найдём её другим путём.

2. Если имеются сообщения об ошибках, покажите их. Может случится, что программа с ошибкой будет работать у нас. Самый простой способ это скопировать вывод сообщения об ошибке с терминала.

   В случае фатальных ошибок, этого будет не достаточно. В этом случае посмотрите файлы регистрации, находящиеся в /var/log. Некоторые приложения, например httpd, имеют свои собственные файлы регистрации, найдите и просмотрите их (в случае с httpd, это /var/www/logs).

3. Вывод ядра OpenBSD. Используя команду dmesg вы можете получить вывод системных сообщений ядра OpenBSD, но возможно он не содержит полной информации, которая может содержаться в /var/run/dmesg.boot. В этом случае, включите в доклад информацию из обоих источников.
   Вывод сообщений ядра OpenBSD должен быть в каждом докладе.

4. Если ошибка в программном обеспечении третьего лица, укажите это. Если вы говорите о CVS или FTP снапшоте, укажите это, а так же его дату и время.

5. Вывод traceback вашего ядра. Если при kernel panic вы попадаете в приглашение ddb>, пожалуйста включите сообщение выданное при panic, а так же вывод команд trace и ps в ваш доклад об ошибке. Если по каким-то причинам, сообщение не видно, вы можете получить его командой x/s *panicstr.
   Это очень ценная для нас информация. Доклады о kernel panic без этих элементов бесполезны.
   Вывод show registers так же может быть полезен. Вы сможете затем перезагрузиться используя boot dump, так чтобы сохранить образ ядра с помощью savecore(8) для дальнейшей отладки.

6. Если проблема в системе X window на платформе использующей сервер XFree86, включите в доклад весь файл /var/log/XFree86.0.log.

Не бойтесь того, что ваш доклад будет слишком большим. Лучше сообщить обо всем сразу, чем заставлять нас опрашивать вас. С другой стороны, если ваш доклад просто огромен, было бы верно спросить, заинтересован ли кто изучением вашей проблемы.

При написании доклада не используйте запутанную терминологию.

Отправка доклада об ошибке

Сообщения об ошибках посылаются используя утилиту sendbug(1), для того, чтобы ваше сообщение попало в систему отслеживания ошибок. Просмотр сообщений об ошибках. Для работы утилиты sendbug, ваша система должна быть настроена для посылки электронной почты. Сообщения об ошибках также могут быть посланы на адрес bugs@openbsd.org.

Посылаемые сообщения не обязательно должны быть сообщениями об ошибках, вы можете предложить новые возможности для системы или программы и если возможно исходной текст для реализации этих возможностей.

Для отладки и устранения некоторых проблем, мы должны иметь аппаратные средства, в которых и есть проблема. Пожалуйста помните, что ресурсы проекта OpenBSD ограничены и вы можете предоставить нам некоторые аппаратные средства.

Типы докладов об ошибках в порядке желательности:

1. Повторяющиеся проблемы с готовым решением.
2. Повторяющиеся проблемы, которые не относятся к вашим аппаратным/программным средствам.
3. Повторяющиеся проблемы, которые относятся к программным средствам.
4. Повторяющиеся проблемы, которые относятся к аппаратным средствам.
5. Не повторяющиеся проблемы -- или проблемы которые вы не желаете повторять.