dmtracedump
- Syntax
  - Global options
  - Commands and command options
- Output

dmtracedump

dmtracedump is a tool that generatesgraphical call-stack diagrams from trace log files. The tool uses the GraphvizDot utility to create the graphical output, so you need to install Graphvizbefore running dmtracedump. If you haven't yet generated trace logs andsaved them from your connected device to your local machine, go toGenerate trace logs by instrumenting your app.

The dmtracedump tool generates the call stack data as a tree diagram, where eachnode represents a method call. It shows call flow (from parent node to child nodes)using arrows. The diagram below shows a sample output of dmtracedump.

The dmtracedump tool is provided in the Android SDK Tools package and islocated in android-sdk/platform-tools/.

Syntax

The usage for dmtracedump is:

dmtracedump [-ho] [-s sortable] [-d trace-base-name] [-g outfile] trace-base-name

The tool then loads trace log data from trace-base-name.data andtrace-base-name.key.

Global options

Global options	Description
`-h`	Turn on HTML output
`-o`	Dump the trace file instead of profiling

Commands and command options

Commands and options	Description
`-d trace-base-name`	Diff with this trace name
`-g outfile`	Generate output to `outfile`
`-s sortable`	URL base to the location of the sortable javascript file
`-t percent`	Minimum threshold for including child nodes in the graph (child's inclusive time as a percentage of parent inclusive time). If this option is not used, the default threshold is 20%.

Output

Figure 1. Screenshot of dmtracedump

For each node in the graph, dmtracedump shows the followinginformation:

ref callname (inc-ms, exc-ms,numcalls)

ref — Call reference number, as used in trace logs
inc-ms — Inclusive elapsed time (milliseconds spent in method, including all child methods)
exc-ms — Exclusive elapsed time (milliseconds spent in method, not including any child methods)
numcalls — Number of calls