|
|
|
|
.\" 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 TDE 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
|
|
|
|
|
tdecachegrind cachegrind.out.12345.1
|
|
|
|
|
.RE
|
|
|
|
|
.PP
|
|
|
|
|
.SH SEE ALSO
|
|
|
|
|
.BR tdecachegrind (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).
|
