1FPROFPP(1)            User Contributed Perl Documentation           FPROFPP(1)
2
3
4

NAME

6       fprofpp - Devel::FastProf post processor
7

SYNOPSIS

9         $ fprofpp [-f filename] [-r] [-e] [-g] [-p] [-t num]
10

DESCRIPTION

12       "fprofpp" reads the profile information generated when using
13       Devel::FastProf (usually saved on a file named "fastprof.out") and
14       prints a "human friendly" report.
15
16   OPTIONS
17       Those are the flags that can be used with "fprofpp":
18
19       -f filename
20           instead of the default "fastprof.out" reads the file given as an
21           argument.
22
23       -r  sorts the lines on the output by the number of times they have been
24           called instead of by the time spent on them (that is the default).
25
26       -t num
27           only outputs the first "num" lines
28
29       -e  account the time spent on code inside "eval "..."" constructions on
30           the line where the eval starts.
31
32           Time spent on subroutines defined inside an eval will also be
33           accounted on that line even when the subs are latter called outside
34           the eval.
35
36           By default, every time an eval is executed its code is considered
37           to be a different source file and accounted independently of the
38           rest of the calls to the same eval.
39
40           On the report, it points to the place (file and line) where the
41           eval sits, but the line source is the code actually executed.
42
43       -g  by default, on forking code, the time spent on every line by every
44           process is accounted separately.
45
46           when this option is set, instead, the time reported is the sum of
47           the time spent by all the processes on every line.
48
49       -p  include process information on the report.
50
51       -H  Do not print the report header.
52

THE EMACS/XEMACS HACK

54       The format of the report generated by "Devel::SmallProf" is similar to
55       that generated by "gcc" or "grep -n" and so, easily parseable by
56       "Emacs" (and I suppose it shouldn't be too difficult to do the same
57       from "vi" and other editors).
58
59       For instance, one way to do it from XEmacs is, starting from a buffer
60       on the same directory where "fastprof.out" sits:
61
62         M-! fprofpp -t 30
63         M-x compilation-mode
64
65       then, going to the hot spots of the profiled program would be as easy
66       as clicking the mouse over the lines on the "fprofpp" output buffer.
67

SEE ALSO

69       Devel::FastProf, perlrun.
70

72       Copyright (C) 2005 by Salvador Fandiño <sfandino@yahoo.com>.
73
74       This program is free software; you can redistribute it and/or modify it
75       under the same terms as Perl itself, either Perl version 5.8.7 or, at
76       your option, any later version of Perl 5 you may have available.
77
78
79
80perl v5.38.0                      2023-07-20                        FPROFPP(1)
Impressum