llvm-profdata - Profile data tool#

SYNOPSIS#

llvm-profdata command [args…]

DESCRIPTION#

The llvm-profdata tool is a small utility for working with profile data files.

COMMANDS#

MERGE#

SYNOPSIS#

llvm-profdata merge [options] [filename…]

DESCRIPTION#

llvm-profdata merge takes several profile data files generated by PGO instrumentation and merges them together into a single indexed profile data file.

By default profile data is merged without modification. This means that the relative importance of each input file is proportional to the number of samples 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 -weighted-input option.

Profiles passed in via -weighted-input, -input-files, or via positional arguments are processed once for each time they are seen.

OPTIONS#

--help#

Print a summary of command line options.

--output=<output>, -o#

Specify the output file name. Output cannot be - as the resulting indexed profile data can’t be written to standard output.

--weighted-input=<weight,filename>#

Specify an input file name along with a weight. The profile counts of the supplied filename will be scaled (multiplied) by the supplied weight, where weight is a decimal integer >= 1. Input files specified without using this option are assigned a default weight of 1. Examples are shown below.

--input-files=<path>, -f#

Specify a file which contains a list of files to merge. The entries in this file are newline-separated. Lines starting with ‘#’ are skipped. Entries may be of the form <filename> or <weight>,<filename>.