path: root/chinese/Bugs/Reporting.wml

#use wml::debian::template title="Debian 缺陷跟踪系统——报告缺陷" NOHEADER=yes NOCOPYRIGHT=true
#use wml::debian::translation-check translation="8a8a9eb42466b527acfb4f0ec8730550acec5b94" maintainer="Boyuan Yang"

<h1>如何使用 reportbug 在 Debian 中报告问题</h1>

<a name="reportbug"></a>
<p>我们强烈建议您在 Debian 中报告问题、缺陷与错误时使用
<code><a
href="https://packages.debian.org/stable/utils/reportbug">reportbug</a></code>
程序。</p>

<p>reportbug 在大多数系统上已默认安装。如果在您的系统上暂时不可用，\
您可以使用软件包管理工具进行安装。</p>

<p>reportbug 工具可以从图形界面系统菜单中的<q>系统</q>分区中找到并启动，\
您也可以在命令行输入 <code>reportbug</code> 来启动它。</p>

<p>该程序将引导您一步一步完成缺陷报告流程。</p>

<p>如果您对 reportbug 提供的交互式功能有疑问或者其功能无法满足您的需求的话，
请参考本文后面叙述的文档内容，或者在<a
href="mailto:debian-user@lists.debian.org"> Debian 用户邮件列表（英文）</a>
或 <a href="https://lists.debian.org/debian-chinese-gb">Debian 中文邮件列表</a>询问。</p>


<h1>如何使用电子邮件向 Debian 报告 bug（含 reportbug 的高级用法）</h1>

<h2>在您发送缺陷报告<strong>之前</strong>需要了解的东西</h2>

<a name="whatpackage"></a>
<h3>您的报告应当归属哪个软件包之下？</h3>
<p>您需要知道您的缺陷报告应该针对哪一个软件包进行提交。请查看
<a href="#findpkgver">这个例子</a>以了解您该如何获取这类信息。
（您还可以通过这些信息了解到<a href="#filedalready">您的缺陷报告是否已经被其他人提交过了。</a>）
</p>

<p>如果您无法确定您的报告应该针对哪一个软件包提交，
请向 <a href="mailto:debian-user@lists.debian.org">Debian
用户邮件列表</a>发送邮件询问以得到建议。</p>

<p>如果您遇到的问题并不仅仅和某个单一的软件包相关，而是和某些一般的 Debian
服务有关的话，我们有一些 <a href="pseudo-packages">pseudo-packages</a>
（即“伪软件包”）以及 <a href="../MailingLists/">邮件列表</a>。
这些设施可以帮助您将相关的信息转递给我们。

<a name="filedalready"></a>
<h3>您的缺陷报告是否已被提交过了？</h3>
<p>在提交报告之前，您应该检查您的缺陷报告是否已被他人提交过了。
即，其他人已经提交了一份报告描述了相同的问题。
如需查找某个软件包中已经被提交的问题报告列表，
您可以使用<a href="./#pkgreport">缺陷搜索表格中的“package”（软件包）选项</a>进行查找。
如果已经存在一个编号为“#<var>&lt;number&gt;</var>”且与您遇到的问题相同的报告的话，
您应该以向收件人为“<var>&lt;number&gt;</var>@bugs.debian.org”
的电子邮件地址发送电子邮件以附加您的评论。此时请不要提交一个新的缺陷报告以避免重复。</p>

<h3>请为不同的问题各自提交报告</h3>
<p>请不要在单一的缺陷报告中描述多个不相关的问题。当这些问题分属不同的软件包时更是如此。
请为每个问题提交各自独立的报告。</p>

<h3>避免直接向上游提交报告</h3>
<p>如果您已经在 Debian 中提交了一份报告，请不要将其副本原封不动地向上游再报告一份，
因为这个问题很可能只在 Debian 中出现。如果真的必要的话，软件包维护者会帮忙将报告
转发给上游。</p>

<h2>使用电子邮件发送缺陷报告</h2>

