src: add conntrack information to trace monitor mode
Florian Westphal
maintainerPATCH v3 1/1 src: add conntrack information to trace monitor mode
Upcoming kernel change provides the packets conntrack state in the trace message data.
This allows to see if packet is seen as original or reply, the conntrack state (new, establieshed, related) and the status bits which show if e.g. NAT was applied. Alsoi include conntrack ID so users can use conntrack tool to query the kernel for more information via ctnetlink.
This improves debugging when e.g. packets do not pick up the expected NAT mapping, which could e.g. also happen because of expectations following the NAT binding of the owning conntrack entry.
Example output ("conntrack: " lines are new):
trace id 32 t PRE_RAW packet: iif "enp0s3" ether saddr [..]
trace id 32 t PRE_RAW rule tcp flags syn meta nftrace set 1 (verdict continue)
trace id 32 t PRE_RAW policy accept
trace id 32 t PRE_MANGLE conntrack: ct direction original ct state new ct id 2641368242 trace id 32 t PRE_MANGLE packet: iif "enp0s3" ether saddr [..]
trace id 32 t ct_new_pre rule jump rpfilter (verdict jump rpfilter)
trace id 32 t PRE_MANGLE policy accept
trace id 32 t INPUT conntrack: ct direction original ct state new ct status dnat-done ct id 2641368242 trace id 32 t INPUT packet: iif "enp0s3" [..]
trace id 32 t public_in rule tcp dport 443 accept (verdict accept)
v3: remove clash bit again, kernel won't expose it anymore.
v2: add more status bits: helper, clash, offload, hw-offload.
add flag explanation to documentation.
--- doc/data-types.txt | 30 ++--- include/linux/netfilter/nf_conntrack_common.h | 16 +++ src/ct.c | 7 ++ src/trace.c | 109 ++++++++++++++++++ 4 files changed, 147 insertions(+), 15 deletions(-)
doc/data-types.txt +15 -15
@@ -378,21 +378,21 @@ For each of the types above, keywords are available for convenience: .conntrack status (ct_status) [options="header"] |================== -|Keyword| Value -|expected| -1 -|seen-reply| -2 -|assured| -4 -|confirmed| -8 -|snat| -16 -|dnat| -32 -|dying| -512 +|Keyword| Value | Description +|expected|1| Expected connection; conntrack helper set it up +|seen-reply|2| Conntrack has seen packets in both directions +|assured| 4 |Conntrack entry will not be removed if hash table is full +|confirmed | 8 | Initial packet processed +|snat| 16 | Original source address differs from reply destination +|dnat| 32 | Original destination differs from reply source +|seq-adjust| 64 | tcp sequence number rewrite due to conntrack helper or synproxy +|snat-done| 128 | tried to find matching snat/masquerade rule +|dnat-done| 256 | tried to find matching dnat/redirect rule +|dying| 512 | Connection about to be deleted +|fixed-timeout | 1024 | entry expires even if traffic is active +|helper | 8192 | connection is monitored by conntrack helper +|offload | 16384 | connection is offloaded to a flow table +|hw-offload | 32768 | connection is offloaded to hardware |================ .conntrack event bits (ct_event)
include/linux/netfilter/nf_conntrack_common.h +16 -0
@@ -77,6 +77,22 @@ enum ip_conntrack_status {/* Connection has fixed timeout. */ IPS_FIXED_TIMEOUT_BIT =10 ,IPS_FIXED_TIMEOUT = (1 <<IPS_FIXED_TIMEOUT_BIT ), + +/* Conntrack is a fake untracked entry. Obsolete and not used anymore */ +IPS_UNTRACKED_BIT =12 , +IPS_UNTRACKED = (1 <<IPS_UNTRACKED_BIT ), + +/* Conntrack got a helper explicitly attached (ruleset, ctnetlink). */ +IPS_HELPER_BIT =13 , +IPS_HELPER = (1 <<IPS_HELPER_BIT ), + +/* Conntrack has been offloaded to flow table. */ +IPS_OFFLOAD_BIT =14 , +IPS_OFFLOAD = (1 <<IPS_OFFLOAD_BIT ), + +/* Conntrack has been offloaded to hardware. */ +IPS_HW_OFFLOAD_BIT =15 , + IPS_HW_OFFLOAD = (1 << IPS_HW_OFFLOAD_BIT), };/* Connection tracking event types */
src/ct.c +7 -0
@@ -98,7 +98,14 @@ static const struct symbol_table ct_status_tbl = { SYMBOL("confirmed", IPS_CONFIRMED), SYMBOL("snat", IPS_SRC_NAT), SYMBOL("dnat", IPS_DST_NAT), + SYMBOL("seq-adjust", IPS_SEQ_ADJUST), + SYMBOL("snat-done", IPS_SRC_NAT_DONE), + SYMBOL("dnat-done", IPS_DST_NAT_DONE), SYMBOL("dying", IPS_DYING), + SYMBOL("fixed-timeout", IPS_FIXED_TIMEOUT), + SYMBOL("helper", IPS_HELPER_BIT), + SYMBOL("offload", IPS_OFFLOAD_BIT), + SYMBOL("hw-offload", IPS_HW_OFFLOAD_BIT),SYMBOL_LIST_END }, };
src/trace.c +109 -0
121 lines not on this page · raw message
Signature · 1 line
2.49.0
Quoted 25 lines · Florian Westphal
Upcoming kernel change provides the packets conntrack state in the trace message data.
This allows to see if packet is seen as original or reply, the conntrack state (new, establieshed, related) and the status bits which show if e.g. NAT was applied. Alsoi include conntrack ID so users can use conntrack tool to query the kernel for more information via ctnetlink.
This improves debugging when e.g. packets do not pick up the expected NAT mapping, which could e.g. also happen because of expectations following the NAT binding of the owning conntrack entry.
Example output ("conntrack: " lines are new):
trace id 32 t
PRE_RAWpacket: iif "enp0s3" ether saddr [..]
trace id 32 tPRE_RAWrule tcp flags syn meta nftrace set 1 (verdict continue)
trace id 32 tPRE_RAWpolicy accept
trace id 32 tPRE_MANGLEconntrack: ct direction original ct state new ct id 2641368242 trace id 32 tPRE_MANGLEpacket: iif "enp0s3" ether saddr [..]
trace id 32 tct_new_prerule jump rpfilter (verdict jump rpfilter)
trace id 32 tPRE_MANGLEpolicy accept
trace id 32 t INPUT conntrack: ct direction original ct state new ct status dnat-done ct id 2641368242 trace id 32 t INPUT packet: iif "enp0s3" [..]
trace id 32 tpublic_inrule tcp dport 443 accept (verdict accept)
Quoted 5 lines
v3: remove clash bit again, kernel won't expose it anymore.
v2: add more status bits: helper, clash, offload, hw-offload.
add flag explanation to documentation.Signed-off-by Florian Westphal <[email protected]>
Thanks.