summaryrefslogtreecommitdiffstats
path: root/ubuntu/maverick_automake/kdesdk/debian/man/dprof2calltree.1
blob: f1e7691a49699702adb5ced70e9ccc0a928a21c9 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
.\"                                      Hey, EMACS: -*- nroff -*-
.\" First parameter, NAME, should be all caps
.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
.\" other parameters are allowed: see man(7), man(1)
.TH DPROF2CALLTREE 1 "October 15, 2004"
.\" Please adjust this date whenever revising the manpage.
.\"
.\" Some roff macros, for reference:
.\" .nh        disable hyphenation
.\" .hy        enable hyphenation
.\" .ad l      left justify
.\" .ad b      justify to both left and right margins
.\" .nf        disable filling
.\" .fi        enable filling
.\" .br        insert line break
.\" .sp <n>    insert n+1 empty lines
.\" for manpage-specific macros, see man(7)
.SH NAME
dprof2calltree \- convert perl's DProf profiling data to KCachegrind calltree format
.SH SYNOPSIS
.B dprof2calltree
\fB\-f\fP \fIinput\fP
[ \fB\-o\fP \fIoutput\fP ]
.SH DESCRIPTION
\fBdprof2calltree\fP reads the \fItmon.out\fP profiling data output by
Perl's Devel::DProf profiling package, and converts it into calltree format
for use by KCachegrind.
.PP
This utility is part of the KDE Software Development Kit.
.SH OPTIONS
.TP
\fB\-f\fP \fIinput\fP
Specifies the DProf \fItmon.out\fP file to convert.
.TP
\fB\-o\fP \fIoutput\fP
Write the calltree output to the given file for use by KCachegrind.
If omitted, the output will be written to file of the form
\fIcachgrind.out.<input>\fP.
.SH EXAMPLE
If you run a perl script as:
.PP
.RS
perl -d:DProf yourscript.pl
.RE
.PP
then this will write profiling data to \fItmon.out\fP.  You can then
work with this data in KCachegrind as follows:
.PP
.RS
dprof2calltree -f tmin.out -o cachegrind.out.foo
.br
kcachegrind cachegrind.out.foo
.RE
.SH SEE ALSO
.BR kcachegrind (1).
.SH AUTHOR
This converter was written by George Schlossnagle <george@omniti.com>.
.br
This manual page was prepared by Ben Burton <bab@debian.org>
for the Debian GNU/Linux system (but may be used by others).