Linux kernel mirror (for testing) git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel os linux

doc: Tighten-up and clarify description of tcp_fin_timeout

The description for tcp_fin_timeout should be tigher and more clear.

In addition to being tighter, we should make the spelling of the
state name consistent with what utilities report, remove the now
dated reference to 2.2 and put the default in the consistent place.

Signed-off-by: Rick Jones <rick.jones2@hp.com>
Signed-off-by: David S. Miller <davem@davemloft.net>

authored by

Rick Jones and committed by
David S. Miller
d825da2e b146ecd6

+8 -9
+8 -9
Documentation/networking/ip-sysctl.txt
··· 224 224 The value is not used, if tcp_sack is not enabled. 225 225 226 226 tcp_fin_timeout - INTEGER 227 - Time to hold socket in state FIN-WAIT-2, if it was closed 228 - by our side. Peer can be broken and never close its side, 229 - or even died unexpectedly. Default value is 60sec. 230 - Usual value used in 2.2 was 180 seconds, you may restore 231 - it, but remember that if your machine is even underloaded WEB server, 232 - you risk to overflow memory with kilotons of dead sockets, 233 - FIN-WAIT-2 sockets are less dangerous than FIN-WAIT-1, 234 - because they eat maximum 1.5K of memory, but they tend 235 - to live longer. Cf. tcp_max_orphans. 227 + The length of time an orphaned (no longer referenced by any 228 + application) connection will remain in the FIN_WAIT_2 state 229 + before it is aborted at the local end. While a perfectly 230 + valid "receive only" state for an un-orphaned connection, an 231 + orphaned connection in FIN_WAIT_2 state could otherwise wait 232 + forever for the remote to close its end of the connection. 233 + Cf. tcp_max_orphans 234 + Default: 60 seconds 236 235 237 236 tcp_frto - INTEGER 238 237 Enables Forward RTO-Recovery (F-RTO) defined in RFC4138.