Oracle Solaris 11.1 Dynamic Tracing Guide

October 2012

The Oracle Solaris Dynamic Tracing Guide describes how to use DTrace. It also describes the DTrace providers in detail. Most of the information present in this document is generic to all releases of the Oracle Solaris operating system.

Document Information
Preface
1. About DTrace
- Getting Started
- Providers and Probes
2. D Programming Language
- D Program Structure
- Compilation and Instrumentation
- Variables and Arithmetic Expressions
- Predicates
- Output Formatting
- Arrays
- External Symbols and Types
- Types, Operators, and Expressions
- Variables
- Pointers and Arrays
- Strings
- Structs and Unions
- Type and Constant Definitions
3. Aggregations
- Aggregating Functions
- Aggregations
- Printing Aggregations
- Data Normalization
- Clearing Aggregations
- Truncating aggregations
- Minimizing Drops
4. Actions and Subroutines
- Actions
- Default Action
- Data Recording Actions
  - trace
  - tracemem
  - printf
  - printa
  - stack
  - ustack
  - jstack
  - uaddr
  - usym
- Destructive Actions
  - Process Destructive Actions
    - stop
    - raise
    - copyout
    - copyoutstr
    - system
  - Kernel Destructive Actions
- Special Actions
  - Speculative Actions
  - exit
- Subroutines
  - alloca
  - basename
  - bcopy
  - cleanpath
  - copyin
  - copyinstr
  - copyinto
  - dirname
  - inet_ntoa
  - inet_ntoa6
  - inet_ntop
  - msgdsize
  - msgsize
  - mutex_owned
  - mutex_owner
  - mutex_type_adaptive
  - progenyof
  - rand
  - rw_iswriter
  - rw_write_held
  - speculation
  - strjoin
  - strlen
5. Buffers and Buffering
- Principal Buffers
- Principal Buffer Policies
- Other Buffers
- Buffer Sizes
- Buffer Resizing Policy
6. Output Formatting
- printf
- printa
- trace Default Format
7. Speculative Tracing
- Speculation Interfaces
- Creating a Speculation
- Using a Speculation
- Committing a Speculation
- Discarding a Speculation
- Speculation Example
- Speculation Options and Tuning
8. dtrace(1M) Utility
- Description
- Options
- Operands
- Exit Status
9. Scripting
- Interpreter Files
- Macro Variables
- Macro Arguments
- Target Process ID
10. Options and Tunables
- Consumer Options
- Modifying Options
11. Providers
- dtrace Provider
- lockstat Provider
- profile Provider
- cpc Provider
- fbt Provider
- syscall Provider
- sdt Provider
- mib Provider
- fpuinfo Provider
- pid Provider
- plockstat Provider
- fasttrap Provider
  - Probes
  - Stability
- sysinfo Provider
  - Probes
  - Arguments
  - Example
  - Stability
- vminfo Provider
  - Probes
  - Arguments
  - Example
  - Stability
- proc Provider
- sched Provider
- io Provider
- Protocols
12. User Process Tracing
- copyin and copyinstr Subroutines
  - Avoiding Errors
- Eliminating dtrace(1M) Interference
- syscall Provider
- ustack Action
- uregs[] Array
- pid Provider
  - User Function Boundary Tracing
  - Tracing Arbitrary Instructions
13. Statically Defined Tracing for User Applications
- Choosing the Probe Points
- Adding Probes to an Application
14. Security
- Privileges
- Privileged Use of DTrace
- dtrace_proc Privilege
- dtrace_user Privilege
- dtrace_kernel Privilege
- Super User Privileges
15. Anonymous Tracing
- Anonymous Enablings
- Claiming Anonymous State
- Anonymous Tracing Examples
16. Postmortem Tracing
- Displaying DTrace Consumers
- Displaying Trace Data
17. Performance Considerations
- Limit Enabled Probes
- Use Aggregations
- Use Cacheable Predicates
18. Stability
- Stability Levels
- Dependency Classes
- Interface Attributes
- USDT Interfaces
- Stability Computations and Reports
- Stability Enforcement
19. Translators
- Translator Declarations
- Translate Operator
- Process Model Translators
- Stable Translations
20. Versioning
- Versions and Releases
- Versioning Options
- Provider Versioning
Index
- Numbers and Symbols
- A
- B
- C
- D
- E
- F
- I
- K
- L
- M
- N
- O
- P
- R
- S
- T
- U
- V

Skip Navigation Links
	Oracle Solaris 11.1 Dynamic Tracing Guide Oracle Solaris 11.1 Information Library