← Back to branch summary

~ubuntu-branches/ubuntu/intrepid/perl-doc-html/intrepid

« back to all changes in this revision

Viewing changes to dprofpp.html

  • Committer: Bazaar Package Importer
  • Author(s): Roberto C. Sanchez
  • Date: 2008-05-17 20:14:19 UTC
  • mfrom: (1.1.1 upstream)
  • Revision ID: james.westby@ubuntu.com-20080517201419-qgbuogq2ckkdisyi
Tags: 5.10.0-2
Supersede botched upload of 5.10.0-1.

Show diffs side-by-side

added added

removed removed

Lines of Context:
dprofpp.html
54
54
      <h2>Links:</h2>
55
55
      <ul>
56
56
        <li><a href="http://search.cpan.org">CPAN</a></li>
 
57
        <li><a href="http://www.perl.org">Perl.org</a></li>
57
58
        <li><a href="http://www.perl.com">Perl.com</a></li>
58
 
        <li><a href="http://www.perl.org">Perl.org</a></li>
 
59
        <li><a href="http://perlbuzz.com">Perl Buzz</a></li>
 
60
        <li><a href="http://www.perlfoundation.org/perl5/index.cgi">Perl 5 Wiki</a></li>
 
61
        <li><a href="http://jobs.perl.org">Perl Jobs</a></li>
59
62
        <li><a href="http://www.pm.org">Perl Mongers</a></li>
60
63
        <li><a href="http://www.perlmonks.org">Perl Monks</a></li>
61
64
        <li><a href="http://planet.perl.org">Planet Perl</a></li>
65
68
      <ul>
66
69
        <li>Site maintained by<br><a href="http://perl.jonallen.info">Jon Allen</a>
67
70
            (<a href="http://perl.jonallen.info">JJ</a>)</li>
68
 
        <li class="spaced">Last updated on<br>23 April 2006</li>
 
71
        <li class="spaced">Last updated on<br>23 December 2007</li>
69
72
        <li class="spaced">See the <a href="http://perl.jonallen.info/projects/perldoc">project page</a> for
70
73
        more details</li>
71
74
      </ul>
76
79
    <div id="centerContent">
77
80
      <div id="contentHeader">
78
81
        <div id="contentHeaderLeft"><a href="#" onClick="showLeft()">Show navigation</a></div>
79
 
        <div id="contentHeaderCentre">-- Perl 5.8.8 documentation --</div>
 
82
        <div id="contentHeaderCentre">-- Perl 5.10.0 documentation --</div>
80
83
        <div id="contentHeaderRight"><a href="#" onClick="showRight()">Show toolbar</a></div>
81
84
      </div>
82
85
      <div id="breadCrumbs"><a href="index.html">Home</a> &gt; <a href="index-utilities.html">Utilities</a> &gt; dprofpp</div>
84
87
      <div id="contentBody"><div class="title_container"><div class="page_title">dprofpp</div></div><ul><li><a href="#NAME">NAME</a><li><a href="#SYNOPSIS">SYNOPSIS</a><li><a href="#DESCRIPTION">DESCRIPTION</a><li><a href="#OUTPUT">OUTPUT</a><li><a href="#OPTIONS">OPTIONS</a><li><a href="#ENVIRONMENT">ENVIRONMENT</a><li><a href="#BUGS">BUGS</a><li><a href="#FILES">FILES</a><li><a href="#SEE-ALSO">SEE ALSO</a></ul><a name="NAME"></a><h1>NAME</h1>
85
88
<p>dprofpp - display perl profile data</p>
86
89
<a name="SYNOPSIS"></a><h1>SYNOPSIS</h1>
87
 
<p>dprofpp [<b>-a</b>|<b>-z</b>|<b>-l</b>|<b>-v</b>|<b>-U</b>] [<b>-d</b>] [<b>-s</b>|<b>-r</b>|<b>-u</b>] [<b>-q</b>] [<b>-F</b>] [<b>-I|-E</b>] [<b>-O cnt</b>] [<b>-A</b>] [<b>-R</b>] [<b>-S</b>] [<b>-g subroutine</b>] [<b>-G</b> &lt;regexp&gt; [<b>-P</b>]] [<b>-f</b> &lt;regexp&gt;] [profile]
88
 
  
89
 
dprofpp <b>-T</b> [<b>-F</b>] [<b>-g subroutine</b>] [profile]</p>
 
90
<p>dprofpp [<b>-a</b>|<b>-z</b>|<b>-l</b>|<b>-v</b>|<b>-U</b>] [<b>-d</b>] [<b>-s</b>|<b>-r</b>|<b>-u</b>] [<b>-q</b>] [<b>-F</b>] [<b>-I|-E</b>] [<b>-O cnt</b>] [<b>-A</b>] [<b>-R</b>] [<b>-S</b>] [<b>-g subroutine</b>] [<b>-G</b> &lt;regexp&gt; [<b>-P</b>]] [<b>-f</b> &lt;regexp&gt;] [profile]</p>
 
91
<p>dprofpp <b>-T</b> [<b>-F</b>] [<b>-g subroutine</b>] [profile]</p>
90
92
<p>dprofpp <b>-t</b> [<b>-F</b>] [<b>-g subroutine</b>] [profile]</p>
91
 
<p>dprofpp <b>-G</b> &lt;regexp&gt; [<b>-P</b>] [profile]
92
 
 
93
 
dprofpp <b>-p script</b> [<b>-Q</b>] [other opts]</p>
 
93
<p>dprofpp <b>-G</b> &lt;regexp&gt; [<b>-P</b>] [profile]</p>
 
