Skip to Content
Sun and Oracle
Channel Sun
How to Buy
Log In
English
docs.sun.com Home
>
Solaris 10 Software Developer Collection
> Solaris Dynamic Tracing Guide
Solaris Dynamic Tracing Guide
Search only this book
Search Help
View this book in:
Other Languages
Deutsch
Español
Français
日本語
Português brasileiro
简体中文
Contained Within
Solaris 10 Software Developer Collection
Find More Documentation
Browse Documentation Titles
Browse Product Documentation
Featured Support Resources
Sun Training Courses
BigAdmin System Admininstration Portal
Sun Support Center
Sun Solve
Download this book in PDF (2009 KB)
Solaris Dynamic Tracing Guide
Index
Numbers and Symbols
A
B
C
D
E
F
H
I
K
L
M
O
P
Q
R
S
T
U
V
W
Book Information
Preface
Who Should Use This Book
How This Book Is Organized
Related Information
Documentation, Support, and Training
Typographic Conventions
Shell Prompts in Command Examples
1. Introduction
Getting Started
Providers and Probes
Compilation and Instrumentation
Variables and Arithmetic Expressions
Predicates
Output Formatting
Arrays
External Symbols and Types
2. 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
Precedence
3. Variables
Scalar Variables
Associative Arrays
Thread-Local Variables
Clause-Local Variables
Built-in Variables
External Variables
4. D Program Structure
Probe Clauses and Declarations
Probe Descriptions
Predicates
Actions
Use of the C Preprocessor
5. Pointers and 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
6. Strings
String Representation
String Constants
String Assignment
String Conversion
String Comparison
7. Structs and Unions
Structs
Pointers to Structs
Unions
Member Sizes and Offsets
Bit-Fields
8. Type and Constant Definitions
Typedef
Enumerations
Inlines
Type Namespaces
9. Aggregations
Aggregating Functions
Aggregations
Printing Aggregations
Data Normalization
Clearing Aggregations
Truncating aggregations
Minimizing Drops
10. Actions and Subroutines
Actions
Default Action
Data Recording Actions
trace()
tracemem()
printf()
printa()
stack()
ustack()
jstack()
Destructive Actions
Process Destructive Actions
stop()
raise()
copyout()
copyoutstr()
system()
Kernel Destructive Actions
breakpoint()
panic()
chill()
Special Actions
Speculative Actions
exit()
Subroutines
alloca()
basename()
bcopy()
cleanpath()
copyin()
copyinstr()
copyinto()
dirname()
msgdsize()
msgsize()
mutex_owned()
mutex_owner()
mutex_type_adaptive()
progenyof()
rand()
rw_iswriter()
rw_write_held()
speculation()
strjoin()
strlen()
11. 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
12. Output Formatting
printf()
Conversion Specifications
Flag Specifiers
Width and Precision Specifiers
Size Prefixes
Conversion Formats
printa()
trace() Default Format
13. Speculative Tracing
Speculation Interfaces
Creating a Speculation
Using a Speculation
Committing a Speculation
Discarding a Speculation
Speculation Example
Speculation Options and Tuning
14. dtrace(1M) Utility
Description
Options
Operands
Exit Status
15. Scripting
Interpreter Files
Macro Variables
Macro Arguments
Target Process ID
16. Options and Tunables
Consumer Options
Modifying Options
17. dtrace Provider
BEGIN Probe
The END Probe
ERROR Probe
Stability
18. lockstat Provider
Overview
Adaptive Lock Probes
Spin Lock Probes
Thread Locks
Readers/Writer Lock Probes
Stability
19. profile Provider
profile-n probes
tick-n probes
Arguments
Timer Resolution
Probe Creation
Stability
20. fbt Provider
Probes
Probe arguments
entry probes
return probes
Examples
Tail-call Optimization
Assembly Functions
Instruction Set Limitations
x86 Limitations
SPARC Limitations
Breakpoint Interaction
Module Loading
Stability
21. syscall Provider
Probes
System Call Anachronisms
Subcoded System Calls
Large File System Calls
Private System Calls
Arguments
Stability
22. sdt Provider
Probes
Examples
Creating SDT Probes
Declaring Probes
Probe Arguments
Stability
23. sysinfo Provider
Probes
Arguments
Example
Stability
24. vminfo Provider
Probes
Arguments
Example
Stability
25. proc Provider
Probes
Arguments
lwpsinfo_t
psinfo_t
Examples
exec
start and exit
lwp-start and lwp-exit
signal-send
Stability
26. sched Provider
Probes
Arguments
cpuinfo_t
Examples
on-cpu and off-cpu
enqueue and dequeue
sleep and wakeup
preempt, remain-cpu
change-pri
tick
Stability
27. io Provider
Probes
Arguments
bufinfo_t structure
devinfo_t
fileinfo_t
Examples
Stability
28. mib Provider
Probes
Arguments
Stability
29. fpuinfo Provider
Probes
Arguments
Stability
30. pid Provider
Naming pid Probes
Function Boundary Probes
entry Probes
return Probes
Function Offset Probes
Stability
31. plockstat Provider
Overview
Mutex Probes
Reader/Writer Lock Probes
Stability
32. fasttrap Provider
Probes
Stability
33. 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
34. Statically Defined Tracing for User Applications
Choosing the Probe Points
Adding Probes to an Application
Defining Providers and Probes
Adding Probes to Application Code
Building Applications with Probes
35. Security
Privileges
Privileged Use of DTrace
dtrace_proc Privilege
dtrace_user Privilege
dtrace_kernel Privilege
Super User Privileges
36. Anonymous Tracing
Anonymous Enablings
Claiming Anonymous State
Anonymous Tracing Examples
37. Postmortem Tracing
Displaying DTrace Consumers
Displaying Trace Data
38. Performance Considerations
Limit Enabled Probes
Use Aggregations
Use Cacheable Predicates
39. Stability
Stability Levels
Dependency Classes
Interface Attributes
Stability Computations and Reports
Stability Enforcement
40. Translators
Translator Declarations
Translate Operator
Process Model Translators
Stable Translations
41. Versioning
Versions and Releases
Versioning Options
Provider Versioning
Glossary
News Center
About Sun
Contact Sun
Terms of Use
Privacy
Copyright
1994-2009
Sun Microsystems, Inc.