dappprof(1m) USER COMMANDS dappprof(1m)

dappprof - profile user and lib function usage. Uses DTrace.

dappprof [-acehoTU] [-u lib] { -p PID | command }

dappprof prints details on user and library call times for processes as a summary style aggragation. By default the user fuctions are traced, options can be used to trace library activity. Output can include function counts, elapsed times and on cpu times.

The elapsed times are interesting, to help identify functions that take some time to complete (during which the process may have slept). CPU time helps us identify syscalls that are consuming CPU cycles to run.

Since this uses DTrace, only users with root privileges can run this command.

print all data
print function counts
print elapsed times, ns
print CPU times, ns
print totals
examine this PID
trace this library instead
trace all library and user functions

# dappprof df -h
# dappprof -ceo df -h
# dappprof -p 1871
# dappprof -ap 1871

Function call name
Total elapsed time, nanoseconds
Total on-cpu time, nanoseconds
Number of occurrences

See the DTraceToolkit for further documentation under the Docs directory. The DTraceToolkit docs may include full worked examples with verbose descriptions explaining the output.

dappprof will sample until Ctrl-C is hit.

Brendan Gregg [Sydney, Australia]

dapptrace(1M), dtrace(1M), apptrace(1)

May 14, 2005 version 1.10