94
<p>dprofpp <b>-p script</b> [<b>-Q</b>] [other opts]</p>
94
95
<p>dprofpp <b>-V</b> [profile]</p>
95
96
<a name="DESCRIPTION"></a><h1>DESCRIPTION</h1>
96
97
<p>The <i>dprofpp</i> command interprets profile data produced by a profiler, such
112
113
         0.00   0.000          1   0.0000 DynaLoader::import
113
114
         0.00   0.000          1   0.0000 main::baz</pre><p>The dprofpp tool can also run the profiler before analyzing the profile
114
115
data.  The above two commands can be executed with one dprofpp command.</p>
115
 
<pre class="verbatim">  <span class="i">$ dprofpp</span> -u -p <span class="i">test</span>.pl</pre>
 
116
<pre class="verbatim">  <span class="i">$ dprofpp</span> -<span class="w">u</span> -p <span class="w">test</span>.<span class="w">pl</span></pre>
116
117
<p>Consult <a href="Devel/DProf.html#PROFILE-FORMAT">"PROFILE FORMAT" in Devel::DProf</a> for a description of the raw profile.</p>
117
118
<a name="OUTPUT"></a><h1>OUTPUT</h1>
118
119
<p>Columns are:</p>
155
156
Otherwise the time to autoload it is counted as time of the subroutine
156
157
itself (there is no way to separate autoload time from run time).</p>
157
158
<p>This is going to be irrelevant with newer Perls.  They will inform
158
 
<code class="inline"><a class="l_w" href="Devel/DProf.html">Devel::DProf</a></code> <i>when</i> the <code class="inline">AUTOLOAD</code>
 
159
<code class="inline"><span class="w">Devel::DProf</span></code>
 
160
 <i>when</i> the <code class="inline">AUTOLOAD</code>
159
161
 switches to actual subroutine,
160
162
so a separate statistics for <code class="inline">AUTOLOAD</code>
161
163
 will be collected no matter
211
213
</li>
212
214
<li><a name="*-S*"></a><b><b>-S</b></b>
213
215
<p>Display <i>merged</i> subroutine call tree to stdout.  Statistics are
214
 
displayed for each branch of the tree.  </p>
 
216
displayed for each branch of the tree.</p>
215
217
<p>When a function is called multiple (<i>not necessarily consecutive</i>)
216
218
times in the same branch then all these calls go into one branch of
217
219
the next level.  A repeat count is output together with combined
230
232
</li>
231
233
<li><a name="*-v*"></a><b><b>-v</b></b>
232
234
<p>Sort by average time spent in subroutines during each call.  This may help
233
 
identify candidates for inlining. </p>
 
235
identify candidates for inlining.</p>
234
236
</li>
235
237
<li><a name="*-z*"></a><b><b>-z</b></b>
236
238
<p>(default) Sort by amount of user+system time used.  The first few lines
237
239
should show you which subroutines are using the most time.</p>
238
240
</li>
239
 
<li><a name="*-g*-'subroutine'"></a><b><b>-g</b> <code class="inline">subroutine</code>
 
241
<li><a name="*-g*-'subroutine'"></a><b><b>-g</b> <code class="inline"><span class="w">subroutine</span></code>
240
242
</b>
241
 
<p>Ignore subroutines except <code class="inline">subroutine</code>
 
243
<p>Ignore subroutines except <code class="inline"><span class="w">subroutine</span></code>
242
244
 and whatever is called from it.</p>
243
245
</li>
244
246
<li><a name="*-G*-%3cregexp%3e"></a><b><b>-G</b> &lt;regexp&gt;</b>
245
247
<p>Aggregate "Group" all calls matching the pattern together.
246
248
For example this can be used to group all calls of a set of packages</p>
247
 
<pre class="verbatim">  -G <span class="q">&quot;(package1::)|(package2::)|(package3::)&quot;</span></pre>
 
249
<pre class="verbatim">  -<span class="w">G</span> <span class="q">&quot;(package1::)|(package2::)|(package3::)&quot;</span></pre>
248
250
<p>or to group subroutines by name:</p>
249
 
<pre class="verbatim">  -G <span class="q">&quot;getNum&quot;</span></pre>
 
251
<pre class="verbatim">  -<span class="w">G</span> <span class="q">&quot;getNum&quot;</span></pre>
250
252
</li>
251
253
<li><a name="*-P*"></a><b><b>-P</b></b>
252
254
<p>Used with -G to aggregate "Pull" together all calls that did not match -G.</p>
277
279
<i>&lt;perl5-porters@perl.org&gt;</i>.  Bug reports should include the
278
280
output of the <b>-V</b> option.</p>
279
281
<a name="FILES"></a><h1>FILES</h1>
280
 
<pre class="verbatim">  dprofpp         - profile processor
281
 
        tmon.out        - raw profile</pre>
 
282
<pre class="verbatim">  <span class="w">dprofpp</span>          - <span class="w">profile</span> <span class="w">processor</span>
 
283
        <span class="w">tmon</span>.<span class="w">out</span>  - <span class="w">raw</span> <span class="w">profile</span></pre>
282
284
<a name="SEE-ALSO"></a><h1>SEE ALSO</h1>
283
285
<p><a href="perl.html">perl</a>, <a href="Devel/DProf.html">Devel::DProf</a>, times(2)</p>
284
286
</div>
298
300
          <!--<select name="r"><option value="1" selected>Go to top result<option value="0">Show results list</select>-->
299
301
        </form>
300
302
      </p>
 
303
      <script language="JavaScript" type="text/javascript" src="/perl-version.js"></script>
301
304
      <h2>Labels:</h2>
302
305
      <p>
303
306
        <a href="#" onClick="addLabel('dprofpp','dprofpp.html')">Add this page</a>