* [PATCH 1/5] docs/zh_CN: Add networking team documentation Chinese translation
2026-07-24 5:13 [PATCH 0/5] docs/zh_CN: Add Chinese translations for five networking documents Siwei Chen
@ 2026-07-24 5:13 ` Siwei Chen
2026-07-24 5:13 ` [PATCH 2/5] docs/zh_CN: Add NIC SR-IOV APIs " Siwei Chen
` (3 subsequent siblings)
4 siblings, 0 replies; 6+ messages in thread
From: Siwei Chen @ 2026-07-24 5:13 UTC (permalink / raw)
To: alexs, si.yanteng, dzm91, corbet, skhan
Cc: wy, linux-doc, linux-kernel, 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/team.rst | 16 ++++++++++++++++
1 file changed, 16 insertions(+)
create mode 100644 Documentation/translations/zh_CN/networking/team.rst
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
^ permalink raw reply related [flat|nested] 6+ messages in thread* [PATCH 2/5] docs/zh_CN: Add NIC SR-IOV APIs Chinese translation
2026-07-24 5:13 [PATCH 0/5] docs/zh_CN: Add Chinese translations for five networking documents Siwei Chen
2026-07-24 5:13 ` [PATCH 1/5] docs/zh_CN: Add networking team documentation Chinese translation Siwei Chen
@ 2026-07-24 5:13 ` Siwei Chen
2026-07-24 5:13 ` [PATCH 3/5] docs/zh_CN: Add Softnet Driver Issues " Siwei Chen
` (2 subsequent siblings)
4 siblings, 0 replies; 6+ messages in thread
From: Siwei Chen @ 2026-07-24 5:13 UTC (permalink / raw)
To: alexs, si.yanteng, dzm91, corbet, skhan
Cc: wy, linux-doc, linux-kernel, 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/sriov.rst | 31 +++++++++++++++++++
1 file changed, 31 insertions(+)
create mode 100644 Documentation/translations/zh_CN/networking/sriov.rst
diff --git a/Documentation/translations/zh_CN/networking/sriov.rst b/Documentation/translations/zh_CN/networking/sriov.rst
new file mode 100644
index 000000000000..be9c2f271ca2
--- /dev/null
+++ b/Documentation/translations/zh_CN/networking/sriov.rst
@@ -0,0 +1,31 @@
+.. 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`` 模型（ 参见 :ref:`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``
--
2.53.0
^ permalink raw reply related [flat|nested] 6+ messages in thread* [PATCH 3/5] docs/zh_CN: Add Softnet Driver Issues Chinese translation
2026-07-24 5:13 [PATCH 0/5] docs/zh_CN: Add Chinese translations for five networking documents Siwei Chen
2026-07-24 5:13 ` [PATCH 1/5] docs/zh_CN: Add networking team documentation Chinese translation Siwei Chen
2026-07-24 5:13 ` [PATCH 2/5] docs/zh_CN: Add NIC SR-IOV APIs " Siwei Chen
@ 2026-07-24 5:13 ` Siwei Chen
2026-07-24 5:13 ` [PATCH 4/5] docs/zh_CN: Add ipv6 " Siwei Chen
2026-07-24 5:13 ` [PATCH 5/5] docs/zh_CN: Add LSM/SeLinux secid " Siwei Chen
4 siblings, 0 replies; 6+ messages in thread
From: Siwei Chen @ 2026-07-24 5:13 UTC (permalink / raw)
To: alexs, si.yanteng, dzm91, corbet, skhan
Cc: wy, linux-doc, linux-kernel, 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 ++++++++++++++++++
1 file changed, 138 insertions(+)
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`` 传递， **要么** 写入系统日志。驱动不应
+试图将同一信息同时报告到两处。
--
2.53.0
^ permalink raw reply related [flat|nested] 6+ messages in thread* [PATCH 4/5] docs/zh_CN: Add ipv6 Chinese translation
2026-07-24 5:13 [PATCH 0/5] docs/zh_CN: Add Chinese translations for five networking documents Siwei Chen
` (2 preceding siblings ...)
2026-07-24 5:13 ` [PATCH 3/5] docs/zh_CN: Add Softnet Driver Issues " Siwei Chen
@ 2026-07-24 5:13 ` Siwei Chen
2026-07-24 5:13 ` [PATCH 5/5] docs/zh_CN: Add LSM/SeLinux secid " Siwei Chen
4 siblings, 0 replies; 6+ messages in thread
From: Siwei Chen @ 2026-07-24 5:13 UTC (permalink / raw)
To: alexs, si.yanteng, dzm91, corbet, skhan
Cc: wy, linux-doc, linux-kernel, 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/ipv6.rst | 76 +++++++++++++++++++
1 file changed, 76 insertions(+)
create mode 100644 Documentation/translations/zh_CN/networking/ipv6.rst
diff --git a/Documentation/translations/zh_CN/networking/ipv6.rst b/Documentation/translations/zh_CN/networking/ipv6.rst
new file mode 100644
index 000000000000..5246d8588cf6
--- /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
^ permalink raw reply related [flat|nested] 6+ messages in thread* [PATCH 5/5] docs/zh_CN: Add LSM/SeLinux secid Chinese translation
2026-07-24 5:13 [PATCH 0/5] docs/zh_CN: Add Chinese translations for five networking documents Siwei Chen
` (3 preceding siblings ...)
2026-07-24 5:13 ` [PATCH 4/5] docs/zh_CN: Add ipv6 " Siwei Chen
@ 2026-07-24 5:13 ` Siwei Chen
4 siblings, 0 replies; 6+ messages in thread
From: Siwei Chen @ 2026-07-24 5:13 UTC (permalink / raw)
To: alexs, si.yanteng, dzm91, corbet, skhan
Cc: wy, linux-doc, linux-kernel, 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/secid.rst | 24 +++++++++++++++++++
1 file changed, 24 insertions(+)
create mode 100644 Documentation/translations/zh_CN/networking/secid.rst
diff --git a/Documentation/translations/zh_CN/networking/secid.rst b/Documentation/translations/zh_CN/networking/secid.rst
new file mode 100644
index 000000000000..0168feddcc3d
--- /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 结构体：
+
+flow 结构体中的 secid 成员在 LSM（如 SELinux）中用于表示该流的标签。
+该流的标签目前用于选择相匹配的带标签 xfrm。
+
+若为出向流，标签派生自套接字（若有），或派生自本流作为响应而生成的入站报文
+（如 TCP 复位、timewait ACK 等）。在特殊情况下，也可酌情让标签派生自其他
+来源，如进程上下文、设备等。
+
+若为入向流，标签派生自报文所使用的 IPSec 安全关联（若存在）。
--
2.53.0
^ permalink raw reply related [flat|nested] 6+ messages in thread