[PATCH v5 0/5] docs/zh_CN: Add Chinese translations for five networking documents

[PATCH v5 0/5] docs/zh_CN: Add Chinese translations for five networking documents

[Siwei Chen]

From: Siwei Chen <businiaoanka@anka1.top>

This series adds Simplified Chinese translations for five documents
under Documentation/networking/:

  - team.rst: Team devices driven from userspace via libteam
  - sriov.rst: NIC SR-IOV APIs (switchdev model and legacy API)
  - driver.rst: Softnet driver issues (probing, close/stop,
    transmit path guidelines, and extack error reporting)
  - ipv6.rst: ipv6 module parameters (disable, autoconf,
    disable_ipv6)
  - secid.rst: LSM/SELinux secid usage in the flowi structure

Changes in v5:
  - Use direct link instead of ":ref:" to fix the warning of 
    "undefined label" in the translation of "sriov.rst" since "switchdev" 
    documentation has no translation in the same directory.
  - Revise the commit title: "SeLinux" -> "SELinux".
  - Translate "flowi structure" and "flow structure" into 
    "flowi structure" uniformly in the translation of "secid.rst".
  - Link to v4: https://lore.kernel.org/linux-doc/20260817021340.17318-1-anka@stu.cdut.edu.cn/

Changes in v4:
  - Fix two minor issues in the translation of "ipv6.rst" and "secid.rst".
  - Link to v3: https://lore.kernel.org/linux-doc/20260811071200.54062-1-anka@stu.cdut.edu.cn/

Changes in v3:
  - Remove spaces before and after "（".
  - Add a missing space after "IPv6".
  - Update the translation of "secid".
  - Link to v2: https://lore.kernel.org/linux-doc/20260727073538.56951-1-anka@stu.cdut.edu.cn/

Changes in v2:
  - Add translated documents to corresponding index file.
  - Link to v1: https://lore.kernel.org/linux-doc/cover.1784866896.git.businiaoanka@anka1.top/

Siwei Chen (5):
  docs/zh_CN: Add networking team documentation Chinese translation
  docs/zh_CN: Add NIC SR-IOV APIs Chinese translation
  docs/zh_CN: Add Softnet Driver Issues Chinese translation
  docs/zh_CN: Add ipv6 Chinese translation
  docs/zh_CN: Add LSM/SELinux secid Chinese translation

 .../translations/zh_CN/networking/driver.rst  | 138 ++++++++++++++++++
 .../translations/zh_CN/networking/index.rst   |  10 +-
 .../translations/zh_CN/networking/ipv6.rst    |  76 ++++++++++
 .../translations/zh_CN/networking/secid.rst   |  24 +++
 .../translations/zh_CN/networking/sriov.rst   |  34 +++++
 .../translations/zh_CN/networking/team.rst    |  16 ++
 6 files changed, 293 insertions(+), 5 deletions(-)
 create mode 100644 Documentation/translations/zh_CN/networking/driver.rst
 create mode 100644 Documentation/translations/zh_CN/networking/ipv6.rst
 create mode 100644 Documentation/translations/zh_CN/networking/secid.rst
 create mode 100644 Documentation/translations/zh_CN/networking/sriov.rst
 create mode 100644 Documentation/translations/zh_CN/networking/team.rst

-- 
2.53.0

[PATCH v5 1/5] docs/zh_CN: Add networking team documentation Chinese translation

[Siwei Chen]

From: Siwei Chen <businiaoanka@anka1.top>

Translate .../networking/team.rst into Chinese.

Update the translation through commit aa8a6ee3e3fc
("docs: networking: convert team.txt to ReST")

Signed-off-by: Siwei Chen <businiaoanka@anka1.top>
---
 .../translations/zh_CN/networking/index.rst      |  2 +-
 .../translations/zh_CN/networking/team.rst       | 16 ++++++++++++++++
 2 files changed, 17 insertions(+), 1 deletion(-)
 create mode 100644 Documentation/translations/zh_CN/networking/team.rst

diff --git a/Documentation/translations/zh_CN/networking/index.rst b/Documentation/translations/zh_CN/networking/index.rst
index 333e9f6cafff..fcb8dc8f2c72 100644
--- a/Documentation/translations/zh_CN/networking/index.rst
+++ b/Documentation/translations/zh_CN/networking/index.rst
@@ -29,6 +29,7 @@
    alias
    mptcp-sysctl
    generic-hdlc
+   team
    timestamping
 
 Todolist:
@@ -136,7 +137,6 @@ Todolist:
 *   tc-queue-filters
 *   tcp_ao
 *   tcp-thin
-*   team
 *   tipc
 *   tproxy
 *   tuntap
diff --git a/Documentation/translations/zh_CN/networking/team.rst b/Documentation/translations/zh_CN/networking/team.rst
new file mode 100644
index 000000000000..e6cf19a245a1
--- /dev/null
+++ b/Documentation/translations/zh_CN/networking/team.rst
@@ -0,0 +1,16 @@
+.. SPDX-License-Identifier: GPL-2.0
+
+.. include:: ../disclaimer-zh_CN.rst
+
+:Original: Documentation/networking/team.rst
+
+:翻译:
+
+	陈思为 Siwei Chen <businiaoanka@anka1.top>
+
+====================
+Team（网络接口聚合）
+====================
+
+Team 设备由用户空间通过 libteam 库驱动，该库位于：
+	https://github.com/jpirko/libteam
-- 
2.53.0

Re: [PATCH v5 1/5] docs/zh_CN: Add networking team documentation Chinese translation

[Dongliang Mu]

