iprep
iprep (IP sampling REPort)
===== === ======== =======
iprep is used to create a useful report from one or more raw ip
sampling reports produced by histx. E.g.
% iprep < ip.prog.12345 > report.12345
or
% iprep -c 5 ip.prog.* > report.all
Output from iprep consists of one or two sections. First, a listing of
summed functions counts, sorted from largest to smallest, along with
their self and cumulative percentages. For example:
Count Self % Cum. % Name
----- ------- ------- ----
12362 29.730 29.730 libm.so.6.1:cos
7716 18.557 48.286 libm.so.6.1:acos
6533 15.712 63.998 libm.so.6.1:asin
6338 15.243 79.241 a.out:f1 [prog.c:19]
5655 13.600 92.840 a.out:f2 [prog.c:29]
1401 3.369 96.210 a.out:_init
625 1.503 97.713 libm.so.6.1:sin
...
The second section presents the line level data (if available) in a similar
format. E.g.
Count Self % Cum. % Name
-------------------- ------- ------- --------------------
6345 48.989 48.989 [prog.c:23] (a.out)
5401 41.700 90.689 [prog.c:33] (a.out)
96 0.741 91.430 [elf/elf.h:80] (ld-linux-ia64.so.2)
...
See the histx documentation for a description of the entries
in the "Name" column.
iprep will not report counts for functions or lines whose self
percentage is less than a cutoff. The default cutoff is 0.5%.
A different cutoff percentage may be provided to iprep
by placing "-c <cutoff percentage>" first on the command line,
where 0 <= <cutoff percentage> < 100.
An option "-s[NNN]" is provided to "shorten" the length of the
entries in the "Name" column. When "-s" is used:
. Only the names of the functions of interest are given; the
library and any file and line information is omitted. Additionally,
when the "-sNNN" form is used, any function names whose length
exceeds NNN are truncated.
. Only the file name and line number is provided in the line level
data section. The library name is omitted.