summaryrefslogtreecommitdiffstats
path: root/doc/man/tdecachegrind/dprof2calltree.1
diff options
context:
space:
mode:
Diffstat (limited to 'doc/man/tdecachegrind/dprof2calltree.1')
-rw-r--r--doc/man/tdecachegrind/dprof2calltree.160
1 files changed, 60 insertions, 0 deletions
diff --git a/doc/man/tdecachegrind/dprof2calltree.1 b/doc/man/tdecachegrind/dprof2calltree.1
new file mode 100644
index 00000000..88bcd0b0
--- /dev/null
+++ b/doc/man/tdecachegrind/dprof2calltree.1
@@ -0,0 +1,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 TDE 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
+tdecachegrind cachegrind.out.foo
+.RE
+.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).