view DOCS/Chinese/bugreports.html @ 8740:cd67631ae382

trivial endianness fix
author colin
date Fri, 03 Jan 2003 14:51:49 +0000
parents 363959276ef2
children e7aad3a3bb7c
line wrap: on
line source

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<HTML>

<HEAD>
  <TITLE>bug报告 -- MPlayer -- Linux的电影播放器</TITLE>
  <LINK REL="stylesheet" TYPE="text/css" HREF="default.css">
  <META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=gb_2312-80">
</HEAD>

<BODY>


<H1><A NAME="B">附录B -- 如何报告bug</A></H1>

<P>好的bug报告对任何软件项目的发展都是十分有价值的贡献。但是就象写好的软件一样,好的问题报告也需要一些工作。请明白大多数开发者忙的要死并且会收到
多的变态的电子邮件。所以尽管你的反馈对改进<B>MPlayer</B>至关重要而且非常值得赞赏,希望你理解你必须提供我们需要的<B>所有</B>信息并且严格遵循这个
文件中的指导进行。</P>


<H2>如何修正bug</H2>

<P>如果你觉得你有足够的技巧欢迎你尝试自己修正bug。或者也许你已经这么干了?请阅读<A HREF="tech/patches.txt">这个简短的文件</A>了解怎样让你的代码
包括到<B>MPlayer</B>的代码中。如果你有问题可以从加入<A HREF="http://mplayerhq.hu/mailman/listinfo/mplayer-dev-eng">mplayer-dev-eng</A>
邮件列表的人那里获得帮助。</P>


<H2>如何报告bug</H2>

<P>首先,请先尝试<B>MPlayer</B>最新的CVS版本,因为你的bug在那里可能已经被修正了。发展过程进展的相当快,官方发行版的大部分问题在几天甚至几小时之内
就被报告了,因此请<B>仅仅使用CVS</B>来报告bug。CVS指令能在<A HREF="http://www.mplayerhq.hu/homepage/dload.html">这个页面</A>的底部或者
README中找到。如果这样做没有改进那么请查阅<A HREF="documentation.html#known_bugs">已知的bug列表</A>和文件的其他部分。如果你的问题我们没有提到或者
按照我们提供的步骤没有解决,那么请报告bug。</P>

<P>请不要私下向单独的开发者报告bug。这是一项社区工作所以可能有若干人都对它感兴趣。有时其它用户已经遇到过你的麻烦并且知道如何绕过这个问题
即使它是<B>MPlayer</B>代码中的bug。</P>

<P>请尽可能详细的描述你的问题。做一些小的侦探工作来确定问题发生的情况的范围。这个bug只在一定的情况中出现吗?或是具体针对特定文件或者文件类型吗?
它是针对于唯一的编码格式还是独立于编码格式的?你能用所有的输出驱动重现它吗?你提供的信息越多我们的修复你的问题的机会就越大。别忘了也要包括下面所要求的
有价值的信息,否则我们将无法正确分析你的问题。</P>

<P>有篇文采飞扬的关于如何在公共论坛上提问的极好的指导是Eric S. Raymond写的<A HREF="http://www.tuxedo.org/~esr/faqs/smart-questions.html">
How To Ask Questions The Smart Way</A>。你照着那些指示做是没问题的。但是请明白我们大家都在我们的自由时间自愿地回复邮件列表。我们十分忙碌并且
不能保证你的问题一定能得到解决甚至得到回复。</P>


<H3>向哪里报告错误?</H3>

<P>订阅mplayer-users邮件列表:<BR>
  &nbsp;&nbsp;&nbsp;&nbsp;<A HREF="http://mplayerhq.hu/mailman/listinfo/mplayer-users">http://mplayerhq.hu/mailman/listinfo/mplayer-users</A><BR>
  同时,把你的bug发送到:<BR>
  &nbsp;&nbsp;&nbsp;&nbsp;<A HREF="mailto:mplayer-users@mplayerhq.hu">mplayer-users@mplayerhq.hu</A></P>

