Solaris Dynamic Tracing Guide


Numbers and Symbols

	`$` (dollar sign) ( )

	`*curlwpsinfo` ( )

	`*curpsinfo` ( )

	`*curthread` ( )

	`$target` macro variable ( )


A

	actions
		`alloca` ( )
		`basename` ( )
		`bcopy` ( )
		`cleanpath` ( )
		`copyin` ( )
		`copyinstr` ( )
		`copyinto` ( )
		data recording ( )
		default ( )
		destructive ( )
			`breakpoint` ( )
			`chill` ( )
			`copyout` ( )
			`copyoutstr` ( )
			`panic` ( )
			`raise` ( )
			`stop` ( )
			`system` ( )
		`dirname` ( )
		`exit` ( )
		`jstack` ( )
		`msgsize` ( )
		`mutex_owned` ( )
		`mutex_owner` ( )
		`mutex_type_adaptive` ( )
		`printa` ( )
		`printf` ( )
		`progenyof` ( )
		`rand` ( )
		`rw_iswriter` ( )
		`rw_write_held` ( )
		special ( )
		`speculation` ( )
		`stack` ( )
			and aggregators ( )
		`strjoin` ( )
		`strlen` ( )
		`trace` ( )
		`tracemem` ( )
		`ustack` ( )

	adaptive lock probes ( )

	aggregations ( )

	aggregator
		clearing ( )
		drops ( )
		normalization ( )
		output ( )
		truncating ( )

	aggregators ( )

	anonymous enabling ( )

	anonymous tracing ( )
		claiming anonymous state ( )
		example of use ( )

	`arg0` ( )

	`arg1` ( )

	`arg2` ( )

	`arg3` ( )

	`arg4` ( )

	`arg5` ( )

	`arg6` ( )

	`arg7` ( )

	`arg8` ( )

	`arg9` ( )

	`args[]` ( )

	arrays
		and and pointers ( )
		multi-dimensional scalar ( )

	associative arrays ( )
		and dynamic variable drops ( )
		and explicit variable declarations ( )
		and keys ( )
		and tuples ( ) ( )
		assigned to zero ( )
		defining ( )
		differences from normal arrays ( )
		object types ( )
		unassigned ( )
		uses of ( )

	`avg` ( )


