Skip to contentSkip to conversation

docs: networking: Update connection tracking offload sysctl parameters

PATCH Applied Oz Shlomo 3 participants 5 messages Jun 17, 2021 – Jun 21, 2021

Subsystems (3)
lore
Share & tools
lore

Oz Shlomo

author
#0 lore raw

PATCH 1/1 docs: networking: Update connection tracking offload sysctl parameters

Document the following connection offload configuration parameters:
- nf_flowtable_tcp_timeout
- nf_flowtable_tcp_pickup
- nf_flowtable_udp_timeout
- nf_flowtable_udp_pickup

---
 Documentation/networking/nf_conntrack-sysctl.rst | 24 ++++++++++++++++++++++++
 1 file changed, 24 insertions(+)
Documentation/networking/nf_conntrack-sysctl.rst +24 -0
index 11a9b76786cb..0467b30e4abe 100644
@@ -177,3 +177,27 @@ nf_conntrack_gre_timeout_stream - INTEGER (seconds)
 
 	This extended timeout will be used in case there is an GRE stream
 	detected.
+
+nf_flowtable_tcp_timeout - INTEGER (seconds)
+        default 30
+
+        Control offload timeout for tcp connections.
+        TCP connections may be offloaded from nf conntrack to nf flow table.
+        Once aged, the connection is returned to nf conntrack with tcp pickup timeout.
+
+nf_flowtable_tcp_pickup - INTEGER (seconds)
+        default 120
+
+        TCP connection timeout after being aged from nf flow table offload.
+
+nf_flowtable_udp_timeout - INTEGER (seconds)
+        default 30
+
+        Control offload timeout for udp connections.
+        UDP connections may be offloaded from nf conntrack to nf flow table.
+        Once aged, the connection is returned to nf conntrack with udp pickup timeout.
+
+nf_flowtable_udp_pickup - INTEGER (seconds)
+        default 30
+
+        UDP connection timeout after being aged from nf flow table offload.
Signature · 1 line
1.8.3.1
maintainer Applied
#1 lore raw
Quoted 5 lines · Oz Shlomo

Document the following connection offload configuration parameters:
- nf_flowtable_tcp_timeout
- nf_flowtable_tcp_pickup
- nf_flowtable_udp_timeout
- nf_flowtable_udp_pickup

Applied, thanks.

#2 lore raw
In reply to Oz Shlomo
Quoted 7 lines · Oz Shlomo

Document the following connection offload configuration parameters:
- nf_flowtable_tcp_timeout
- nf_flowtable_tcp_pickup
- nf_flowtable_udp_timeout
- nf_flowtable_udp_pickup

Sorry for the late feedback.

In my experience the kernel docs have rather poor documents for netfilter sysctl parameters. I often find myself reading the source code for a deeper understanding of what is going on.

The docs included in this patch are too short in my opinion, example:

+nf_flowtable_tcp_pickup - INTEGER (seconds)
+ default 120
+
+ TCP connection timeout after being aged from nf flow table offload.

Here, having an example of the sequence of events going on with the conntrack entry and how this sysctl key affects it would be great. Some explanation of the behavior that may be observed when tuning this value would be nice as well.

Given the patch was merged already, you can feel free to ignore this anyway :-)

#3 lore raw
Quoted 23 lines · Arturo Borrero Gonzalez
Quoted 7 lines · Oz Shlomo

Document the following connection offload configuration parameters:
- nf_flowtable_tcp_timeout
- nf_flowtable_tcp_pickup
- nf_flowtable_udp_timeout
- nf_flowtable_udp_pickup

Sorry for the late feedback.

In my experience the kernel docs have rather poor documents for netfilter sysctl parameters. I often find myself reading the source code for a deeper understanding of what is going on.

The docs included in this patch are too short in my opinion, example:

Documentation/networking/nf_conntrack-sysctl.rst +4 -0
+nf_flowtable_tcp_pickup - INTEGER (seconds)
+        default 120
+
+        TCP connection timeout after being aged from nf flow table offload.
Quoted 6 lines

Here, having an example of the sequence of events going on with the conntrack entry and how this sysctl key affects it would be great. Some explanation of the behavior that may be observed when tuning this value would be nice as well.

Given the patch was merged already, you can feel free to ignore this anyway :-)

I think I can extend the flowtable documentation to include this information:

https://www.kernel.org/doc/html/latest/networking/nf_flowtable.html

to refer to this new sysctl knobs too.

If you think something else in the big picture, please, let me know I'll be glad to extend it.

Thanks!