2 .TH "LLVM-PROF" "1" "2013-04-11" "3.3" "LLVM"
4 llvm-prof \- print execution profile of LLVM program
6 .nr rst2man-indent-level 0
10 level \\n[rst2man-indent-level]
11 level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
18 .\" .rstReportMargin pre:
20 . nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
21 . nr rst2man-indent-level +1
22 .\" .rstReportMargin post:
26 .\" indent \\n[an-margin]
27 .\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
28 .nr rst2man-indent-level -1
29 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
30 .in \\n[rst2man-indent\\n[rst2man-indent-level]]u
32 .\" Man page generated from reStructuredText.
36 \fBllvm\-prof\fP [\fIoptions\fP] [\fIbitcode file\fP] [\fIllvmprof.out\fP]
39 The \fBllvm\-prof\fP tool reads in an \fIllvmprof.out\fP file (which can
40 optionally use a specific file with the third program argument), a bitcode file
41 for the program, and produces a human readable report, suitable for determining
42 where the program hotspots are.
44 This program is often used in conjunction with the \fIutils/profile.pl\fP
45 script. This script automatically instruments a program, runs it with the JIT,
46 then runs \fBllvm\-prof\fP to format a report. To get more information about
47 \fIutils/profile.pl\fP, execute it with the \fB\-help\fP option.
50 \fB\-\-annotated\-llvm\fP or \fB\-A\fP
53 In addition to the normal report printed, print out the code for the
54 program, annotated with execution frequency information. This can be
55 particularly useful when trying to visualize how frequently basic blocks
56 are executed. This is most useful with basic block profiling
57 information or better.
61 \fB\-\-print\-all\-code\fP
64 Using this option enables the \fB\-\-annotated\-llvm\fP option, but it
65 prints the entire module, instead of just the most commonly executed
70 \fB\-\-time\-passes\fP
73 Record the amount of time needed for each pass and print it to standard
79 \fBllvm\-prof\fP returns 1 if it cannot load the bitcode file or the profile
80 information. Otherwise, it exits with zero.
82 Maintained by The LLVM Team (http://llvm.org/).
84 2003-2013, LLVM Project
85 .\" Generated by docutils manpage writer.