[PATCH v2 4/9] docs/zh_CN: reorganize process debugging guides
From: Dongliang Mu
Date: Tue Oct 27 2026 - 23:43:56 EST
Move the GDB debugging translation into process/debugging. Update the
process and development tools indexes to match the current English
structure.
Synchronize the process index with upstream revision a03ef333fbd6.
Signed-off-by: Dongliang Mu <dzm91@xxxxxxxxxxx>
---
.../translations/zh_CN/dev-tools/index.rst | 37 +++---
.../debugging}/gdb-kernel-debugging.rst | 15 ++-
.../zh_CN/process/debugging/index.rst | 62 ++++++++++
.../translations/zh_CN/process/index.rst | 111 +++++++++++-------
4 files changed, 160 insertions(+), 65 deletions(-)
rename Documentation/translations/zh_CN/{dev-tools => process/debugging}/gdb-kernel-debugging.rst (93%)
create mode 100644 Documentation/translations/zh_CN/process/debugging/index.rst
diff --git a/Documentation/translations/zh_CN/dev-tools/index.rst b/Documentation/translations/zh_CN/dev-tools/index.rst
index 7b37194217b0..f5cf2621b6e3 100644
--- a/Documentation/translations/zh_CN/dev-tools/index.rst
+++ b/Documentation/translations/zh_CN/dev-tools/index.rst
@@ -1,18 +1,16 @@
.. include:: ../disclaimer-zh_CN.rst
-:Original: Documentation/dev-tools/index.rst
:Translator: 赵军奎 Bernard Zhao <bernard@xxxxxxxx>
============
内核开发工具
============
-本文档是有关内核开发工具文档的合集。
-目前这些文档已经整理在一起，不需要再花费额外的精力。
-欢迎任何补丁。
+本文档收集了用于内核开发的工具文档。目前这些文档只是汇集在一起，尚未充分整理成一份连贯的指南；欢迎提交补丁！
-有关测试专用工具的简要概述，参见
-Documentation/translations/zh_CN/dev-tools/testing-overview.rst
+测试工具的简要概述见 ``Documentation/dev-tools/testing-overview.rst``。
+
+调试专用工具见 ``Documentation/process/debugging/index.rst``。
.. toctree::
:caption: 目录
@@ -21,21 +19,26 @@ Documentation/translations/zh_CN/dev-tools/testing-overview.rst
testing-overview
sparse
kcov
- kcsan
- kmsan
gcov
kasan
+ kmsan
ubsan
kmemleak
- gdb-kernel-debugging
+ kcsan
Todolist:
- - checkpatch
- - coccinelle
- - kfence
- - kgdb
- - kselftest
- - kunit/index
- - ktap
- - checkuapi
+* checkpatch
+* clang-format
+* coccinelle
+* context-analysis
+* lkmm/index
+* kfence
+* kselftest
+* kunit/index
+* ktap
+* checkuapi
+* gpio-sloppy-logic-analyzer
+* autofdo
+* propeller
+* container
diff --git a/Documentation/translations/zh_CN/dev-tools/gdb-kernel-debugging.rst b/Documentation/translations/zh_CN/process/debugging/gdb-kernel-debugging.rst
similarity index 93%
rename from Documentation/translations/zh_CN/dev-tools/gdb-kernel-debugging.rst
rename to Documentation/translations/zh_CN/process/debugging/gdb-kernel-debugging.rst
index 0b382a32b3fe..f5010c144dcb 100644
--- a/Documentation/translations/zh_CN/dev-tools/gdb-kernel-debugging.rst
+++ b/Documentation/translations/zh_CN/process/debugging/gdb-kernel-debugging.rst
@@ -1,8 +1,7 @@
.. highlight:: none
-.. include:: ../disclaimer-zh_CN.rst
+.. include:: ../../disclaimer-zh_CN.rst
-:Original: Documentation/process/debugging/gdb-kernel-debugging.rst
:Translator: 高超 gao chao <gaochao49@xxxxxxxxxx>
通过gdb调试内核和模块
@@ -34,7 +33,7 @@ Kgdb内核调试器、QEMU等虚拟机管理程序或基于JTAG的硬件接口
但这通常仅在不依赖内核模块时才有效。有关此模式的更多详细信息，请参阅QEMU文档。
在这种情况下，如果架构支持KASLR，应该在禁用CONFIG_RANDOMIZE_BASE的情况下构建内核。
-- 构建gdb脚本（适用于内核v5.1版本及以上）
+- 构建gdb脚本（内核 v5.1 及以上版本需要此步骤）::
make scripts_gdb
@@ -78,7 +77,7 @@ Kgdb内核调试器、QEMU等虚拟机管理程序或基于JTAG的硬件接口
...
loading @0xffffffffa0000000: /home/user/linux/build/drivers/ata/ata_generic.ko
-- 对一些尚未加载的模块中的函数函数设置断点，例如::
+- 对尚未加载的模块中的函数设置断点，例如::
(gdb) b btrfs_init_sysfs
Function "btrfs_init_sysfs" not defined.
@@ -165,3 +164,11 @@ Kgdb内核调试器、QEMU等虚拟机管理程序或基于JTAG的硬件接口
可以通过“help <command-name>”或“help function <function-name>”命令
获取指定命令或指定调试功能的更多详细信息。
+
+调试 GDB 脚本
+-------------
+
+GDB 默认不会显示完整的 Python 回溯，这会使调试 GDB 脚本比必要的更困难。
+使用以下命令可输出 Python 环境的完整回溯::
+
+ (gdb) set python print-stack full
diff --git a/Documentation/translations/zh_CN/process/debugging/index.rst b/Documentation/translations/zh_CN/process/debugging/index.rst
new file mode 100644
index 000000000000..b0a121f7a91e
--- /dev/null
+++ b/Documentation/translations/zh_CN/process/debugging/index.rst
@@ -0,0 +1,62 @@
+.. SPDX-License-Identifier: GPL-2.0
+
+.. include:: ../../disclaimer-zh_CN.rst
+
+
+========================
+Linux 内核开发者调试指南
+========================
+
+通用指南
+--------
+
+.. toctree::
+ :maxdepth: 1
+
+ gdb-kernel-debugging
+
+待译文档：
+
+* driver_development_debugging_guide
+* kgdb
+* userspace_debugging_guide
+
+针对特定子系统的指南
+--------------------
+
+待译文档：
+
+* media_specific_debugging_guide
+
+一般调试建议
+============
+
+根据遇到的问题，可以使用不同的工具追踪问题，甚至判断问题是否确实存在。
+
+首先要弄清楚需要调试哪一类问题。不同的问题可能需要不同的方法和工具。
+
+是否只能有限地访问系统？
+------------------------
+
+如果只能有限地访问机器，或者无法停止正在运行的程序，调试能力就取决于发行版内核
+内置的调试支持。有关这种情况下可用工具的简要介绍，请参阅
+``Documentation/process/debugging/userspace_debugging_guide.rst``。多数情况下，
+可以查看 ``/boot`` 目录中的内核配置文件，确认内核提供了哪些调试支持。
+
+是否拥有系统的 root 权限？
+--------------------------
+
+如果能够轻松地更换模块或安装新内核，可用的调试手段就多得多。详情请参阅
+``Documentation/process/debugging/driver_development_debugging_guide.rst``。
+
+时间因素是否相关？
+------------------
+
+需要判断问题是稳定复现的（即相同输入总会得到相同的错误结果），还是偶发的。
+如果问题偶发，就可能受到时间因素影响。如果插入延迟会改变问题的表现，那么时间
+因素很可能起了作用。
+
+当时间因素会影响结果时，使用简单的 ``printk()`` 调试可能不起作用。可以改用
+``trace_printk()``，将消息写入跟踪文件，而不是内核日志。
+
+**Copyright** ©2024 : Collabora
diff --git a/Documentation/translations/zh_CN/process/index.rst b/Documentation/translations/zh_CN/process/index.rst
index 3a36ca7d9333..9d775eaae742 100644
--- a/Documentation/translations/zh_CN/process/index.rst
+++ b/Documentation/translations/zh_CN/process/index.rst
@@ -5,94 +5,117 @@
.. include:: ../disclaimer-zh_CN.rst
-:Original: Documentation/process/index.rst
-
:翻译:
Alex Shi <alex.shi@xxxxxxxxxxxxxxxxx>
+.. _process_index_zh:
+
========================
与Linux 内核社区一起工作
========================
-你想成为Linux内核开发人员吗？欢迎之至！在学习许多关于内核的技术知识的同时，
-了解我们社区的工作方式也很重要。阅读这些文档可以让您以更轻松的、麻烦更少的
-方式将更改合并到内核。
+你想成为 Linux 内核开发者吗？欢迎！除了要学习大量内核技术知识，了解社区的工作方式
+也很重要。阅读这些文档可以帮助你更顺利地将改动合入内核。
-以下是每位开发人员都应阅读的基本指南：
+内核开发流程简介
+----------------
+
+请先阅读这些文档：理解其中的内容有助于你加入内核社区。
.. toctree::
:maxdepth: 1
- license-rules
howto
- code-of-conduct
- code-of-conduct-interpretation
development-process
submitting-patches
- programming-language
- coding-style
- maintainer-pgp-guide
- email-clients
- kernel-enforcement-statement
- kernel-driver-statement
-
-TODOLIST:
+ submit-checklist
-* handling-regressions
-* maintainer-handbooks
+内核开发者的工具和技术指南
+--------------------------
-安全方面, 请阅读:
+内核开发者应当熟悉以下资料。
.. toctree::
:maxdepth: 1
- embargoed-hardware-issues
- cve
- security-bugs
+ programming-language
+ coding-style
+ maintainer-pgp-guide
+ email-clients
+ applying-patches
+ volatile-considered-harmful
-TODOLIST:
+Todolist:
-* handling-regressions
+* changes
+* backporting
+* adding-syscalls
+* botching-up-ioctls
-其它大多数开发人员感兴趣的社区指南：
+政策指南与开发者声明
+--------------------
+这些是内核社区及其他相关领域努力遵守的规则。
.. toctree::
:maxdepth: 1
+ license-rules
+ code-of-conduct
+ code-of-conduct-interpretation
+ kernel-enforcement-statement
+ kernel-driver-statement
stable-api-nonsense
- management-style
stable-kernel-rules
- submit-checklist
+ management-style
researcher-guidelines
-TODOLIST:
+Todolist:
-* changes
-* kernel-docs
-* deprecated
-* maintainers
* contribution-maturity-model
+* generated-content
+* coding-assistants
+* conclave
+处理缺陷
+--------
-这些是一些总体性技术指南，由于不大好分类而放在这里：
+缺陷不可避免，妥善处理很重要。以下文档提供一般的调试建议，并介绍
+如何处理两类特殊缺陷——回归问题和安全问题。
.. toctree::
:maxdepth: 1
- magic-number
- applying-patches
- volatile-considered-harmful
- ../arch/riscv/patch-acceptance
- ../core-api/unaligned-memory-access
+ debugging/index
+ security-bugs
+ cve
+ embargoed-hardware-issues
-TODOLIST:
+Todolist:
-* backporting
-* adding-syscalls
-* botching-up-ioctls
-* clang-format
+* handling-regressions
+* threat-model
+
+维护者信息
+----------
+
+这些文档介绍如何找到能够接受你提交的补丁的人。
+
+Todolist:
+
+* maintainer-handbooks
+* maintainers
+
+其他资料
+--------
+
+以下社区指南也与大多数开发者有关。
+
+Todolist:
+
+* kernel-docs
+* deprecated
.. only:: subproject and html
--
2.51.0