sync with r19587

patch by Vladimir Voroshilov, voroshil {[at]} gmail {[dot]} com


git-svn-id: svn://svn.mplayerhq.hu/mplayer/trunk@19631 b3059339-0415-0410-9bf9-f77b7e298cf2
This commit is contained in:
diego 2006-09-02 04:15:16 +00:00
parent 1941ea1992
commit 9fb4488c8d
1 changed files with 85 additions and 3 deletions

View File

@ -1,5 +1,5 @@
<?xml version="1.0" encoding="koi8-r"?>
<!-- synced with 1.10 -->
<!-- synced with r19587 -->
<appendix id="bugreports">
<title>Как сообщать об ошибках</title>
<para>
@ -12,6 +12,19 @@
<emphasis role="bold">Всю</emphasis> требуемую нами информацию, поэтому точно
следуйте инструкциям в этом документе.
</para>
<sect1 id="bugreports_security">
<title>Отчеты об ошибках безопасности</title>
<para>
В случае, если вы нашли уязвимость и хотите позволить нам исправить ее до того, как она будет
обнародована, мы будем рады получить ваше уведомление по адресу
<ulink url="mailto:&#115;&#101;&#99;&#117;&#114;&#105;&#116;&#121;&#64;&#109;&#112;&#108;&#97;&#121;&#101;&#114;&#104;&#113;&#46;&#104;&#117;">&#115;&#101;&#99;&#117;&#114;&#105;&#116;&#121;&#64;&#109;&#112;&#108;&#97;&#121;&#101;&#114;&#104;&#113;&#46;&#104;&#117;</ulink>.
Пожалуйста добавьте [SECURITY] или [ADVISORY] к теме письма.
Убедитесь, что ваш отчет содержит полный и подробный анализ ошибки.
Желательно также прислать и исправление уязвимости.
Пожалуйста, не откладывайте отчет для написания подтверждающего ошибку эксплойта.
Вы можете отослать его позже другим письмом.
</para>
</sect1>
<sect1 id="bugreports_fix">
<title>Как исправить ошибку</title>
<para>
@ -24,15 +37,84 @@
помогут Вас, если у Вас есть вопросы.
</para>
</sect1>
<sect1 id="bugreports_regression_test">
<title>Как провести проверку на деградацию, используя Subversion</title>
<para>
Иногда возникает проблема 'раньше это работало, а теперь - нет'. Здесь представлена
пошаговая процедура определения момента возникновения ошибки.
Не она <emphasis role="bold">не для</emphasis> рядовых пользователей.
</para>
<para>
Во-первых, вам нужно получить исходный код MPlayer из Subversion.
Инструкции могут быть найдены в нижней части
<ulink url="http://www.mplayerhq.hu/dload.html">этой страницы</ulink>.
</para>
<para>
После этого в каталоге mplayer/ вы будете иметь образ дерева Subversion
Теперь обновите этот образ на желаемую дату:
<screen>
cd mplayer/
svn update -r {"2004-08-23"}
</screen>
Формат даты: YYYY-MM-DD HH:MM:SS.
Использование этого формата, гарантирует, что вы сможете извлечь патчи по дате их
внесения, которые указаны в
<ulink url="http://mplayerhq.hu/pipermail/mplayer-cvslog/">архиве MPlayer-cvslog</ulink>.
</para>
<para>
Далее выполняйте как при обычном обновлении:
<screen>
./configure
make
</screen>
</para>
<para>
Для непрограммистов, читающих эту страницу, сообщим, то самый быстрый способ найти место
возникновения ошибки - использование бинарного поиска, т.е. поиск даты,
деля интервал поиска пололам раз за разом.
Например, если проблема возникла в 2003 году, начните с середины года и
выясните присутствует ли проблема. Если да, то переходите к проверке
начала Апреля, иначе - к началу Октября. Повторяйте этот процесс, уменьшая интервал
поиска вдвое, пока не выясните искомую дату.
</para>
<para>
Если у вас имеется достаточно свободного места на жестком диске (полная
компиляция требует около 100Мб, или 300-350 если включена отладочная
информация), скопируйте последнюю работающую версию перед обновлением,
это сэкономит время при необходимости вернуться назад.
(Как правило необходимо выполнять 'make distclean' до перекомпиляции
более ранней версии, поэтому при отсутствии сохраненной копии
вам придется перекомпилировать весь проект.)
</para>
<para>
Как только вы нашди дату, продолжайте поиск, используя архив mplayer-cvslog
(отсортированный по дате) до получения более точного времени, включая
час, минуту, секунду:
<screen>
svn update -r {"2004-08-23 15:17:25"}
</screen>
Это позволит легко выделить патч, явившийся источником проблемы.
</para>
<para>
Если вы нашли нужный патч, то вы практически победили; сообщите о нем в
<ulink url="http://bugzilla.mplayerhq.hu/">MPlayer Bugzilla</ulink> или
подпишитесь на
<ulink url="http://mplayerhq.hu/mailman/listinfo/mplayer-users">MPlayer-users</ulink>
и отправте сообщение туда.
Есть шанс, что автор исправит ошибку.
Вы также можете долго и пристально вглядываться в патч, пока сами не увидите ошибку :).
</para>
</sect1>
<sect1 id="bugreports_report">
<title>Как сообщить об ошибке</title>
<para>
Прежде всего, пожалуйста, попробуйте использовать новейшую CVS версию
Прежде всего, пожалуйста, попробуйте использовать новейшую Subversion версию
<application>MPlayer</application>'а, поскольку Ваша ошибка уже может быть исправлена. Разработка
продвигается очень быстро, большинство проблем в официальных релизах сообщается
в течение дней, и даже часов, после релиза, поэтому, пожалуйста, для сообщений
об ошибках используйте <emphasis role="bold">только CVS</emphasis>. Это
включает и бинарные пакеты <application>MPlayer</application>'а. Вы найдёте инструкции по CVS внизу
включает и бинарные пакеты <application>MPlayer</application>'а. Вы найдёте
инструкции по Subversion внизу
<ulink url="http://www.mplayerhq.hu/dload.html">этой страницы</ulink>
или в README. Если это не помогло, пожалуйста, обратитесь к списку
<link linkend="bugs">известных ошибок</link> и остальной документации. Если