[PATCH tracing 3/3] tracing: document > 8 byte numeric filtering support

From: Alan Maguire
Date: Tue Apr 25 2023 - 05:17:04 EST


For values > 8 bytes in size, only == and != filter predicates are
supported; document this.

Signed-off-by: Alan Maguire <alan.maguire@xxxxxxxxxx>
---
Documentation/trace/events.rst | 9 +++++++++
1 file changed, 9 insertions(+)

diff --git a/Documentation/trace/events.rst b/Documentation/trace/events.rst
index f5fcb8e1218f..0142bf59dc4b 100644
--- a/Documentation/trace/events.rst
+++ b/Documentation/trace/events.rst
@@ -186,6 +186,15 @@ The operators available for numeric fields are:

==, !=, <, <=, >, >=, &

+For numeric fields larger than 8 bytes, only
+
+==, !=
+
+...are allowed, and values for comparison must match field size exactly.
+For example, to match the "::1" IPv6 address:
+
+"dst == 0x00000000000000000000000000000001"
+
And for string fields they are:

==, !=, ~
--
2.31.1