Skip to contentSkip to conversation

tcp.7: tcp_syncookies: It is now an integer [0, 2]

PATCH Superseded Alejandro Colomar 2 participants 5 messages Dec 7, 2020 – Dec 11, 2020 Man-pages: manual pages for Linux -- Sections 2, 3, 4, 5, and 7

lore
Share & tools
lore
#0 lore raw

PATCH 1/1 tcp.7: tcp_syncookies: It is now an integer [0, 2]

Since Linux kernel 3.12, tcp_syncookies can have the value 2, which sends out cookies unconditionally.

Related kernel commits:
5ad37d5deee1ff7150a2d0602370101de158ad86
d8513df2598e5142f8a5c4724f28411936e1dfc7

Cc Eric Dumazet <[email protected]>
Cc Hannes Frederic Sowa <[email protected]>
Cc David S. Miller <[email protected]>
---
 man7/tcp.7 | 14 ++++++++++++--
 1 file changed, 12 insertions(+), 2 deletions(-)
man7/tcp.7 +12 -2
index d983a8f9a..591f73d8d 100644
@@ -830,12 +830,11 @@ The maximum number of times a SYN/ACK segment
 for a passive TCP connection will be retransmitted.
 This number should not be higher than 255.
 .TP
-.IR tcp_syncookies " (Boolean; since Linux 2.2)"
+.IR tcp_syncookies " (integer; default: 1; since Linux 2.2)"
 .\" Since 2.1.43
 Enable TCP syncookies.
 The kernel must be compiled with
 .BR CONFIG_SYN_COOKIES .
-Send out syncookies when the syn backlog queue of a socket overflows.
 The syncookies feature attempts to protect a
 socket from a SYN flood attack.
 This should be used as a last resort, if at all.
@@ -849,6 +848,17 @@ For recommended alternatives see
 .IR tcp_synack_retries ,
 and
 .IR tcp_abort_on_overflow .
+Set to one of the following values:
+.RS
+.IP 0 3
+Disable TCP syncookies.
+.IP 1
+Send out syncookies when the syn backlog queue of a socket overflows.
+.IP 2
+.\" commit 5ad37d5deee1ff7150a2d0602370101de158ad86
+Send out syncookies unconditionally.
+This can be useful for network testing.
+.RE
 .TP
 .IR tcp_timestamps " (integer; default: 1; since Linux 2.2)"
 .\" Since 2.1.36
Signature · 1 line
2.29.2
#1 lore raw

Hi Alex,

Quoted 35 lines · Alejandro Colomar

Since Linux kernel 3.12, tcp_syncookies can have the value 2, which sends out cookies unconditionally.

Related kernel commits:
5ad37d5deee1ff7150a2d0602370101de158ad86
d8513df2598e5142f8a5c4724f28411936e1dfc7

Cc Eric Dumazet <[email protected]>
Cc Hannes Frederic Sowa <[email protected]>
Cc David S. Miller <[email protected]>
---
 man7/tcp.7 | 14 ++++++++++++--
 1 file changed, 12 insertions(+), 2 deletions(-)
man7/tcp.7 +1 -2
index d983a8f9a..591f73d8d 100644
@@ -830,12 +830,11 @@ The maximum number of times a SYN/ACK segment
 for a passive TCP connection will be retransmitted.
 This number should not be higher than 255.
 .TP
-.IR tcp_syncookies " (Boolean; since Linux 2.2)"
+.IR tcp_syncookies " (integer; default: 1; since Linux 2.2)"
 .\" Since 2.1.43
 Enable TCP syncookies.
 The kernel must be compiled with
 .BR CONFIG_SYN_COOKIES .
-Send out syncookies when the syn backlog queue of a socket overflows.
 The syncookies feature attempts to protect a
 socket from a SYN flood attack.
 This should be used as a last resort, if at all.

man7/tcp.7 For recommended alternatives see · line 857

Quoted 10 lines
man7/tcp.7 +7 -0
@@ -849,6 +848,17 @@ For recommended alternatives see
 .IR tcp_synack_retries ,
 and
 .IR tcp_abort_on_overflow .
+Set to one of the following values:
+.RS
+.IP 0 3
+Disable TCP syncookies.
+.IP 1
+Send out syncookies when the syn backlog queue of a socket overflows.
+.IP 2

I think it's helpful to let the reader know that this is a more recent feature. So, better:

.IP 2 (since Linux 3.12)

Thanks,

Michael

Quoted 8 lines
man7/tcp.7 +4 -0
+.\" commit 5ad37d5deee1ff7150a2d0602370101de158ad86
+Send out syncookies unconditionally.
+This can be useful for network testing.
+.RE
 .TP
 .IR tcp_timestamps " (integer; default: 1; since Linux 2.2)"
 .\" Since 2.1.36
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/
#2 lore raw

Hi Michael,

On 12/11/20 9:32 AM, Michael Kerrisk (man-pages) wrote:[...]

Quoted 6 lines
Quoted 1 line

+.IP 2