<p>您可以使用发送电子邮件的方式向 Debian 提交一份新的缺陷报告，
下文将具体描述操作方法。您的电子邮件应当发往<a href="mailto:submit@bugs.debian.org">
<code>submit@bugs.debian.org</code></a>，并采取后文中描述的特殊文本格式。
<code>reportbug</code> 工具（<a href="#reportbug">参见前文</a>）实质上是自动帮助您
撰写了合适格式的电子邮件并进行提交。可能的话，请尽量使用该工具！</p>

<h3>信头</h3>
<p>和其它电子邮件一样，您应该在您的邮件中写上一个明晰、描述性的<code>Subject</code>
（主题、标题）行。这个标题将为作为追踪系统中报告的初始标题，所以请尽可能地在标题中提供有用的信息！</p>

<p>如果您想要将这份缺陷报告的副本发送给其它的接收者（如邮件列表）的话，
您不应该在电子邮件头部写上收件人（即不应该使用标准的抄送、密送方式）。
此时您应该采用一种<a href="#xcc">特殊的方式进行，详见下文</a>。</p>

<h3><a name="pseudoheader">伪信头（Pseudo-Headers）</a></h3>
<p>您的缺陷报告正文的第一部分是伪信头（pseudo-headers），
其中应该包含一些与报告相关的信息，如这个报告所针对的软件包名称、对应软件包的版本等等。
邮件正文的第一行必须是一个伪信头信息。
它的内容应该是：</p>

<pre>
Package: &lt;packagename&gt;
</pre>

<p>请将 <code>&lt;packagename&gt;</code> 替换为 <a href="#whatpackage">软件包的名称</a>，
这个软件包应该存在您正在报告的问题或缺陷。</p>

<p>邮件正文信息的第二行应该是：</p>

<pre>
Version: &lt;packageversion&gt;
</pre>

<p>请将 <code>&lt;packageversion&gt;</code> 替换为软件包的版本。
除了版本字符串以外，这里请不要填入其它任何文本；
因为缺陷追踪系统需要使用该信息推断出哪些 Debian 发行版本受到该问题的影响。</p>

<p>为了让缺陷追踪系统能够将您的信息正确地转发到软件包维护者处，
您需要在伪信头部分提供正确的 <code>Package</code>（软件包名称）一行内容。
请参考 <a href="#findpkgver">这个例子</a> 以了解如何找到软件包名称的信息。</p>

<p>如需了解其它可用的伪信头，请见<a
href="#additionalpseudoheaders">额外的伪信头</a>。</p>

<h3>报告正文</h3>
<p>请考虑在您的报告中提供以下信息：</p>

