|
 |
029dc7 |
From 39808343b03078f992bc5e831ccdd843312f0714 Mon Sep 17 00:00:00 2001
|
|
|
029dc7 |
From: Phil Sutter <phil@nwl.cc>
|
|
|
029dc7 |
Date: Tue, 18 Dec 2018 12:16:30 +0100
|
|
|
029dc7 |
Subject: [PATCH] extensions: TRACE: Point at xtables-monitor in documentation
|
|
|
029dc7 |
|
|
|
029dc7 |
With iptables-nft, logging of trace events is different from legacy.
|
|
|
029dc7 |
Explain why and hint at how to receive events in this case.
|
|
|
029dc7 |
|
|
|
029dc7 |
Signed-off-by: Phil Sutter <phil@nwl.cc>
|
|
|
029dc7 |
Signed-off-by: Florian Westphal <fw@strlen.de>
|
|
|
029dc7 |
(cherry picked from commit 9ac39888722ee9c7e97d9b8cb9eb4f33b582130a)
|
|
|
029dc7 |
Signed-off-by: Phil Sutter <psutter@redhat.com>
|
|
|
029dc7 |
---
|
|
|
029dc7 |
extensions/libxt_TRACE.man | 21 ++++++++++++++-------
|
|
|
029dc7 |
1 file changed, 14 insertions(+), 7 deletions(-)
|
|
|
029dc7 |
|
|
|
029dc7 |
diff --git a/extensions/libxt_TRACE.man b/extensions/libxt_TRACE.man
|
|
|
029dc7 |
index 8d590a52e26f8..5187a8d22802f 100644
|
|
|
029dc7 |
--- a/extensions/libxt_TRACE.man
|
|
|
029dc7 |
+++ b/extensions/libxt_TRACE.man
|
|
|
029dc7 |
@@ -1,13 +1,20 @@
|
|
|
029dc7 |
This target marks packets so that the kernel will log every rule which match
|
|
|
029dc7 |
-the packets as those traverse the tables, chains, rules.
|
|
|
029dc7 |
+the packets as those traverse the tables, chains, rules. It can only be used in
|
|
|
029dc7 |
+the
|
|
|
029dc7 |
+.BR raw
|
|
|
029dc7 |
+table.
|
|
|
029dc7 |
.PP
|
|
|
029dc7 |
-A logging backend, such as ip(6)t_LOG or nfnetlink_log, must be loaded for this
|
|
|
029dc7 |
-to be visible.
|
|
|
029dc7 |
+With iptables-legacy, a logging backend, such as ip(6)t_LOG or nfnetlink_log,
|
|
|
029dc7 |
+must be loaded for this to be visible.
|
|
|
029dc7 |
The packets are logged with the string prefix:
|
|
|
029dc7 |
"TRACE: tablename:chainname:type:rulenum " where type can be "rule" for
|
|
|
029dc7 |
plain rule, "return" for implicit rule at the end of a user defined chain
|
|
|
029dc7 |
and "policy" for the policy of the built in chains.
|
|
|
029dc7 |
-.br
|
|
|
029dc7 |
-It can only be used in the
|
|
|
029dc7 |
-.BR raw
|
|
|
029dc7 |
-table.
|
|
|
029dc7 |
+.PP
|
|
|
029dc7 |
+With iptables-nft, the target is translated into nftables'
|
|
|
029dc7 |
+.B "meta nftrace"
|
|
|
029dc7 |
+expression. Hence the kernel sends trace events via netlink to userspace where
|
|
|
029dc7 |
+they may be displayed using
|
|
|
029dc7 |
+.B "xtables-monitor --trace"
|
|
|
029dc7 |
+command. For details, refer to
|
|
|
029dc7 |
+.BR xtables-monitor (8).
|
|
|
029dc7 |
--
|
|
|
029dc7 |
2.21.0
|
|
|
029dc7 |
|