docs/welcome/zh_CN/bugreports.html

   1 <?xml version="1.0" encoding="UTF-8"?>
   2 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
   3 <html xmlns="http://www.w3.org/1999/xhtml" lang="zh-CN" xml:lang="zh-CN">
   4 <head>
   5 <!--
   6  *
   7  * Copyright 2008-2012, Haiku. All rights reserved.
   8  * Distributed under the terms of the MIT License.
   9  *
  10  * Authors:
  11  *              Niels Reedijk, Matt Madia and Ingo Weinhold who wrote
  12  *              http://dev.haiku-os.org/wiki/ and http://dev.haiku-os.org/wiki/ReportingBugs
  13  *              Humdinger <humdingerb@gmail.com>
  14  * Translators:
  15  *              Pengphei Han
  16  *              dgy18787
  17  *
  18 -->
  19         <meta http-equiv="content-type" content="text/html; charset=utf-8" />
  20         <meta name="robots" content="all" />
  21         <title>报告错误</title>
  22         <meta name="viewport" content="width=device-width, initial-scale=1.0" />
  23         <link rel="stylesheet" type="text/css" href="../Haiku-doc.css" />
  24 </head>
  25 <body>
  26
  27 <div id="banner">
  28 <div><span>用户指南</span></div>
  29 </div>
  30
  31 <div class="nav">
  32 <div class="inner">
  33 <ul class="lang-menu">
  34 <li class="now"><img src="../images/flags/zh_CN.png" alt="" />  中文 ［中文］</li>
  35 <li><a href="../ca/bugreports.html"><img src="../images/flags/ca.png" alt="" />Català</a></li>
  36 <li><a href="../de/bugreports.html"><img src="../images/flags/de.png" alt="" />Deutsch</a></li>
  37 <li><a href="../en/bugreports.html"><img src="../images/flags/gb.png" alt="" />English</a></li>
  38 <li><a href="../es/bugreports.html"><img src="../images/flags/es.png" alt="" />Español</a></li>
  39 <li><a href="../fr/bugreports.html"><img src="../images/flags/fr.png" alt="" />Français</a></li>
  40 <li><a href="../it/bugreports.html"><img src="../images/flags/it.png" alt="" />Italiano</a></li>
  41 <li><a href="../hu/bugreports.html"><img src="../images/flags/hu.png" alt="" />Magyar</a></li>
  42 <li><a href="../pl/bugreports.html"><img src="../images/flags/pl.png" alt="" />Polski</a></li>
  43 <li><a href="../pt_PT/bugreports.html"><img src="../images/flags/pt_PT.png" alt="" />Português</a></li>
  44 <li><a href="../pt_BR/bugreports.html"><img src="../images/flags/pt_BR.png" alt="" />Português (Brazil)</a></li>
  45 <li><a href="../ro/bugreports.html"><img src="../images/flags/ro.png" alt="" />Română</a></li>
  46 <li><a href="../sk/bugreports.html"><img src="../images/flags/sk.png" alt="" />Slovenčina</a></li>
  47 <li><a href="../fi/bugreports.html"><img src="../images/flags/fi.png" alt="" />Suomi</a></li>
  48 <li><a href="../sv_SE/bugreports.html"><img src="../images/flags/sv_SE.png" alt="" />Svenska</a></li>
  49 <li><a href="../ru/bugreports.html"><img src="../images/flags/ru.png" alt="" />Русский</a></li>
  50 <li><a href="../uk/bugreports.html"><img src="../images/flags/uk.png" alt="" />Українська</a></li>
  51 <li><a href="../jp/bugreports.html"><img src="../images/flags/jp.png" alt="" />日本語</a></li>
  52 </ul>
  53 <span>
  54     <a href="../welcome_zh_CN.html" class="uplink">Welcome</a>
  55 </span></div>
  56 </div>
  57
  58 <div id="content">
  59 <div>
  60 <div class="box-info">本节的翻译还未完成。在未完成之前，所有的未完成部分都将使用英语原文。</div>
  61
  62 <table class="index" id="index" summary="index">
  63 <tr class="heading"><td>索引</td></tr>
  64 <tr class="index"><td><a href="#account">获取Trac账户</a><br />
  65                 <a href="#report">创建错误报告</a><br />
  66                 <a href="#app">软件错误</a><br />
  67                   <a href="#server">服务错误</a><br />
  68                   <a href="#kernel">内核错误</a><br />
  69                   <a href="#kdl">内核调试- KDL</a><br />
  70                   <a href="#syslog">系统日志</a><br />
  71                   <a href="#onscreen">屏幕调试</a><br />
  72                   <a href="#hardware">硬件错误</a><br />
  73                   <a href="#next">下一步？</a></td></tr>
  74 </table>
  75
  76 <h1>报告错误</h1>
  77
  78 <p>由于我们的开发人员不可能测试每种硬件组合和每种不同的系统交互方式，所以我们依赖于用户，通过用户来给予我们Haiku的运行情况。由于Haiku还很年轻，您在使用时很有可能会遇到错误。我们非常感谢您能够分出时间来提交这些错误报告。我们可以共同一步一步的提高Haiku的性能。</p>
  79 <p>为了确保我们的错误跟踪系统的有效性，遵守共同的<a href="http://dev.haiku-os.org/wiki/BugTrackerEtiquette">错误报告规范</a>是很有必要的。</p>
  80
  81 <h2><a href="#"><img src="../images/up.png" style="border:none;float:right" alt="index" /></a>
  82 <a id="account" name="accout">获取Trac账户</a></h2>
  83 <p>为了提交任务单，您需要在<a href="http://dev.haiku-os.org/register" title="Register at Haiku's Bugtracker">Haiku 的错误跟踪系统</a>中注册一个账户。
  84 <br />
  85 新建账户时，您需要<b>提供自己的电子邮箱</b> ，否则您将不具备基本的任务单修改权限。完成之后，您必须要保证<b>检查您的垃圾邮箱</b>，因为所有重要的验证邮件可能都会被发送到那里。</p>
  86
  87 <h2><a href="#"><img src="../images/up.png" style="border:none;float:right" alt="index" /></a>
  88 <a id="report" name="report">创建错误报告</a></h2>
  89 <p>在报告一个错误之前，请您<a href="http://dev.haiku-os.org/query?status=new&amp;status=assigned&amp;status=reopened&amp;status=closed&amp;summary=%7Etext+you+want+to+search+for&amp;order=priority">确保</a>该错误报告之前不存在。你可以使用<a href="http://dev.haiku-os.org/search?q=&amp;noquickjump=1&amp;ticket=on">查找</a>功能来查找其是否存在。
  90 <br />
  91 在确定它是一个独特的错误之后，您需要尽可能的找出有关的详细信息：</p>
  92 <ul>
  93         <li><p>尝试在当前版本的Haiku系统中重现您的问题。  有许多用于测试的预编译镜像都是<a href="http://haiku-files.org/">可用的</a>。</p></li>
  94         <li><p>包括基本的信息，例如以何种方式测试 Haiku（利用真实的硬件，VMware，还是 QEMU）。</p></li>
  95         <li><p>注意您所运行的系统版本。您可以在桌面栏菜单的 <span class="menu">关于 Haiku...</span> 找到该信息。<br /> 同时您还需要注意您所测试的 Haiku 的构建类型（gcc2，gcc4，gcc2hybird，gcc4hybird）。 可下载的镜像都会给出相应的命名，对于自主构建的镜像，您需要了解自己的构建方法。</p></li>
  96         <li><p>描述您所遇到的问题。尽量把问题讲得精确和明白：详细的描述系统的行为反馈，和您期望的反馈。</p></li>
  97         <li><p>描述出现该错误所需要的操作步骤。这将会有助于开发者重现该错误，并对其进行修复和完善。</p></li>
  98         <li><p>附带你所掌握的尽可能多的信息。如果是一个GUI错误，或者其中的程序错误，尽量使用 <span class="key">PRINT</span> 键来截取当时的屏幕图像。</p></li>
  99 </ul>
 100
 101 <h2><a href="#"><img src="../images/up.png" style="border:none;float:right" alt="index" /></a>
 102 <a id="app" name="app">程序错误</a></h2>
 103 <p>如果程序发生崩溃，您需要从弹出的警告窗口中启动调试程序。它将会打开一个运行gdb（GNUdebugger）的终端窗口。输入 <span class="cli">bt</span>，您将会创建一个有关调试信息的“回溯”，然后您需要把它完整的复制出来（包括您输入 <span class="cli">bt</span> 命令之前终端中显示的内容），附加到错误报告中。</p>
 104
 105 <h2><a href="#"><img src="../images/up.png" style="border:none;float:right" alt="index" /></a>
 106 <a id="server" name="server">服务错误</a></h2>
 107 <p>当 app server，registrar server 或者 input server 等重要组件崩溃时，您将无法看到通常的崩溃警告。相反的，整个屏幕将会呈现白色，并且启动一个 gdb 会话，相关的输出信息直接在屏幕中进行显示。您可能还可以继续移动鼠标，这将会覆盖掉屏幕中的白色区域和 gdb 输出信息。仍在运行的程序 (例如，进程控制器或者桌面栏的时钟) 可能也会覆盖屏幕中的调试信息。
 108 <br />
 109 除却所有显示的丑陋和操作的不便，它与软件出错基本一样。 最重要的是获取一个有关错误的回溯（使用 <span class="cli">bt</span> 命令）。您可能还需要使用数码相机记录下相关的屏幕显示，因为这种情况下，您无法拷贝相关的文本，<br />
 110 根据不同的崩溃问题，您可以尝试通过 <span class="cli">save-report</span> 指令在桌面保存崩溃报告，然后按下电源键尝试重启。</p>
 111
 112 <h2><a href="#"><img src="../images/up.png" style="border:none;float:right" alt="index" /></a>
 113 <a id="kernel" name="kernel">内核错误</a></h2>
 114 <p>内核错误通常都是危害效果最大的错误，同时也是最难调试的错误。下面几种情形，通常都可能是内核或者驱动问题：</p>
 115 <ul>
 116 <li><p>系统自动进入了内核调试状态（KDL），屏幕上方显示为白色，并且打印出几行文本。文本第二行显示为“<i>Welcome to Kernel Debugging Land...</i>”，而第一行则声明了进入内核调试状态的实时原因。</p></li>
 117 <li><p>系统自动重新启动。</p></li>
 118 <li><p>系统完全冻结。您无法移动鼠标，并且屏幕中无任何程序显示。在此情况下，重要的是测试能否使用快捷键 <span class="key">ALT</span> <span class="key">SysReq</span> <span class="key">D</span> 进入内核调试状态（在多数键盘上，<span class="key">SysReq</span> 是 <span class="key">PRINT</span> 键）。然后等待至少一分钟，查看系统反应状态。</p></li>
 119 <li><p>系统无法实现正确引导。它可能自动重启，或停止在某个步骤（例如，某个启动图标）。对于后一种情况，可以尝试使用快捷键 <span class="key">ALT</span> <span class="key">SysReq</span> <span class="key">D</span>。</p></li>
 120 <li><p>整个系统或者部分硬件无法正确运行。例如，系统运行缓慢，出现错误，或者完全无法运行。如果某个硬件完全无法工作，首要的是检查Haiku目前是否支持该硬件（例如，在邮件列表或论坛中进行询问）。</p></li>
 121 </ul>
 122 <p>需要注意的是，只有最后这种情况与硬件相关，而所有其他的问题也可能由硬件驱动中的错误引起。如果您对引起该问题的硬件或相关的驱动有所疑问，您可以检查删除/禁用该硬件或驱动是否会产生影响。例如，如果您怀疑无线网络有问题，您会发现 BIOS 中有可禁用它的选项。如果其中没有该选项，您可以从安装的 Haiku 中删除相关的无线网络驱动（参见 <a href="../../../userguide/en/bootloader.html">引导程序</a>）。</p>
 123
 124 <h3><a href="#"><img src="../images/up.png" style="border:none;float:right" alt="index" /></a>
 125 <a id="kdl" name="kdl">内核调试 - KDL</a></h3>
 126 <p>如果系统没有自动的进入内核调试状态，您也可以有意识的使用 <span class="key">ALT</span> <span class="key">SysReq</span> <span class="key">D</span> 快捷键手动进入。<br />
 127 需要注意的是，在内核调试状态，您的键盘可能会无法工作。PS/2 键盘通常都能够正常工作；对于 UHCI 控制器连接的 USB 键盘，您至少需要使用快捷键进入内核调试状态一次，它才可用。但是对于 USB OCHI，目前还未实现支持。</p>
 128 <p>KDL 本身是 shell 中的一类。它可以执行命令，打印系统信息。下面是一些感兴趣的命令：</p>
 129 <table summary="layout" border="0" cellpadding="2" cellspacing="0">
 130 <tr><td><span class="cli">bt</span> (aka sc)</td><td> </td><td>打印回溯信息。如果系统自主进入内核调试状态，通常需要输入该命令。</td></tr>
 131 <tr><td><span class="cli">ints</span></td><td> </td><td>显示已处理和未处理的硬件中断。</td></tr>
 132 <tr><td class="onelinetop"><span class="cli">co</span> (aka continue)</td><td> </td><td>离开内核调试状态；如果可能的话，继续正常的系统操作。</td></tr>
 133 <tr><td><span class="cli">reboot</span></td><td> </td><td>立即重启系统。您将会丢失所有未保存的数据，甚至包括那些已经保存，但是还未写入硬盘的数据。</td></tr>
 134 </table>
 135 <p>获取更多信息，请参阅 <a href="http://www.haiku-os.org/documents/dev/welcome_to_kernel_debugging_land">欢迎使用内核调试工具</a>。</p>
 136 <p>KDL输出信息将会写入到串行端口（如果您拥有另一台与之相连接的计算机，您可以通过中断程序重定向输出信息）和系统日志。如果您无法离开KDL，它将无法写入系统日志文件。尽管如此，还有一个系统引导调试选项，允许您捕获系统信息（参阅下文）。</p>
 137 <p>您可以从KDL输出中生成 QR 代码，而它们可以通过智能手机或相似设备转换为文本内容。有关如何使用该功能从 KDL 获取数据，详情参考 <a href="http://www.haiku-os.org/blog/mmlr/2012-07-01_qr_encode_your_kdl_output">QR Encode your KDL Output</a> 。</p>
 138
 139 <h3><a href="#"><img src="../images/up.png" style="border:none;float:right" alt="index" /></a>
 140 <a id="syslog" name="syslog">系统日志</a></h3>
 141 <p><b>这是从无法引导的系统中获取信息的首选方法。</b>
 142 <br />
 143 系统日志（syslog，system log 的缩写）中包含了关于系统问题的有用信息，包括 KDL 会话的输出信息 。通常将它附带到有关内核问题的报告中是个不错的主意。系统日志将会写入文件 <span class="path">/boot/system/var/log/syslog</span>。由于写入文件需要系统处于运行状态，因此当内核出现问题时（尤其是，系统自动重启，或者无法持续 KDL 会话），最新的输出信息可能无法写入日志文件。</p>
 144 <p>The option <span class="menu">Enable debug syslog</span> in the boot loader's <span class="menu">Debug menu</span> makes the syslog persistent. If the option <span class="menu">Save syslog from previous session during boot</span> is activated in the boot loader options (as it is by default), you'll find the syslog of your last session as <span class="path">/boot/system/var/log/previous_syslog</span>.<br />
 145 If you're not able to boot to get to the previous_syslog, you have to enter the boot loader menu by holding down <span class="key">SHIFT</span> while booting.<br />
 146 In the boot loader's <span class="menu">Debug menu</span> you should find the entries <span class="menu">Display syslog from previous session</span> and <span class="menu">Save syslog from previous session</span>. The former displays the syslog on screen, the latter allows you to save it as a file to disk. Note that at the moment only FAT32 volumes are supported for saving the file. If you want to use a USB stick, but have plugged it in too late so that it isn't recognized yet, you can reset the machine and re-enter the boot loader menu. Note: Don't accidentally boot any operating system or the data will be lost.</p>
 147
 148 <h3><a href="#"><img src="../images/up.png" style="border:none;float:right" alt="index" /></a>
 149 <a id="onscreen" name="onscreen">屏幕调试</a></h3>
 150 <p><b>The on-screen debug output is useful only for debugging very specific issues and is known to have (timing) issues. Don't use it, if you don't have to.</b><br />
 151 This is only relevant when Haiku fails to boot on your machine and the <span class="menu">Debug syslog option</span> doesn't work for some reason. Before the Haiku boot logo appears, hold <span class="key">SHIFT</span> to enter the boot loader menu. Select <span class="menu">Select safe mode options</span>. Near the bottom, <span class="menu">[ ] Enable on screen debug output</span> will be listed. (Note: The other options could be enabled in an attempt to boot Haiku. If Haiku will boot only when one or more options are activated, be sure to mention which ones.)<br />
 152 Finally select <span class="menu">Return to main menu</span> and then <span class="menu">Continue booting</span>.<br />
 153 One or more pages of text will display on the screen, only the last few lines need to be included on your ticket. There's more information on the <a href="../../userguide/zh_CN/bootloader.html">Boot Loader</a>.</p>
 154
 155 <h2><a href="#"><img src="../images/up.png" style="border:none;float:right" alt="index" /></a>
 156 <a id="hardware" name="hardware">硬件错误</a></h2>
 157 <p>在处理有关硬件/驱动的问题时，您需要在报告中附带下面的信息：</p>
 158
 159 <table summary="layout" border="0" cellpadding="2" cellspacing="0">
 160 <tr><td>- <span class="cli">listdev</span></td><td> </td><td> 给出所有硬件的详细列表，包括提供商和 PCI ID；类似于Linux下的 <span class="cli">lshw</span> 和 <span class="cli">lspci</span> 。</td></tr>
 161 <tr><td>- <span class="cli">listusb -v</span></td><td> </td><td>假如是有关 USB 的问题，它类似于Linux下的 <span class="cli">lsusb</span>。</td></tr>
 162 <tr><td>- <span class="cli">open /var/log/syslog</span></td><td> </td><td>Haiku的主要系统日志，类似于引导过程中的屏幕调试信息。您可以使用 <span class="cli">open</span> 命令在文本编辑器中获取到系统日志中相关的部分。</td></tr>
 163 <tr><td class="onelinetop">- <span class="cli">listimage | grep drivers/</span></td><td> </td><td> 列出所有使用的驱动。</td></tr>
 164 <tr><td>- <span class="cli">ints</span></td><td> </td><td>只在 <i>内核调试状态</i> 可用（参阅下文）。它用显示中断使用情况。不可能有许多由不同硬件共享的中断。</td></tr>
 165 <tr><td colspan="3">- 屏幕调试输出（引导时间选项的安全模式）。</td></tr>
 166 </table>
 167
 168 <p>前四个命令需要在终端中进行输入。在命令后添加 <span class="cli"> &gt; output.txt</span> ，然后输出的信息将会重定向到“output.txt”文本文件，您可以将其附带到您的错误报告或者邮件。</p>
 169
 170 <h2><a href="#"><img src="../images/up.png" style="border:none;float:right" alt="index" /></a>
 171 <a id="next" name="next">下一步</a></h2>
 172 <p>在您提交错误报告之后，开发人员将会检查您的错误，然后尝试进行修复。但是需要注意的是，我们所有的人员都是志愿者，有时候一个错误报告可能会很长时间没有人来进行回复。如果可以的话，添加新的信息将会有助于早点修复错误，但是请不要添加非描述性的评论来将“炒热”该错误。</p>
 173 <p>切记，提交错误报告不是花很少时间写个报告，然后就结束了。如果您提交了一个错误，然后您就是Haiku开发过程中的一员。开发人员在解决您的错误过程中可能会遇到问题，因此请你一定要始终关注该错误，然后回答相关的问题。如果该问题没有“fixed”，你的任务就没有“done”。</p>
 174
 175 </div>
 176 </div>
 177
 178 <div class="nav">
 179 <div class="inner"><span>
 180     <a href="../welcome_zh_CN.html" class="uplink">Welcome</a>
 181 </span></div>
 182 </div>
 183
 184 </body>
 185 </html>