3.3.2. 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) statement1 else statement2
Thestatement1
is executed if thecondition
expression is non-zero. Thestatement2
is executed if thecondition
expression is zero. Theelse
clause (else
statement2) is optional. Bothstatement1
andstatement2
can be statement blocks.Example 3.9. ifelse.stp
global countread, countnonread probe kernel.function("vfs_read"),kernel.function("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) }
Example 3.9, “ifelse.stp” 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 variablecountread
by 1 if the name of the function it probed matchesvfs_read
(as noted by the conditionif (probefunc()=="vfs_read")
); otherwise, it incrementscountnonread
(else {countnonread ++}
). - While Loops
- Format:
while (condition) statement
So long ascondition
is non-zero the block of statements instatement
are executed. Thestatement
is often a statement block and it must change a value socondition
will eventually be zero. - For Loops
- Format:
for (initialization; conditional; increment) statement
Thefor
loop is simply shorthand for a while loop. The following is the equivalentwhile
loop:initialization while (conditional) { statement increment }
Conditional Operators
Aside from ==
("is equal to"), you can also use the following operators in your conditional statements:
- >=
- Greater than or equal to
- <=
- Less than or equal to
- !=
- Is not equal to