PR18075 documentation

diff --git a/NEWS b/NEWS
index a8aa277dba822ffd7b4fc20b30bb0fb855e9e489..d93206a570de87988b409d4480fdc326fd0d0075 100644 (file)
--- a/NEWS
+++ b/NEWS
@@ -1,5 +1,16 @@
 * What's new in version 2.9
 
+- Callee probe points now support '.return' and '.call' suffix.
+  For example,
+
+    process("proc").function("foo").callee("bar").return
+
+  will fire upon returning from bar when called by foo.
+
+    process("proc").function("foo").callee("bar").call
+
+  will only fire for non-inlined callees.
+
 - The following tapset variables and functions are deprecated in
   version 2.9:
   - The '__int32_compat' library macro got deprecated in favor of

diff --git a/man/stapprobes.3stap b/man/stapprobes.3stap
index fe27582bbfcad4be5b9f2b4e9c82e4e86b24a18b..fcf789b92900a4ac96f290c9c3690c3f4e1436cd 100644 (file)
--- a/man/stapprobes.3stap
+++ b/man/stapprobes.3stap
@@ -370,6 +370,8 @@ Here is a list of DWARF probe points currently supported:
 kernel.function(PATTERN)
 kernel.function(PATTERN).call
 kernel.function(PATTERN).callee(PATTERN)
+kernel.function(PATTERN).callee(PATTERN).return
+kernel.function(PATTERN).callee(PATTERN).call
 kernel.function(PATTERN).callees(DEPTH)
 kernel.function(PATTERN).return
 kernel.function(PATTERN).inline
@@ -377,6 +379,8 @@ kernel.function(PATTERN).label(LPATTERN)
 module(MPATTERN).function(PATTERN)
 module(MPATTERN).function(PATTERN).call
 module(MPATTERN).function(PATTERN).callee(PATTERN)
+module(MPATTERN).function(PATTERN).callee(PATTERN).return
+module(MPATTERN).function(PATTERN).callee(PATTERN).call
 module(MPATTERN).function(PATTERN).callees(DEPTH)
 module(MPATTERN).function(PATTERN).return
 module(MPATTERN).function(PATTERN).inline
@@ -393,6 +397,8 @@ process("PATH").library("PATH").statement("*@FILE.c:123").nearest
 process("PATH").function("*").return
 process("PATH").function("myfun").label("foo")
 process("PATH").function("foo").callee("bar")
+process("PATH").function("foo").callee("bar").return
+process("PATH").function("foo").callee("bar").call
 process("PATH").function("foo").callees(DEPTH)
 process(PID).function("NAME")
 process(PID).function("myfun").label("foo")