On 8/24/26 12:38 PM, Siwei Chen wrote:
> From: Siwei Chen <businiaoanka@anka1.top>
>
> Translate .../networking/team.rst into Chinese.
>
> Update the translation through commit aa8a6ee3e3fc
> ("docs: networking: convert team.txt to ReST")
>
> Signed-off-by: Siwei Chen <businiaoanka@anka1.top>
Reviewed-by: Dongliang Mu <dzm91@hust.edu.cn>
> ---
>   .../translations/zh_CN/networking/index.rst      |  2 +-
>   .../translations/zh_CN/networking/team.rst       | 16 ++++++++++++++++
>   2 files changed, 17 insertions(+), 1 deletion(-)
>   create mode 100644 Documentation/translations/zh_CN/networking/team.rst
>
> diff --git a/Documentation/translations/zh_CN/networking/index.rst b/Documentation/translations/zh_CN/networking/index.rst
> index 333e9f6cafff..fcb8dc8f2c72 100644
> --- a/Documentation/translations/zh_CN/networking/index.rst
> +++ b/Documentation/translations/zh_CN/networking/index.rst
> @@ -29,6 +29,7 @@
>      alias
>      mptcp-sysctl
>      generic-hdlc
> +   team
>      timestamping
>   
>   Todolist:
> @@ -136,7 +137,6 @@ Todolist:
>   *   tc-queue-filters
>   *   tcp_ao
>   *   tcp-thin
> -*   team
>   *   tipc
>   *   tproxy
>   *   tuntap
> diff --git a/Documentation/translations/zh_CN/networking/team.rst b/Documentation/translations/zh_CN/networking/team.rst
> new file mode 100644
> index 000000000000..e6cf19a245a1
> --- /dev/null
> +++ b/Documentation/translations/zh_CN/networking/team.rst
> @@ -0,0 +1,16 @@
> +.. SPDX-License-Identifier: GPL-2.0
> +
> +.. include:: ../disclaimer-zh_CN.rst
> +
> +:Original: Documentation/networking/team.rst
> +
> +:翻译:
> +
> +	陈思为 Siwei Chen <businiaoanka@anka1.top>
> +
> +====================
> +Team（网络接口聚合）
> +====================
> +
> +Team 设备由用户空间通过 libteam 库驱动，该库位于：
> +	https://github.com/jpirko/libteam

[PATCH v5 2/5] docs/zh_CN: Add NIC SR-IOV APIs Chinese translation

[Siwei Chen]

From: Siwei Chen <businiaoanka@anka1.top>

Translate .../networking/sriov.rst into Chinese.

Update the translation through commit 4558645d139c
("docs: net: document guidance of implementing the SR-IOV NDOs")

Signed-off-by: Siwei Chen <businiaoanka@anka1.top>
---
 .../translations/zh_CN/networking/index.rst   |  2 +-
 .../translations/zh_CN/networking/sriov.rst   | 34 +++++++++++++++++++
 2 files changed, 35 insertions(+), 1 deletion(-)
 create mode 100644 Documentation/translations/zh_CN/networking/sriov.rst

diff --git a/Documentation/translations/zh_CN/networking/index.rst b/Documentation/translations/zh_CN/networking/index.rst
index fcb8dc8f2c72..ae374c4cb144 100644
--- a/Documentation/translations/zh_CN/networking/index.rst
+++ b/Documentation/translations/zh_CN/networking/index.rst
@@ -29,6 +29,7 @@
    alias
    mptcp-sysctl
    generic-hdlc
+   sriov
    team
    timestamping
 
@@ -128,7 +129,6 @@ Todolist:
 *   secid
 *   seg6-sysctl
 *   smc-sysctl
-*   sriov
 *   statistics
 *   strparser
 *   switchdev
diff --git a/Documentation/translations/zh_CN/networking/sriov.rst b/Documentation/translations/zh_CN/networking/sriov.rst
new file mode 100644
index 000000000000..d5e16a099b07
--- /dev/null
+++ b/Documentation/translations/zh_CN/networking/sriov.rst
@@ -0,0 +1,34 @@
+.. SPDX-License-Identifier: GPL-2.0
+
+.. include:: ../disclaimer-zh_CN.rst
+
+:Original: Documentation/networking/sriov.rst
+
+:翻译:
+
+	陈思为 Siwei Chen <businiaoanka@anka1.top>
+
+===============
+网卡 SR-IOV API
+===============
+
+强烈建议现代网卡专注于实现 ``switchdev`` 模型
+（参见 `以太网交换机设备驱动模型（switchdev）`_）
+来配置 SR-IOV 功能的转发与安全。
+
+传统 API
+========
+
+旧的 SR-IOV API 在 ``rtnetlink`` Netlink 协议族中实现，是 ``RTM_GETLINK`` 和
+``RTM_SETLINK`` 命令的一部分。在驱动侧，它由若干 ``ndo_set_vf_*`` 和
+``ndo_get_vf_*`` 回调组成。
+
+由于传统 API 与协议栈其余部分集成不佳，该 API 被视为已冻结；不再接受任何新功能或扩展。
+新驱动不应实现那些不常用的回调；
+即以下回调禁止使用：
+
+ - ``ndo_get_vf_port``
+ - ``ndo_set_vf_port``
+ - ``ndo_set_vf_rss_query_en``
+
+.. _`以太网交换机设备驱动模型（switchdev）`: https://docs.kernel.org/networking/switchdev.html#switchdev
-- 
2.53.0

Re: [PATCH v5 2/5] docs/zh_CN: Add NIC SR-IOV APIs Chinese translation

[Dongliang Mu]

