Add flag to llvm-profdata to allow symbols in profile data to be remapped, and
add a tool to generate symbol remapping files.
Summary:
The new tool llvm-cxxmap builds a symbol mapping table from a file containing
a description of partial equivalences to apply to mangled names and files
containing old and new symbol tables.
Reviewers: davidxl
Subscribers: mgorny, llvm-commits
Differential Revision: https://reviews.llvm.org/D51470
llvm-svn: 342168
diff --git a/llvm/docs/CommandGuide/llvm-profdata.rst b/llvm/docs/CommandGuide/llvm-profdata.rst
index 5b6330b..96c91e3 100644
--- a/llvm/docs/CommandGuide/llvm-profdata.rst
+++ b/llvm/docs/CommandGuide/llvm-profdata.rst
@@ -74,6 +74,16 @@
file are newline-separated. Lines starting with '#' are skipped. Entries may
be of the form <filename> or <weight>,<filename>.
+.. option:: -remapping-file=path, -r=path
+
+ Specify a file which contains a remapping from symbol names in the input
+ profile to the symbol names that should be used in the output profile. The
+ file should consist of lines of the form ``<input-symbol> <output-symbol>``.
+ Blank lines and lines starting with ``#`` are skipped.
+
+ The :doc:`llvm-cxxmap <llvm-cxxmap>` tool can be used to generate the symbol
+ remapping file.
+
.. option:: -instr (default)
Specify that the input profile is an instrumentation-based profile.