docs: networking: Update connection tracking offload sysctl parameters
Subsystems (3)
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
@@ -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
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.
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_pickupSigned-off-by Oz Shlomo<[email protected]>
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 :-)
Pablo Neira Ayuso
maintainerQuoted 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_pickupSigned-off-by Oz Shlomo<[email protected]>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!
Quoted 8 lines · Pablo Neira Ayuso
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.
That would be cool :-)