<P>这个列表使用的语言是<B>英语</B>。请遵循标准的<A HREF="http://www.ietf.org/rfc/rfc1855.txt">Netiquette标准</A>并且<B>不要发送HTML邮件</B>
到任何我们的邮件列表。你将被忽略或者封掉。如果你不知道什么是HTML邮件,以及它为什么邪恶,阅读这个<A HREF="http://expita.com/nomime.html">不错的文件</A>。
它解释了所有细节和关掉HTML的指令。也请注意到我们不会个别地CC(抄送)给人因此最好通过订阅来保证你会收到答案。</P>


<H3>报告什么?</H3>

<H4>系统信息:</H4>

<UL>
  <LI>你的Linux发行版或者操作系统,比如:。
    <UL>
      <LI>Red Hat7.1</LI>
      <LI>Slackware 7.0 + devel packs from 7.1 ...</LI>
    </UL>
  </LI>
  <LI>内核版本:<BR>
      <CODE>uname -a</CODE></LI>
  <LI>libc版本:<BR>
      <CODE>ls -l /lib/libc[.-]*</CODE></LI>
  <LI>X版本:<BR>
      <CODE>X -version</CODE></LI>
  <LI>gcc和ld版本:<BR>
      <CODE>gcc -v<BR>
      ld -v </CODE></LI>
  <LI>binutils版本:<BR>
      <CODE>as --version</CODE></LI>
  <LI>如果你有全屏模式方面的问题:
    <UL>
      <LI>窗口管理器类型和版本</LI>
    </UL>
  </LI>
  <LI>如果是buggy的GUI:
    <UL>
      <LI>GTK版本</LI>
      <LI>GLIB版本</LI>
      <LI>libpng版本</LI>
      <LI>bug发生时GUI的状态</LI>
    </UL>
  </LI>
</UL>


<H4>硬件 &amp; 驱动:</H4>

<UL>
  <LI>CPU信息(仅用于Linux):<BR>
    <CODE>cat /proc/cpuinfo</CODE></LI>
  <LI>显卡制造厂和型号,例如:。
    <UL>
      <LI>ASUS V3800U chip: nVidia TNT2 Ultra pro 32MB SDRAM</LI>
      <LI>Matrox G400 DH 32MB SGRAM</LI>
    </UL>
  </LI>
  <LI>显卡驱动类型 &amp; 版本,e.g:。
    <UL>
      <LI>X built-in driver</LI>
      <LI>nVidia 0.9.623</LI>
      <LI>Utah-GLX CVS 2001-02-17</LI>
      <LI>DRI from X 4.0.3</LI>
    </UL>
  </LI>
  <LI>声卡类型 &amp; 驱动,例如:。
    <UL>
      <LI>Creative SBLive! Gold with OSS driver from oss.creative.com</LI>
      <LI>Creative SB16 with kernel OSS drivers</LI>
      <LI>GUS PnP with ALSA OSS emulation</LI>
    </UL>
  </LI>
  <LI>如果不放心的话对linux系统再附上<CODE>lspci -vv</CODE>的输出。</LI>
</UL>


<H4>对于编译问题/错误</H4>

请包括这些文件:

<UL>
  <LI>configure.log</LI>
  <LI>config.h</LI>
  <LI>config.mak</LI>
  <LI>libvo/config.mak</LI>
</UL>


<H4>对于回放问题</H4>

<P>请包括<B>MPlayer</B>的冗长水平为1的输出,但是记住当你把它粘贴到你的邮件中时<B>不要删减输出内容</B>。开发者们需要所有的信息来正确的分析问题。
你可以像这样把输出导入到一个文件中:</P>

<P><CODE>&nbsp;&nbsp;&nbsp;&nbsp;mplayer -v [options] [filename] &amp;&gt; mplayer.log</CODE></P>

<P>如果你的问题是具体对于一个或更多的文件的,那么请上传捣乱的文件:</P>

<P>&nbsp;&nbsp;&nbsp;&nbsp;<A HREF="ftp://mplayerhq.hu/MPlayer/incoming/">ftp://mplayerhq.hu/MPlayer/incoming/</A></P>

