summaryrefslogtreecommitdiffstats
path: root/stapprobes.5.in
diff options
context:
space:
mode:
authorWilliam Cohen <wcohen@redhat.com>2009-02-02 14:22:56 -0500
committerWilliam Cohen <wcohen@redhat.com>2009-02-02 14:22:56 -0500
commit0d65057a8a8b418568a18eb394d3e57f5a8051a5 (patch)
tree164de98691d1d6f37ee7e28579b4b7a23c70f0c5 /stapprobes.5.in
parent1bf72dfea404434f954214298367817d5c591903 (diff)
parent592470cde0ceb84bbf409482927ba6554b536b95 (diff)
downloadsystemtap-steved-0d65057a8a8b418568a18eb394d3e57f5a8051a5.tar.gz
systemtap-steved-0d65057a8a8b418568a18eb394d3e57f5a8051a5.tar.xz
systemtap-steved-0d65057a8a8b418568a18eb394d3e57f5a8051a5.zip
Merge branch 'master' of ssh://sources.redhat.com/git/systemtap
Diffstat (limited to 'stapprobes.5.in')
-rw-r--r--stapprobes.5.in15
1 files changed, 9 insertions, 6 deletions
diff --git a/stapprobes.5.in b/stapprobes.5.in
index b50adc9d..0854be53 100644
--- a/stapprobes.5.in
+++ b/stapprobes.5.in
@@ -263,6 +263,8 @@ kernel.function(PATTERN).return
.br
kernel.function(PATTERN).inline
.br
+kernel.function(PATTERN).label(LPATTERN)
+.br
module(MPATTERN).function(PATTERN)
.br
module(MPATTERN).function(PATTERN).call
@@ -280,8 +282,10 @@ module(MPATTERN).statement(PATTERN)
.ESAMPLE
In the above list, MPATTERN stands for a string literal that aims to
-identify the loaded kernel module of interest. It may include "*", "[]",
-and "?" wildcards. PATTERN stands for a string literal that
+identify the loaded kernel module of interest and LPATTERN stands for
+a source program label. Both MPATTERN and LPATTERN may include the "*"
+"[]", and "?" wildcards.
+PATTERN stands for a string literal that
aims to identify a point in the program. It is made up of three
parts:
.IP \(bu 4
@@ -445,14 +449,13 @@ A
.B .mark
probe gets called via a static probe which is defined in the
application by
-STAP_PROBE1(handle,LABEL,arg1). The handle is an application handle,
+STAP_PROBE1(handle,LABEL,arg1), which is defined in sdt.h. The handle is an application handle,
LABEL corresponds to the .mark argument, and arg1 is the argument.
STAP_PROBE1 is used for probes with 1 argument, STAP_PROBE2 is used
for probes with 2 arguments, and so on.
The arguments of the probe are available in the context variables
-$arg1, $arg2, ...
-The application should be compiled with ../share/systemtap/runtime/sduprobes.h
-and should be linked with libsduprobes.a.
+$arg1, $arg2, ... An alternative to using the STAP_PROBE macros is to
+use the dtrace script to create custom macros.
.PP
Note that
.I PATH