From 91018c73409bc6d5d01666f5bbf53d62af5e6c18 Mon Sep 17 00:00:00 2001 From: ddomingo Date: Thu, 23 Oct 2008 17:04:20 +1000 Subject: added Arrays and other minor edits --- doc/SystemTap_Beginners_Guide/en-US/Scripts.xml | 173 +----------------------- 1 file changed, 3 insertions(+), 170 deletions(-) (limited to 'doc/SystemTap_Beginners_Guide/en-US/Scripts.xml') diff --git a/doc/SystemTap_Beginners_Guide/en-US/Scripts.xml b/doc/SystemTap_Beginners_Guide/en-US/Scripts.xml index f35bb058..fad12dee 100644 --- a/doc/SystemTap_Beginners_Guide/en-US/Scripts.xml +++ b/doc/SystemTap_Beginners_Guide/en-US/Scripts.xml @@ -51,7 +51,7 @@ probe event, {handler}
- Events + Event SystemTap events can be broadly classified into two types: synchronous and asynchronous. @@ -215,7 +215,7 @@ probe timer.ms(4000)
- Handlers/Probe Body + Handler/Probe Body Consider the following sample script: @@ -304,7 +304,7 @@ hald(2360) open SystemTap Functions - SystemTap supports a wide variety of functions that can be used as printf () arguments. uses the SystemTap functions execname() (current process name) and pid() (current process ID). + SystemTap supports a wide variety of functions that can be used as printf () arguments. uses the SystemTap functions execname() (name of the process that called a kernel function/performed a system call) and pid() (current process ID). is "handler function" an appropriate term? wcohen: use "SystemTap functions" to match up language in man pages @@ -479,172 +479,5 @@ probe syscall.* {
-
- Basic Handler Constructs - -SystemTap supports the use of several basic constructs in handlers. The syntax for most of these handler constructs are mostly based on C and awk syntax. This section describes several of the most useful SystemTap handler constructs. - - - Variables - - Variables can be used freely throughout a handler; simply choose a name, assign it to a function, and use it in an expression. SystemTap automatically identifies whether a variable should be identified as a string or integer, based on the function it is assigned to. For instance, if you use set the variable foo to gettimeofday_s() (as in foo = gettimeofday_s()), then foo can be used as an integer argument (%d) in printf(). - - -Note, however, that by default variables are only local to the probe they are used in. This means that variables are initialized, used and disposed at each probe handler invocation. To share a variable between probes, declare the variable name first using global outside of any probe. Consider the following example: - - - timer-jiffies.stp - -global count_jiffies, count_ms -probe timer.jiffies(100) { count_jiffies ++ } -probe timer.ms(100) { count_ms ++ } -probe timer.ms(12345) -{ - hz=(1000*count_jiffies) / count_ms - printf ("jiffies:ms ratio %d:%d => CONFIG_HZ=%d\n", - count_jiffies, count_ms, hz) - exit () -} - - - - attempts to compute the CONFIG_HZ setting of the kernel using timers that count jiffies and milliseconds, then computing accordingly. The global statement allows the script to use the variables count_jiffies and count_ms (set in their own respective probes) to be shared with probe timer.ms(12345). - - - Note - The ++ notation in (i.e. count_jiffies ++ and count_ms ++) is used to increment the value of a variable by 1. In the following probe, count_jiffies is incremented by 1 every 100 jiffies: - -probe timer.jiffies(100) { count_jiffies ++ } - - In this instance, SystemTap understands that count_jiffies is an integer. Because no initial value was assigned to count_jiffies, its initial value is zero by default. - - - - - - - -
- Conditional Statements - -In some cases, the output of a SystemTap script may be too big. To address this, you need to further refine the script's logic in order to delimit the output into something more relevant or useful to your probe. - - - -You can do this by using conditionals in handlers. SystemTap accepts the following types of conditional statements: - - - - - If/Else Statements - - Format: - -if (condition) - {handler} else {handler} - - - - ifelse.stp - -global countread, countnonread -probe vfs.read,vfs.write -{ - if (probefunc()=="vfs_read") { - countread ++ } - else {countnonread ++} -} -probe timer.s(5) { - exit()} -probe end { - printf("VFS reads total %d\n VFS writes total %d\n", countread, countnonread)} - - - - is a script that counts how many virtual file system reads (vfs.read) and writes (vfs.write) the system performs within a 5-second span. When run, the script increments the value of the variable countread by 1 if the name of the function it probed matches vfs_read (as noted by the condition if (probefunc()=="vfs_read")); otherwise, it increments countnonread (else {countnonread ++}). - - - - - - While Loops - - Format: - -while (condition) {handler} - - - - - - For Loops - - Format: - -for (argument1; argument2; argument3) {handler} - - - - - - - - - -These constructs are better illustrated in the different examples available in . - -will get back to these ones later -
-
- Command-Line Arguments - You can also allow a SystemTap script to accept simple command-line arguments and declare them in the script without using target(). One way to do this is to use the variable notation $ or @. - - - -commandlineargs.stp - -probe kernel.function(@1) { } -probe kernel.function(@1).return { } - - - - is similar to , except that it allows you to pass the kernel function to be probed as a command-line argument (as in stap commandlineargs.stp kernel function). You can also specify the script to accept multiple command-line arguments, noting them as @1, @2, and so on, in the order they are entered by the user. - -Both variable notations $ and @ also represent a specific variable type. Use $ if you are expecting the user to enter an integer as a command-line argument, and @ if you are expecting a string. -
- - -
-- cgit