Table of Contents

• Title and Copyright Information
• Preface
  • Documentation License
  • Conventions
  • Documentation Accessibility
  • Access to Oracle Support for Accessibility
  • Diversity and Inclusion
• 1 About DTrace
  • Getting Started With DTrace
  • Providers and Probes
• 2 The D Programming Language
  • D Program Structure
    • Probe Clauses and Declarations
    • Probe Descriptions
    • Clause Predicates
    • Probe Actions
    • Order of Execution
    • Use of the C Preprocessor
  • Compilation and Instrumentation
  • Variables and Arithmetic Expressions
  • Predicate Examples
  • Output Formatting Examples
  • Array Overview
    • Associative Array Example
  • External Symbols and Types
  • Types, Operators, and Expressions
    • Identifier Names and Keywords
    • Data Types and Sizes
    • Constants
    • Arithmetic Operators
    • Relational Operators
    • Logical Operators
    • Bitwise Operators
    • Assignment Operators
    • Increment and Decrement Operators
    • Conditional Expressions
    • Type Conversions
    • Operator Precedence
  • Variables
    • Scalar Variables
    • Associative Arrays
    • Thread-Local Variables
    • Clause-Local Variables
    • Built-In Variables
    • External Variables
  • Pointers and Scalar Arrays
    • Pointers and Addresses
    • Pointer Safety
    • Array Declarations and Storage
    • Pointer and Array Relationship
    • Pointer Arithmetic
    • Generic Pointers
    • Multi-Dimensional Arrays
    • Pointers to DTrace Objects
    • Pointers and Address Spaces
  • DTrace Support for Strings
    • String Representation
    • String Constants
    • String Assignment
    • String Conversion
    • String Comparison
  • Structs and Unions
    • Structs
    • Pointers to Structs
    • Unions
    • Member Sizes and Offsets
    • Bit-Fields
  • Type and Constant Definitions
    • typedefs
    • Enumerations
    • Inlines
    • Type Namespaces
• 3 Aggregations
  • Aggregation Concepts
  • Basic Aggregation Statement
  • Aggregation Examples
    • Basic Aggregation
    • Using Keys
    • Using the avg Function
    • Using the stddev Function
    • Using the quantize Function
    • Using the lquantize Function
  • Printing Aggregations
  • Data Normalization
  • Clearing Aggregations
  • Truncating Aggregations
  • Minimizing Drops
• 4 Actions and Subroutines
  • Action Functions
    • Default Action
    • Data Recording Actions
      • freopen
      • ftruncate
      • func
      • mod
      • printa
      • printf
      • stack
      • sym
      • trace
      • tracemem
      • ustack
      • uaddr
      • usym
    • Destructive Actions
      • copyout (Process-Destructive)
      • copyoutstr (Process-Destructive)
      • raise (Process-Destructive)
      • stop (Process-Destructive)
      • system (Process-Destructive)
      • chill (Kernel-Destructive)
      • panic (Kernel-Destructive)
    • Special Actions
      • Speculative Actions
      • exit
      • setopt
  • Subroutine Functions
    • alloca
    • basename
    • bcopy
    • cleanpath
    • copyin
    • copyinstr
    • copyinto
    • d_path
    • dirname
    • getmajor
    • getminor
    • htonl
    • htonll
    • htons
    • index
    • inet_ntoa
    • inet_ntoa6
    • inet_ntop
    • lltostr
    • mutex_owned
    • mutex_owner
    • mutex_type_adaptive
    • mutex_type_spin
    • ntohl
    • ntohll
    • ntohs
    • progenyof
    • rand
    • rindex
    • rw_iswriter
    • rw_read_held
    • rw_write_held
    • speculation
    • strchr
    • strjoin
    • strlen
    • strrchr
    • strstr
    • strtok
    • substr
• 5 Buffers and Buffering
  • Principal Buffers
  • Principal Buffer Policies
    • switch Policy
    • fill Policy
    • fill Policy and END Probes
    • ring Policy
  • Other Buffers
  • Buffer Sizes
  • Buffer Resizing Policy