On 8/24/26 12:38 PM, Siwei Chen wrote:
> From: Siwei Chen <businiaoanka@anka1.top>
>
> Translate .../networking/sriov.rst into Chinese.
>
> Update the translation through commit 4558645d139c
> ("docs: net: document guidance of implementing the SR-IOV NDOs")
>
> Signed-off-by: Siwei Chen <businiaoanka@anka1.top>
Reviewed-by: Dongliang Mu <dzm91@hust.edu.cn>
> ---
>   .../translations/zh_CN/networking/index.rst   |  2 +-
>   .../translations/zh_CN/networking/sriov.rst   | 34 +++++++++++++++++++
>   2 files changed, 35 insertions(+), 1 deletion(-)
>   create mode 100644 Documentation/translations/zh_CN/networking/sriov.rst
>
> diff --git a/Documentation/translations/zh_CN/networking/index.rst b/Documentation/translations/zh_CN/networking/index.rst
> index fcb8dc8f2c72..ae374c4cb144 100644
> --- a/Documentation/translations/zh_CN/networking/index.rst
> +++ b/Documentation/translations/zh_CN/networking/index.rst
> @@ -29,6 +29,7 @@
>      alias
>      mptcp-sysctl
>      generic-hdlc
> +   sriov
>      team
>      timestamping
>   
> @@ -128,7 +129,6 @@ Todolist:
>   *   secid
>   *   seg6-sysctl
>   *   smc-sysctl
> -*   sriov
>   *   statistics
>   *   strparser
>   *   switchdev
> diff --git a/Documentation/translations/zh_CN/networking/sriov.rst b/Documentation/translations/zh_CN/networking/sriov.rst
> new file mode 100644
> index 000000000000..d5e16a099b07
> --- /dev/null
> +++ b/Documentation/translations/zh_CN/networking/sriov.rst
> @@ -0,0 +1,34 @@
> +.. SPDX-License-Identifier: GPL-2.0
> +
> +.. include:: ../disclaimer-zh_CN.rst
> +
> +:Original: Documentation/networking/sriov.rst
> +
> +:翻译:
> +
> +	陈思为 Siwei Chen <businiaoanka@anka1.top>
> +
> +===============
> +网卡 SR-IOV API
> +===============
> +
> +强烈建议现代网卡专注于实现 ``switchdev`` 模型
> +（参见 `以太网交换机设备驱动模型（switchdev）`_）
> +来配置 SR-IOV 功能的转发与安全。
> +
> +传统 API
> +========
> +
> +旧的 SR-IOV API 在 ``rtnetlink`` Netlink 协议族中实现，是 ``RTM_GETLINK`` 和
> +``RTM_SETLINK`` 命令的一部分。在驱动侧，它由若干 ``ndo_set_vf_*`` 和
> +``ndo_get_vf_*`` 回调组成。
> +
> +由于传统 API 与协议栈其余部分集成不佳，该 API 被视为已冻结；不再接受任何新功能或扩展。
> +新驱动不应实现那些不常用的回调；
> +即以下回调禁止使用：
> +
> + - ``ndo_get_vf_port``
> + - ``ndo_set_vf_port``
> + - ``ndo_set_vf_rss_query_en``
> +
> +.. _`以太网交换机设备驱动模型（switchdev）`: https://docs.kernel.org/networking/switchdev.html#switchdev

[PATCH v5 3/5] docs/zh_CN: Add Softnet Driver Issues Chinese translation

[Siwei Chen]

From: Siwei Chen <businiaoanka@anka1.top>

Translate .../networking/driver.rst into Chinese.

Update the translation through commit 96fbe161e402
("docs: networking: add guidance on what to push via extack")

Signed-off-by: Siwei Chen <businiaoanka@anka1.top>
---
 .../translations/zh_CN/networking/driver.rst  | 138 ++++++++++++++++++
 .../translations/zh_CN/networking/index.rst   |   2 +-
 2 files changed, 139 insertions(+), 1 deletion(-)
 create mode 100644 Documentation/translations/zh_CN/networking/driver.rst

diff --git a/Documentation/translations/zh_CN/networking/driver.rst b/Documentation/translations/zh_CN/networking/driver.rst
new file mode 100644
index 000000000000..acb0863c6b0d
--- /dev/null
+++ b/Documentation/translations/zh_CN/networking/driver.rst
@@ -0,0 +1,138 @@
+.. SPDX-License-Identifier: GPL-2.0
+
+.. include:: ../disclaimer-zh_CN.rst
+
+:Original: Documentation/networking/driver.rst
+
+:翻译:
+
+	陈思为 Siwei Chen <businiaoanka@anka1.top>
+
+================
+Softnet 驱动问题
+================
+
+探测指南
+========
+
+地址校验
+--------
+
+为设备获取的任何硬件层地址都应进行校验。例如，以太网地址应使用
+linux/etherdevice.h 中的 is_valid_ether_addr() 进行检查。
+
+关闭/停止指南
+=============
+
+静默
+----
+
+ndo_stop 例程被调用后，硬件不得再收发任何数据。所有在途报文都必须中止。
+如有必要，应轮询或等待任何复位命令完成。
+
+自动关闭
+--------
+
+若设备仍处于 UP 状态，ndo_stop 例程将由 unregister_netdevice 调用。
+
+发送路径指南
+============
+
+提前停止队列
+------------
+
+ndo_start_xmit 方法在任何正常情况下都不得返回 NETDEV_TX_BUSY。
+除非设备确实无法预先判断其发送功能何时会繁忙，否则返回该值被视为严重错误。
+
+相反，驱动必须正确地维护队列。例如，对于实现分散-聚集
+（scatter-gather）的驱动，这意味着：
+
+.. code-block:: c
+
+	static u32 drv_tx_avail(struct drv_ring *dr)
+	{
+		u32 used = READ_ONCE(dr->prod) - READ_ONCE(dr->cons);
+
+		return dr->tx_ring_size - (used & dr->tx_ring_mask);
+	}
+
+	static netdev_tx_t drv_hard_start_xmit(struct sk_buff *skb,
+					       struct net_device *dev)
+	{
+		struct drv *dp = netdev_priv(dev);
+		struct netdev_queue *txq;
+		struct drv_ring *dr;
+		int idx;
+
+		idx = skb_get_queue_mapping(skb);
+		dr = dp->tx_rings[idx];
+		txq = netdev_get_tx_queue(dev, idx);
+
+		//...
+		/* 这应当是极为罕见的竞争——记录下来。 */
+		if (drv_tx_avail(dr) <= skb_shinfo(skb)->nr_frags + 1) {
+			netif_tx_stop_queue(txq);
+			netdev_warn(dev, "Tx Ring full when queue awake!\n");
+			return NETDEV_TX_BUSY;
+		}
+
+		//... 将报文排队到网卡 ...
+
+		netdev_tx_sent_queue(txq, skb->len);
+
+		//... 使用 WRITE_ONCE() 更新 tx 生产者索引 ...
+
+		if (!netif_txq_maybe_stop(txq, drv_tx_avail(dr),
+					  MAX_SKB_FRAGS + 1, 2 * MAX_SKB_FRAGS))
+			dr->stats.stopped++;
+
+		//...
+		return NETDEV_TX_OK;
+	}
+
+然后在 TX 回收事件处理的末尾：
+
+.. code-block:: c
+
+	//... 使用 WRITE_ONCE() 更新 tx 消费者索引 ...
+
+	netif_txq_completed_wake(txq, cmpl_pkts, cmpl_bytes,
+				 drv_tx_avail(dr), 2 * MAX_SKB_FRAGS);
+
+无锁队列停止/唤醒辅助宏
+~~~~~~~~~~~~~~~~~~~~~~~
+
+.. kernel-doc:: include/net/netdev_queues.h
+   :doc: Lockless queue stopping / waking helpers.
+
+netif_txq_maybe_stop()、netif_txq_try_stop() 等标准宏已经过充分测试，
+请优先使用它们，而非本地同步方案。
+
+无独占所有权
+------------
+
+ndo_start_xmit 方法不得修改被克隆 SKB 的共享部分。
+
+及时完成
+--------
+
+请谨记：一旦 ndo_start_xmit 方法返回 NETDEV_TX_OK，
+驱动就有责任在有限的时间内释放该 SKB。
+
+例如，这意味着不允许你的 TX 缓解方案在没有新 TX 报文发送时，
+让 TX 报文永远“滞留”在 TX 环中而不被回收。
+这种错误会使等待发送缓冲区空间释放的套接字发生死锁。
+
+若 ndo_start_xmit 方法返回 NETDEV_TX_BUSY，
+则不得保留对该 SKB 的任何引用，也不得尝试释放它。
+
+错误消息报告
+============
+
+许多驱动配置接口会向驱动传递一个 Netlink 扩展 ACK（``extack``）对象
+（直接作为参数，或作为参数结构体的成员）。驱动应尽量通过 ``extack`` 对象
+报告大多数错误。表示系统或设备行为异常、处于不良状态的系统级异常，则应继续
+报告到系统日志。
+
+消息应 **要么** 通过 ``extack`` 传递， **要么** 写入系统日志。驱动不应
+试图将同一信息同时报告到两处。
diff --git a/Documentation/translations/zh_CN/networking/index.rst b/Documentation/translations/zh_CN/networking/index.rst
index ae374c4cb144..4675d23a7f28 100644
--- a/Documentation/translations/zh_CN/networking/index.rst
+++ b/Documentation/translations/zh_CN/networking/index.rst
@@ -21,6 +21,7 @@
    :maxdepth: 1
 
    msg_zerocopy
