mirror of https://lore.kernel.org/lkml/
 help / color / mirror / Atom feed
* [PATCH v2 0/5] docs/zh_CN: Add Chinese translations for five networking documents
@ 2026-07-27  7:35 Siwei Chen
  2026-07-27  7:35 ` [PATCH v2 1/5] docs/zh_CN: Add networking team documentation Chinese translation Siwei Chen
                   ` (5 more replies)
  0 siblings, 6 replies; 12+ messages in thread
From: Siwei Chen @ 2026-07-27  7:35 UTC (permalink / raw)
  To: alexs, si.yanteng, dzm91, corbet, skhan
  Cc: wy, linux-doc, linux-kernel, 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 v2:
  - Add translated documents to corresponding index file.
  - Link to v1: https://lore.kernel.org/linux-doc/54B9FF7CF7DE776B+6294277.lOV4Wx5bFT@anka-20eya00ycd/T/#t

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   |  31 ++++
 .../translations/zh_CN/networking/team.rst    |  16 ++
 6 files changed, 290 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


^ permalink raw reply	[flat|nested] 12+ messages in thread

* [PATCH v2 1/5] docs/zh_CN: Add networking team documentation Chinese translation
  2026-07-27  7:35 [PATCH v2 0/5] docs/zh_CN: Add Chinese translations for five networking documents Siwei Chen
@ 2026-07-27  7:35 ` Siwei Chen
  2026-07-27  7:35 ` [PATCH v2 2/5] docs/zh_CN: Add NIC SR-IOV APIs " Siwei Chen
                   ` (4 subsequent siblings)
  5 siblings, 0 replies; 12+ messages in thread
From: Siwei Chen @ 2026-07-27  7:35 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/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


^ permalink raw reply	[flat|nested] 12+ messages in thread

* [PATCH v2 2/5] docs/zh_CN: Add NIC SR-IOV APIs Chinese translation
  2026-07-27  7:35 [PATCH v2 0/5] docs/zh_CN: Add Chinese translations for five networking documents Siwei Chen
  2026-07-27  7:35 ` [PATCH v2 1/5] docs/zh_CN: Add networking team documentation Chinese translation Siwei Chen
@ 2026-07-27  7:35 ` Siwei Chen
  2026-08-11  4:13   ` Dongliang Mu
  2026-07-27  7:35 ` [PATCH v2 3/5] docs/zh_CN: Add Softnet Driver Issues " Siwei Chen
                   ` (3 subsequent siblings)
  5 siblings, 1 reply; 12+ messages in thread
From: Siwei Chen @ 2026-07-27  7:35 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/index.rst   |  2 +-
 .../translations/zh_CN/networking/sriov.rst   | 31 +++++++++++++++++++
 2 files changed, 32 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..021c5d97c234
--- /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	[flat|nested] 12+ messages in thread

* [PATCH v2 3/5] docs/zh_CN: Add Softnet Driver Issues Chinese translation
  2026-07-27  7:35 [PATCH v2 0/5] docs/zh_CN: Add Chinese translations for five networking documents Siwei Chen
  2026-07-27  7:35 ` [PATCH v2 1/5] docs/zh_CN: Add networking team documentation Chinese translation Siwei Chen
  2026-07-27  7:35 ` [PATCH v2 2/5] docs/zh_CN: Add NIC SR-IOV APIs " Siwei Chen
@ 2026-07-27  7:35 ` Siwei Chen
  2026-07-27  7:35 ` [PATCH v2 4/5] docs/zh_CN: Add ipv6 " Siwei Chen
                   ` (2 subsequent siblings)
  5 siblings, 0 replies; 12+ messages in thread
From: Siwei Chen @ 2026-07-27  7:35 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 ++++++++++++++++++
 .../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


^ permalink raw reply	[flat|nested] 12+ messages in thread

* [PATCH v2 4/5] docs/zh_CN: Add ipv6 Chinese translation
  2026-07-27  7:35 [PATCH v2 0/5] docs/zh_CN: Add Chinese translations for five networking documents Siwei Chen
                   ` (2 preceding siblings ...)
  2026-07-27  7:35 ` [PATCH v2 3/5] docs/zh_CN: Add Softnet Driver Issues " Siwei Chen
@ 2026-07-27  7:35 ` Siwei Chen
  2026-08-11  4:14   ` Dongliang Mu
  2026-07-27  7:35 ` [PATCH v2 5/5] docs/zh_CN: Add LSM/SeLinux secid " Siwei Chen
  2026-08-10  1:15 ` [PATCH v2 0/5] docs/zh_CN: Add Chinese translations for five networking documents Siwei Chen
  5 siblings, 1 reply; 12+ messages in thread
From: Siwei Chen @ 2026-07-27  7:35 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/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..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	[flat|nested] 12+ messages in thread

* [PATCH v2 5/5] docs/zh_CN: Add LSM/SeLinux secid Chinese translation
  2026-07-27  7:35 [PATCH v2 0/5] docs/zh_CN: Add Chinese translations for five networking documents Siwei Chen
                   ` (3 preceding siblings ...)
  2026-07-27  7:35 ` [PATCH v2 4/5] docs/zh_CN: Add ipv6 " Siwei Chen
@ 2026-07-27  7:35 ` Siwei Chen
  2026-08-11  4:08   ` Dongliang Mu
  2026-08-10  1:15 ` [PATCH v2 0/5] docs/zh_CN: Add Chinese translations for five networking documents Siwei Chen
  5 siblings, 1 reply; 12+ messages in thread