• 6 Output Formatting
  • printf Action
    • Conversion Specifications
    • Flag Specifiers
    • Width and Precision Specifiers
    • Size Prefixes
    • Conversion Formats
  • printa Action
  • trace Default Format
• 7 Speculative Tracing
  • About Speculative Tracing
  • Speculation Interfaces
  • Creating a Speculation
  • Using a Speculation
  • Committing a Speculation
  • Discarding a Speculation
  • Example of a Speculation
  • Speculation Options and Tuning
• 8 dtrace Command Reference
  • dtrace Command Description
  • dtrace Command Options
  • dtrace Command Operands
  • dtrace Command Exit Status
• 9 Scripting
  • Interpreter Files
  • Macro Variables
  • Macro Arguments
  • Target Process ID
• 10 Options and Tunables
  • Consumer Options
  • Modifying Options
• 11 DTrace Providers
  • dtrace Provider
    • BEGIN Probe
    • END Probe
    • ERROR Probe
    • dtrace Stability
  • profile Provider
    • profile-n Probes
    • tick-n Probes
    • profile Probe Arguments
    • profile Probe Creation
    • prof Stability
  • fbt Provider
    • fbt Probes
    • fbt Probe Arguments
    • fbt Examples
    • Module Loading and fbt
    • fbt Stability
  • syscall Provider
    • syscall Probes
      • System Call Anachronisms
      • Subcoded System Calls
      • New System Calls
      • Replaced System Calls
      • Large File System Calls
      • Private System Calls
    • syscall Probe Arguments
    • syscall Stability
  • sdt provider
    • Creating sdt Probes
      • Declaring Probes
      • sdt Probe Arguments
    • sdt Stability
  • pid Provider
    • Naming pid Probes
    • pid Probe Arguments
    • pid Stability
  • proc Provider
    • proc Probes
    • proc Probe Arguments
      • lwpsinfo_t
      • psinfo_t
    • proc Examples
      • exec
      • start and exit Probes
      • signal-send
    • proc Stability
  • sched Provider
    • sched Probes
    • sched Probe Arguments
      • cpuinfo_t
    • sched Examples
      • on-cpu and off-cpu Probes
      • enqueue and dequeue Probes
      • sleep and wakeup Probes
      • preempt and remain-cpu Probes
      • tick
    • sched Stability
  • io Provider
    • io Probes
    • io Probe Arguments
      • bufinfo_t
      • devinfo_t
      • fileinfo_t
    • io Examples
    • io Stability
  • fasttrap Provider
    • fasttrap Probes
    • fasttrap Stability
• 12 User Process Tracing
  • copyin and copyinstr Subroutines
    • Avoiding Errors
  • Eliminating dtrace Interference
  • Using the syscall Provider
  • ustack Action
  • uregs[] Array
  • Using the pid Provider
    • User Function Boundary Tracing
    • Tracing Arbitrary Instructions
• 13 Statically Defined Tracing of User Applications
  • Choosing the Probe Points
  • Adding Probes to an Application
    • Defining Providers and Probes
    • Adding Probes to Application Code
    • Testing if a Probe Is Enabled
    • Building Applications With Probes
    • Using Statically Defined Probes
• 14 Statically Defined Tracing of Kernel Modules
  • Inserting Static Probe Points
    • revdev.h Example
    • rev_mod.c Example
    • rev_dev.c Example
  • Building Modules With Static Probes
    • Kbuild Example
    • Makefile Example
    • testrevdev.c Example
  • Using DTrace to Test Modules With Static Probes
• 15 Performance Considerations
  • Limit Enabled Probes
  • Using Aggregations
  • Using Cacheable Predicates
• 16 DTrace Stability Features
  • Stability Levels
  • Dependency Classes
  • Interface Attributes
  • Stability Computations and Reports
  • Stability Enforcement
• 17 Translators
  • Translator Declarations
  • xlate D Operator
  • Process Model Translators
  • Stable Translations
• 18 DTrace Versioning
  • Versions and Releases
  • Versioning Options
  • Provider Versioning