-
Notifications
You must be signed in to change notification settings - Fork 42
/
Copy pathreport.html
184 lines (158 loc) · 11.8 KB
/
report.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>Доклад о проблеме в OpenBSD</title>
<link rev=made href="mailto:[email protected]">
<meta name="resource-type" content="document">
<meta name="description" content="OpenBSD problem report page">
<meta name="keywords" content="openbsd,problemreports">
<meta name="distribution" content="global">
<meta name="copyright" content="This document copyright 1998-2004 by OpenBSD.">
</head>
<body bgcolor="#ffffff" text="#000000" link="#23238e">
<a href="index.html">
<img alt="[OpenBSD]" height="30" width="141"
src="../images/smalltitle.gif" border="0"></a>
<p>
<h2><font color="#e00000">Как доложить о проблеме</font></h2>
<hr>
<h3><font color="#0000e0">Проблема в релизе OpenBSD</font></h3>
Перед тем как оповестить об ошибке/проблеме в релизе, проверьте следующее:
<ol>
<li><a href="../errata.html">Исправления и примечания
относительно этого релиза.</a>
<li>Имеется ли более <a href="../orders.html">новый релиз</a>.
<li><a href="../plus.html">Изменения сделанные между версиями OpenBSD.</a>
</ol>
<p>
Если вы, так и не нашли ничего схожего с вашей проблемой, ознакомьтесь с
утилитой <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=sendbug&sektion=1&format=html">sendbug(1)</a>
перед написанием доклада об ошибке.
<p>
Читайте далее о возможных <a href="#bugtypes">типах доклада</a>.
<h3><font color="#0000e0">Проблема в текущей версии</font></h3>
Если проблема в <i>текущей</i> (current) версии OpenBSD:
<ol>
<li>Протестируйте проблему по крайней мере дважды, с обновлёнными
исходными текстами.
<li>Не сообщайте об ошибках при компиляции дерева. В большинстве случаев
это ваши ошибки или возможно вы получили версию, над которой
производилась работа. Люди работающие над проектом выполняют
<u>make build</u> по крайней мере раз в день, и несколько раз
в день на различных платформах.
<li>Запомните, что <a href="anoncvs.html">AnonCVS сервера</a> обновляются
значительно позже рабочего дерева исходных текстов.
<li>Проверьте <a href="../plus.html">изменения сделанные между версиями
OpenBSD</a>, чтобы посмотреть была ли проблема указана.
<li>Особая осторожность нужна при создании снапшотов. Но иногда допускаются
ошибки, затем следуют наши извинения. При этом чтение/участие в списках
рассылки более предпочтительнее, чем написание доклада об ошибке.
</ol>
<h3><font color="#0000e0">Как сформировать доклад</font></h3>
<b>Всегда предоставляйте столько информации, сколько это возможно</b>.
Попробуйте точно определить проблему. Не давайте неясных постановок.
Поговорите с другими пользователями на IRC или на форумах, разузнайте
как можно больше об этой проблеме.
<p>
Пожалуйста, не начинайте самостоятельно устранять проблему, для которой
нужна существенная работа пока вы не будете в точности уверены из-за чего
она возникла. Особенно это касается релиза, так как мы не должны вносить
большие изменения в код. Если вы все-таки решили написать существенное
исправление, проверьте различные форумы и удостоверьтесь, что никто, кроме
вас, больше не работает над этой проблемой.
<p>
Следующие постановки должны содержатся в каждом докладе об ошибке:
<ol>
<li>Воспроизведите точную последовательность шагов, при которых возникает
ошибка от самого запуска системы. Если ошибка при запуске программы,
укажите все параметры переданные ей. Если ошибка возникает при
специфических обстоятельствах перечислите их. Если ошибка не
воспроизводима, мы найдём её другим путём.
<p>
<li>Если имеются сообщения об ошибках, покажите их. Может случится, что
программа с ошибкой будет работать у нас. Самый простой способ
это скопировать вывод сообщения об ошибке с терминала.
<p>В случае фатальных ошибок, этого будет не достаточно. В этом
случае посмотрите файлы регистрации, находящиеся в /var/log.
Некоторые приложения, например httpd, имеют свои собственные
файлы регистрации, найдите и просмотрите их (в случае с httpd,
это /var/www/logs).
<p>
<li>Вывод ядра OpenBSD. Используя команду dmesg вы можете получить
вывод системных сообщений ядра OpenBSD, но возможно он не содержит
полной информации, которая может содержаться в /var/run/dmesg.boot.
В этом случае, включите в доклад информацию из обоих источников.<br>
<b>Вывод сообщений ядра OpenBSD должен быть в каждом докладе.</b>
<p>
<li>Если ошибка в программном обеспечении третьего лица, укажите это.
Если вы говорите о CVS или FTP снапшоте, укажите это, а так же
его дату и время.
<p>
<li>Вывод traceback вашего ядра. Если при kernel panic вы попадаете в
приглашение <tt><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ddb&sektion=4&format=html">ddb</a>></tt>,
пожалуйста включите сообщение выданное при panic, а так же вывод
команд <tt>trace</tt> и <tt>ps</tt> в ваш доклад об ошибке.
Если по каким-то причинам, сообщение не видно, вы можете получить
его командой <tt>x/s *panicstr</tt>.<br>
<b>Это очень ценная для нас информация. Доклады о kernel panic
без этих элементов бесполезны</b>.<br> Вывод <tt>show registers</tt>
так же может быть полезен. Вы сможете затем перезагрузиться
используя <tt>boot dump</tt>, так чтобы сохранить образ ядра с
помощью <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=savecore&sektion=8&format=html">savecore(8)</a>
для дальнейшей отладки.
<p>
<li>Если проблема в системе X window на платформе использующей сервер
XFree86, включите в доклад весь файл <tt>/var/log/XFree86.0.log</tt>.
</ol>
<p>
Не бойтесь того, что ваш доклад будет слишком большим. Лучше сообщить обо
всем сразу, чем заставлять нас опрашивать вас. С другой стороны, если ваш
доклад просто огромен, было бы верно спросить, заинтересован ли кто
изучением вашей проблемы.
<p>
При написании доклада не используйте запутанную терминологию.
<a name="bugtypes"></a>
<h3><font color="#0000e0">Отправка доклада об ошибке</font></h3>
<p>
Сообщения об ошибках посылаются используя утилиту <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=sendbug&sektion=1&format=html">sendbug(1)</a>,
для того, чтобы ваше сообщение попало в систему отслеживания ошибок. Просмотр
<a href="../query-pr.html">сообщений об ошибках</a>.
Для работы утилиты sendbug, ваша система должна быть настроена для посылки
электронной почты. Сообщения об ошибках также могут быть посланы на адрес
<a href="mailto:[email protected]">[email protected]</a>.
<p>
Посылаемые сообщения не обязательно должны быть сообщениями об ошибках, вы
можете предложить новые возможности для системы или программы и если возможно
исходной текст для реализации этих возможностей.
<p>
Для отладки и устранения некоторых проблем, мы должны иметь аппаратные
средства, в которых и есть проблема. Пожалуйста помните, что ресурсы проекта
OpenBSD ограничены и <a href="../want.html">вы можете предоставить нам
некоторые аппаратные средства</a>.
<p>
Типы докладов об ошибках в порядке желательности:
<ol>
<li>Повторяющиеся проблемы с готовым решением.
<li>Повторяющиеся проблемы, которые не относятся к вашим
аппаратным/программным средствам.
<li>Повторяющиеся проблемы, которые относятся к программным средствам.
<li>Повторяющиеся проблемы, которые относятся к аппаратным средствам.
<li>Не повторяющиеся проблемы -- или проблемы которые вы не желаете
повторять.
</ol>
<hr>
<img align="right" alt="OpenBSDPower" height="46" width="201"
src="../images/openbsdpower.gif">
<a href="index.html">
<img height="24" width="24" src="../back.gif" border="0" alt="OpenBSD"></a>
<a href="mailto:[email protected]">[email protected]</a>
<br>
<small>
Originally [OpenBSD: report.html,v 1.26 ]<br>
$RuOBSD: report.html,v 1.12 2004/02/28 08:38:39 dfa Exp $<br>
$Translation: report.html,v 1.21 2013/09/28 19:38:14 rustybsd Exp $<br>
$OpenBSD: report.html,v 1.19 2013/09/29 17:20:04 ajacoutot Exp $
</small>
</body>
</html>