+   driver
    napi
    vxlan
    netif-msg
@@ -76,7 +77,6 @@ Todolist:
 *   dctcp
 *   devmem
 *   dns_resolver
-*   driver
 *   eql
 *   fib_trie
 *   filter
-- 
2.53.0

Re: [PATCH v5 3/5] docs/zh_CN: Add Softnet Driver Issues Chinese translation

[Dongliang Mu]

On 8/24/26 12:38 PM, Siwei Chen wrote:
> From: Siwei Chen <businiaoanka@anka1.top>
>
> Translate .../networking/driver.rst into Chinese.
>
> Update the translation through commit 96fbe161e402
> ("docs: networking: add guidance on what to push via extack")
>
> Signed-off-by: Siwei Chen <businiaoanka@anka1.top>
Reviewed-by: Dongliang Mu <dzm91@hust.edu.cn>
> ---
>   .../translations/zh_CN/networking/driver.rst  | 138 ++++++++++++++++++
>   .../translations/zh_CN/networking/index.rst   |   2 +-
>   2 files changed, 139 insertions(+), 1 deletion(-)
>   create mode 100644 Documentation/translations/zh_CN/networking/driver.rst
>
> diff --git a/Documentation/translations/zh_CN/networking/driver.rst b/Documentation/translations/zh_CN/networking/driver.rst
> new file mode 100644
> index 000000000000..acb0863c6b0d
> --- /dev/null
> +++ b/Documentation/translations/zh_CN/networking/driver.rst
> @@ -0,0 +1,138 @@
> +.. SPDX-License-Identifier: GPL-2.0
> +
> +.. include:: ../disclaimer-zh_CN.rst
> +
> +:Original: Documentation/networking/driver.rst
> +
> +:翻译:
> +
> +	陈思为 Siwei Chen <businiaoanka@anka1.top>
> +
> +================
> +Softnet 驱动问题
> +================
> +
> +探测指南
> +========
> +
> +地址校验
> +--------
> +
> +为设备获取的任何硬件层地址都应进行校验。例如，以太网地址应使用
> +linux/etherdevice.h 中的 is_valid_ether_addr() 进行检查。
> +
> +关闭/停止指南
> +=============
> +
> +静默
> +----
> +
> +ndo_stop 例程被调用后，硬件不得再收发任何数据。所有在途报文都必须中止。
> +如有必要，应轮询或等待任何复位命令完成。
> +
> +自动关闭
> +--------
> +
> +若设备仍处于 UP 状态，ndo_stop 例程将由 unregister_netdevice 调用。
> +
> +发送路径指南
> +============
> +
> +提前停止队列
> +------------
> +
> +ndo_start_xmit 方法在任何正常情况下都不得返回 NETDEV_TX_BUSY。
> +除非设备确实无法预先判断其发送功能何时会繁忙，否则返回该值被视为严重错误。
> +
> +相反，驱动必须正确地维护队列。例如，对于实现分散-聚集
> +（scatter-gather）的驱动，这意味着：
> +
> +.. code-block:: c
> +
> +	static u32 drv_tx_avail(struct drv_ring *dr)
> +	{
> +		u32 used = READ_ONCE(dr->prod) - READ_ONCE(dr->cons);
> +
> +		return dr->tx_ring_size - (used & dr->tx_ring_mask);
> +	}
> +
> +	static netdev_tx_t drv_hard_start_xmit(struct sk_buff *skb,
> +					       struct net_device *dev)
> +	{
> +		struct drv *dp = netdev_priv(dev);
> +		struct netdev_queue *txq;
> +		struct drv_ring *dr;
> +		int idx;
> +
> +		idx = skb_get_queue_mapping(skb);
> +		dr = dp->tx_rings[idx];
> +		txq = netdev_get_tx_queue(dev, idx);
> +
> +		//...
> +		/* 这应当是极为罕见的竞争——记录下来。 */
> +		if (drv_tx_avail(dr) <= skb_shinfo(skb)->nr_frags + 1) {
> +			netif_tx_stop_queue(txq);
> +			netdev_warn(dev, "Tx Ring full when queue awake!\n");
> +			return NETDEV_TX_BUSY;
> +		}
> +
> +		//... 将报文排队到网卡 ...
> +
> +		netdev_tx_sent_queue(txq, skb->len);
> +
> +		//... 使用 WRITE_ONCE() 更新 tx 生产者索引 ...
> +
> +		if (!netif_txq_maybe_stop(txq, drv_tx_avail(dr),
> +					  MAX_SKB_FRAGS + 1, 2 * MAX_SKB_FRAGS))
> +			dr->stats.stopped++;
> +
> +		//...
> +		return NETDEV_TX_OK;
> +	}
> +
> +然后在 TX 回收事件处理的末尾：
> +
> +.. code-block:: c
> +
> +	//... 使用 WRITE_ONCE() 更新 tx 消费者索引 ...
> +
> +	netif_txq_completed_wake(txq, cmpl_pkts, cmpl_bytes,
> +				 drv_tx_avail(dr), 2 * MAX_SKB_FRAGS);
> +
> +无锁队列停止/唤醒辅助宏
> +~~~~~~~~~~~~~~~~~~~~~~~
> +
> +.. kernel-doc:: include/net/netdev_queues.h
> +   :doc: Lockless queue stopping / waking helpers.
> +
> +netif_txq_maybe_stop()、netif_txq_try_stop() 等标准宏已经过充分测试，
> +请优先使用它们，而非本地同步方案。
> +
> +无独占所有权
> +------------
> +
> +ndo_start_xmit 方法不得修改被克隆 SKB 的共享部分。
> +
> +及时完成
> +--------
> +
> +请谨记：一旦 ndo_start_xmit 方法返回 NETDEV_TX_OK，
> +驱动就有责任在有限的时间内释放该 SKB。
> +
> +例如，这意味着不允许你的 TX 缓解方案在没有新 TX 报文发送时，
> +让 TX 报文永远“滞留”在 TX 环中而不被回收。
> +这种错误会使等待发送缓冲区空间释放的套接字发生死锁。
> +
> +若 ndo_start_xmit 方法返回 NETDEV_TX_BUSY，
> +则不得保留对该 SKB 的任何引用，也不得尝试释放它。
> +
> +错误消息报告
> +============
> +
> +许多驱动配置接口会向驱动传递一个 Netlink 扩展 ACK（``extack``）对象
> +（直接作为参数，或作为参数结构体的成员）。驱动应尽量通过 ``extack`` 对象
> +报告大多数错误。表示系统或设备行为异常、处于不良状态的系统级异常，则应继续
> +报告到系统日志。
> +
> +消息应 **要么** 通过 ``extack`` 传递， **要么** 写入系统日志。驱动不应
> +试图将同一信息同时报告到两处。
> diff --git a/Documentation/translations/zh_CN/networking/index.rst b/Documentation/translations/zh_CN/networking/index.rst
> index ae374c4cb144..4675d23a7f28 100644
> --- a/Documentation/translations/zh_CN/networking/index.rst
> +++ b/Documentation/translations/zh_CN/networking/index.rst
> @@ -21,6 +21,7 @@
>      :maxdepth: 1
>   
>      msg_zerocopy
> +   driver
>      napi
>      vxlan
>      netif-msg
> @@ -76,7 +77,6 @@ Todolist:
>   *   dctcp
>   *   devmem
>   *   dns_resolver
> -*   driver
>   *   eql
>   *   fib_trie
>   *   filter

