mirror of https://lore.kernel.org/lkml/
 help / color / mirror / Atom feed
From: <wang.yaxin@zte.com.cn>
To: <wang.yaxin@zte.com.cn>
Cc: <alexs@kernel.org>, <si.yanteng@linux.dev>, <corbet@lwn.net>,
	<linux-doc@vger.kernel.org>, <linux-kernel@vger.kernel.org>,
	<xu.xin16@zte.com.cn>, <yang.yang29@zte.com.cn>,
	<fan.yu9@zte.com.cn>, <he.peilin@zte.com.cn>,
	<tu.qiang35@zte.com.cn>, <qiu.yutan@zte.com.cn>
Subject: [PATCH 1/4 v3] Docs/zh_CN: Translate mptcp-sysctl.rst to Simplified Chinese
Date: Sat, 30 Aug 2025 16:58:18 +0800 (CST)	[thread overview]
Message-ID: <20250830165818597ycQqMyAK7UIDMwrEArw1C@zte.com.cn> (raw)
In-Reply-To: <2025083016571123360dlV3pxVqfCY35MOQnma@zte.com.cn>

From: Sun yuxi <sun.yuxi@zte.com.cn>

translate the "mptcp-sysctl.rst" into Simplified Chinese.

Update the translation through commit fa3ee9dd8067
("mptcp: sysctl: add available_path_managers")

Signed-off-by: Sun yuxi <sun.yuxi@zte.com.cn>
---
v2->v3:
1. add reviewer tag

 .../translations/zh_CN/networking/index.rst   |   2 +-
 .../zh_CN/networking/mptcp-sysctl.rst         | 139 ++++++++++++++++++
 2 files changed, 140 insertions(+), 1 deletion(-)
 create mode 100644 Documentation/translations/zh_CN/networking/mptcp-sysctl.rst

diff --git a/Documentation/translations/zh_CN/networking/index.rst b/Documentation/translations/zh_CN/networking/index.rst
index bb0edcffd144..6e1c1df4a980 100644
--- a/Documentation/translations/zh_CN/networking/index.rst
+++ b/Documentation/translations/zh_CN/networking/index.rst
@@ -27,6 +27,7 @@
    xfrm_proc
    netmem
    alias
+   mptcp-sysctl

 Todolist:

@@ -96,7 +97,6 @@ Todolist:
 *   mctp
 *   mpls-sysctl
 *   mptcp
-*   mptcp-sysctl
 *   multiqueue
 *   multi-pf-netdev
 *   net_cachelines/index
