summaryrefslogtreecommitdiffstats
path: root/stapprobes.3stap.in
diff options
context:
space:
mode:
authorFrank Ch. Eigler <fche@elastic.org>2009-03-27 12:15:19 -0400
committerFrank Ch. Eigler <fche@elastic.org>2009-03-27 12:15:19 -0400
commite904ad9554d7eb3363612f4f32141c6dbc4f50d4 (patch)
treeedd86436170bad118b16b61e0f64708e3f089c85 /stapprobes.3stap.in
parent28f569c22b5a4ec666be5ccdf26fd194d3643c29 (diff)
downloadsystemtap-steved-e904ad9554d7eb3363612f4f32141c6dbc4f50d4.tar.gz
systemtap-steved-e904ad9554d7eb3363612f4f32141c6dbc4f50d4.tar.xz
systemtap-steved-e904ad9554d7eb3363612f4f32141c6dbc4f50d4.zip
PR6819: clarify syntactic vs. semantic probe point validity
Diffstat (limited to 'stapprobes.3stap.in')
-rw-r--r--stapprobes.3stap.in11
1 files changed, 8 insertions, 3 deletions
diff --git a/stapprobes.3stap.in b/stapprobes.3stap.in
index f175e6e0..a8988c71 100644
--- a/stapprobes.3stap.in
+++ b/stapprobes.3stap.in
@@ -49,12 +49,16 @@ including alias's body is skipped. The condition is stacked up through
all levels of alias/wildcard expansion. So the final condition becomes
the logical-and of conditions of all expanded alias/wildcard.
-These are all syntactically valid probe points:
+These are all
+.B syntactically
+valid probe points. (They are generally
+.B semantically
+invalid, depending on the contents of the tapsets, and the versions of
+kernel/user software installed.)
.SAMPLE
kernel.function("foo").return
-syscall(22)
-user.inode("/bin/vi").statement(0x2222)
+process("/bin/vi").statement(0x2222)
end
syscall.*
kernel.function("no_such_function") ?
@@ -62,6 +66,7 @@ module("awol").function("no_such_function") !
signal.*? if (switch)
.ESAMPLE
+
Probes may be broadly classified into "synchronous" and
"asynchronous". A "synchronous" event is deemed to occur when any
processor executes an instruction matched by the specification. This