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.