[RFC tracing 4/4] tracing: document > 8 byte numeric filtering support

From: Alan Maguire
Date: Sun Aug 07 2022 - 18:34:33 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 c47f381d0c00..318dba2fe3ee 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