Documentation revision for TCP_USER_TIMEOUT in man7/tcp7

man7/tcp.7 +2 -1

index 6c91f058b..2ce831c90 100644
@@ -1161,7 +1161,8 @@ This option takes an
 as an argument.
 When the value is greater than 0,
 it specifies the maximum amount of time in milliseconds that transmitted
-data may remain unacknowledged before TCP will forcibly close the
+data may remain unacknowledged, or bufferred data may remain untransmitted
+(due to zero window size) before TCP will forcibly close the
 corresponding connection and return
 .B ETIMEDOUT
 to the application.

Hello Enke (and Eric),

Thank you for the patch. Is this a change in behavior, or a better documentation of longstanding behavior?

Eric, do you have an Ack/Review for this patch?

Thanks,

Michael

Quoted 15 lines · Enke Chen

man7/tcp.7 +2 -1

index 6c91f058b..2ce831c90 100644
@@ -1161,7 +1161,8 @@ This option takes an
 as an argument.
 When the value is greater than 0,
 it specifies the maximum amount of time in milliseconds that transmitted
-data may remain unacknowledged before TCP will forcibly close the
+data may remain unacknowledged, or bufferred data may remain untransmitted
+(due to zero window size) before TCP will forcibly close the
 corresponding connection and return
 .B ETIMEDOUT
 to the application.

Signature · 3 lines

Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Linux/UNIX System Programming Training: http://man7.org/training/

Hello Michael:

It is the latter, better documentation of longstanding behavior.

There is a bug, however, that broke the functionality two years ago. The bug is being fixed.

Quoted 34 lines

Hello Enke (and Eric),

Thank you for the patch. Is this a change in behavior, or a better documentation of longstanding behavior?

Eric, do you have an Ack/Review for this patch?

Thanks,

Michael

Quoted 15 lines · Enke Chen

man7/tcp.7 +2 -1

index 6c91f058b..2ce831c90 100644
@@ -1161,7 +1161,8 @@ This option takes an
 as an argument.
 When the value is greater than 0,
 it specifies the maximum amount of time in milliseconds that transmitted
-data may remain unacknowledged before TCP will forcibly close the
+data may remain unacknowledged, or bufferred data may remain untransmitted
+(due to zero window size) before TCP will forcibly close the
 corresponding connection and return
 .B ETIMEDOUT
 to the application.

Signature · 3 lines

Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Linux/UNIX System Programming Training: http://man7.org/training/