[PATCH v5 4/5] docs/zh_CN: Add ipv6 Chinese translation

[Siwei Chen]

From: Siwei Chen <businiaoanka@anka1.top>

Translate .../networking/ipv6.rst into Chinese.

Update the translation through commit 19093313cb04
("docs: networking: convert ipv6.txt to ReST")

Signed-off-by: Siwei Chen <businiaoanka@anka1.top>
---
 .../translations/zh_CN/networking/index.rst   |  2 +-
 .../translations/zh_CN/networking/ipv6.rst    | 76 +++++++++++++++++++
 2 files changed, 77 insertions(+), 1 deletion(-)
 create mode 100644 Documentation/translations/zh_CN/networking/ipv6.rst

diff --git a/Documentation/translations/zh_CN/networking/index.rst b/Documentation/translations/zh_CN/networking/index.rst
index 4675d23a7f28..cd768d0a2837 100644
--- a/Documentation/translations/zh_CN/networking/index.rst
+++ b/Documentation/translations/zh_CN/networking/index.rst
@@ -22,6 +22,7 @@
 
    msg_zerocopy
    driver
+   ipv6
    napi
    vxlan
    netif-msg
@@ -89,7 +90,6 @@ Todolist:
 *   ip_dynaddr
 *   ipsec
 *   ip-sysctl
-*   ipv6
 *   ipvlan
 *   ipvs-sysctl
 *   kcm
