diff options
| author | fche <fche> | 2005-08-19 21:50:42 +0000 |
|---|---|---|
| committer | fche <fche> | 2005-08-19 21:50:42 +0000 |
| commit | 98afd80eb5038542fa3a98c75528524b5d4287b6 (patch) | |
| tree | 2b968e1c8523fd50596431e09f936290220a0d29 /stap.1.in | |
| parent | efc364eebf15dd7e8b6c93e155af83b6d3971752 (diff) | |
| download | systemtap-steved-98afd80eb5038542fa3a98c75528524b5d4287b6.tar.gz systemtap-steved-98afd80eb5038542fa3a98c75528524b5d4287b6.tar.xz systemtap-steved-98afd80eb5038542fa3a98c75528524b5d4287b6.zip | |
2005-08-19 Frank Ch. Eigler <fche@elastic.org>
PR systemtap/1209
* tapsets.cxx
* elaborate.cxx (derived_probe_builder): Add get_param function.
* elaborate.h: Declare them.
* tapsets.cxx (dwarf_query::get_*_param): Call them.
(timer_derived_probe, timer_builder): New classes.
(register_standard_tapsets): Register timer.jiffies(N) and friend.
* translate.cxx (translate_pass): #include <linux/timers.h>.
* stap.1.in: Document timer.jiffies(N) probe points.
* testsuite/buildok/fourteen.stp: New test.
2005-08-19 Frank Ch. Eigler <fche@elastic.org>
* arith.c (_stp_random_pm): New function.
Diffstat (limited to 'stap.1.in')
| -rw-r--r-- | stap.1.in | 12 |
1 files changed, 12 insertions, 0 deletions
@@ -1,3 +1,4 @@ +.\" -*- nroff -*- .TH STAP 1 @DATE@ "Red Hat" .SH NAME stap \- systemtap script translator/driver @@ -281,6 +282,10 @@ module(MPATTERN).function(PATTERN).return kernel.statement(PATTERN) .br module(MPATTERN).statement(PATTERN) +.br +timer.jiffies(NUM) +.br +timer.jiffies(NUM).randomize(RAND) .fi .RE .PP @@ -300,6 +305,10 @@ and identifies the line number in the source file, preceded by a ":". As an alternative, PATTERN may be a numeric constant, indicating an (module-relative or kernel-absolute) address. .PP +The timer-based asynchronous probe points run the given handler every +NUM jiffies. If given, the random value in the range [-RAND..RAND] is +added to NUM every time the handler is run. +.PP Here are some example probe points: .TP kernel.function("*init*"), kernel.function("*exit*") @@ -316,6 +325,9 @@ name in any of the USB drivers. kernel.statement(0xc0044852) refers to the first byte of the statement whose compiled instructions include the given address in the kernel. +.TP +timer.jiffies(1000).randomize(200) +refers to a periodic interrupt, every 1000 +/- 200 jiffies. .PP When any matching event occurs, the probe handler is run within that |