tracing: Update documentation on tracepoint glob matching
authorSteven Rostedt (Red Hat) <rostedt@goodmis.org>
Mon, 17 Jun 2013 14:59:17 +0000 (10:59 -0400)
committerSteven Rostedt <rostedt@goodmis.org>
Thu, 20 Jun 2013 03:32:06 +0000 (23:32 -0400)
b0f1a59a "tracing/filters: Use a different op for glob match" added
glob matching to tracepoint filter strings. It uses the ftrace function
tracing glob matching facility that allows for the wild card character (*)
to be used at the start and/or end of the matching string.

But the documentation still states that the filtering only allows for
exact string matches.

Cc: Li Zefan <lizefan@huawei.com>
Signed-off-by: Steven Rostedt <rostedt@goodmis.org>
Documentation/trace/events.txt

index 41911240c65c47f48832f8fd645bedfd47eb12a4..37732a220d331dcbafbf49c1fb0b04fc0cb6edad 100644 (file)
@@ -187,9 +187,18 @@ The operators available for numeric fields are:
 
 And for string fields they are:
 
-==, !=
+==, !=, ~
 
-Currently, only exact string matches are supported.
+The glob (~) only accepts a wild card character (*) at the start and or
+end of the string. For example:
+
+  prev_comm ~ "*sh"
+  prev_comm ~ "sh*"
+  prev_comm ~ "*sh*"
+
+But does not allow for it to be within the string:
+
+  prev_comm ~ "ba*sh"   <-- is invalid
 
 5.2 Setting filters
 -------------------