diff options
Diffstat (limited to 'usr.bin/clang/llvm-profdata/llvm-profdata.1')
-rw-r--r-- | usr.bin/clang/llvm-profdata/llvm-profdata.1 | 48 |
1 files changed, 42 insertions, 6 deletions
diff --git a/usr.bin/clang/llvm-profdata/llvm-profdata.1 b/usr.bin/clang/llvm-profdata/llvm-profdata.1 index 18c26fc..f764541 100644 --- a/usr.bin/clang/llvm-profdata/llvm-profdata.1 +++ b/usr.bin/clang/llvm-profdata/llvm-profdata.1 @@ -1,7 +1,7 @@ .\" $FreeBSD$ .\" Man page generated from reStructuredText. . -.TH "LLVM-PROFDATA" "1" "2016-03-03" "3.8" "LLVM" +.TH "LLVM-PROFDATA" "1" "2017-12-24" "6" "LLVM" .SH NAME llvm-profdata \- Profile data tool . @@ -61,6 +61,9 @@ or counts it contains. In general, the input from a longer training run will be interpreted as relatively more important than a shorter run. Depending on the nature of the training runs it may be useful to adjust the weight given to each input file by using the \fB\-weighted\-input\fP option. +.sp +Profiles passed in via \fB\-weighted\-input\fP, \fB\-input\-files\fP, or via positional +arguments are processed once for each time they are seen. .SS OPTIONS .INDENT 0.0 .TP @@ -76,10 +79,18 @@ indexed profile data can\(aqt be written to standard output. .INDENT 0.0 .TP .B \-weighted\-input=weight,filename -Specify an input file name along with a weight. The profile counts of the input -file will be scaled (multiplied) by the supplied \fBweight\fP, where where \fBweight\fP -is a decimal integer >= 1. Input files specified without using this option are -assigned a default weight of 1. Examples are shown below. +Specify an input file name along with a weight. The profile counts of the +supplied \fBfilename\fP will be scaled (multiplied) by the supplied +\fBweight\fP, where where \fBweight\fP is a decimal integer >= 1. +Input files specified without using this option are assigned a default +weight of 1. Examples are shown below. +.UNINDENT +.INDENT 0.0 +.TP +.B \-input\-files=path, \-f=path +Specify a file which contains a list of files to merge. The entries in this +file are newline\-separated. Lines starting with \(aq#\(aq are skipped. Entries may +be of the form <filename> or <weight>,<filename>. .UNINDENT .INDENT 0.0 .TP @@ -115,6 +126,19 @@ reader. .sp Emit the profile using GCC\(aqs gcov format (Not yet supported). .UNINDENT +.INDENT 0.0 +.TP +.B \-sparse[=true|false] +Do not emit function records with 0 execution count. Can only be used in +conjunction with \-instr. Defaults to false, since it can inhibit compiler +optimization during PGO. +.UNINDENT +.INDENT 0.0 +.TP +.B \-num\-threads=N, \-j=N +Use N threads to perform profile merging. When N=0, llvm\-profdata auto\-detects +an appropriate number of threads to use. This is the default. +.UNINDENT .SS EXAMPLES .SS Basic Usage .sp @@ -208,9 +232,21 @@ annotations. .UNINDENT .INDENT 0.0 .TP +.B \-topn=n +Instruct the profile dumper to show the top \fBn\fP functions with the +hottest basic blocks in the summary section. By default, the topn functions +are not dumped. +.UNINDENT +.INDENT 0.0 +.TP .B \-sample Specify that the input profile is a sample\-based profile. .UNINDENT +.INDENT 0.0 +.TP +.B \-memop\-sizes +Show the profiled sizes of the memory intrinsic calls for shown functions. +.UNINDENT .SH EXIT STATUS .sp \fBllvm\-profdata\fP returns 1 if the command is omitted or is invalid, @@ -218,6 +254,6 @@ if it cannot read input files, or if there is a mismatch between their data. .SH AUTHOR Maintained by The LLVM Team (http://llvm.org/). .SH COPYRIGHT -2003-2016, LLVM Project +2003-2017, LLVM Project .\" Generated by docutils manpage writer. . |