diff --git a/Documentation/translations/zh_CN/networking/ipv6.rst b/Documentation/translations/zh_CN/networking/ipv6.rst
new file mode 100644
index 000000000000..3726b6fdc460
--- /dev/null
+++ b/Documentation/translations/zh_CN/networking/ipv6.rst
@@ -0,0 +1,76 @@
+.. SPDX-License-Identifier: GPL-2.0
+
+.. include:: ../disclaimer-zh_CN.rst
+
+:Original: Documentation/networking/ipv6.rst
+
+:翻译:
+
+	陈思为 Siwei Chen <businiaoanka@anka1.top>
+
+====
+IPv6
+====
+
+
+ipv6 模块的选项在加载时以参数形式提供。
+
+模块选项可作为 insmod 或 modprobe 命令的命令行参数给出，但通常在
+``/etc/modules.d/*.conf`` 配置文件中，或在发行版特定的配置文件中指定。
+
+可用的 ipv6 模块参数如下所列。若未指定某参数，则使用其默认值。
+
+参数如下：
+
+disable
+
+	指定是否在加载 IPv6 模块的同时禁用其全部功能。当另一模块依赖于 IPv6
+	模块已加载，但又不需要任何 IPv6 地址或操作时，可使用此选项。
+
+	可选值及其效果如下：
+
+	0
+		启用 IPv6。
+
+		这是默认值。
+
+	1
+		禁用 IPv6。
+
+		接口不会添加 IPv6 地址，也无法打开 IPv6 套接字。
+
+		需要重启才能启用 IPv6。
+
+autoconf
+
+	指定是否在所有接口上启用 IPv6 地址自动配置。当不希望根据路由器通告
+	（Router Advertisement）中收到的前缀自动生成地址时，可使用此选项。
+
+	可选值及其效果如下：
+
+	0
+		所有接口均禁用 IPv6 地址自动配置。
+
+		仅添加 IPv6 回环地址（::1）与链路本地地址。
+
+	1
+		所有接口均启用 IPv6 地址自动配置。
+
+		这是默认值。
+
+disable_ipv6
+
+	指定是否在所有接口上禁用 IPv6。
+	当不需要任何 IPv6 地址时，可使用此选项。
+
+	可选值及其效果如下：
+
+	0
+		在所有接口上启用 IPv6。
+
+		这是默认值。
+
+	1
+		在所有接口上禁用 IPv6。
+
+		接口不会添加 IPv6 地址。
-- 
2.53.0

Re: [PATCH v5 4/5] docs/zh_CN: Add ipv6 Chinese translation

[Dongliang Mu]

On 8/24/26 12:38 PM, Siwei Chen wrote:
> From: Siwei Chen <businiaoanka@anka1.top>
>
> Translate .../networking/ipv6.rst into Chinese.
>
> Update the translation through commit 19093313cb04
> ("docs: networking: convert ipv6.txt to ReST")
>
> Signed-off-by: Siwei Chen <businiaoanka@anka1.top>
Reviewed-by: Dongliang Mu <dzm91@hust.edu.cn>
> ---
>   .../translations/zh_CN/networking/index.rst   |  2 +-
>   .../translations/zh_CN/networking/ipv6.rst    | 76 +++++++++++++++++++
>   2 files changed, 77 insertions(+), 1 deletion(-)
>   create mode 100644 Documentation/translations/zh_CN/networking/ipv6.rst
>
> diff --git a/Documentation/translations/zh_CN/networking/index.rst b/Documentation/translations/zh_CN/networking/index.rst
> index 4675d23a7f28..cd768d0a2837 100644
> --- a/Documentation/translations/zh_CN/networking/index.rst
> +++ b/Documentation/translations/zh_CN/networking/index.rst
> @@ -22,6 +22,7 @@
>   
>      msg_zerocopy
>      driver
> +   ipv6
>      napi
>      vxlan
>      netif-msg
> @@ -89,7 +90,6 @@ Todolist:
>   *   ip_dynaddr
>   *   ipsec
>   *   ip-sysctl
> -*   ipv6
>   *   ipvlan
>   *   ipvs-sysctl
>   *   kcm
> diff --git a/Documentation/translations/zh_CN/networking/ipv6.rst b/Documentation/translations/zh_CN/networking/ipv6.rst
> new file mode 100644
> index 000000000000..3726b6fdc460
> --- /dev/null
> +++ b/Documentation/translations/zh_CN/networking/ipv6.rst
> @@ -0,0 +1,76 @@
> +.. SPDX-License-Identifier: GPL-2.0
> +
> +.. include:: ../disclaimer-zh_CN.rst
> +
> +:Original: Documentation/networking/ipv6.rst
> +
> +:翻译:
> +
> +	陈思为 Siwei Chen <businiaoanka@anka1.top>
> +
> +====
> +IPv6
> +====
> +
> +
> +ipv6 模块的选项在加载时以参数形式提供。
> +
> +模块选项可作为 insmod 或 modprobe 命令的命令行参数给出，但通常在
> +``/etc/modules.d/*.conf`` 配置文件中，或在发行版特定的配置文件中指定。
> +
> +可用的 ipv6 模块参数如下所列。若未指定某参数，则使用其默认值。
> +
> +参数如下：
> +
> +disable
> +
> +	指定是否在加载 IPv6 模块的同时禁用其全部功能。当另一模块依赖于 IPv6
> +	模块已加载，但又不需要任何 IPv6 地址或操作时，可使用此选项。
> +
> +	可选值及其效果如下：
> +
> +	0
> +		启用 IPv6。
> +
> +		这是默认值。
> +
> +	1
> +		禁用 IPv6。
> +
> +		接口不会添加 IPv6 地址，也无法打开 IPv6 套接字。
> +
> +		需要重启才能启用 IPv6。
> +
> +autoconf
> +
> +	指定是否在所有接口上启用 IPv6 地址自动配置。当不希望根据路由器通告
> +	（Router Advertisement）中收到的前缀自动生成地址时，可使用此选项。
> +
> +	可选值及其效果如下：
> +
> +	0
> +		所有接口均禁用 IPv6 地址自动配置。
> +
> +		仅添加 IPv6 回环地址（::1）与链路本地地址。
> +
> +	1
> +		所有接口均启用 IPv6 地址自动配置。
> +
> +		这是默认值。
> +
> +disable_ipv6
> +
> +	指定是否在所有接口上禁用 IPv6。
> +	当不需要任何 IPv6 地址时，可使用此选项。
> +
> +	可选值及其效果如下：
> +
> +	0
> +		在所有接口上启用 IPv6。
> +
> +		这是默认值。
> +
> +	1
> +		在所有接口上禁用 IPv6。
> +
> +		接口不会添加 IPv6 地址。

[PATCH v5 5/5] docs/zh_CN: Add LSM/SELinux secid Chinese translation

[Siwei Chen]

From: Siwei Chen <businiaoanka@anka1.top>

Translate .../networking/secid.rst into Chinese.

Update the translation through commit de1fd4a7b0f2
("docs: networking: convert secid.txt to ReST")

Signed-off-by: Siwei Chen <businiaoanka@anka1.top>
---
 .../translations/zh_CN/networking/index.rst   |  2 +-
 .../translations/zh_CN/networking/secid.rst   | 24 +++++++++++++++++++
 2 files changed, 25 insertions(+), 1 deletion(-)
 create mode 100644 Documentation/translations/zh_CN/networking/secid.rst

diff --git a/Documentation/translations/zh_CN/networking/index.rst b/Documentation/translations/zh_CN/networking/index.rst
index cd768d0a2837..bf22d22b64db 100644
--- a/Documentation/translations/zh_CN/networking/index.rst
+++ b/Documentation/translations/zh_CN/networking/index.rst
@@ -24,6 +24,7 @@
    driver
    ipv6
    napi
+   secid
    vxlan
    netif-msg
    xfrm_proc
@@ -126,7 +127,6 @@ Todolist:
 *   representors
 *   rxrpc
 *   sctp
-*   secid
 *   seg6-sysctl
 *   smc-sysctl
 *   statistics
diff --git a/Documentation/translations/zh_CN/networking/secid.rst b/Documentation/translations/zh_CN/networking/secid.rst
new file mode 100644
index 000000000000..94d9e7fb5d13
--- /dev/null
+++ b/Documentation/translations/zh_CN/networking/secid.rst
@@ -0,0 +1,24 @@
+.. SPDX-License-Identifier: GPL-2.0
+
+.. include:: ../disclaimer-zh_CN.rst
+
+:Original: Documentation/networking/secid.rst
+
+:翻译:
+
+	陈思为 Siwei Chen <businiaoanka@anka1.top>
+
+=================
+LSM/SeLinux secid
+=================
+
+flowi 结构体：
+
+flowi 结构体中的 secid 成员在 LSM（如 SELinux）中用于表示该流的标签。
+该流的标签目前用于选择相匹配的带标签 xfrm。
+
+若为出向流，标签派生自套接字（若有）；如果该流是为响应某个入站报文而生成的，
+则标签派生自相应的入站报文（例如 TCP 复位、timewait ACK 等）。
+在特殊情况下，也可酌情让标签派生自其他来源，如进程上下文、设备等。
+
+若为入向流，标签派生自报文所使用的 IPSec 安全关联（若存在）。
-- 
2.53.0

Re: [PATCH v5 5/5] docs/zh_CN: Add LSM/SELinux secid Chinese translation

[Dongliang Mu]

On 8/24/26 12:38 PM, Siwei Chen wrote:
> From: Siwei Chen <businiaoanka@anka1.top>
>
> Translate .../networking/secid.rst into Chinese.
>
> Update the translation through commit de1fd4a7b0f2
> ("docs: networking: convert secid.txt to ReST")
>
> Signed-off-by: Siwei Chen <businiaoanka@anka1.top>
Reviewed-by: Dongliang Mu <dzm91@hust.edu.cn>
> ---
>   .../translations/zh_CN/networking/index.rst   |  2 +-
>   .../translations/zh_CN/networking/secid.rst   | 24 +++++++++++++++++++
>   2 files changed, 25 insertions(+), 1 deletion(-)
>   create mode 100644 Documentation/translations/zh_CN/networking/secid.rst
>
> diff --git a/Documentation/translations/zh_CN/networking/index.rst b/Documentation/translations/zh_CN/networking/index.rst
> index cd768d0a2837..bf22d22b64db 100644
> --- a/Documentation/translations/zh_CN/networking/index.rst
> +++ b/Documentation/translations/zh_CN/networking/index.rst
> @@ -24,6 +24,7 @@
>      driver
>      ipv6
>      napi
> +   secid
>      vxlan
>      netif-msg
>      xfrm_proc
> @@ -126,7 +127,6 @@ Todolist:
>   *   representors
>   *   rxrpc
>   *   sctp
> -*   secid
>   *   seg6-sysctl
>   *   smc-sysctl
>   *   statistics
> diff --git a/Documentation/translations/zh_CN/networking/secid.rst b/Documentation/translations/zh_CN/networking/secid.rst
> new file mode 100644
> index 000000000000..94d9e7fb5d13
> --- /dev/null
> +++ b/Documentation/translations/zh_CN/networking/secid.rst
> @@ -0,0 +1,24 @@
> +.. SPDX-License-Identifier: GPL-2.0
> +
> +.. include:: ../disclaimer-zh_CN.rst
> +
> +:Original: Documentation/networking/secid.rst
> +
> +:翻译:
> +
> +	陈思为 Siwei Chen <businiaoanka@anka1.top>
> +
> +=================
> +LSM/SeLinux secid
> +=================
> +
> +flowi 结构体：
> +
> +flowi 结构体中的 secid 成员在 LSM（如 SELinux）中用于表示该流的标签。
> +该流的标签目前用于选择相匹配的带标签 xfrm。
> +
> +若为出向流，标签派生自套接字（若有）；如果该流是为响应某个入站报文而生成的，
> +则标签派生自相应的入站报文（例如 TCP 复位、timewait ACK 等）。
> +在特殊情况下，也可酌情让标签派生自其他来源，如进程上下文、设备等。
> +
> +若为入向流，标签派生自报文所使用的 IPSec 安全关联（若存在）。

Re: [PATCH v5 0/5] docs/zh_CN: Add Chinese translations for five networking documents

[不死鸟Anka]

在 2026年8月24日星期一 中国标准时间 12:37:59，Siwei Chen 写道：
> From: Siwei Chen <businiaoanka@anka1.top>
> 
> This series adds Simplified Chinese translations for five documents
> under Documentation/networking/:
> 
>   - team.rst: Team devices driven from userspace via libteam
>   - sriov.rst: NIC SR-IOV APIs (switchdev model and legacy API)
>   - driver.rst: Softnet driver issues (probing, close/stop,
>     transmit path guidelines, and extack error reporting)
>   - ipv6.rst: ipv6 module parameters (disable, autoconf,
>     disable_ipv6)
>   - secid.rst: LSM/SELinux secid usage in the flowi structure
> 
> Changes in v5:
>   - Use direct link instead of ":ref:" to fix the warning of
>     "undefined label" in the translation of "sriov.rst" since "switchdev"
>     documentation has no translation in the same directory.
>   - Revise the commit title: "SeLinux" -> "SELinux".
>   - Translate "flowi structure" and "flow structure" into
>     "flowi structure" uniformly in the translation of "secid.rst".
>   - Link to v4:
> https://lore.kernel.org/linux-doc/20260817021340.17318-1-anka@stu.cdut.edu.
> cn/
> 
> Changes in v4:
>   - Fix two minor issues in the translation of "ipv6.rst" and "secid.rst".
>   - Link to v3:
> https://lore.kernel.org/linux-doc/20260811071200.54062-1-anka@stu.cdut.edu.
> cn/
> 
> Changes in v3:
>   - Remove spaces before and after "（".
>   - Add a missing space after "IPv6".
>   - Update the translation of "secid".
>   - Link to v2:
> https://lore.kernel.org/linux-doc/20260727073538.56951-1-anka@stu.cdut.edu.
> cn/
> 
> Changes in v2:
>   - Add translated documents to corresponding index file.
>   - Link to v1:
> https://lore.kernel.org/linux-doc/cover.1784866896.git.businiaoanka@anka1.t
> op/
> 
> Siwei Chen (5):
>   docs/zh_CN: Add networking team documentation Chinese translation
>   docs/zh_CN: Add NIC SR-IOV APIs Chinese translation
>   docs/zh_CN: Add Softnet Driver Issues Chinese translation
>   docs/zh_CN: Add ipv6 Chinese translation
>   docs/zh_CN: Add LSM/SELinux secid Chinese translation
> 
>  .../translations/zh_CN/networking/driver.rst  | 138 ++++++++++++++++++
>  .../translations/zh_CN/networking/index.rst   |  10 +-
>  .../translations/zh_CN/networking/ipv6.rst    |  76 ++++++++++
>  .../translations/zh_CN/networking/secid.rst   |  24 +++
>  .../translations/zh_CN/networking/sriov.rst   |  34 +++++
>  .../translations/zh_CN/networking/team.rst    |  16 ++
>  6 files changed, 293 insertions(+), 5 deletions(-)
>  create mode 100644 Documentation/translations/zh_CN/networking/driver.rst
>  create mode 100644 Documentation/translations/zh_CN/networking/ipv6.rst
>  create mode 100644 Documentation/translations/zh_CN/networking/secid.rst
>  create mode 100644 Documentation/translations/zh_CN/networking/sriov.rst
>  create mode 100644 Documentation/translations/zh_CN/networking/team.rst

Ping

Re: [PATCH v5 0/5] docs/zh_CN: Add Chinese translations for five networking documents

[Alex Shi]

Applied, thanks!



On 2026/9/7 11:02, 不死鸟Anka wrote:
> 在 2026年8月24日星期一 中国标准时间 12:37:59，Siwei Chen 写道：
>> From: Siwei Chen<businiaoanka@anka1.top>
>>
>> This series adds Simplified Chinese translations for five documents
>> under Documentation/networking/:
>>
>>    - team.rst: Team devices driven from userspace via libteam
>>    - sriov.rst: NIC SR-IOV APIs (switchdev model and legacy API)
>>    - driver.rst: Softnet driver issues (probing, close/stop,
>>      transmit path guidelines, and extack error reporting)
>>    - ipv6.rst: ipv6 module parameters (disable, autoconf,
>>      disable_ipv6)
>>    - secid.rst: LSM/SELinux secid usage in the flowi structure
>>
>> Changes in v5:
>>    - Use direct link instead of ":ref:" to fix the warning of
>>      "undefined label" in the translation of "sriov.rst" since "switchdev"
>>      documentation has no translation in the same directory.
>>    - Revise the commit title: "SeLinux" -> "SELinux".
>>    - Translate "flowi structure" and "flow structure" into
>>      "flowi structure" uniformly in the translation of "secid.rst".
>>    - Link to v4:
>> https://lore.kernel.org/linux-doc/20260817021340.17318-1-anka@stu.cdut.edu.
>> cn/
>>
>> Changes in v4:
>>    - Fix two minor issues in the translation of "ipv6.rst" and "secid.rst".
>>    - Link to v3:
>> https://lore.kernel.org/linux-doc/20260811071200.54062-1-anka@stu.cdut.edu.
>> cn/
>>
>> Changes in v3:
>>    - Remove spaces before and after "（".
>>    - Add a missing space after "IPv6".
>>    - Update the translation of "secid".
>>    - Link to v2:
>> https://lore.kernel.org/linux-doc/20260727073538.56951-1-anka@stu.cdut.edu.
>> cn/
>>
>> Changes in v2:
>>    - Add translated documents to corresponding index file.
>>    - Link to v1:
>> https://lore.kernel.org/linux-doc/ 
>> cover.1784866896.git.businiaoanka@anka1.t
>> op/
>>
>> Siwei Chen (5):
>>    docs/zh_CN: Add networking team documentation Chinese translation
>>    docs/zh_CN: Add NIC SR-IOV APIs Chinese translation
>>    docs/zh_CN: Add Softnet Driver Issues Chinese translation
>>    docs/zh_CN: Add ipv6 Chinese translation
>>    docs/zh_CN: Add LSM/SELinux secid Chinese translation
>>
>>   .../translations/zh_CN/networking/driver.rst  | 138 ++++++++++++++++++
>>   .../translations/zh_CN/networking/index.rst   |  10 +-
>>   .../translations/zh_CN/networking/ipv6.rst    |  76 ++++++++++
>>   .../translations/zh_CN/networking/secid.rst   |  24 +++
>>   .../translations/zh_CN/networking/sriov.rst   |  34 +++++
>>   .../translations/zh_CN/networking/team.rst    |  16 ++
>>   6 files changed, 293 insertions(+), 5 deletions(-)
>>   create mode 100644 Documentation/translations/zh_CN/networking/driver.rst
>>   create mode 100644 Documentation/translations/zh_CN/networking/ipv6.rst
>>   create mode 100644 Documentation/translations/zh_CN/networking/secid.rst
>>   create mode 100644 Documentation/translations/zh_CN/networking/sriov.rst
>>   create mode 100644 Documentation/translations/zh_CN/networking/team.rst
> Ping
>