Documentation/translations/zh_CN/admin-guide/reporting-issues.rst
Source file repositories/reference/linux-study-clean/Documentation/translations/zh_CN/admin-guide/reporting-issues.rst
File Facts
- System
- Linux kernel
- Corpus path
Documentation/translations/zh_CN/admin-guide/reporting-issues.rst- Extension
.rst- Size
- 88077 bytes
- Lines
- 1369
- 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_CN.rst
:Original: Documentation/admin-guide/reporting-issues.rst
:译者:
吴想成 Wu XiangCheng <bobwxc@email.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.