From: Siwei Chen @ 2026-07-27  7:35 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/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..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	[flat|nested] 12+ messages in thread

* Re: [PATCH v2 0/5] docs/zh_CN: Add Chinese translations for five networking documents
  2026-07-27  7:35 [PATCH v2 0/5] docs/zh_CN: Add Chinese translations for five networking documents Siwei Chen
                   ` (4 preceding siblings ...)
  2026-07-27  7:35 ` [PATCH v2 5/5] docs/zh_CN: Add LSM/SeLinux secid " Siwei Chen
@ 2026-08-10  1:15 ` Siwei Chen
  2026-08-10  5:34   ` Dongliang Mu
  5 siblings, 1 reply; 12+ messages in thread
From: Siwei Chen @ 2026-08-10  1:15 UTC (permalink / raw)
  To: alexs, si.yanteng, dzm91, corbet, skhan, Siwei Chen
  Cc: wy, linux-doc, linux-kernel

在 2026年7月27日星期一 中国标准时间 15:35:31,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 v2:
>   - Add translated documents to corresponding index file.
>   - Link to v1:
> https://lore.kernel.org/linux-doc/54B9FF7CF7DE776B+6294277.lOV4Wx5bFT@anka-> 20eya00ycd/T/#t
> 

Ping




^ permalink raw reply	[flat|nested] 12+ messages in thread

* Re: [PATCH v2 0/5] docs/zh_CN: Add Chinese translations for five networking documents
  2026-08-10  1:15 ` [PATCH v2 0/5] docs/zh_CN: Add Chinese translations for five networking documents Siwei Chen
@ 2026-08-10  5:34   ` Dongliang Mu
  0 siblings, 0 replies; 12+ messages in thread
From: Dongliang Mu @ 2026-08-10  5:34 UTC (permalink / raw)
  To: Siwei Chen, alexs, si.yanteng, corbet, skhan, Siwei Chen
  Cc: wy, linux-doc, linux-kernel


On 8/10/26 9:15 AM, Siwei Chen wrote:
> 在 2026年7月27日星期一 中国标准时间 15:35:31,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


I will post my review today or tomorrow.

Dongliang Mu


>>
>> Changes in v2:
>>    - Add translated documents to corresponding index file.
>>    - Link to v1:
>> https://lore.kernel.org/linux-doc/54B9FF7CF7DE776B+6294277.lOV4Wx5bFT@anka-> 20eya00ycd/T/#t
>>
> Ping
>
>


^ permalink raw reply	[flat|nested] 12+ messages in thread

* Re: [PATCH v2 5/5] docs/zh_CN: Add LSM/SeLinux secid Chinese translation
  2026-07-27  7:35 ` [PATCH v2 5/5] docs/zh_CN: Add LSM/SeLinux secid " Siwei Chen
@ 2026-08-11  4:08   ` Dongliang Mu
  0 siblings, 0 replies; 12+ messages in thread
From: Dongliang Mu @ 2026-08-11  4:08 UTC (permalink / raw)
  To: Siwei Chen, alexs, si.yanteng, corbet, skhan
  Cc: wy, linux-doc, linux-kernel, Siwei Chen


On 7/27/26 3:35 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>
> ---
>   .../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..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 等)。在特殊情况下,也可酌情让标签派生自其他
> +来源,如进程上下文、设备等。

If this is an outbound flow, the label is derived from the socket, if any, or
the incoming packet this flow is being generated as a response to (e.g. tcp
resets, timewait ack, etc.).

Suggested translation:

若为出向流,标签派生自套接字(若有);如果该流是为响应某个入站报文而生成的,则标签派生自相应的入站报文(例如 
TCP 复位、

timewait ACK 等)。

Dongliang Mu

> +
> +若为入向流,标签派生自报文所使用的 IPSec 安全关联(若存在)。


^ permalink raw reply	[flat|nested] 12+ messages in thread

* Re: [PATCH v2 2/5] docs/zh_CN: Add NIC SR-IOV APIs Chinese translation
  2026-07-27  7:35 ` [PATCH v2 2/5] docs/zh_CN: Add NIC SR-IOV APIs " Siwei Chen
@ 2026-08-11  4:13   ` Dongliang Mu
  0 siblings, 0 replies; 12+ messages in thread