diff --git a/Documentation/translations/zh_CN/networking/mptcp-sysctl.rst b/Documentation/translations/zh_CN/networking/mptcp-sysctl.rst
new file mode 100644
index 000000000000..0b1b9ed7c647
--- /dev/null
+++ b/Documentation/translations/zh_CN/networking/mptcp-sysctl.rst
@@ -0,0 +1,139 @@
+.. SPDX-License-Identifier: GPL-2.0
+
+.. include:: ../disclaimer-zh_CN.rst
+
+:Original: Documentation/networking/mptcp-sysctl.rst
+
+:翻译:
+
+   孙渔喜 Sun yuxi <sun.yuxi@zte.com.cn>
+
+================
+MPTCP Sysfs 变量
+================
+
+/proc/sys/net/mptcp/* Variables
+===============================
+
+add_addr_timeout - INTEGER (秒)
+	设置ADD_ADDR控制消息的重传超时时间。当MPTCP对端未确认
+	先前的ADD_ADDR消息时,将在该超时时间后重新发送。
+
+	默认值与TCP_RTO_MAX相同。此为每个命名空间的sysctl参数。
+
+	默认值:120
+
+allow_join_initial_addr_port - BOOLEAN
+	控制是否允许对端向初始子流使用的IP地址和端口号发送加入
+	请求(1表示允许)。此参数会设置连接时发送给对端的标志位,
+	并决定是否接受此类加入请求。
+
+	通过ADD_ADDR通告的地址不受此参数影响。
+
+	此为每个命名空间的sysctl参数。
+
+	默认值:1
+
+available_path_managers - STRING
+	显示已注册的可用路径管理器选项。可能有更多路径管理器可用
+	但尚未加载。
+
+available_schedulers - STRING
+	显示已注册的可用调度器选项。可能有更多数据包调度器可用
+	但尚未加载。
+
+blackhole_timeout - INTEGER (秒)
+	当发生MPTCP防火墙黑洞问题时,初始禁用活跃MPTCP套接字上MPTCP
+	功能的时间(秒)。如果在重新启用MPTCP后立即检测到更多黑洞问题,
+	此时间段将呈指数增长;当黑洞问题消失时,将重置为初始值。
+
+	设置为0可禁用黑洞检测功能。此为每个命名空间的sysctl参数。
+
+	默认值:3600
+
+checksum_enabled - BOOLEAN
+	控制是否启用DSS校验和功能。
+
+	当值为非零时可启用DSS校验和。此为每个命名空间的sysctl参数。
+
+	默认值:0
+
+close_timeout - INTEGER (seconds)
+	设置"先断后连"超时时间:在未调用close或shutdown系统调用时,
+	MPTCP套接字将在最后一个子流移除后保持当前状态达到该时长,才
+	会转为TCP_CLOSE状态。
+
+	默认值与TCP_TIMEWAIT_LEN相同。此为每个命名空间的sysctl参数。
+
+	默认值:60
+
+enabled - BOOLEAN
+	控制是否允许创建MPTCP套接字。
+
+	当值为1时允许创建MPTCP套接字。此为每个命名空间的sysctl参数。
+
+	默认值:1(启用)
+
+path_manager - STRING
+	设置用于每个新MPTCP套接字的默认路径管理器名称。内核路径管理将
+	根据通过MPTCP netlink API配置的每个命名空间值来控制子流连接
+	和地址通告。用户空间路径管理将每个MPTCP连接的子流连接决策和地
+	址通告交由特权用户空间程序控制,代价是需要更多netlink流量来
+	传播所有相关事件和命令。
+
+	此为每个命名空间的sysctl参数。
+
+	* "kernel"		  - 内核路径管理器
+	* "userspace"	   - 用户空间路径管理器
+
+	默认值:"kernel"
+
+pm_type - INTEGER
+	设置用于每个新MPTCP套接字的默认路径管理器类型。内核路径管理将
+	根据通过MPTCP netlink API配置的每个命名空间值来控制子流连接
+	和地址通告。用户空间路径管理将每个MPTCP连接的子流连接决策和地
+	址通告交由特权用户空间程序控制,代价是需要更多netlink流量来
+	传播所有相关事件和命令。
+
+	此为每个命名空间的sysctl参数。
+
+	自v6.15起已弃用,请改用path_manager参数。
+
+	* 0 - 内核路径管理器
+	* 1 - 用户空间路径管理器
+
+	默认值:0
+
+scheduler - STRING
+	选择所需的调度器类型。
+
+	支持选择不同的数据包调度器。此为每个命名空间的sysctl参数。
+
+	默认值:"default"
+
+stale_loss_cnt - INTEGER
+	用于判定子流失效(stale)的MPTCP层重传间隔次数阈值。当指定
+	子流在连续多个重传间隔内既无数据传输又有待处理数据时,将被标
+	记为失效状态。失效子流将被数据包调度器忽略。
+	设置较低的stale_loss_cnt值可实现快速主备切换,较高的值则能
+	最大化边缘场景(如高误码率链路或对端暂停数据处理等异常情况)
+	的链路利用率。
+
+	此为每个命名空间的sysctl参数。
+
+	默认值:4
+
+syn_retrans_before_tcp_fallback - INTEGER
+	在回退到 TCP(即丢弃 MPTCP 选项)之前,SYN + MP_CAPABLE
+	报文的重传次数。换句话说,如果所有报文在传输过程中都被丢弃,
+	那么将会:
+
+	* 首次SYN携带MPTCP支持选项
+	* 按本参数值重传携带MPTCP选项的SYN包
+	* 后续重传将不再携带MPTCP支持选项
+
+	0 表示首次重传即丢弃MPTCP选项。
+	>=128 表示所有SYN重传均保留MPTCP选项设置过低的值可能增加
+	MPTCP黑洞误判几率。此为每个命名空间的sysctl参数。
+
+	默认值:2
-- 
2.25.1

  reply	other threads:[~2025-08-30  8:58 UTC|newest]

Thread overview: 8+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2025-08-30  8:57 [PATCH 0/4 linux next v3] Docs/zh_CN: Translate networking docs " wang.yaxin
2025-08-30  8:58 ` wang.yaxin [this message]
2025-08-30  9:00 ` [PATCH 2/4 v3] Docs/zh_CN: Translate skbuff.rst " wang.yaxin
2025-08-30  9:01 ` [PATCH 3/4 v3] Docs/zh_CN: Translate generic-hdlc.rst " wang.yaxin
2025-08-30  9:01 ` [PATCH 4/4 v3] Docs/zh_CN: Translate timestamping.rst " wang.yaxin
2025-09-12  6:53   ` Yanteng Si
2025-09-16 13:58     ` Alex Shi
2025-09-16 13:56 ` [PATCH 0/4 linux next v3] Docs/zh_CN: Translate networking docs " Alex Shi

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=20250830165818597ycQqMyAK7UIDMwrEArw1C@zte.com.cn \
    --to=wang.yaxin@zte.com.cn \
    --cc=alexs@kernel.org \
    --cc=corbet@lwn.net \
    --cc=fan.yu9@zte.com.cn \
    --cc=he.peilin@zte.com.cn \
    --cc=linux-doc@vger.kernel.org \
    --cc=linux-kernel@vger.kernel.org \
    --cc=qiu.yutan@zte.com.cn \
    --cc=si.yanteng@linux.dev \
    --cc=tu.qiang35@zte.com.cn \
    --cc=xu.xin16@zte.com.cn \
    --cc=yang.yang29@zte.com.cn \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
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®