B

	backquote character (`) ( )

	`BEGIN` probe ( )

	`b_flags` Values ( )

	binary construction with probes ( )

	bit-fields ( )

	breakpoints ( )

	buffer
		resizing policy ( )
		sizes ( )

	buffer policy, on resizing ( )

	`bufinfo_t` structure ( )

	built-in variables ( ) ( )


C

	cacheable predicates ( )

	`caller` ( )

	clause-local variables ( )
		and probe clause lifetime ( )
		defining ( )
		example of use ( )
		explicit variable declaration ( )
		uses of ( )
		value persistence ( )

	constant definitions ( )

	constructing a binary ( )

	contention-event probes ( ) ( )

	`copyin()` ( )

	`copyinstr()` ( )

	`count` ( )

	C preprocessor, and the D programming language ( )

	`cwd` ( )


D

	data recording actions ( )

	declarations ( )

	dependency classes ( )

	destructive actions ( )
		kernel ( )
		process ( )

	`devinfo_t` structure ( )

	displaying consumers ( )

	displaying trace data ( )

	dollar sign (`$`) ( )

	D programming language
		and the C preprocessor ( )
		differences from ANSI-C ( ) ( )
		variable declarations in ( )

	`dtrace` ( )
		exit values ( )
		operands ( )

	DTrace
		options ( )

	`dtrace`
		options ( )
			32 ( )
			64 ( )
			a ( )
			A ( )
			b ( )
			c ( )
			C ( )
			D ( )
			e ( )
			f ( )
			F ( )
			G ( )
			H ( )
			i ( )
			I ( )
			l ( )
			L ( )
			m ( )

	DTrace
		options
			modifying ( ) ( )

	`dtrace`
		options
			n ( )
			o ( )
			p ( )
			P ( )
			q ( )
			s ( )
			S ( )
			U ( )
			v ( )
			V ( )
			w ( )
			x ( )
			X ( )
			Z ( )

	`dtrace` interference ( )

	`dtrace_kernel` privilege ( )

	`dtrace` probe stability ( )

	`dtrace_proc` privilege ( )

	`dtrace_user`privilege ( )

	`dtrace` utility ( )


E

	embedding probe points ( )

	`END` probe ( )

	`entry` probes ( ) ( )

	enumeration ( )
		syntax ( )
		UIO_READ visibility ( )
		UIO_WRITE visibility ( )

	enumeration of symbolic names ( )

	`epid` ( )

	`errno` ( )

	error-event probes ( )

	`ERROR` probe ( )

	evolving stability value ( )

	examples
		anonymous tracing ( )
		enumeration ( )
		`exec` probe ( )
		`FBT` ( )
		`io` probe use ( )
		of clause-local variables ( )
		of `pid` probe use ( )
		of stability reports ( )
		of thread-local variables ( )
		of union use ( )
		`sdt` probe ( )
		speculation ( )

	`execname` ( ) ( )

	`exec` probes ( )

	`exit` probe ( )

	explicit variable declaration
		for associative arrays ( )
		for clause-local variables ( )
		for scalar variables ( )

	explicit variable declarations, for thread-local variables ( )

	external stability value ( )

	external variables ( )
		and D operators ( )
		and interface stability ( )

	extracting DTrace data ( )


F

	`fasttrap` probe ( )
		stability ( )

	`FBT` probe ( )

	`FBT` probes
		and breakpoints ( )
		and module loading ( )
		stability ( )
		uninstrumentable functions ( )
		unsporting functions ( )

	`FBT`probes, tail-call optimization ( )

	`fileinfo_t` structure ( )

	`fill` buffer policy ( )
		and `END` probes ( )

	`fpuinfo` ( )
		stability ( )

	function boundary testing (FBT) ( )

	function offset probes ( )


H

	hold-event probes ( ) ( )


I

	`id` ( )

	inline directives ( )

	interface attributes ( )

	interface dependency classes ( )
		common ( )
		CPU ( )
		group ( )
		ISA ( )
		platform ( )
		unknown ( )

	internal stability value ( )

	interpreter files ( )

	`io` probe ( )

	`ipl` ( )


K

	kernel boundary probes ( )

	kernel module, specifying ( )

	kernel symbol
		name conflict resolution ( )
		namespace ( )
		type associations ( )

	`kstat` framework, and structs ( )


L

	large file system calls ( )

	`lockstat`, stability of ( )

	`lockstat` provider ( )
		contention-event probes ( )
		hold-event probes ( )
		probes ( )

	`lockstat` stability ( )

	`lquantize` ( )

	`lwp-exit` probe ( )

	`lwpsinfo_t` ( )

	`lwp-start` probe ( )


M

	macro arguments ( )

	macro variables ( ) ( )

	`max` ( )

	member sizes ( )

	memory addresses ( )

	`mib` probe ( )
		arguments ( )
		stability ( )

	`min` ( )

	modifying options ( )

	module loading ( )

	multi-dimensional scalar arrays ( )

	mutex probes ( )


O

	obsolete stability value ( )

	`offsetof` ( )

	offsets ( )

	operator overloading ( )

	options ( )
		modifying ( ) ( )


P

	performance ( )
		cacheable predicates ( )

	`pid` ( )

	`pid` probes
		and function boundaries ( )
		example of use ( )

	`pid`probes ( )

	`pid` provider ( ) ( )

	`plockstat` ( )

	pointers ( )
		and arrays ( )
		and explicit casts ( )
		and `struct` ( )
		and type conversion ( )
		arithmetic operations on ( )
		declaring ( )
		safe use of ( )
		to DTrace objects ( )

	pragmas ( )

	predicates ( )

	principal buffer
		policies ( )
			`fill` ( )
			`ring` ( )
			`switch` ( )

	`printa` ( )

	`printf` ( )
		conversion flags ( )
		conversion formats ( )
		conversion specifications ( )
		size prefixes ( )
		width and precision specifiers ( )

	private stability value ( )

	privileges ( )
		and DTrace ( )
		`dtrace_kernel` ( )
		`dtrace_proc` ( )
		`dtrace_user` ( )
		superuser ( )

	probe actions ( )

	probe clause, lifetime and clause-local variables ( )

	probe clauses ( )

	probe descriptions ( )
		recommended syntax ( )
		special characters in ( )

	`probefunc` ( )

	`probemod` ( )

	`probename` ( )

	probe points ( )

	`probeprov` ( )

	probes
		adaptive lock ( )
		`BEGIN` ( )
		contention-event ( ) ( )
		`done` ( )
		`END` ( )
		`entry` ( ) ( )
		`ERROR` ( )
		error-event ( )
		`exec` ( )
		`exit` ( )
		`fasttrap` ( )
		`FBT` ( )
			and tail-call optimization ( )
			breakpoints ( )
			example of use ( )
			module loading ( )
			stability ( )
			uninstrumentable functions ( )
			unsporting functions ( )
		for `lockstat` ( )
		`fpuinfo` ( )
		function boundary ( )
		function offset ( )
		hold-event ( ) ( )
		`io` ( )
			arguments ( )
			`bufinfo_t` structure ( )
			`devinfo_t` structure ( )
			example of use ( )
			`fileinfo_t` structure ( )
			stability ( )
		limiting ( )
		`lwp-exit` ( )
		`lwp-start` ( )
		`mib` ( )
		mutex ( )
		`pid` ( ) ( )
		`plockstat`
			stability ( )
		`proc` ( )
		profile ( )
		reader/writer ( )
		reader/writer locks ( )
		`return` ( ) ( )
		`sched` ( )
		`sdt` ( )
			arguments ( )
			creating ( )
			example of use ( )
			stability ( )
		`signal-send` ( )
		spin lock ( )
		`start` ( ) ( )
		`syscall` ( )
		`syscall()` ( )
		thread lock ( )
		tick ( )
		`vminfo` ( )
			arguments ( )
			example of use ( )
		`wait-done` ( )
		`wait-start` ( )

	`proc` probe ( )
		arguments ( )
		stability ( )

	profile probes ( )
		arguments ( )
		creation ( )
		stability ( )
		timer resolution ( )

	provider versioning ( )

	`psinfo_t` ( )


Q

	`quantize` ( )


R

	reader/writer lock probes ( ) ( )

	`return` probes ( )

	`ring` buffer policy ( )

	`root` ( )


S

	scalar arrays ( )

	scalar variables ( )
		creation ( )
		explicit variable declaration ( )

	`sched` probe ( )
		stability ( )

	scripting ( )

	`sdt` probe ( )
		arguments ( )
		creating ( )

	security ( )

	`signal-send` probe ( )

	`sizeof` ( )

	speculation ( )
		committing ( )
		creating ( )
		discarding ( )
		example of use ( )
		options ( )
		tuning ( )
		use ( )

	`speculation()` function ( )

	speculative drops ( )

	spin lock probes ( )

	stability ( )
		computations ( )
		enforcement ( )
		`fasttrap` ( )
		`FBT` probes ( )
		`io` ( )
		levels ( )
		`mib` ( )
		of `dtrace` probes ( )
		of `lockstat` ( )
		of `syscall` probes ( )
		`plockstat` ( )
		`proc` ( )
		reports ( )
			example of use ( )
		`sched` ( )
		`sdt` probe ( )
		values ( )
			evolving ( )
			external ( )
			internal ( )
			obsolete ( )
			private ( )
			stable ( )
			standard ( )
			unstable ( )
		`vminfo` ( )

	stable stability value ( )

	`stackdepth` ( )

	standard stability value ( )

	`start` probe ( )

	statically defined tracking (SDT), See SDT

	string constants ( )

	strings ( )
		and operator overloading ( )
		assignment ( )
		comparison ( )
		conversion ( )
		relational operators ( )
		type ( )

	`struct` ( )
		and pointers ( )
		example of use ( )

	subroutines ( )
		`copyin()` ( )
		`copyinstr()` ( )

	`sum` ( )

	superuser privileges ( )

	`switch` buffer policy ( )

	`syscall` probe ( )

	`syscall` probes
		arguments ( )
		large file system interfaces ( )
		stability ( )

	system calls, for large files ( )


T

	targeting a process ID ( )

	thread-local variables ( )
		and dynamic variable drops ( )
		and explicit variable declarations ( )
		and thread identity ( )
		assigned to zero ( )
		example of use ( )
		referencing ( ) ( )
		types ( )
		unassigned ( )

	thread lock probes ( )

	tick probes ( )

	`tid` ( )

	`timestamp` ( )

	`trace` ( )

	trace data
		displaying ( )
		extracting ( )

	tracing instructions ( )

	tunables ( )

	`typedef` ( )

	type definitions ( )

	type namespaces ( )
		built in ( )


U

	uninstrumentable functions ( )

	unions ( )
		and the `kstat` framework ( )
		example of use ( )

	unsporting functions ( )

	unstable stability value ( )

	`uregs[]` ( )

	`uregs[]` array ( )

	user process memory ( )

	user process tracing ( )

	`ustack()` ( )


V

	versioning ( )
		for providers ( )
		options ( )
		version binding ( )

	version string ( )

	virtual memory ( )

	`vminfo` probe ( )
		arguments ( )
		example ( )
		stability ( )

	`vtimestamp` ( )


W

	`walltimestamp` ( )