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 Reviewed-by: Eric Dumazet --- 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)