Contents

• List of Tables
• 1 SystemTap overview
  • 1.1 About this guide
  • 1.2 Reasons to use SystemTap
  • 1.3 Event-action language
  • 1.4 Sample SystemTap scripts
  • 1.5 The stap command
  • 1.6 Safety and security
  
  
• 2 Types of SystemTap scripts
  • 2.1 Probe scripts
  • 2.2 Tapset scripts
  
  
• 3 Components of a SystemTap script
  • 3.1 Probe definitions
  • 3.2 Probe aliases
  • 3.3 Variables
  • 3.4 Auxiliary functions
  • 3.5 Embedded C
  • 3.6 Embedded C functions
  
  
• 4 Probe points
  • 4.1 General syntax
  • 4.2 Built-in probe point types (DWARF probes)
  • 4.3 DWARF-less probing
  • 4.4 Userspace probing
  • 4.5 PROCFS probes
  • 4.6 Marker probes
  • 4.7 Syscall probes
  • 4.8 Tracepoints
  • 4.9 Timer probes
  • 4.10 Return probes
  • 4.11 Special probe points
  • 4.12 Pointer typecasting
  
  
• 5 Language elements
  • 5.1 Identifiers
  • 5.2 Data types
  • 5.3 Semicolons
  • 5.4 Comments
  • 5.5 Whitespace
  • 5.6 Expressions
  • 5.7 Literals passed in from the stap command line
  • 5.8 Conditional compilation
  
  
• 6 Statement types
  • 6.1 break and continue
  • 6.2 delete
  • 6.3 EXP (expression)
  • 6.4 for
  • 6.5 foreach
  • 6.6 if
  • 6.7 next
  • 6.8 ; (null statement)
  • 6.9 return
  • 6.10 { } (statement block)
  • 6.11 while
  
  
• 7 Associative arrays
  • 7.1 Examples
  • 7.2 Types of values
  • 7.3 Array capacity
  • 7.4 Iteration, foreach
  
  
• 8 Statistics (aggregates)
  • 8.1 The aggregation (< < <) operator
  • 8.2 Extraction functions
  • 8.3 Integer extractors
  • 8.4 Histogram extractors
  
  
• 9 Predefined functions
  • 9.1 Output functions
  • 9.2 Context at the probe point
  • 9.3 Task data
  • 9.4 Accessing string data at a probe point
  • 9.5 Initializing queue statistics
  • 9.6 Using queue statistics
  • 9.7 Probe point identification
  • 9.8 Formatting functions
  • 9.9 String functions
  • 9.10 Timestamps
  • 9.11 Miscellaneous tapset functions
  
  
• 10 For Further Reference
• Index