I think it's helpful to let the reader know that this is a more recent feature. So, better:

.IP 2 (since Linux 3.12)

Sure!

Thanks,

Alex

Quoted 15 lines

Thanks,

Michael

Quoted 8 lines

+.\" commit 5ad37d5deee1ff7150a2d0602370101de158ad86

man7/tcp.7 +3 -0
+Send out syncookies unconditionally.
+This can be useful for network testing.
+.RE
 .TP
 .IR tcp_timestamps " (integer; default: 1; since Linux 2.2)"
 .\" Since 2.1.36
Signature · 3 lines
Alejandro Colomar
Linux man-pages comaintainer; https://www.kernel.org/doc/man-pages/
http://www.alejandro-colomar.es
#3 lore raw

PATCH v2 1/1 tcp.7: tcp_syncookies: It is now an integer [0, 2]

Since Linux kernel 3.12, tcp_syncookies can have the value 2, which sends out cookies unconditionally.

Related kernel commits:
5ad37d5deee1ff7150a2d0602370101de158ad86
d8513df2598e5142f8a5c4724f28411936e1dfc7

Cc Eric Dumazet <[email protected]>
Cc Hannes Frederic Sowa <[email protected]>
Cc David S. Miller <[email protected]>
---
 man7/tcp.7 | 15 +++++++++++++--
 1 file changed, 13 insertions(+), 2 deletions(-)
man7/tcp.7 +13 -2
index d983a8f9a..cce8dd910 100644
@@ -830,12 +830,11 @@ The maximum number of times a SYN/ACK segment
 for a passive TCP connection will be retransmitted.
 This number should not be higher than 255.
 .TP
-.IR tcp_syncookies " (Boolean; since Linux 2.2)"
+.IR tcp_syncookies " (integer; default: 1; since Linux 2.2)"
 .\" Since 2.1.43
 Enable TCP syncookies.
 The kernel must be compiled with
 .BR CONFIG_SYN_COOKIES .
-Send out syncookies when the syn backlog queue of a socket overflows.
 The syncookies feature attempts to protect a
 socket from a SYN flood attack.
 This should be used as a last resort, if at all.
@@ -849,6 +848,18 @@ For recommended alternatives see
 .IR tcp_synack_retries ,
 and
 .IR tcp_abort_on_overflow .
+Set to one of the following values:
+.RS
+.IP 0 3
+Disable TCP syncookies.
+.IP 1
+Send out syncookies when the syn backlog queue of a socket overflows.
+.IP 2
+(since Linux 3.12)
+.\" commit 5ad37d5deee1ff7150a2d0602370101de158ad86
+Send out syncookies unconditionally.
+This can be useful for network testing.
+.RE
 .TP
 .IR tcp_timestamps " (integer; default: 1; since Linux 2.2)"
 .\" Since 2.1.36
Signature · 1 line
2.29.2
#4 lore raw

Hi Alex,

Quoted 2 lines · Alejandro Colomar

Since Linux kernel 3.12, tcp_syncookies can have the value 2, which sends out cookies unconditionally.

Thanks. Patch applied.

Cheers,

Michael

Quoted 51 lines

Related kernel commits:
5ad37d5deee1ff7150a2d0602370101de158ad86
d8513df2598e5142f8a5c4724f28411936e1dfc7

Cc Eric Dumazet <[email protected]>
Cc Hannes Frederic Sowa <[email protected]>
Cc David S. Miller <[email protected]>
---
 man7/tcp.7 | 15 +++++++++++++--
 1 file changed, 13 insertions(+), 2 deletions(-)
man7/tcp.7 +13 -2
index d983a8f9a..cce8dd910 100644
@@ -830,12 +830,11 @@ The maximum number of times a SYN/ACK segment
 for a passive TCP connection will be retransmitted.
 This number should not be higher than 255.
 .TP
-.IR tcp_syncookies " (Boolean; since Linux 2.2)"
+.IR tcp_syncookies " (integer; default: 1; since Linux 2.2)"
 .\" Since 2.1.43
 Enable TCP syncookies.
 The kernel must be compiled with
 .BR CONFIG_SYN_COOKIES .
-Send out syncookies when the syn backlog queue of a socket overflows.
 The syncookies feature attempts to protect a
 socket from a SYN flood attack.
 This should be used as a last resort, if at all.
@@ -849,6 +848,18 @@ For recommended alternatives see
 .IR tcp_synack_retries ,
 and
 .IR tcp_abort_on_overflow .
+Set to one of the following values:
+.RS
+.IP 0 3
+Disable TCP syncookies.
+.IP 1
+Send out syncookies when the syn backlog queue of a socket overflows.
+.IP 2
+(since Linux 3.12)
+.\" commit 5ad37d5deee1ff7150a2d0602370101de158ad86
+Send out syncookies unconditionally.
+This can be useful for network testing.
+.RE
 .TP
 .IR tcp_timestamps " (integer; default: 1; since Linux 2.2)"
 .\" Since 2.1.36
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/