docs/html/tools/help/dmtracedump.jd

   1 page.title=dmtracedump
   2 parent.title=Tools
   3 parent.link=index.html
   4 @jd:body
   5
   6
   7  <p><code>dmtracedump</code> is a tool that gives you an alternate way of generating
   8   graphical call-stack diagrams from trace log files (instead of using Traceview).</p>
   9
  10   <p>This document is a reference to the available command line options. For more information on generating trace
  11   logs, see <a href="{@docRoot}tools/debugging/debugging-tracing.html">Profiling with
  12   Traceview and dmtracedump</a>.</p>
  13
  14   <p>The usage for <code>dmtracedump</code> is:</p>
  15   <pre>
  16 dmtracedump [-ho] [-s sortable] [-d trace-base-name] [-g outfile] &lt;trace-base-name&gt;
  17 </pre>
  18
  19   <p>The tool then loads trace log data from <code>&lt;trace-base-name&gt;.data</code> and
  20   &lt;trace-base-name&gt;.key. The table below lists the options for dmtracedump.</p>
  21
  22   <table>
  23     <tr>
  24       <th>Option</th>
  25
  26       <th>Description</th>
  27     </tr>
  28
  29     <tr>
  30       <td><nobr><code>-d&nbsp;<em>&lt;trace-base-name&gt;</em></code></nobr></td>
  31
  32       <td>Diff with this trace name</td>
  33     </tr>
  34
  35     <tr>
  36       <td><code>-g&nbsp;<em>&lt;outfile&gt;</em></code></td>
  37
  38       <td>Generate output to &lt;outfile&gt;</td>
  39     </tr>
  40
  41     <tr>
  42       <td><code>-h</code></td>
  43
  44       <td>Turn on HTML output</td>
  45     </tr>
  46
  47     <tr>
  48       <td><code>-o</code></td>
  49
  50       <td>Dump the trace file instead of profiling</td>
  51     </tr>
  52
  53     <tr>
  54       <td><code>-d&nbsp;<em>&lt;trace-base-name&gt;</em></code></td>
  55
  56       <td>URL base to the location of the sortable javascript file</td>
  57     </tr>
  58
  59     <tr>
  60       <td><code>-t&nbsp;&lt;percent&gt;</code></td>
  61
  62       <td>Minimum threshold for including child nodes in the graph (child's inclusive time as a
  63       percentage of parent inclusive time). If this option is not used, the default threshold is
  64       20%.</td>
  65     </tr>
  66   </table>