From: Dongliang Mu @ 2026-08-11  4:13 UTC (permalink / raw)
  To: Siwei Chen, alexs, si.yanteng, corbet, skhan
  Cc: wy, linux-doc, linux-kernel, Siwei Chen


On 7/27/26 3:35 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>
> ---
>   .../translations/zh_CN/networking/index.rst   |  2 +-
>   .../translations/zh_CN/networking/sriov.rst   | 31 +++++++++++++++++++
>   2 files changed, 32 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..021c5d97c234
> --- /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` )
remove spaces before and after (. Maybe you can use ( other than (.
> +来配置 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``


^ permalink raw reply	[flat|nested] 12+ messages in thread

* Re: [PATCH v2 4/5] docs/zh_CN: Add ipv6 Chinese translation
  2026-07-27  7:35 ` [PATCH v2 4/5] docs/zh_CN: Add ipv6 " Siwei Chen
@ 2026-08-11  4:14   ` Dongliang Mu
  2026-08-11  6:09     ` Siwei Chen
  0 siblings, 1 reply; 12+ messages in thread
From: Dongliang Mu @ 2026-08-11  4:14 UTC (permalink / raw)
  To: Siwei Chen, alexs, si.yanteng, corbet, skhan
  Cc: wy, linux-doc, linux-kernel, Siwei Chen


On 7/27/26 3:35 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>
> ---
>   .../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..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地址自动配置。当不希望根据路由器通告
If you prefer spaces before and after English words, add a space after 
IPv6.
> +	(Router Advertisement)中收到的前缀自动生成地址时,可使用此选项。
> +
> +	可选值及其效果如下:
> +
> +	0
> +		所有接口均禁用 IPv6 地址自动配置。
> +
> +		仅添加 IPv6 回环地址(::1)与链路本地地址。
> +
> +	1
> +		所有接口均启用 IPv6 地址自动配置。
> +
> +		这是默认值。
> +
> +disable_ipv6
> +
> +	指定是否在所有接口上禁用 IPv6。
> +	当不需要任何 IPv6 地址时,可使用此选项。
> +
> +	可选值及其效果如下:
> +
> +	0
> +		在所有接口上启用 IPv6。
> +
> +		这是默认值。
> +
> +	1
> +		在所有接口上禁用 IPv6。
> +
> +		接口不会添加 IPv6 地址。


^ permalink raw reply	[flat|nested] 12+ messages in thread

* Re: [PATCH v2 4/5] docs/zh_CN: Add ipv6 Chinese translation
  2026-08-11  4:14   ` Dongliang Mu
@ 2026-08-11  6:09     ` Siwei Chen
  0 siblings, 0 replies; 12+ messages in thread
From: Siwei Chen @ 2026-08-11  6:09 UTC (permalink / raw)
  To: alexs, si.yanteng, corbet, skhan, Dongliang Mu
  Cc: wy, linux-doc, linux-kernel

> Suggested translation:
> 
> 若为出向流,标签派生自套接字(若有);如果该流是为响应某个入站报文而生成的,则标签派生自相应的入站报文(例如
> TCP 复位、
> 
> timewait ACK 等)。

> remove spaces before and after (. Maybe you can use ( other than (.

> > +
> > +autoconf
> > +
> > +	指定是否在所有接口上启用 IPv6地址自动配置。当不希望根据路由器通告
> 
> If you prefer spaces before and after English words, add a space after
> IPv6.
> 

Thank you for your reply. I have received all your 3 comments. I will make the 
corrections in the next version of the patch.

^ permalink raw reply	[flat|nested] 12+ messages in thread

end of thread, other threads:[~2026-08-11  6:10 UTC | newest]

Thread overview: 12+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2026-07-27  7:35 [PATCH v2 0/5] docs/zh_CN: Add Chinese translations for five networking documents Siwei Chen
2026-07-27  7:35 ` [PATCH v2 1/5] docs/zh_CN: Add networking team documentation Chinese translation Siwei Chen
2026-07-27  7:35 ` [PATCH v2 2/5] docs/zh_CN: Add NIC SR-IOV APIs " Siwei Chen
2026-08-11  4:13   ` Dongliang Mu
2026-07-27  7:35 ` [PATCH v2 3/5] docs/zh_CN: Add Softnet Driver Issues " Siwei Chen
2026-07-27  7:35 ` [PATCH v2 4/5] docs/zh_CN: Add ipv6 " Siwei Chen
2026-08-11  4:14   ` Dongliang Mu
2026-08-11  6:09     ` Siwei Chen
2026-07-27  7:35 ` [PATCH v2 5/5] docs/zh_CN: Add LSM/SeLinux secid " Siwei Chen
2026-08-11  4:08   ` Dongliang Mu
2026-08-10  1:15 ` [PATCH v2 0/5] docs/zh_CN: Add Chinese translations for five networking documents Siwei Chen
2026-08-10  5:34   ` Dongliang Mu

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox

all inboxes | Powered by JetHome®