Documentation/translations/zh_TW/admin-guide/reporting-issues.rst

Source file repositories/reference/linux-study-clean/Documentation/translations/zh_TW/admin-guide/reporting-issues.rst

File Facts

System
Linux kernel
Corpus path
Documentation/translations/zh_TW/admin-guide/reporting-issues.rst
Extension
.rst
Size
88129 bytes
Lines
1371
Domain
Support Tooling And Documentation
Bucket
Documentation
Inferred role
Support Tooling And Documentation: exported/initcall integration point
Status
integration implementation candidate

Why This File Exists

Repository support layer: documentation, build tooling, samples, user-space helper tools, generated initramfs support, licenses, and validation utilities.

Dependency Surface

Detected Declarations

Annotated Snippet

.. SPDX-License-Identifier: (GPL-2.0+ OR CC-BY-4.0)
.. See the bottom of this file for additional redistribution information.


.. include:: ../disclaimer-zh_TW.rst

:Original: Documentation/admin-guide/reporting-issues.rst

:譯者:

 吳想成 Wu XiangCheng <bobwxc@email.cn>
 胡皓文 Hu Haowen <2023002089@link.tyut.edu.cn>


報告問題
+++++++++


簡明指南(亦即 太長不看)
==========================

您面臨的是否爲同系列穩定版或長期支持內核的普通內核的迴歸?是否仍然受支持?
請搜索 `LKML內核郵件列表 <https://lore.kernel.org/lkml/>`_ 和
`Linux穩定版郵件列表 <https://lore.kernel.org/stable/>`_ 存檔中匹配的報告並
加入討論。如果找不到匹配的報告,請安裝該系列的最新版本。如果它仍然出現問題,
請報告給穩定版郵件列表(stable@vger.kernel.org)並抄送回歸郵件列表
(regressions@lists.linux.dev);理想情況下,還可以抄送維護者和相關子系統的
郵件列表。

在所有其他情況下,請儘可能猜測是哪個內核部分導致了問題。查看MAINTAINERS文件,
瞭解開發人員希望如何得知問題,大多數情況下,報告問題都是通過電子郵件和抄送
相關郵件列表進行的。檢查報告目的地的存檔中是否已有匹配的報告;也請搜索
`LKML <https://lore.kernel.org/lkml/>`_ 和網絡。如果找不到可加入的討論,請
安裝 `最新的主線內核 <https://kernel.org/>`_ 。如果仍存在問題,請發送報告。

問題已經解決了,但是您希望看到它在一個仍然支持的穩定版或長期支持系列中得到
解決?請安裝其最新版本。如果它出現了問題,那麼在主線中搜索修復它的更改,並
檢查是否正在回傳(backporting)或者已放棄;如果兩者都沒有,那麼可詢問處理
更改的人員。

**通用提醒** :當安裝和測試上述內核時,請確保它是普通的(即:沒有補丁,也沒
有使用附加模塊)。還要確保它是在一個正常的環境中構建和運行,並且在問題發生
之前沒有被污染(tainted)。

當你同時面臨Linux內核的多個問題時,請分別報告。在編寫報告時,要涵蓋與問題
相關的所有信息,如使用的內核和發行版。如果碰見迴歸,請把報告抄送回歸郵件列表
(regressions@lists.linux.dev)。也請試試用二分法找出源頭;如果成功找到,請
在報告中寫上它的提交ID並抄送sign-off-by鏈中的所有人。

一旦報告發出,請回答任何出現的問題,並儘可能地提供幫助。這包括通過不時重新
測試新版本併發送狀態更新來推動進展。


如何向內核維護人員報告問題的逐步指南
=====================================

上面的簡明指南概述瞭如何向Linux內核開發人員報告問題。對於已經熟悉向自由和開
源軟件(FLOSS)項目報告問題的人來說,這可能是他們所需要的全部內容。對於其他
人,本部分更爲詳細,並一步一步地描述。爲了便於閱讀,它仍然儘量簡潔,並省略
了許多細節;這些在逐步指南後的參考章節中進行了描述,該章節更詳細地解釋了每
個步驟。

注意:本節涉及的方面比簡明指南多,順序也稍有不同。這符合你的利益,以確保您
儘早意識到看起來像Linux內核毛病的問題可能實際上是由其他原因引起的。這些步驟
可以確保你最終不會覺得在這一過程中投入的時間是浪費:

 * 您是否面臨硬件或軟件供應商提供的Linux內核的問題?那麼基本上您最好停止閱讀
   本文檔,轉而向您的供應商報告問題,除非您願意自己安裝最新的Linux版本。尋找
   和解決問題往往需要後者。

Annotation

Implementation Notes