2014-07-30 20:30:11 +00:00
|
|
|
llvm-profdata - Profile data tool
|
|
|
|
|
=================================
|
2014-02-17 23:22:49 +00:00
|
|
|
|
|
|
|
|
SYNOPSIS
|
|
|
|
|
--------
|
|
|
|
|
|
2014-07-30 20:30:11 +00:00
|
|
|
:program:`llvm-profdata` *command* [*args...*]
|
2014-02-17 23:22:49 +00:00
|
|
|
|
|
|
|
|
DESCRIPTION
|
|
|
|
|
-----------
|
|
|
|
|
|
2014-07-30 20:30:11 +00:00
|
|
|
The :program:`llvm-profdata` tool is a small utility for working with profile
|
|
|
|
|
data files.
|
2014-02-17 23:22:49 +00:00
|
|
|
|
2014-07-30 20:30:11 +00:00
|
|
|
COMMANDS
|
|
|
|
|
--------
|
|
|
|
|
|
|
|
|
|
* `merge <profdata_merge_>`_
|
|
|
|
|
* `show <profdata_show_>`_
|
|
|
|
|
|
|
|
|
|
.. program:: llvm-profdata merge
|
|
|
|
|
|
|
|
|
|
.. _profdata_merge:
|
|
|
|
|
|
|
|
|
|
MERGE
|
|
|
|
|
-----
|
|
|
|
|
|
|
|
|
|
SYNOPSIS
|
|
|
|
|
^^^^^^^^
|
|
|
|
|
|
|
|
|
|
:program:`llvm-profdata merge` [*options*] [*filenames...*]
|
|
|
|
|
|
|
|
|
|
DESCRIPTION
|
|
|
|
|
^^^^^^^^^^^
|
|
|
|
|
|
|
|
|
|
:program:`llvm-profdata merge` takes several profile data files
|
|
|
|
|
generated by PGO instrumentation and merges them together into a single
|
|
|
|
|
indexed profile data file.
|
2014-02-17 23:22:49 +00:00
|
|
|
|
|
|
|
|
OPTIONS
|
2014-07-30 20:30:11 +00:00
|
|
|
^^^^^^^
|
|
|
|
|
|
|
|
|
|
.. option:: -help
|
|
|
|
|
|
|
|
|
|
Print a summary of command line options.
|
|
|
|
|
|
|
|
|
|
.. option:: -output=output, -o=output
|
|
|
|
|
|
|
|
|
|
Specify the output file name. *Output* cannot be ``-`` as the resulting
|
|
|
|
|
indexed profile data can't be written to standard output.
|
|
|
|
|
|
|
|
|
|
.. program:: llvm-profdata show
|
|
|
|
|
|
|
|
|
|
.. _profdata_show:
|
|
|
|
|
|
|
|
|
|
SHOW
|
|
|
|
|
----
|
|
|
|
|
|
|
|
|
|
SYNOPSIS
|
|
|
|
|
^^^^^^^^
|
|
|
|
|
|
|
|
|
|
:program:`llvm-profdata show` [*options*] [*filename*]
|
|
|
|
|
|
|
|
|
|
DESCRIPTION
|
|
|
|
|
^^^^^^^^^^^
|
|
|
|
|
|
|
|
|
|
:program:`llvm-profdata show` takes a profile data file and displays the
|
|
|
|
|
information about the profile counters for this file and
|
|
|
|
|
for any of the specified function(s).
|
|
|
|
|
|
|
|
|
|
If *filename* is omitted or is ``-``, then **llvm-profdata show** reads its
|
|
|
|
|
input from standard input.
|
|
|
|
|
|
|
|
|
|
OPTIONS
|
|
|
|
|
^^^^^^^
|
|
|
|
|
|
|
|
|
|
.. option:: -all-functions
|
|
|
|
|
|
|
|
|
|
Print details for every function.
|
|
|
|
|
|
|
|
|
|
.. option:: -counts
|
|
|
|
|
|
|
|
|
|
Print the counter values for the displayed functions.
|
|
|
|
|
|
|
|
|
|
.. option:: -function=string
|
|
|
|
|
|
|
|
|
|
Print details for a function if the function's name contains the given string.
|
|
|
|
|
|
|
|
|
|
.. option:: -help
|
|
|
|
|
|
|
|
|
|
Print a summary of command line options.
|
2014-02-17 23:22:49 +00:00
|
|
|
|
2014-07-30 20:30:11 +00:00
|
|
|
.. option:: -output=output, -o=output
|
2014-02-17 23:22:49 +00:00
|
|
|
|
2014-07-30 20:30:11 +00:00
|
|
|
Specify the output file name. If *output* is ``-`` or it isn't specified,
|
|
|
|
|
then the output is sent to standard output.
|
2014-02-17 23:22:49 +00:00
|
|
|
|
|
|
|
|
EXIT STATUS
|
|
|
|
|
-----------
|
|
|
|
|
|
2014-07-30 20:30:11 +00:00
|
|
|
:program:`llvm-profdata` returns 1 if the command is omitted or is invalid,
|
|
|
|
|
if it cannot read input files, or if there is a mismatch between their data.
|
