Consumer Options

DTrace is tuned by setting or enabling options. The available options are described in the following table. For more information, see the dtrace(8) man page.

Table 10-1 DTrace Consumer Options

Option Name	Value or Value Type	Default Value	dtrace Command Option	Description	See Chapter
agghist	-	-	-	Print aggregation as histogram	DTrace Aggregations
aggpack	-	-	-	Print aggregation histograms in packed form	DTrace Aggregations
aggrate	time (ns, us, ms, s, hz)	1 hz	-	Rate of aggregation reading	DTrace Aggregations
aggsize	size (k, m, g, t)	4 m	-	Aggregation buffer size	DTrace Aggregations
aggsortkey	-	-	-	Sort aggregation by key order with ties broken by value	DTrace Aggregations
aggsortrev	-	-	-	Sort aggregation in the reverse order	DTrace Aggregations
aggsortpos	position	0	-	Position of the aggregate variable on which the output is sorted	DTrace Aggregations
aggsortkeypos	position	0	-	Position of the aggregate key on which the output is sorted	DTrace Aggregations
aggzoom	-	-	-	Zoom aggregation histograms to the maximum value	DTrace Aggregations
bufpolicy	fill, ring, switch	switch	-	Buffer policy	DTrace Buffers and Buffering
bufresize	auto, manual	auto	-	Buffer resizing policy	DTrace Buffers and Buffering
bufsize	size	4 m	-b	Principal buffer size	DTrace Buffers and Buffering
cleanrate	time	101 hz	-	Cleaning rate	Speculative Tracing in DTrace
cpu	integer	-	-c	CPU on which to enable tracing	DTrace Buffers and Buffering
defaultargs	-	-	-	Allow references to unspecified macro arguments	Scripting in DTrace
destructive	-	-	-w	Allow destructive actions	DTrace Actions and Subroutines
dynvarsize	size	1 m	-	Dynamic variable space size	Variables in DTrace
errexit	integer	1	-	Exit on error with a specified status code. However, if no arguments are specified, exits with the status code 1.
flowindent	-	-	-F	Indent function entry and prefix with >; unindent function return and prefix with <	dtrace Utility
grabanon	-	-	-a	Claim anonymous state	Anonymous Tracing in DTrace
jstackframes	integer	50	-	Number of default stack frames jstack	DTrace Actions and Subroutines
jstackstrsize	integer	512	-	Default string space size for jstack	DTrace Actions and Subroutines
noresolve	-	-	-	Alias for uresolve=no.	DTrace Actions and Subroutines
nspec	integer	1	-	Number of speculations	Speculative Tracing in DTrace
quiet	-	-	-q	Output only explicitly traced data	dtrace Utility
rawbytes	-	-	-	Always print tracemem output in hexadecimal	DTrace Actions and Subroutines
specsize	size	32 k	-	Speculation buffer size	Speculative Tracing in DTrace
strsize	size	256	-	String size	Strings in DTrace
stackframes	integer	20	-	Number of stack frames	DTrace Actions and Subroutines
stackindent	integer	14	-	Number of whitespace characters to use when indenting stack and ustack output	DTrace Actions and Subroutines
statusrate	time	10 s	-	Rate of status checking
switchrate	time	1 hz	-	Rate of buffer switching	DTrace Buffers and Buffering
uresolve	no, symbol, basename, absolute	symbol	-	Modify resolution of user addresses	DTrace Actions and Subroutines
ustackframes	integer	20	-	Number of user stack frames	DTrace 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.