xref: /netbsd-src/external/cddl/dtracetoolkit/dist/Docs/Contents (revision c29d51755812ace2e87aeefdb06cb2b4dac7087a)
1*c29d5175SchristosContents - Command Summary
2*c29d5175Schristos
3*c29d5175Schristos   The following is a list of commands found in the DTraceToolkit, along
4*c29d5175Schristos   with their directory location.
5*c29d5175Schristos
6*c29d5175SchristosGenerally commands that end in a ".d" are DTrace scripts, and commands
7*c29d5175Schristosthat don't are DTrace scripts wrapped in another language (eg, shell
8*c29d5175Schristosor Perl). See the Docs/Readme for instructions for finding their docs.
9*c29d5175Schristos
10*c29d5175SchristosDTraceToolkit/
11*c29d5175Schristos   dexplorer		run a series of scripts and archive output
12*c29d5175Schristos   dtruss		process syscall info. DTrace truss
13*c29d5175Schristos   dvmstat		vmstat by PID/name/command
14*c29d5175Schristos   errinfo		report syscall failures with details
15*c29d5175Schristos   execsnoop		snoop process execution as it occurs
16*c29d5175Schristos   iosnoop		snoop I/O events as they occur
17*c29d5175Schristos   iopattern		print disk I/O pattern
18*c29d5175Schristos   iotop		display top disk I/O events by process
19*c29d5175Schristos   opensnoop		snoop file opens as they occur
20*c29d5175Schristos   procsystime		analyse process system call times
21*c29d5175Schristos   rwsnoop		snoop read/write events
22*c29d5175Schristos   rwtop		display top read/write bytes by process
23*c29d5175Schristos   statsnoop		snoop file stats as they occur
24*c29d5175Schristos   Apps/
25*c29d5175Schristos	httpdstat.d	realtime httpd statistics
26*c29d5175Schristos	nfswizard.d	NFS client activity wizard
27*c29d5175Schristos	shellsnoop	snoop live shell activity
28*c29d5175Schristos	weblatency.d	website latency statistics
29*c29d5175Schristos   Cpu/
30*c29d5175Schristos	cputypes.d	list CPU types
31*c29d5175Schristos	cpuwalk.d	measure which CPUs a process runs on
32*c29d5175Schristos	dispqlen.d	dispatcher queue length by CPU
33*c29d5175Schristos	intbycpu.d	interrupts by CPU
34*c29d5175Schristos	intoncpu.d	interrput on-cpu usage
35*c29d5175Schristos	inttimes.d	interrput on-cpu time total
36*c29d5175Schristos	loads.d		print load averages
37*c29d5175Schristos	runocc.d	run queue occupancy by CPU
38*c29d5175Schristos	xcallsbypid.d	CPU cross calls by PID
39*c29d5175Schristos   Disk/
40*c29d5175Schristos	bitesize.d	print disk event size report
41*c29d5175Schristos	diskhits	disk access by file offset
42*c29d5175Schristos	hotspot.d	print disk event by location
43*c29d5175Schristos	iofile.d	I/O wait time by filename and process
44*c29d5175Schristos	iofileb.d	I/O bytes by filename and process
45*c29d5175Schristos	iopending	plot number of pending disk events
46*c29d5175Schristos	pathopens.d	pathnames successfully opened count
47*c29d5175Schristos	seeksize.d	print disk seek size report
48*c29d5175Schristos   Docs/
49*c29d5175Schristos	oneliners.txt	DTrace oneliners
50*c29d5175Schristos   FS/
51*c29d5175Schristos	fsrw.d		file system read/write event tracing
52*c29d5175Schristos	fspaging.d	file system read/write and paging tracing
53*c29d5175Schristos	rfsio.d		read FS I/O stats, with cache miss rate
54*c29d5175Schristos	rfileio.d	read file I/O stats, with cache miss rate
55*c29d5175Schristos	vopstat		vnode interface statistics
56*c29d5175Schristos   Java/
57*c29d5175Schristos	j_*.d		18 scripts for tracing Java using the hotspot provider
58*c29d5175Schristos   JavaScript/
59*c29d5175Schristos	js_*.d		14 scripts for JavaScript with the Mozilla provider
60*c29d5175Schristos   Kernel/
61*c29d5175Schristos	cputimes	print time by Kernel/Idle/Process
62*c29d5175Schristos	cpudists	time distribution by Kernel/Idle/Process
63*c29d5175Schristos	cswstat.d	context switch time statistics
64*c29d5175Schristos	dnlcps.d	DNLC stats by process
65*c29d5175Schristos	dnlcsnoop.d	snoop DNLC activity
66*c29d5175Schristos	dnlcstat	DNLC statistics
67*c29d5175Schristos	kstat_types.d	trace kstat reads with type info
68*c29d5175Schristos	modcalls.d	kernel function calls by module name
69*c29d5175Schristos	priclass.d	priority distribution by scheduling class
70*c29d5175Schristos	pridist.d	process priority distribution
71*c29d5175Schristos	putnexts.d	trace who is putting to which streams module
72*c29d5175Schristos	whatexec.d	examine the type of files executed
73*c29d5175Schristos   Locks/
74*c29d5175Schristos	lockbyproc.d	lock time by process name
75*c29d5175Schristos	lockbydist.d	lock time distribution by process name
76*c29d5175Schristos   Mem/
77*c29d5175Schristos	anonpgpid.d	anonymous memory paging info by PID on CPU
78*c29d5175Schristos	minfbypid.d	minor faults by PID
79*c29d5175Schristos	minfbyproc.d	minor faults by process name
80*c29d5175Schristos	pgpginbypid.d	pages paged in by PID
81*c29d5175Schristos	pgpginbyproc.d	pages paged in by process name
82*c29d5175Schristos	swapinfo.d	print virtual memory info
83*c29d5175Schristos	vmbypid.d	virtual memory stats by PID
84*c29d5175Schristos	vmstat.d	vmstat demo using DTrace
85*c29d5175Schristos	vmstat-p.d	vmstat -p demo using DTrace
86*c29d5175Schristos	xvmstat		extended vmstat demo using DTrace
87*c29d5175Schristos   Misc/
88*c29d5175Schristos	guess.d		guessing game
89*c29d5175Schristos	wpm.d		words per minute tracing
90*c29d5175Schristos	woof.d		audio alert for new processes
91*c29d5175Schristos   Net/
92*c29d5175Schristos	connections	print inbound TCP connections by process
93*c29d5175Schristos	icmpstat.d	print ICMP statistics
94*c29d5175Schristos	tcpsnoop	snoop TCP network packets by process, Solaris 10 3/05
95*c29d5175Schristos	tcpsnoop_snv	snoop TCP network packets by process, Solaris Nevada
96*c29d5175Schristos	tcpsnoop.d	snoop TCP network packets by process, Solaris 10 3/05
97*c29d5175Schristos	tcpsnoop_snv.d	snoop TCP network packets by process, Solaris Nevada
98*c29d5175Schristos	tcpstat.d	print TCP statistics
99*c29d5175Schristos	tcptop		display top TCP network packets by PID, Solaris 10 3/05
100*c29d5175Schristos	tcptop_snv	display top TCP network packets by PID, Solaris Nevada
101*c29d5175Schristos	tcpwdist.d	simple TCP write distribution by process
102*c29d5175Schristos	udpstat.d	print UDP statistics
103*c29d5175Schristos   Perl/
104*c29d5175Schristos	pl_*.d		12 scripts for tracing Perl
105*c29d5175Schristos   Php/
106*c29d5175Schristos	php_*.d		12 scripts for tracing Php
107*c29d5175Schristos   Proc/
108*c29d5175Schristos	crash.d		crashed application report
109*c29d5175Schristos	creatbyproc.d	snoop file creat() by process name
110*c29d5175Schristos	dappprof	profile user and lib function usage
111*c29d5175Schristos	dapptrace	trace user and lib function usage
112*c29d5175Schristos	fddist		file descriptor usage distribution
113*c29d5175Schristos	fileproc.d	snoop files opened by process
114*c29d5175Schristos	kill.d		snoop process signals
115*c29d5175Schristos	lastwords	print syscalls before exit
116*c29d5175Schristos	mmapfiles.d	mmap'd files by process
117*c29d5175Schristos	newproc.d	snoop new processes
118*c29d5175Schristos	pfilestat	show I/O latency break down by FD
119*c29d5175Schristos	pidpersec.d	print new PIDs per sec
120*c29d5175Schristos	readbytes.d	read bytes by process name
121*c29d5175Schristos	readdist.d	read distribution by process name
122*c29d5175Schristos	rwbbypid.d	read/write bytes by PID
123*c29d5175Schristos	rwbypid.d	read/write calls by PID
124*c29d5175Schristos	rwbytype.d	read/write bytes by vnode type
125*c29d5175Schristos	sampleproc	sample processes on the CPUs
126*c29d5175Schristos	shortlived.d	check short lived process time
127*c29d5175Schristos	sigdist.d	signal distribution by process name
128*c29d5175Schristos	stacksize.d	measure stack size for running threads
129*c29d5175Schristos	sysbypid.d	system stats by PID
130*c29d5175Schristos	syscallbyproc.d	system calls by process name
131*c29d5175Schristos	syscallbypid.d	system calls by process ID
132*c29d5175Schristos	threaded.d	sample multi-threaded CPU usage
133*c29d5175Schristos	topsysproc	display top syscalls by process name
134*c29d5175Schristos	writebytes.d	write bytes by process name
135*c29d5175Schristos	writedist.d	write distribution by process name
136*c29d5175Schristos   Python/
137*c29d5175Schristos	py_*.d		14 scripts for tracing Python
138*c29d5175Schristos   Shell/
139*c29d5175Schristos	sh_*.d		15 scripts for tracing the Bourne shell
140*c29d5175Schristos   System/
141*c29d5175Schristos	sar-c.d		sar -c demo using DTrace
142*c29d5175Schristos	syscallbysysc.d	system calls by system call
143*c29d5175Schristos	topsyscall	display top system call type
144*c29d5175Schristos	uname-a.d	uname -a demo using DTrace
145*c29d5175Schristos   Tcl/
146*c29d5175Schristos	tcl_*.d		15 scripts for tracing Tcl
147*c29d5175Schristos   User/
148*c29d5175Schristos	setuids.d	snoop setuid calls
149*c29d5175Schristos   Zones/
150*c29d5175Schristos	zvmstat		vmstat info by zone
151*c29d5175Schristos
152*c29d5175SchristosTotal: 230 scripts
153