From: Yongjian Wang 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 --- This describes the behavior checked by the black hole detection tests added in commit 8a83f21ad75d ("selftests/net: packetdrill: add TCP black hole detection tests"). --- Documentation/networking/ip-sysctl.rst | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) diff --git a/Documentation/networking/ip-sysctl.rst b/Documentation/networking/ip-sysctl.rst index 0b7bfbd98a92..a11baf04758c 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,20 @@ 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 the minimum + RTO, which is 3 seconds with the default tcp_retries1. + + With value 1, the first detection enables MTU probing and the MSS + falls back to tcp_base_mss. Each later detection, or any detection + with value 2, 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. + 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 --- base-commit: 6ff4c5942a301675eb12e5b49d53a81e604624a1 change-id: 20261117-tcp-mtu-probing-doc-v1-351cb754fa7b Best regards, -- Yongjian Wang