From a43ba4339f5b291d139e0be59bba4bc46c55ea25 Mon Sep 17 00:00:00 2001 From: "Frank Ch. Eigler" Date: Fri, 15 Aug 2008 12:21:22 -0400 Subject: PR6836: $$vars extensions, $$return --- stapprobes.5.in | 16 ++++++++++++---- 1 file changed, 12 insertions(+), 4 deletions(-) (limited to 'stapprobes.5.in') diff --git a/stapprobes.5.in b/stapprobes.5.in index c71f79d3..f1626166 100644 --- a/stapprobes.5.in +++ b/stapprobes.5.in @@ -334,6 +334,11 @@ $var\->field traversal to a structure's field. The indirection operator may be repeated to follow more levels of pointers. .TP +$return +is available in return probes only for functions that are declared +with a return value. +.TP +.TP $var[N] indexes into an array. The index is given with a literal number. @@ -344,12 +349,15 @@ sprintf("parm1=%x ... parmN=%x var1=%x ... varN=%x", parm1, ..., parmN, var1, ..., varN) .TP $$locals -expands to a character string that is equivalent to -sprintf("var1=%x ... varN=%x", var1, ..., varN) +expands to a subset of $$vars for only local variables. .TP $$parms -expands to a character string that is equivalent to -sprintf("parm1=%x ... parmN=%x", parm1, ..., parmN) +expands to a subset of $$vars for only function parameters. +.TP +$$return +is available in return probes only. It expands to a string that +is equivalent to sprintf("$return=%x", $return) +if the probed function has a return value, or else an empty string. .PP For ".return" probes, context variables other than the "$return" value itself are only available for the function call parameters. -- cgit From fd5747054ac2a5c90d209195c55e6310972f969a Mon Sep 17 00:00:00 2001 From: "Frank Ch. Eigler" Date: Fri, 15 Aug 2008 14:46:27 -0400 Subject: PR6836: tweak $$return formatting --- stapprobes.5.in | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'stapprobes.5.in') diff --git a/stapprobes.5.in b/stapprobes.5.in index f1626166..a3697d0d 100644 --- a/stapprobes.5.in +++ b/stapprobes.5.in @@ -356,7 +356,7 @@ expands to a subset of $$vars for only function parameters. .TP $$return is available in return probes only. It expands to a string that -is equivalent to sprintf("$return=%x", $return) +is equivalent to sprintf("return=%x", $return) if the probed function has a return value, or else an empty string. .PP For ".return" probes, context variables other than the "$return" -- cgit From 986e98de88e5a55451aaf24a6ead7f44725124c1 Mon Sep 17 00:00:00 2001 From: David Smith Date: Fri, 15 Aug 2008 14:02:31 -0500 Subject: Change system-wide probes from 'process("*").begin' to 'process.begin'. 2008-08-15 David Smith * tapsets.cxx (utrace_builder::build): Change system-wide probes from 'process("*").begin' to 'process.begin'. (register_standard_tapsets): Add new 'process' binding. * stapprobes.5.in: Change system-wide probes from 'process("*").begin' to 'process.begin'. 2008-08-15 David Smith * systemtap.base/utrace_p4.exp: Change system-wide probes from 'process("*").begin' to 'process.begin'. --- stapprobes.5.in | 11 ++++++++--- 1 file changed, 8 insertions(+), 3 deletions(-) (limited to 'stapprobes.5.in') diff --git a/stapprobes.5.in b/stapprobes.5.in index f1626166..4b2b4e2b 100644 --- a/stapprobes.5.in +++ b/stapprobes.5.in @@ -386,16 +386,22 @@ Additional user-space probing is available in the following forms: .SAMPLE process(PID).begin process("PATH").begin +process.begin process(PID).thread.begin process("PATH").thread.begin +process.thread.begin process(PID).end process("PATH").end +process.end process(PID).thread.end process("PATH").thread.end +process.thread.end process(PID).syscall process("PATH").syscall +process.syscall process(PID).syscall.return process("PATH").syscall.return +process.syscall.return process(PID).itrace process("PATH").itrace .ESAMPLE @@ -431,9 +437,8 @@ Note that names refer to executables that are searched the same way shells do: relative to the working directory if they contain a "/" character, otherwise in .BR $PATH . -A -.I PATH -of "*" means to probe all threads. +If a process probe is specified without a PID or PATH, all user +threads are probed. .SS PROCFS -- cgit