Consumer Options
DTrace is tuned by setting or enabling options. The available options are described
in the table below. For some options, dtrace(1M) provides a corresponding command-line option.
Table 16-1 DTrace Consumer Options
Option
Name |
Value |
dtrace(1M) Alias |
Description |
See Chapter |
|---|
aggrate |
time |
|
Rate of aggregation reading |
Chapter 9, Aggregations |
aggsize |
size |
|
Aggregation buffer size |
Chapter 9, Aggregations |
bufresize |
auto or manual |
|
Buffer resizing policy |
Chapter 11, Buffers and Buffering |
bufsize |
size |
-b |
Principal
buffer size |
Chapter 11, Buffers and Buffering |
cleanrate |
time |
|
Cleaning rate. Must be specified in number-per-second with the hz suffix. |
Chapter 13, Speculative Tracing |
cpu |
scalar |
-c |
CPU
on which to enable tracing |
Chapter 11, Buffers and Buffering |
defaultargs |
— |
|
Allow references to unspecified macro arguments |
Chapter 15, Scripting |
destructive |
— |
-w |
Allow destructive actions |
Chapter 10, Actions and Subroutines |
dynvarsize |
size |
|
Dynamic
variable space size |
Chapter 3, Variables |
flowindent |
— |
-F |
Indent function entry and prefix with ->; unindent function return and
prefix with <- |
Chapter 14, dtrace(1M) Utility |
grabanon |
— |
-a |
Claim anonymous state |
Chapter 36, Anonymous Tracing |
jstackframes |
scalar |
|
Number of default stack frames jstack() |
Chapter 10, Actions and Subroutines |
jstackstrsize |
scalar |
|
Default string space
size for jstack() |
Chapter 10, Actions and Subroutines |
nspec |
scalar |
|
Number of speculations |
Chapter 13, Speculative Tracing |
quiet |
— |
-q |
Output only explicitly traced data |
Chapter 14, dtrace(1M) Utility |
specsize |
size |
|
Speculation buffer size |
Chapter 13, Speculative Tracing |
strsize |
size |
|
String size |
Chapter 6, Strings |
stackframes |
scalar |
|
Number
of stack frames |
Chapter 10, Actions and Subroutines |
stackindent |
scalar |
|
Number of whitespace characters to use when indenting stack() and
ustack() output |
Chapter 10, Actions and Subroutines |
statusrate |
time |
|
Rate of status checking |
|
switchrate |
time |
|
Rate of buffer switching |
Chapter 11, Buffers and Buffering |
ustackframes |
scalar |
|
Number of user stack frames |
Chapter 10, Actions and Subroutines |
Values that denote sizes may be given an optional suffix of k,
m, g, or t to denote kilobytes, megabytes, gigabytes, and terabytes respectively. Values
that denote times may be given an optional suffix of ns, us, ms,
s or hz to denote nanoseconds, microseconds, milliseconds, seconds, and number-per-second, respectively.
