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.
- Repository support layer: documentation, build tooling, samples, user-space helper tools, generated initramfs support, licenses, and validation utilities.
- Exports symbols or registers init work; inspect boot/module ordering and who consumes the exported contract.
Dependency Surface
- No C-style include directives detected by the generator.
Detected Declarations
- No top-level syscall, struct, function, initcall, or export declaration detected by the generator.
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
- Atlas domain: Support Tooling And Documentation / Documentation.
- Implementation status: integration implementation candidate.
Implementation Notes
- This generated page is the file-by-file coverage layer; curated subsystem chapters should link here when they synthesize a multi-file control flow.
- Core OS pages should be promoted from atlas-only to deep-reviewed when they explain data structures, invariants, locking, lifecycle, and C implementation snippets.
- Driver-family pages are intentionally pattern-oriented unless they are part of the selected PCIe/NVMe representative device path.