[PATCH v2 5/9] docs/zh_CN: update magic-number to match upstream

From: Dongliang Mu

Date: Tue Oct 27 2026 - 23:47:05 EST

Update the Chinese magic-number guide to match its English source.
Move it from process to staging and update the staging index.

Synchronize the translation with upstream revision dd8d4bc28ad7.

Signed-off-by: Dongliang Mu <dzm91@xxxxxxxxxxx>
---
.../translations/zh_CN/staging/index.rst | 6 ++--
.../{process => staging}/magic-number.rst | 35 +++++++++----------
2 files changed, 19 insertions(+), 22 deletions(-)
rename Documentation/translations/zh_CN/{process => staging}/magic-number.rst (58%)

diff --git a/Documentation/translations/zh_CN/staging/index.rst b/Documentation/translations/zh_CN/staging/index.rst
index 6d68fabce175..896734ade5eb 100644
--- a/Documentation/translations/zh_CN/staging/index.rst
+++ b/Documentation/translations/zh_CN/staging/index.rst
@@ -1,8 +1,6 @@
.. SPDX-License-Identifier: GPL-2.0
.. include:: ../disclaimer-zh_CN.rst

-:Original: Documentation/staging/index.rst
-
:翻译:

李睿 Rui Li <me@xxxxxxxxx>
@@ -13,14 +11,14 @@
.. toctree::
:maxdepth: 2

+ magic-number
speculation
xz

-TODOList:
+Todolist:

* crc32
* lzo
* remoteproc
* rpmsg
* static-keys
-* tee
diff --git a/Documentation/translations/zh_CN/process/magic-number.rst b/Documentation/translations/zh_CN/staging/magic-number.rst
similarity index 58%
rename from Documentation/translations/zh_CN/process/magic-number.rst
rename to Documentation/translations/zh_CN/staging/magic-number.rst
index 05ee75cf4346..2cb46a6e343b 100644
--- a/Documentation/translations/zh_CN/process/magic-number.rst
+++ b/Documentation/translations/zh_CN/staging/magic-number.rst
@@ -1,7 +1,5 @@
.. include:: ../disclaimer-zh_CN.rst

-:Original: Documentation/staging/magic-number.rst
-
:翻译:

贾威威 Jia Wei Wei <harryxiyou@xxxxxxxxx>
@@ -10,16 +8,18 @@

司延腾 Yanteng Si <siyanteng@xxxxxxxxxxx>

+.. _magicnumbers_zh:
+
Linux 魔术数
============

-这个文件是有关当前使用的魔术值注册表。当你给一个结构体添加了一个魔术值，你也
-应该把这个魔术值添加到这个文件，因为我们最好把用于各种结构体的魔术值统一起来。
+本文档登记当前使用的魔术数。给结构体添加魔术数时，也应将其登记在这里，
+因为不同结构体使用的魔术数最好互不相同。

-使用魔术值来保护内核数据结构是一个 **非常好的主意** 。这就允许你在运行时检
-查一个结构体(a)是否已经被攻击，或者(b)你已经给一个例程传递了一个错误的结构
-体。最后一种情况特别地有用---特别是当你通过一个空指针指向结构体的时候。例如，
-tty源码经常通过特定驱动使用这种方法用来反复地排列特定方面的结构体。
+用魔术数保护内核数据结构是一个 **非常好的主意**。这样可以在运行时检查：
+（a）结构体是否被意外覆盖，或（b）是否向函数传入了错误的结构体。后一种情况
+尤其常见于通过 ``void *`` 指针传递结构体指针时。例如，tty 代码经常这样
+在驱动专用结构体和线路规程专用结构体之间传递指针。

使用魔术值的方法是在结构体的开头声明它们，如下::

@@ -28,30 +28,29 @@ tty源码经常通过特定驱动使用这种方法用来反复地排列特定
...
};

-当你以后给内核添加增强功能的时候，请遵守这条规则！这样就会节省数不清的调试
-时间，特别是一些古怪的情况，例如，数组超出范围并且覆盖写了超出部分。利用这
-个规则，这些情况可以被快速地，安全地检测到这些案例。
+今后扩展内核时，请遵循这一做法！它能节省大量调试时间，尤其是在数组越界并
+覆盖后续结构体等难以排查的情况下。使用魔术数可以快速、安全地发现这些问题。

变更日志::

Theodore Ts'o
31 Mar 94

- 给当前的Linux 2.1.55添加魔术表。
+ 此魔术数表已更新至 Linux 2.1.55。

Michael Chastain
<mailto:mec@xxxxxxxxx>
22 Sep 1997

- 现在应该最新的Linux 2.1.112.因为在特性冻结期间，不能在2.2.x前改变任
- 何东西。这些条目被数域所排序。
+ 此表现在应已更新至 Linux 2.1.112。由于目前处于功能冻结期，在 2.2.x
+ 发布前不太可能再发生变化。条目按数值字段排序。

Krzysztof G.Baranowski
<mailto: kgb@xxxxxxxxxx>
29 Jul 1998

- 更新魔术表到Linux 2.5.45。刚好越过特性冻结，但是有可能还会有一些新的魔
- 术值在2.6.x之前融入到内核中。
+ 将魔术数表更新至 Linux 2.5.45。虽然刚进入功能冻结期，2.6.x 发布前
+ 仍可能有新的魔术数进入内核。

Petr Baudis
<pasky@xxxxxx>
@@ -66,10 +65,10 @@ tty源码经常通过特定驱动使用这种方法用来反复地排列特定
===================== ================ ======================== ==========================================
魔术数名数字结构文件
===================== ================ ======================== ==========================================
-PG_MAGIC 'P' pg_{read,write}_hdr ``include/linux/pg.h``
+PG_MAGIC 'P' pg_{read,write}_hdr ``include/uapi/linux/pg.h``
APM_BIOS_MAGIC 0x4101 apm_user ``arch/x86/kernel/apm_32.c``
FASYNC_MAGIC 0x4601 fasync_struct ``include/linux/fs.h``
-SLIP_MAGIC 0x5302 slip ``drivers/net/slip.h``
+SLIP_MAGIC 0x5302 slip ``drivers/net/slip/slip.h``
KV_MAGIC 0x5f4b565f kernel_vars_s ``arch/mips/include/asm/sn/klkernvars.h``
CODA_MAGIC 0xC0DAC0DA coda_file_info ``fs/coda/coda_fs_i.h``
CCB_MAGIC 0xf2691ad2 ccb ``drivers/scsi/ncr53c8xx.c``
--
2.51.0