Lines Matching +full:input +full:- +full:only
4 .nr rst2man-indent-level 0
7 \\$1 \\n[an-margin]
8 level \\n[rst2man-indent-level]
9 level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
10 -
11 \\n[rst2man-indent0]
12 \\n[rst2man-indent1]
13 \\n[rst2man-indent2]
18 . nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
19 . nr rst2man-indent-level +1
24 .\" indent \\n[an-margin]
25 .\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
26 .nr rst2man-indent-level -1
27 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
30 .TH "LLVM-PROFDATA" "1" "2023-05-24" "16" "LLVM"
32 llvm-profdata \- Profile data tool
35 \fBllvm\-profdata\fP \fIcommand\fP [\fIargs...\fP]
38 The \fBllvm\-profdata\fP tool is a small utility for working with profile
52 \fBllvm\-profdata merge\fP [\fIoptions\fP] [\fIfilename...\fP]
55 \fBllvm\-profdata merge\fP takes several profile data files
60 relative importance of each input file is proportional to the number of samples
61 or counts it contains. In general, the input from a longer training run will be
64 input file by using the \fB\-weighted\-input\fP option.
66 Profiles passed in via \fB\-weighted\-input\fP, \fB\-input\-files\fP, or via positional
71 .B \-\-help
76 .B \-\-output=<output>, \-o
77 Specify the output file name. \fIOutput\fP cannot be \fB\-\fP as the resulting
82 .B \-\-weighted\-input=<weight,filename>
83 Specify an input file name along with a weight. The profile counts of the
86 Input files specified without using this option are assigned a default
91 .B \-\-input\-files=<path>, \-f
93 file are newline\-separated. Lines starting with \(aq#\(aq are skipped. Entries may
98 .B \-\-remapping\-file=<path>, \-r
99 Specify a file which contains a remapping from symbol names in the input
101 file should consist of lines of the form \fB<input\-symbol> <output\-symbol>\fP\&.
104 The \fI\%llvm\-cxxmap\fP tool can be used to generate the symbol
109 .B \-\-instr (default)
110 Specify that the input profile is an instrumentation\-based profile.
114 .B \-\-sample
115 Specify that the input profile is a sample\-based profile.
120 .B \-\-binary (default)
123 Emit the profile using a binary encoding. For instrumentation\-based profile
127 .B \-\-extbinary
130 Emit the profile using an extensible binary encoding. This option can only
131 be used with sample\-based profile. The extensible binary encoding can be
136 .B \-\-text
140 sample\-based and instrumentation\-based profile. When this option is used
145 .B \-\-gcc
152 .B \-\-sparse[=true|false]
153 Do not emit function records with 0 execution count. Can only be used in
154 conjunction with \-instr. Defaults to false, since it can inhibit compiler
159 .B \-\-num\-threads=<N>, \-j
160 Use N threads to perform profile merging. When N=0, llvm\-profdata auto\-detects
165 .B \-\-failure\-mode=[any|all]
168 only if all profiles are invalid. If \(aqall\(aq is set, information from any
174 .B \-\-prof\-sym\-list=<path>
176 list in the profile. This option can only be used with sample\-based profile
177 in extbinary format. The entries in this file are newline\-separated.
181 .B \-\-compress\-all\-sections=[true|false]
182 Compress all sections when writing the profile. This option can only be used
183 with sample\-based profile in extbinary format.
187 .B \-\-use\-md5=[true|false]
189 This option can only be used with sample\-based profile in extbinary format.
193 .B \-\-gen\-partial\-profile=[true|false]
194 Mark the profile to be a partial profile which only provides partial profile
195 coverage for the optimized target. This option can only be used with
196 sample\-based profile in extbinary format.
200 .B \-\-supplement\-instr\-with\-sample=<file>
202 is the input of the flag. Output will be in instrumentation format (only works
203 with \-instr).
207 .B \-\-zero\-counter\-threshold=<float>
215 .B \-\-instr\-prof\-cold\-threshold=<int>
221 .B \-\-suppl\-min\-size\-threshold=<int>
228 .B \-\-debug\-info=<path>
230 When \fB\-debug\-info\-correlate\fP was used for instrumentation, use this option
242 llvm\-profdata merge foo.profdata bar.profdata baz.profdata \-output merged.profdata
247 .SS Weighted Input
249 The input file \fBfoo.profdata\fP is especially important, multiply its counts by 10:
255 llvm\-profdata merge \-\-weighted\-input=10,foo.profdata bar.profdata baz.profdata \-\-output merge…
267 llvm\-profdata merge \-\-weighted\-input=10,foo.profdata \-\-weighted\-input=1,bar.profdata \-\-wei…
275 \fBllvm\-profdata show\fP [\fIoptions\fP] [\fIfilename\fP]
278 \fBllvm\-profdata show\fP takes a profile data file and displays the
282 If \fIfilename\fP is omitted or is \fB\-\fP, then \fBllvm\-profdata show\fP reads its
283 input from standard input.
287 .B \-\-all\-functions
292 .B \-\-binary\-ids
297 .B \-\-counts
302 .B \-\-show\-format=<text|json|yaml>
307 .B \-\-function=<string>
312 .B \-\-help
317 .B \-\-output=<output>, \-o
318 Specify the output file name. If \fIoutput\fP is \fB\-\fP or it isn\(aqt specified,
323 .B \-\-instr (default)
324 Specify that the input profile is an instrumentation\-based profile.
328 .B \-\-text
330 instrumentation\-based profile data representation. By default, the profile
336 .B \-\-topn=<n>
343 .B \-\-sample
344 Specify that the input profile is a sample\-based profile.
348 .B \-\-memop\-sizes
353 .B \-\-value\-cutoff=<n>
354 Show only those functions whose max count values are greater or equal to \fBn\fP\&.
355 By default, the value\-cutoff is set to 0.
359 .B \-\-list\-below\-cutoff
360 Only output names of functions whose max count value are below the cutoff
365 .B \-\-profile\-version
370 .B \-\-showcs
371 Only show context sensitive profile counts. The default is to filter all
376 .B \-\-show\-prof\-sym\-list=[true|false]
377 Show profile symbol list if it exists in the profile. This option is only
378 meaningful for sample\-based profile in extbinary format.
382 .B \-\-show\-sec\-info\-only=[true|false]
384 only meaningful for sample\-based profile in extbinary format.
388 .B \-\-debug\-info=<path>
390 When \fB\-debug\-info\-correlate\fP was used for instrumentation, use this option
395 .B \-\-covered
396 Show only the functions that have been executed, i.e., functions with non\-zero
402 \fBllvm\-profdata overlap\fP [\fIoptions\fP] [\fIbase profile file\fP] [\fItest profile file\fP]
405 \fBllvm\-profdata overlap\fP takes two profile data files and displays the
415 c2_v_i (i = 1 .. v) are unmatched counters (or counters only existing in)
431 .B \-\-function=<string>
436 .B \-\-help
441 .B \-\-output=<output>, \-o
442 Specify the output file name. If \fIoutput\fP is \fB\-\fP or it isn\(aqt specified,
447 .B \-\-value\-cutoff=<n>
448 Show only those functions whose max count values are greater or equal to \fBn\fP\&.
449 By default, the value\-cutoff is set to max of unsigned long long.
453 .B \-\-cs
454 Only show overlap for the context sensitive profile counts. The default is to show
455 non\-context sensitive profile counts.
459 \fBllvm\-profdata\fP returns 1 if the command is omitted or is invalid,
460 if it cannot read input files, or if there is a mismatch between their data.
464 2003-2023, LLVM Project