.\"                                      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 PPROF2CALLTREE 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
pprof2calltree \- convert APD profiling data to KCachegrind calltree format
.SH SYNOPSIS
.B pprof2calltree
\fB\-f\fP \fIinput\fP
.SH DESCRIPTION
\fBpprof2calltree\fP reads the pprof profiling data output by
APD (http://pecl.php.net/apd/), 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 APD pprof trace file to convert.  This generally has a
name of the form \fIpprof.XXXXX.Y\fP.  The calltree output for
KCachegrind will then be written to the file \fIcachegrind.out.XXXXX.Y\fP.
.SH EXAMPLE
Suppose you profile a script with APD and obtain the pprof trace file
\fIpprof.12345.1\fP.  You can then work with this data in KCachegrind as
follows.
.PP
.RS
pprof2calltree \-f pprof.12345.1
.br
kcachegrind cachegrind.out.12345.1
.RE
.PP
.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).