<P>再上传一个小的同样文件名的文本文件加上.txt的扩展名。在其中描述对于这个特别的文件你遇到的问题加上你的电子邮件地址还有<B>MPlayer</B>冗长水平为1的输出。
通常文件的前1-5MB足以重现问题,但为了以防万一我们要求你运行:</P>

<P><CODE>&nbsp;&nbsp;&nbsp;&nbsp;dd if=yourfile of=smallfile bs=1024k count=5</CODE></P>

<P>它将截取<STRONG>'your-file'</STRONG>的头5兆并把他们写到<STRONG>'small-file'</STRONG>里。然后,测试一下这个小文件,如果bug仍然存在那么你的样本
对我们来说是足够了。请<STRONG>永远不要</STRONG>通过邮件的发送这样文件!把它上传,然后只发送FTP-server上的文件的路径与文件名。如果文件在网上可以获得,
那么发送<STRONG>准确的</STRONG>URL就足够了。</P>


<H4>对于崩溃</H4>

<P>如果你的崩溃有一个core dump那么继续阅读下一段,否则跳过它。</P>


<H4>如何从一个core dump中提取出有意义的信息</H4>

<P>请建立下面的命令文件:</P>

<P><CODE>disass $eip-32 $eip+32<BR>
  printf "eax=%08lX\n",$eax<BR>
  printf "ebx=%08lX\n",$ebx<BR>
  printf "ecx=%08lX\n",$ecx<BR>
  printf "edx=%08lX\n",$edx<BR>
  printf "esp=%08lX\n",$esp<BR>
  printf "ebp=%08lX\n",$ebp<BR>
  printf "edi=%08lX\n",$edi<BR>
  printf "esi=%08lX\n",$esi</CODE></P>

<P>然后直接在你的命令行下执行下列命令:</P>

<P>&nbsp;&nbsp;&nbsp;&nbsp;<CODE>gdb mplayer --core=core -batch --command=command_file &gt; mplayer.bug</CODE></P>


<H4>如何保存一个可再现的崩溃的信息</H4>

开启调试代码重新编译<B>MPlayer</B>:

<P><CODE>&nbsp;&nbsp;&nbsp;&nbsp;./configure --enable-debug=3<BR>
  &nbsp;&nbsp;&nbsp;&nbsp;make</CODE></P>

然后用gdb运行<B>MPlayer</B>:

<P><CODE>&nbsp;&nbsp;&nbsp;&nbsp;gdb mplayer</CODE></P>

现在你在gdb内。输入:

<P><CODE>&nbsp;&nbsp;&nbsp;&nbsp;run -v [options-to-mplayer] filename</code></P>

然后再现你的崩溃。一旦你成功了,gdb将回到命令行,你需要输入

<P><CODE>&nbsp;&nbsp;&nbsp;&nbsp;bt<BR>
  &nbsp;&nbsp;&nbsp;&nbsp;disass $eip-32 $eip+32</CODE></P>

然后把完整的输出发给我们。


<H3>一般的注意事项</H3>

<P>如果有什么东西特别大(比如log)最好把它压缩(最好是gzip或者bzip)之后上载到FTP server上并且在你的bug报告中只要包含路径和文件名。</P>


<H2>我知道我在干什么...</H2>

<P>如果你按照上述步骤建立了一个正确的bug报告而且你充满信心它是<B>MPlayer</B>中的bug,而不是因为编译错误或者文件损坏的问题,你已经阅读了文档并且
找不到解决方案,此外你的声卡驱动正常,那么你可能想要订阅mplayer-advusers列表并把你的bug报告发到那里以便得到更快更好的答案。<BR><BR>
  请听从我们的劝告,如果你在那里问新手级的问题或者问用户手册中已经回答过的问题,你将被忽略或者被骂而不会得到答案。<BR>
  因此,不要骂我们并且仅仅当你确实知道你在干什么并且觉得你已经是高级<B>MPlayer</B>用户或者是开发者再订阅 -advusers。如果你符合这些标准找出如何
订阅应该不难...</P>

</BODY>
</HTML>