summaryrefslogtreecommitdiffstats
path: root/llvm/docs/CommandGuide/llvm-prof.pod
diff options
context:
space:
mode:
authormike-m <mikem.llvm@gmail.com>2010-05-07 00:28:04 +0000
committermike-m <mikem.llvm@gmail.com>2010-05-07 00:28:04 +0000
commitf375e9a0924fd059792c6dccbb0412d5127bfc74 (patch)
tree2f0ab8df49bc88e1ada70472c8f312e1e3084b16 /llvm/docs/CommandGuide/llvm-prof.pod
parentddc93c7e04be840a8069526d4613d51716cab57c (diff)
downloadbcm5719-llvm-f375e9a0924fd059792c6dccbb0412d5127bfc74.tar.gz
bcm5719-llvm-f375e9a0924fd059792c6dccbb0412d5127bfc74.zip
Revert r103213. It broke several sections of live website.
llvm-svn: 103219
Diffstat (limited to 'llvm/docs/CommandGuide/llvm-prof.pod')
-rw-r--r--llvm/docs/CommandGuide/llvm-prof.pod57
1 files changed, 57 insertions, 0 deletions
diff --git a/llvm/docs/CommandGuide/llvm-prof.pod b/llvm/docs/CommandGuide/llvm-prof.pod
new file mode 100644
index 00000000000..9541b05dcaf
--- /dev/null
+++ b/llvm/docs/CommandGuide/llvm-prof.pod
@@ -0,0 +1,57 @@
+=pod
+
+=head1 NAME
+
+llvm-prof - print execution profile of LLVM program
+
+=head1 SYNOPSIS
+
+B<llvm-prof> [I<options>] [I<bitcode file>] [I<llvmprof.out>]
+
+=head1 DESCRIPTION
+
+The B<llvm-prof> tool reads in an F<llvmprof.out> file (which can
+optionally use a specific file with the third program argument), a bitcode file
+for the program, and produces a human readable report, suitable for determining
+where the program hotspots are.
+
+This program is often used in conjunction with the F<utils/profile.pl>
+script. This script automatically instruments a program, runs it with the JIT,
+then runs B<llvm-prof> to format a report. To get more information about
+F<utils/profile.pl>, execute it with the B<-help> option.
+
+=head1 OPTIONS
+
+=over
+
+=item B<--annotated-llvm> or B<-A>
+
+In addition to the normal report printed, print out the code for the
+program, annotated with execution frequency information. This can be
+particularly useful when trying to visualize how frequently basic blocks
+are executed. This is most useful with basic block profiling
+information or better.
+
+=item B<--print-all-code>
+
+Using this option enables the B<--annotated-llvm> option, but it
+prints the entire module, instead of just the most commonly executed
+functions.
+
+=item B<--time-passes>
+
+Record the amount of time needed for each pass and print it to standard
+error.
+
+=back
+
+=head1 EXIT STATUS
+
+B<llvm-prof> returns 1 if it cannot load the bitcode file or the profile
+information. Otherwise, it exits with zero.
+
+=head1 AUTHOR
+
+B<llvm-prof> is maintained by the LLVM Team (L<http://llvm.org>).
+
+=cut
OpenPOWER on IntegriCloud