From mboxrd@z Thu Jan 1 00:00:00 1970 Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.remote-ip=46.101.248.176 ARC-Seal: i=1; d=subspace.kernel.org; s=arc20261015; a=rsa-sha256; cv=none; t=1793096779; b=W3Rc7SaKhh6+0k39eIGS7CNX/IeEOSXGRgWC6C08QCWQ9PC4aSQ9eT8QuwGp57Rl/Hu2 dRPEKfkDy1cofMCRflePjLePJWx54ikHB75eyDIA8wTJ8Q2owUNaubrhIpz9RS8elhuf1 YiBFNGHkBKgRIeKBrpuKd/BPlmBZjPaaj31cdnW/U+gu2z0akiL+5hfGsTBEto4GznKbl 1aUDoPB4cQBNN39jQ+82ckRvMyAguOeokKOKQajT0+Do3Iay7xLgJTAOPuxw8jRmpxjyt oAutmM5UFraYGMxaPij/VdXThRztV02uETnyuWQbNLxzkYxd4GPrhiIoZuh5Z4dOTlQ== ARC-Message-Signature: i=1; d=subspace.kernel.org; s=arc20261015; a=rsa-sha256; c=relaxed/relaxed; t=1793096779; h=DMARC-Filter:Received:Received:From:To:Cc:Subject:Date:Message-ID: X-Mailer:In-Reply-To:References:MIME-Version:Content-Type: Content-Transfer-Encoding:X-CM-TRANSID:X-Coremail-Antispam: X-CM-SenderInfo; bh=mPV1PitHtDsn+aWNR0MaICTlJ609IjTgEbBLoz8jlzk=; b=N5UIDInTue1bW3ZMecWcIngmBqpNhFPnRDwGNC8aGmcMldjOjRxW9Eg/Pp1oIDeqRPjG w71P6CKeLO7ZVYohgysmyBCMF5/ofWGtMkI1rvDWoRxfHWxLTR9vnTL/03YN0xjguU2g+ nPjuv10HAn0f2QCTSDdNVd6sGblGAOnhWzWhz5SM8ou3v5m9sew0eQe28n3HTloqIavb7 sOyOeW5BQDVudfYmA3ekCBynFDT2BQDWXZSPnsC7wGwFKGFoOd1tRpoMjk5o4JwS1B8yr mwUr8AI2+ctLPonl+AWL9ylVcyDyZQ8sqViMKki8BlnykuBfqsFsEo2O5Dds5TThmNw== ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=none header.from=hust.edu.cn; spf=pass smtp.mailfrom=hust.edu.cn; arc=none smtp.remote-ip=46.101.248.176 Received: from zg8tndyumtaxlji0oc4xnzya.icoremail.net (zg8tndyumtaxlji0oc4xnzya.icoremail.net [46.101.248.176]) by smtp.subspace.kernel.org (Postfix) with ESMTP id B904C60A261C; Tue, 27 Oct 2026 10:26:17 +0000 (UTC) DMARC-Filter: OpenDMARC Filter v1.4.2 smtp.subspace.kernel.org B904C60A261C Authentication-Results: smtp.subspace.kernel.org; dmarc=none (p=none dis=none) header.from=hust.edu.cn Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=hust.edu.cn Received: from hust.edu.cn (unknown [172.16.0.50]) by app2 (Coremail) with UTF8SMTP id IQEQrMCmzndBfOBqODZfAA--.50270S2; Tue, 27 Oct 2026 18:26:09 +0800 (CST) Received: from mudongliang-PC.tailb307d0.ts.net (unknown [10.12.191.55]) by gateway (Coremail) with SMTP id _____wDXseYwfOBq0WPDAA--.19105S6; Tue, 27 Oct 2026 18:26:08 +0800 (CST) From: Dongliang Mu To: Alex Shi , Yanteng Si Cc: Jonathan Corbet , Shuah Khan , Randy Dunlap , linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org Subject: [PATCH 4/9] docs/zh_CN: reorganize process debugging guides Date: Tue, 27 Oct 2026 18:25:47 +0800 Message-ID: <20261027102552.3801595-5-dzm91@hust.edu.cn> X-Mailer: git-send-email 2.51.0 In-Reply-To: <20261027102552.3801595-1-dzm91@hust.edu.cn> References: <20261027102552.3801595-1-dzm91@hust.edu.cn> X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Post: List-Help: List-Subscribe: List-Unsubscribe: List-Owner: Precedence: list MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-CM-TRANSID:IQEQrMCmzndBfOBqODZfAA--.50270S2 Authentication-Results: app2; spf=neutral smtp.mail=dzm91@hust.edu.cn; X-Coremail-Antispam: 1UD129KBjvJXoW3trW5Wr47ArW5urW3XFyrZwb_yoWkZFyfpF n3Gryfta1rG343Ary8Cr48GryfGa97Gay5G3W0ya4Sqr18AFWFqr43tFykJFy3WrW8Aay5 XF4xKrW5urW7AFDanT9S1TB71UUUUjDqnTZGkaVYY2UrUUUUjbIjqfuFe4nvWSU5nxnvy2 9KBjDU0xBIdaVrnRJUUUH0b7Iv0xC_Cr1lb4IE77IF4wAFc2x0x2IEx4CE42xK8VAvwI8I cIk0rVWrJVCq3wA2ocxC64kIII0Yj41l84x0c7CEw4AK67xGY2AK021l84ACjcxK6xIIjx v20xvE14v26w1j6s0DM28EF7xvwVC0I7IYx2IY6xkF7I0E14v26r4UJVWxJr1l84ACjcxK 6I8E87Iv67AKxVW0oVCq3wA2z4x0Y4vEx4A2jsIEc7CjxVAFwI0_GcCE3s1ln4kS14v26r 126r1DM2vYz4IE04k24VAvwVAKI4IrM2AIxVAIcxkEcVAq07x20xvEncxIr21l57IF6xkI 12xvs2x26I8E6xACxx1l5I8CrVACY4xI64kE6c02F40Ex7xfMcIj64x0Y40En7xvr7AKxV W8Jr0_Cr1UMcIj6x8ErcxFaVAv8VW8uFyUJr1UMcIj6xkF7I0En7xvr7AKxVW8Jr0_Cr1U McvjeVCFs4IE7xkEbVWUJVW8JwACjcxG0xvY0x0EwIxGrwCY1x0262kKe7AKxVWUAVWUtw CY02Avz4vE-syl42xK82IYc2Ij64vIr41l42xK82IY6x8ErcxFaVAv8VW8uFyUJr1UMxC2 0s026xCaFVCjc4AY6r1j6r4UMxCIbckI1I0E14v26r126r1DMI8I3I0E5I8CrVAFwI0_Jr 0_Jr4lx2IqxVCjr7xvwVAFwI0_JrI_JrWlx4CE17CEb7AF67AKxVWUAVWUtwCIc40Y0x0E wIxGrwCI42IY6xIIjxv20xvE14v26ryj6F1UMIIF0xvE2Ix0cI8IcVCY1x0267AKxVW8JV WxJwCI42IY6xAIw20EY4v20xvaj40_Jr0_JF4lIxAIcVC2z280aVAFwI0_Gr0_Cr1lIxAI cVC2z280aVCY1x0267AKxVW8JVW8JrUvcSsGvfC2KfnxnUUI43ZEXa7IU0XVy3UUUUU== X-CM-SenderInfo: asqsiiirqrkko6kx23oohg3hdfq/ 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 --- .../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 ============ 内核开发工具 ============ -本文档是有关内核开发工具文档的合集。 -目前这些文档已经整理在一起,不需要再花费额外的精力。 -欢迎任何补丁。 +本文档收集了用于内核开发的工具文档。目前这些文档只是汇集在一起,尚未充分整理成一份连贯的指南;欢迎提交补丁! -有关测试专用工具的简要概述,参见 -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 通过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 ”或“help function ”命令 获取指定命令或指定调试功能的更多详细信息。 + +调试 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 +.. _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