Home | History | Annotate | Download | only in help
      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>