2 .\" Man page generated from reStructuredText.
4 .TH "LLVM-PROFDATA" "1" "2016-03-03" "3.8" "LLVM"
6 llvm-profdata \- Profile data tool
8 .nr rst2man-indent-level 0
12 level \\n[rst2man-indent-level]
13 level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
20 .\" .rstReportMargin pre:
22 . nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
23 . nr rst2man-indent-level +1
24 .\" .rstReportMargin post:
28 .\" indent \\n[an-margin]
29 .\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
30 .nr rst2man-indent-level -1
31 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
32 .in \\n[rst2man-indent\\n[rst2man-indent-level]]u
36 \fBllvm\-profdata\fP \fIcommand\fP [\fIargs...\fP]
39 The \fBllvm\-profdata\fP tool is a small utility for working with profile
51 \fBllvm\-profdata merge\fP [\fIoptions\fP] [\fIfilename...\fP]
54 \fBllvm\-profdata merge\fP takes several profile data files
55 generated by PGO instrumentation and merges them together into a single
56 indexed profile data file.
58 By default profile data is merged without modification. This means that the
59 relative importance of each input file is proportional to the number of samples
60 or counts it contains. In general, the input from a longer training run will be
61 interpreted as relatively more important than a shorter run. Depending on the
62 nature of the training runs it may be useful to adjust the weight given to each
63 input file by using the \fB\-weighted\-input\fP option.
68 Print a summary of command line options.
72 .B \-output=output, \-o=output
73 Specify the output file name. \fIOutput\fP cannot be \fB\-\fP as the resulting
74 indexed profile data can\(aqt be written to standard output.
78 .B \-weighted\-input=weight,filename
79 Specify an input file name along with a weight. The profile counts of the input
80 file will be scaled (multiplied) by the supplied \fBweight\fP, where where \fBweight\fP
81 is a decimal integer >= 1. Input files specified without using this option are
82 assigned a default weight of 1. Examples are shown below.
87 Specify that the input profile is an instrumentation\-based profile.
92 Specify that the input profile is a sample\-based profile.
94 The format of the generated file can be generated in one of three ways:
100 Emit the profile using a binary encoding. For instrumentation\-based profile
101 the output format is the indexed binary format.
107 Emit the profile in text mode. This option can also be used with both
108 sample\-based and instrumentation\-based profile. When this option is used
109 the profile will be dumped in the text format that is parsable by the profile
116 Emit the profile using GCC\(aqs gcov format (Not yet supported).
121 Merge three profiles:
127 llvm\-profdata merge foo.profdata bar.profdata baz.profdata \-output merged.profdata
134 The input file \fIfoo.profdata\fP is especially important, multiply its counts by 10:
140 llvm\-profdata merge \-weighted\-input=10,foo.profdata bar.profdata baz.profdata \-output merged.profdata
146 Exactly equivalent to the previous invocation (explicit form; useful for programmatic invocation):
152 llvm\-profdata merge \-weighted\-input=10,foo.profdata \-weighted\-input=1,bar.profdata \-weighted\-input=1,baz.profdata \-output merged.profdata
160 \fBllvm\-profdata show\fP [\fIoptions\fP] [\fIfilename\fP]
163 \fBllvm\-profdata show\fP takes a profile data file and displays the
164 information about the profile counters for this file and
165 for any of the specified function(s).
167 If \fIfilename\fP is omitted or is \fB\-\fP, then \fBllvm\-profdata show\fP reads its
168 input from standard input.
173 Print details for every function.
178 Print the counter values for the displayed functions.
183 Print details for a function if the function\(aqs name contains the given string.
188 Print a summary of command line options.
192 .B \-output=output, \-o=output
193 Specify the output file name. If \fIoutput\fP is \fB\-\fP or it isn\(aqt specified,
194 then the output is sent to standard output.
199 Specify that the input profile is an instrumentation\-based profile.
204 Instruct the profile dumper to show profile counts in the text format of the
205 instrumentation\-based profile data representation. By default, the profile
206 information is dumped in a more human readable form (also in text) with
212 Specify that the input profile is a sample\-based profile.
216 \fBllvm\-profdata\fP returns 1 if the command is omitted or is invalid,
217 if it cannot read input files, or if there is a mismatch between their data.
219 Maintained by The LLVM Team (http://llvm.org/).
221 2003-2016, LLVM Project
222 .\" Generated by docutils manpage writer.