]> git.ipfire.org Git - thirdparty/iptables.git/commitdiff
extensions: TRACE: Point at xtables-monitor in documentation
authorPhil Sutter <phil@nwl.cc>
Tue, 18 Dec 2018 11:16:30 +0000 (12:16 +0100)
committerFlorian Westphal <fw@strlen.de>
Tue, 18 Dec 2018 11:50:29 +0000 (12:50 +0100)
With iptables-nft, logging of trace events is different from legacy.
Explain why and hint at how to receive events in this case.

Signed-off-by: Phil Sutter <phil@nwl.cc>
Signed-off-by: Florian Westphal <fw@strlen.de>
extensions/libxt_TRACE.man

index 8d590a52e26f898e35f7a869c118c741a34a998a..5187a8d22802f4a112c8508257dc6c2bf43366d2 100644 (file)
@@ -1,13 +1,20 @@
 This target marks packets so that the kernel will log every rule which match 
-the packets as those traverse the tables, chains, rules.
+the packets as those traverse the tables, chains, rules. It can only be used in
+the
+.BR raw
+table.
 .PP
-A logging backend, such as ip(6)t_LOG or nfnetlink_log, must be loaded for this
-to be visible.
+With iptables-legacy, a logging backend, such as ip(6)t_LOG or nfnetlink_log,
+must be loaded for this to be visible.
 The packets are logged with the string prefix:
 "TRACE: tablename:chainname:type:rulenum " where type can be "rule" for 
 plain rule, "return" for implicit rule at the end of a user defined chain 
 and "policy" for the policy of the built in chains. 
-.br
-It can only be used in the
-.BR raw
-table.
+.PP
+With iptables-nft, the target is translated into nftables'
+.B "meta nftrace"
+expression. Hence the kernel sends trace events via netlink to userspace where
+they may be displayed using
+.B "xtables-monitor --trace"
+command. For details, refer to
+.BR xtables-monitor (8).