aboutsummaryrefslogtreecommitdiffstats
path: root/docs
diff options
context:
space:
mode:
authorBrian Gaeke <gaeke@uiuc.edu>2004-05-14 18:03:22 +0000
committerBrian Gaeke <gaeke@uiuc.edu>2004-05-14 18:03:22 +0000
commit25ab104acb762ed5c7fdeb56ef6286f47a0b812c (patch)
treed6f3799f77ba3671a93c824c87c6aa1bbe6f1966 /docs
parent09015d9468abc3afb9880f9405bde31346d2b27d (diff)
downloadexternal_llvm-25ab104acb762ed5c7fdeb56ef6286f47a0b812c.zip
external_llvm-25ab104acb762ed5c7fdeb56ef6286f47a0b812c.tar.gz
external_llvm-25ab104acb762ed5c7fdeb56ef6286f47a0b812c.tar.bz2
This seems like as good a place as any to keep POD files.
git-svn-id: https://llvm.org/svn/llvm-project/llvm/trunk@13569 91177308-0d34-0410-b5e6-96231b3b80d8
Diffstat (limited to 'docs')
-rw-r--r--docs/CommandGuide/llvm-prof.pod58
1 files changed, 58 insertions, 0 deletions
diff --git a/docs/CommandGuide/llvm-prof.pod b/docs/CommandGuide/llvm-prof.pod
new file mode 100644
index 0000000..8a75753
--- /dev/null
+++ b/docs/CommandGuide/llvm-prof.pod
@@ -0,0 +1,58 @@
+=pod
+
+=head1 NAME
+
+llvm-prof
+
+=head1 SYNOPSIS
+
+llvm-prof [options] [bytecode file] [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 bytecode 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 bytecode file or the profile
+information. Otherwise, it exits with zero.
+
+=head1 AUTHOR
+
+B<llvm-prof> is maintained by the LLVM Team (L<http://llvm.cs.uiuc.edu>).
+
+=cut
+