<ul>
<li>出错时屏幕上显示或打印出的任何错误信息的<em>准确</em>、<em>完整</em>的文本内容。 
这非常重要！</li>
<li>准确地描述您输入了什么，或者做了什么导致了问题发生。</li>
<li>对不正确行为的一个描述：您期望软件的行为如何，而您又观察到了什么。
一个比较好的做法是从开始到结束描述一次示例会话的过程。</li>
<li>如果您对这个问题有了解的话，请提供一个推荐的修复方案，如果能提供补丁就更好了。</li>
<li>对出问题程序的配置的详细信息，包括配置文件的完整文本。</li>
<li>出问题软件包依赖的所有软件包及其版本号信息。</li>
<li>您正在使用的内核版本（输入<code>uname -a</code>可获得）、
您的共享 C 库信息（输入<code>ls -l /lib/*/libc.so.6</code>
或者 <code>apt show libc6 | grep ^Version</code>）以及任何与您的 Debian
系统相关的细节，只要您认为合适的话都请提供。
例如，如果您碰到了一个 Perl 脚本的问题，您应该考虑提供“perl”
二进制程序的版本号（输入<code>perl -v</code>或<code>dpkg -s perl | grep ^Version:</code>）。</li>
<li>您的系统上相关硬件的合适信息。如果您正要报告的是与设备驱动相关的问题，
请列出您系统上的<em>所有</em>硬件。这是因为问题通常由 IRQ 和 I/O
地址冲突造成。</li>
<li>如果您已经安装了<a
href="https://packages.debian.org/stable/utils/reportbug">reportbug</a>
软件包，那么如下这个命令：
<code>reportbug --template -T none -s none -S normal -b --list-cc
 none -q &lt;package&gt;</code>
的输出会比较有用。这是因为该命令包含了维护者提供的特有脚本以及版本信息
的输出内容。</li>
</ul>

<p>请在报告中包含任何看起来会有点关系的细节——简单来说，报告提供的信息多多益善，
您不用担心内容过多过长会有什么问题。如果内容不多的话，
不妨考虑一下顺带提供能够重现问题的任何相关文件。（如果报告真的已经很长的话，
可以考虑将这些文件放在互联网上其它的地方，并在报告中给出指向的链接。）</p>

<p>如需了解更多能够帮助开发者解决问题的做法的建议，请阅读<a
 href="https://www.chiark.greenend.org.uk/~sgtatham/bugs.html">
如果有效地报告 Bug</a> 一文。</p>


<h2><a name="example">一份示例缺陷报告</a></h2>

<p>一份拥有信头和伪信头的缺陷报告的原文一般长得像这样：</p>

<pre>
  To: submit@bugs.debian.org
  From: diligent@testing.linux.org
  Subject: Hello says `goodbye'

  Package: hello
  Version: 1.3-16

  When I invoke `hello' without arguments from an ordinary shell
  prompt it prints `goodbye', rather than the expected `hello, world'.
  Here is a transcript:

  $ hello
  goodbye
  $ /usr/bin/hello
  goodbye
  $

  I suggest that the output string, in hello.c, be corrected.

  I am using Debian GNU/Linux 2.2, kernel 2.2.17-pre-patch-13
  and libc6 2.1.3-10.
</pre>


<h2><a name="xcc">如何将缺陷报告的副本抄送到其它电子邮件地址</a></h2>

<p>有时候需要将缺陷报告的副本发送到除 <code>debian-bugs-dist</code>
列表和软件包维护者之外的地方。默认情况下，
该报告仅会发送给对应软件包的维护者和上述的邮件列表。</p>

<p>当然，您可以将报告使用电子邮件抄送的功能发送给其它收件人。
然而，这么做的问题在于这样的副本在 <code>Subject</code>（标题）
和 <code>Reply-To</code>（回复地址）部分不会包含缺陷报告编号的信息。
当那位收件人打算对邮件进行回复时，他们很可能会回复到
<code>submit@bugs.debian.org</code> 这个地址，从而错误地产生一个新缺陷报告。
这样最终会产生许多重复的报告。</p>

<p>真正<em>正确</em>的做法是使用名为
<code>X-Debbugs-CC</code> 的伪信头。
请在您的邮件正文伪信头部分添加这样内容：</p>
<pre>
 X-Debbugs-CC: other-list@cosmic.edu
</pre>
<p>这样会指示缺陷追踪系统将报告的一份副本发送至您在
<code>X-Debbugs-CC</code> 伪信头一行中给出的地址。
当然，该报告同样会发送至
<code>debian-bugs-dist</code> 邮件列表。</p>

<p>如果您想指定多个抄送的电子邮件地址，请把它们写入同一行
<code>X-Debbugs-CC</code> 中，并使用英文逗号分隔各个地址。</p>

<p>请避免用 <code>X-Debbugs-CC</code> 将这些副本发送至其它缺陷报告的对应地址，
因为这样做会使得自动检测系统捕捉到邮件转发回环。无论如何，为此使用
<code>X-Debbugs-CC</code> 意义不大，因为该机制添加的缺陷编号会被新的编号所取代。
此时使用通常的抄送（<q><code>CC</code></q>）头即可。</p>

<p>该功能通常也可以和 <code>quiet</code> 邮件共同使用，详情请见下文。</p>

<a name="additionalpseudoheaders"></a>
<h1>其它伪信头</h1>

<h2><a name="severities">问题严重性</a></h2>

<p>如果您了解所报告问题的严重程度，您可以在提交报告时对其进行设置。
这么做并不是必须的，而且软件包维护者会在您未给出严重性信息
（或者选择的严重性等级有误）时赋予该报告正确的严重性等级。</p>

<p>如需对报告赋予严重性等级，请在<a href="#pseudoheader">伪信头</a>
部分添加如下面一行这样的信息：</p>

<pre>
Severity: &lt;<var>severity</var>&gt;
</pre>

<p>请将 &lt;<var>severity</var>&gt; 替换为某个可用的严重性等级。
具体可用的等级列表可以在 <a href="Developer#severities">进阶文档</a>中找到。</p>

<h2><a name="tags">打标签</a></h2>

<p>您可以为所报告的缺陷打上标签。例如，如果您在报告中包含了一个补丁，您可以为报告设置一个
<code>patch</code> 标签。这么做并不是必须的，其他开发者在合适的时候也可能为您的报告设置标签。</p>

<p>如需设置标签，请在<a href="#pseudoheader">伪信头</a>部分加上这样的一行：</p>

<pre>
Tags: &lt;<var>tags</var>&gt;
</pre>

<p>请将上文出现的 &lt;<var>tags</var>&gt;
替换为一个或多个可用的标签，可用标签列表在
<a href="Developer#tags">高级文档</a>中给出。使用英文逗号和/或空格分隔多个标签。</p>

<pre>
User: &lt;<var>username</var>&gt;
Usertags: &lt;<var>usertags</var>&gt;
</pre>

<p>这种情况下，请将 &lt;<var>usertags</var>&gt; 替换为一个或多个用户标签。
使用英文逗号和/或空格分隔多个标签。如果您指定了一个
&lt;<var>username</var>&gt;（即用户名），系统将为该用户分配您指定的用户标签。
否则系统将把提交者的电子邮件地址作为用户名来分配用户标签。</p>

<p>您可以在提交缺陷报告时为多个用户指定用户标签。要如此做，您需要添加
多个 User 伪信头，而每一个 Usertags 伪信头都将为其上方最后一个 User 伪信头
设置用户标签。这在某些情况下十分有用，例如为含有多个用户的团队设置
用户标签、为多个团队设置用户标签，或者为影响多个架构的缺陷
设置<a href="https://wiki.debian.org/Teams/Debbugs/ArchitectureTags">架构用户标签</a>。
</p>

<pre>
User: &lt;<var>first-username</var>&gt;
Usertags: &lt;<var>first-username usertags</var>&gt;
User: &lt;<var>second-username</var>&gt;
Usertags: &lt;<var>second-username usertags</var>&gt;
</pre>

<h2>设置（缺陷）转发信息</h2>
<pre>
Forwarded: <var>foo@example.com</var>
</pre>

<p>
会将新提交的缺陷标记为已转发至 foo@example.com。参见开发者文档中<a
href="Developer#forward">记录您将缺陷报告转交的情况</a>部分以了解详细信息。
</p>

<h2>声明所有权</h2>
<pre>
Owner: <var>foo@example.com</var>
</pre>

<p>
会指示 foo@example.com 当前负责修复该问题。参见开发者文档中<a
href="Developer#owner">修改缺陷所有权</a>部分以了解详细信息。
</p>

<h2>源码包</h2>
<pre>
Source: <var>foopackage</var>
</pre>

<p>
<code>Package:</code> 头的等价形式，用于指出在名为 foopackage
的源码包内存在的缺陷；对于大多数软件包中的缺陷，您大概没有必要使用这个选项。
</p>

<h2><a name="control">控制指令</a></h2>
<pre>
Control: <var>具体控制指令</var>
</pre>

<p>
使得所有本应由 <code>control@bugs.debian.org</code>
接收的控制指令可以同样由发送至 <code>submit@bugs.debian.org</code>
或者 <code>nnn@bugs.debian.org</code> 的邮件等效地被服务器处理。
指令中出现的 -1 将代指当前缺陷报告编号（即，发送至 submit@
的邮件即将创建的缺陷报告编号或发送至 nnn@ 的邮件中的编号）。
请浏览<a href="server-control">BTS服务器控制指令文档</a>以了解具体的可用控制指令。
</p>

<p>例如，下面给出了发送至 <code>12345@bugs.debian.org</code>
的邮件中的伪信头示例：</p>

<pre>
Control: retitle -1 this is the title
Control: severity -1 normal
Control: summary -1 0
Control: forward -1 https://bugs.debian.org/nnn
</pre>

<p>将使得编号为 12345 的缺陷报告得到更名、其严重等级被修改、其简介信息得到设置并
标记为已转发。</p>


<h2>X-Debbugs- 信头</h2>
<p>除此之外，如果您的
<acronym title="邮件用户代理" lang="zh">MUA</acronym>
不允许您编辑信头，您可以在<a href="#pseudoheader">伪信头</a>区域设置各个 <code>X-Debbugs-</code>
项以等效实现原信头的功能。</p>


<h1>额外信息</h1>

<h2>不同的提交地址（用于不严重的问题或批量缺陷报告）</h2>

<p>如果某个报告所涉及到的问题都是小问题，例如文档中的一处错字或是平凡的构建问题，
请考虑将其严重等级适当进行设置（选用低等级），并将报告发送至
<code>maintonly@bugs.debian.org</code> 而非 <code>submit@bugs.debian.org</code>。
<code>maintonly</code> 将只会把报告转发至软件包维护者，它不会将其转发到
BTS 邮件列表中。</p>

<p>如果您打算同时提交许多报告，您肯定应当使用 <code>maintonly@bugs.debian.org</code>
来避免为 BTS 邮件列表带来瞬时大量的流量。
在提交许多相似的问题报告之前，也请考虑在 <code>debian-bugs-dist</code>
邮件列表上发布一份概述信息。</p>

<p>如果希望向缺陷追踪系统报告一个维护者已经知晓的问题的话，您可以使用
<code>quiet@bugs.debian.org</code>。
发送至 <code>quiet@bugs.debian.org</code>
的报告将不会转发给任何人，仅用来归档。</p>

<p>当您设置了不同的提交地址时，缺陷追踪系统会相应地将所转发的邮件中
<code>Reply-To</code> 这一信头设置为与原始报告性质相同的回复地址。
例如，对 <code>maintonly</code> 报告的回复将默认发送至
<var>nnn</var><code>-maintonly@bugs.debian.org</code> 而非
<var>nnn</var><code>@bugs.debian.org</code>，除非回复者手工设置回复到不同的地址。
</p>


<h2>回执</h2>

<p>通常情况下，每当您提交了一份新报告或为已有报告提交一份新信息后，
缺陷追踪系统便会使用电子邮件向您发送一份回执信息。
如果您不想收到这类回执邮件的话，请在报告邮件的信头或伪信头处额外提供
<code>X-Debbugs-No-Ack</code> 一栏（其具体内容无关紧要）。
如果您在提交新报告的同时添加了这份信头的话，
您需要自己使用追踪系统网页前端以查询报告的具体编号。</p>

<p>请注意这个信头不会停止来自 <code>control@bugs.debian.org</code>
邮件服务器的回执邮件的发送；这是因为这些回执信息比较重要，
其中有可能包含需要发送者进行处理的错误信息。</p>

<h2>应对垃圾邮件和邮件丢失</h2>

<p>缺陷追踪系统实现了一套比较完善的规则以确保垃圾邮件不会进入系统。
尽管我们尽力确保错误拦截的情况少出现，但的确会出现垃圾邮件的误判。
如果您怀疑您的邮件被错误拦截的话，请联系 <code>owner@bugs.debian.org</code>
以寻求帮助。另一个时常导致邮件被错误拦截的因素是用户使用了能够匹配
procmail 中 FROM_DAEMON 项的邮件地址，通常包括类似于
<code>mail@foobar.com</code> 的邮件地址。如果您怀疑您的邮件匹配了
FROM_DAEMON 特征，请阅读 <a href="https://manpages.debian.org/cgi-bin/man.cgi?query=procmailrc">procmailrc(5)</a>
以进行验证，并重新使用不匹配 FROM_DAEMON 的新邮件地址重新发送邮件。</p>


<h2>向未知软件包提交的缺陷报告</h2>

<p>如果缺陷追踪系统不知道相关软件包的维护者的话，它会将报告转发给
<code>debian-bugs-dist</code> 邮件列表，且无论是否使用
<code>maintonly</code> 都将进行转发。</p>

<p>在发送邮件至 <code>maintonly@bugs.debian.org</code> 或
<var>nnn</var><code>-maintonly@bugs.debian.org</code>
时，请确保您的报告指向正确的软件包，即在原始报告正文顶部放置了正确的
<code>Package</code> 行，或使用 <a href="server-control">
<code>control@bugs.debian.org</code> 服务</a> 来正确（重）指定报告对应软件包。
</p>


<h2><a name="findpkgver">使用<code>dpkg</code>寻找报告对应的软件包及其版本号</a></h2>

<p>当您使用 <code>reportbug</code> 来报告某个程序的问题时，例如打算报告
<code>grep</code> 的问题时，下面的命令行参数可以帮助您正确选择软件包并直接开始撰写报告：
<code>reportbug --file $(which grep)</code>。</p>

<p>您也可以使用 <code>dpkg --search</code> 来找到提供该文件的软件包。
您可以使用 <code>dpkg --list</code> 或 <code>dpkg --status</code>
来了解您所安装对应软件包的具体版本。
</p>

<p>例如：</p>
<pre>
$ which apt-get
/usr/bin/apt-get
$ type apt-get
apt-get is /usr/bin/apt-get
$ dpkg --search /usr/bin/apt-get
apt: /usr/bin/apt-get
$ dpkg --list apt
Desired=Unknown/Install/Remove/Purge/Hold
| Status=Not/Installed/Config-files/Unpacked/Failed-config/Half-installed
|/ Err?=(none)/Hold/Reinst-required/X=both-problems (Status,Err: uppercase=bad)
||/ Name           Version        Description
+++-==============-==============-============================================
ii  apt            0.3.19         Advanced front-end for dpkg
$ dpkg --status apt
Package: apt
Status: install ok installed
Priority: standard
Section: base
Installed-Size: 1391
Maintainer: APT Development Team &lt;deity@lists.debian.org&gt;
Version: 0.3.19
Replaces: deity, libapt-pkg-doc (&lt;&lt; 0.3.7), libapt-pkg-dev (&lt;&lt; 0.3.7)
Provides: libapt-pkg2.7
Depends: libapt-pkg2.7, libc6 (&gt;= 2.1.2), libstdc++2.10
Suggests: dpkg-dev
Conflicts: deity
Description: Advanced front-end for dpkg
 This is Debian's next generation front-end for the dpkg package manager.
 It provides the apt-get utility and APT dselect method that provides a
 simpler, safer way to install and upgrade packages.
 .
 APT features complete installation ordering, multiple source capability
 and several other unique features, see the Users Guide in
 /usr/doc/apt/guide.text.gz

</pre>

<a name="otherusefulcommands"></a>
<h2>其它有用的命令和软件包</h2>

<p>
<kbd>querybts</kbd> 工具，它由
<a href="https://packages.debian.org/stable/utils/reportbug">reportbug</a>
软件包提供。该工具提供了访问缺陷追踪工具的基于文本的简易界面。</p>

<p>Emacs 用户也可以使用
<code><a href="https://packages.debian.org/stable/utils/debian-el">\
debian-el</a></code> 软件包提供的 debian-bug 命令。
在使用 <kbd>M-x debian-bug</kbd> 调用时，它会如 <code>reportbug</code>
工具一样按步骤询问您必需的信息。</p>

<hr />

#use "otherpages.inc"

#use "$(ENGLISHDIR)/Bugs/footer.inc"