Solaris Dynamic Tracing Guide

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.