[PATCH net-next v2 1/2] tcp: document black hole detection for tcp_mtu_probing

From: Yongjian Wang via B4 Relay

Date: Wed Nov 18 2026 - 03:11:11 EST


From: Yongjian Wang <echoowall@xxxxxxxxx>

ip-sysctl.rst says that tcp_mtu_probing=1 enables MTU probing once an
ICMP black hole is detected, but not when that happens or what TCP
does then.

Describe both, as implemented in tcp_write_timeout() and
tcp_mtu_probing(). Also add the missing defaults of tcp_mtu_probing
and tcp_base_mss.

Signed-off-by: Yongjian Wang <echoowall@xxxxxxxxx>
Reviewed-by: Eric Dumazet <edumazet@xxxxxxxxxx>
---
Documentation/networking/ip-sysctl.rst | 21 +++++++++++++++++++++
1 file changed, 21 insertions(+)

diff --git a/Documentation/networking/ip-sysctl.rst b/Documentation/networking/ip-sysctl.rst
index 0b7bfbd98a92..6ac8b3fb9aae 100644
--- a/Documentation/networking/ip-sysctl.rst
+++ b/Documentation/networking/ip-sysctl.rst
@@ -412,6 +412,8 @@ tcp_base_mss - INTEGER
Path MTU discovery (MTU probing). If MTU probing is enabled,
this is the initial MSS used by the connection.

+ Default: 1024
+
tcp_mtu_probe_floor - INTEGER
If MTU probing is enabled this caps the minimum MSS used for search_low
for the connection.
@@ -711,6 +713,25 @@ tcp_mtu_probing - INTEGER
- 1 - Disabled by default, enabled when an ICMP black hole detected
- 2 - Always enabled, use initial MSS of tcp_base_mss.

+ A black hole is detected when the retransmission timer fires after
+ the handshake and retransmissions have stayed unacknowledged for as
+ long as tcp_retries1 retransmissions would take with an RTO starting
+ at 200 ms and doubling each time, which is 3 seconds with the
+ default tcp_retries1. This time is counted from the first
+ retransmission and only checked when the timer fires, so a flow
+ with a 200 ms RTO detects the black hole at the fifth timeout,
+ about 6 seconds after the original transmission.
+
+ With value 1, the first detection enables MTU probing and lowers
+ the MSS to tcp_base_mss if it is larger. From then on, and from the
+ first detection with value 2, each further retransmission timeout
+ lowers search_low to half its MSS, keeping it at most tcp_base_mss
+ and at least tcp_mtu_probe_floor and tcp_min_snd_mss, and lowers the
+ MSS to match if it is larger. Once MTU probing is enabled, the
+ connection also probes for a larger MSS, as with value 2.
+
+ Default: 0
+
tcp_probe_interval - UNSIGNED INTEGER
Controls how often to start TCP Packetization-Layer Path MTU
Discovery reprobe. The default is reprobing every 10 minutes as

--
Git-157)