From mboxrd@z Thu Jan 1 00:00:00 1970 Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.remote-ip=95.215.58.230 ARC-Seal: i=1; d=subspace.kernel.org; s=arc20261015; a=rsa-sha256; cv=none; t=1793320726; b=xj4Y2+hRVkIVzlds2am1NPq8xalWVMQx13RyS+YRm+6DWwD5cbsPkOYkhn/O+etD7RhS XjSB4BRjfRiai+HwApH3/gTBN0TrEYmUiu2kBzdEPb9Jpkh8LP2Vgh/J5+M+FPAGvZLgp noXLBHLhxY26dNYs69czlVGllbSX9r3KzrZ49FEUQzrYEORTj/dpdHHHRENy3PIArdljD olO3tAxpIj74G+0RWTGAQYzIcFkCLUFjR/N0dQVJVAgUobdp96fGbb2G/kCrqMffGxn4B Y7A2XIvgqOqlFPfk0bdg6FXkWua9BZrIzAyciv0waW5ACnVXLbzRNR9wKavkcFZh/KA== ARC-Message-Signature: i=1; d=subspace.kernel.org; s=arc20261015; a=rsa-sha256; c=relaxed/relaxed; t=1793320726; h=DMARC-Filter:X-Envelope-To:DKIM-Signature:X-Envelope-To:Received: X-Mizu-Trace-ID:X-Migadu-Flow:Message-ID:Date:MIME-Version:User-Agent: Subject:To:Cc:References:Content-Language:From:In-Reply-To: Content-Type:Content-Transfer-Encoding; bh=J6AO5iwJua3wSUKXq7JQ0GRWveMiXiy9MHn5yIPX6+M=; b=wfFtDaHsYZgT6Ae8zxp9U5LVZnaAA6w52kpkznFywUO3Pd4AYi5tzgk98vusNUzH4ECY 8SioYfQVh1SK+1NfTn+Q8txTOW8gL5KMcQxJknyWmxbFR7vUajjgXKEFUDMceyTsa2+DA iWYwYTh017MB7ygMjMb4Gxh862lJThkT5AsoIyjjhiaWEqzwXrxXiR6JhnrwEA2aSf/Ah e3RfO10pOGzrVxL8sLXTl9+IjOFTJL1Uh7uA7AYGA3FZocbmH+632iAikZUxPaVMfoEpf sY0W7Jy5qNyCO+S0o/ifwcqHSNlcY99Y6Rf3bJqA4+Ak2HuvnFthYnq6dCAGEe44m9Q== ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass header.from=linux.dev; spf=pass smtp.mailfrom=linux.dev; dkim=pass header.d=linux.dev header.i=@linux.dev header.a=rsa-sha256 header.s=key1 header.b=qkqJzT1V; arc=none smtp.remote-ip=95.215.58.230 Received: from mta1.migadu.com (out-230.mta1.migadu.com [95.215.58.230]) (using TLSv1.3 with cipher TLS_AES_128_GCM_SHA256 (128/128 bits) key-exchange X25519 server-signature ECDSA (prime256v1) server-digest SHA256) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id C4EF5606A31A for ; Fri, 30 Oct 2026 00:38:44 +0000 (UTC) DMARC-Filter: OpenDMARC Filter v1.4.2 smtp.subspace.kernel.org C4EF5606A31A Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=linux.dev Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=linux.dev Authentication-Results: smtp.subspace.kernel.org; dkim=pass (1024-bit key, unprotected) header.d=linux.dev header.i=@linux.dev header.a=rsa-sha256 header.s=key1 header.b=qkqJzT1V X-Envelope-To: linux-kernel@vger.kernel.org DKIM-Signature: a=rsa-sha256; bh=vxAClMAETmotJ8WMibjPFifJuGZdlwrE/indgpYj/J4=; c=simple/simple; d=linux.dev; h=from:to:subject:date:message-id:mime-version:content-type; s=key1; t=1793320722; v=1; x=1793925522; b=qkqJzT1VmSFmJwVcaNvKkH72ZbagCFYMwi5XWDdW0qcxQJt6vAxmRwqnmvWrztiGpa32mAGF NWe0B/pg1SwushCmfxlDiwZ2KDfw1yUtcZ7hS02o5ZOAGQsOJNzAI8NEJ2VPZ5MHjRBtFcyv6AH hVuAhhNE+VrO7/PEzi+Gjlss= X-Envelope-To: linux-kernel@vger.kernel.org Received: by smtp.migadu.com with ESMTPS id d4ce0f56de47b696; Fri, 30 Oct 2026 00:38:42 +0000 X-Mizu-Trace-ID: d4ce0f56de47b696 X-Migadu-Flow: FLOW_OUT Message-ID: Date: Fri, 30 Oct 2026 08:38:36 +0800 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 User-Agent: Mozilla Thunderbird Subject: Re: [PATCH v3 2/9] docs/zh_CN: update admin-guide/README.rst translation To: Dongliang Mu , Alex Shi Cc: Jonathan Corbet , Shuah Khan , Randy Dunlap , Weijie Yuan , Chen-Yu Yeh , linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org References: <20261029124429.294868-1-dzm91@hust.edu.cn> <20261029124429.294868-3-dzm91@hust.edu.cn> Content-Language: en-US From: Yanteng Si In-Reply-To: <20261029124429.294868-3-dzm91@hust.edu.cn> Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 8bit 在 2026/10/29 20:44, Dongliang Mu 写道: > update Documentation/admin-guide/README.rst Chinese translation > > Refresh the kernel installation guidance and correct the defconfig and > LSMOD descriptions. Add a label to the translated applying-patches guide > so the README can link to it. > > Update the translation through commit 8913632998fc > ("Documentation: Fix typos and grammatical errors") > > Signed-off-by: Dongliang Mu Reviewed-by: Yanteng Si > --- > .../translations/zh_CN/admin-guide/README.rst | 87 +++++++++++-------- > .../zh_CN/process/applying-patches.rst | 2 + > 2 files changed, 51 insertions(+), 38 deletions(-) > > diff --git a/Documentation/translations/zh_CN/admin-guide/README.rst b/Documentation/translations/zh_CN/admin-guide/README.rst > index ee6dd3782f4a..06d0172b2ee3 100644 > --- a/Documentation/translations/zh_CN/admin-guide/README.rst > +++ b/Documentation/translations/zh_CN/admin-guide/README.rst > @@ -1,6 +1,5 @@ > .. include:: ../disclaimer-zh_CN.rst > > -:Original: Documentation/admin-guide/README.rst > > :译者: > > @@ -30,7 +29,7 @@ Linux内核6.x版本 > > 虽然Linux最初是为32位的x86 PC机（386或更高版本）开发的，但今天它也能运行在 > （至少）Compaq Alpha AXP、Sun SPARC与UltraSPARC、Motorola 68000、PowerPC、 > - PowerPC64、ARM、Hitachi SuperH、Cell、IBM S/390、MIPS、HP PA-RISC、Intel > + PowerPC64、ARM、Hitachi SuperH、Cell、IBM S/390、MIPS、HP PA-RISC、Intel > IA-64、DEC VAX、AMD x86-64 Xtensa和ARC架构上。 > > Linux很容易移植到大多数通用的32位或64位体系架构，只要它们有一个分页内存管理 > @@ -42,15 +41,12 @@ Linux内核6.x版本 > > 文档 > ----- > -因特网上和书籍上都有大量的电子文档，既有Linux专属文档，也有与一般UNIX问题相关 > -的文档。我建议在任何Linux FTP站点上查找LDP（Linux文档项目）书籍的文档子目录。 > -本自述文件并不是关于系统的文档：有更好的可用资源。 > > - - 因特网上和书籍上都有大量的（电子）文档，既有Linux专属文档，也有与普通 > - UNIX问题相关的文档。我建议在任何有LDP（Linux文档项目）书籍的Linux FTP > - 站点上查找文档子目录。本自述文件并不是关于系统的文档：有更好的可用资源。 > + - 因特网上有大量电子文档，书籍中也有丰富资料，既包括 Linux 专属内容，也包括 > + 一般 UNIX 问题。在任何 Linux FTP 站点的文档子目录中，都可以查找 > + LDP（Linux 文档项目）的书籍。本 README 并非系统使用手册；另有更好的资料。 > > - - 文档/子目录中有各种自述文件：例如，这些文件通常包含一些特定驱动程序的 > + - ``Documentation/`` 子目录中有各种 README 文件：它们通常包含特定驱动程序的 > 内核安装说明。请阅读 > :ref:`Documentation/process/changes.rst ` 文件，它包含了升级内核 > 可能会导致的问题的相关信息。 > @@ -82,8 +78,8 @@ Linux内核6.x版本 > 直接应用于基本的6.x内核。例如，如果您的基本内核是6.0，并且希望应用6.0.3 > 补丁，则不应先应用6.0.1和6.0.2的补丁。类似地，如果您运行的是6.0.2内核， > 并且希望跳转到6.0.3，那么在应用6.0.3补丁之前，必须首先撤销6.0.2补丁 > - （即patch -R）。更多关于这方面的内容，请阅读 > - Documentation/translations/zh_CN/process/applying-patches.rst 。 > + （即 ``patch -R``）。有关这方面的更多内容，请参阅 > + :ref:`Documentation/translations/zh_CN/process/applying-patches.rst `。 > > 或者，脚本 patch-kernel 可以用来自动化这个过程。它能确定当前内核版本并 > 应用找到的所有补丁:: > @@ -154,13 +150,14 @@ Linux内核6.x版本 > "make olddefconfig" > 类似上一个，但不询问直接将新选项设置为默认值。 > > - "make defconfig" 根据体系架构，使用arch/$arch/defconfig或 > - arch/$arch/configs/${PLATFORM}_defconfig中的 > - 默认选项值创建./.config文件。 > + "make defconfig" 根据体系架构，使用 > + arch/$ARCH/configs/defconfig 或 > + arch/$ARCH/configs/${PLATFORM}_defconfig 中的 > + 默认选项值创建 ./.config 文件。 > > "make ${PLATFORM}_defconfig" > - 使用arch/$arch/configs/${PLATFORM}_defconfig中 > - 的默认选项值创建一个./.config文件。 > + 使用 arch/$ARCH/configs/${PLATFORM}_defconfig 中 > + 的默认选项值创建一个 ./.config 文件。 > 用“make help”来获取您体系架构中所有可用平台的列表。 > > "make allyesconfig" > @@ -180,7 +177,7 @@ Linux内核6.x版本 > 已加载的模块不需要的任何模块选项。 > > 要为另一台计算机创建localmodconfig，请将该计算机 > - 的lsmod存储到一个文件中，并将其作为lsmod参数传入。 > + 的 lsmod 输出存储到文件中，并通过 LSMOD 参数传入。 > > 此外，通过在参数LMC_KEEP中指定模块的路径，可以将 > 模块保留在某些文件夹或kconfig文件中。 > @@ -216,10 +213,10 @@ Linux内核6.x版本 > 这种情况下，数学仿真永远不会被使用。内核会稍微大一点，但不管 > 是否有数学协处理器，都可以在不同的机器上工作。 > > - - “kernel hacking”配置细节通常会导致更大或更慢的内核（或两者 > - 兼而有之），甚至可以通过配置一些例程来主动尝试破坏坏代码以发现 > - 内核问题，从而降低内核的稳定性（kmalloc()）。因此，您可能应该 > - 用于研究“开发”、“实验”或“调试”特性相关问题。 > + - “kernel hacking”配置选项细节通常会使内核体积更大、运行更慢，或者 > + 两者兼有。某些选项还会让例程主动触发有问题的代码，以发现内核问题 > + （例如 ``kmalloc()``），从而降低内核的稳定性。因此，对于“开发”、 > + “实验”或“调试”功能，通常应回答 ``n``。 > > 编译内核 > --------- > @@ -227,8 +224,9 @@ Linux内核6.x版本 > - 确保您至少有gcc 8.1可用。 > 有关更多信息，请参阅 :ref:`Documentation/process/changes.rst ` 。 > > - - 执行 ``make`` 来创建压缩内核映像。如果您安装了lilo以适配内核makefile， > - 那么也可以进行 ``make install`` ，但是您可能需要先检查特定的lilo设置。 > + - 执行 ``make`` 来创建压缩内核映像。如果安装了 LILO，或发行版提供了内核 > + 安装程序可以识别的安装脚本，也可以执行 ``make install``。多数常见发行版 > + 都提供这样的脚本；请先检查发行版的安装方式。 > > 实际安装必须以root身份执行，但任何正常构建都不需要。 > 无须徒然使用root身份。 > @@ -244,7 +242,8 @@ Linux内核6.x版本 > > make V=1 all > > - 如需构建系统也给出内个目标重建的愿意，请使用 ``V=2`` 。默认为 ``V=0`` 。 > + 若还需要构建系统说明每个目标重新构建的原因，请使用 ``V=2``。 > + 默认值为 ``V=0``。 > > - 准备一个备份内核以防出错。对于开发版本尤其如此，因为每个新版本都包含 > 尚未调试的新代码。也要确保保留与该内核对应的模块的备份。如果要安装 > @@ -257,23 +256,35 @@ Linux内核6.x版本 > - 为了引导新内核，您需要将内核映像（例如编译后的 > .../linux/arch/x86/boot/bzImage）复制到常规可引导内核的位置。 > > - - 不再支持在没有LILO等启动装载程序帮助的情况下直接从软盘引导内核。 > + - 在 BIOS（非 EFI）系统上，已不再支持不借助 LILO 或 GRUB 等引导加载程序， > + 直接从存储设备启动内核。在 UEFI/EFI 系统上，可以使用 EFISTUB，让主板 > + 直接启动内核。不过，对于现代工作站和台式机，通常建议使用引导加载程序， > + 因为安装多个内核或启用安全启动时可能遇到困难。有关 EFISTUB 的详情， > + 请参阅 ``Documentation/admin-guide/efi-stub.rst``。 > > - 如果从硬盘引导Linux，很可能使用LILO，它使用/etc/lilo.conf文件中 > - 指定的内核映像文件。内核映像文件通常是/vmlinuz、/boot/vmlinuz、 > - /bzImage或/boot/bzImage。使用新内核前，请保存旧映像的副本，并复制 > - 新映像覆盖旧映像。然后您【必须重新运行LILO】来更新加载映射！否则， > - 将无法启动新的内核映像。 > + - 请注意，LILO（LInux LOader）自 2016 年起就不再积极开发。它曾经非常流行， > + 因此仍常见于文档。常见的替代方案包括 GRUB2、rEFInd、Syslinux、 > + systemd-boot 和 EFISTUB。由于多种原因，不建议使用已经停止积极开发的软件。 > > - 重新安装LILO通常需要运行/sbin/LILO。您可能希望编辑/etc/lilo.conf > - 文件为旧内核映像指定一个条目（例如/vmlinux.old)防止新的不能正常 > - 工作。有关更多信息，请参阅LILO文档。 > + - 您的发行版很可能提供了安装脚本，这时运行 ``make install`` 就足够了。 > + 如果没有，则需要确认所用的引导加载程序并查阅其文档，或配置 EFI。 > > - 重新安装LILO之后，您应该就已经准备好了。关闭系统，重新启动，尽情 > - 享受吧！ > +旧版 LILO 操作说明 > +------------------ > > - 如果需要更改内核映像中的默认根设备、视频模式等，请在适当的地方使用 > - 启动装载程序的引导选项。无需重新编译内核即可更改这些参数。 > + - 如果使用 LILO，内核映像在 ``/etc/lilo.conf`` 中指定。映像文件通常是 > + ``/vmlinuz``、``/boot/vmlinuz``、``/bzImage`` 或 ``/boot/bzImage``。 > + 要使用新内核，请先保存旧映像的副本，再用新映像覆盖旧映像。然后 > + **必须重新运行 LILO** 来更新加载映射！否则将无法启动新内核映像。 > + > + - 重新安装 LILO 通常只需运行 ``/sbin/lilo``。可以编辑 ``/etc/lilo.conf``， > + 为旧内核映像（例如 ``/vmlinux.old``）保留一个条目，以防新内核无法工作。 > + 更多信息请参阅 LILO 文档。 > + > + - 重新安装 LILO 后就可以关闭系统、重新启动并使用新内核了。 > + > + - 如果需要更改内核映像中的默认根设备、视频模式等，请在适当情况下使用 > + 引导加载程序的启动选项。无须为更改这些参数而重新编译内核。 > > - 使用新内核重新启动并享受它吧。 > > @@ -287,5 +298,5 @@ Documentation/translations/zh_CN/admin-guide/reporting-issues.rst 。 > Documentation/translations/zh_CN/admin-guide/bug-hunting.rst 。 > > 更多用GDB调试内核的信息，请参阅： > -Documentation/translations/zh_CN/dev-tools/gdb-kernel-debugging.rst > +Documentation/translations/zh_CN/process/debugging/gdb-kernel-debugging.rst > 和 Documentation/process/debugging/kgdb.rst 。 > diff --git a/Documentation/translations/zh_CN/process/applying-patches.rst b/Documentation/translations/zh_CN/process/applying-patches.rst > index c056b241b0cd..fb76a0b69f5c 100644 > --- a/Documentation/translations/zh_CN/process/applying-patches.rst > +++ b/Documentation/translations/zh_CN/process/applying-patches.rst > @@ -8,6 +8,8 @@ > > 袁维杰 Weijie Yuan > > +.. _zh_applying_patches: > + > 将补丁应用到 Linux 内核 > +++++++++++++++++++++++ >