llvm.org GIT mirror llvm / release_80 docs / CommandGuide / llvm-cxxmap.rst
release_80

Tree @release_80 (Download .tar.gz)

llvm-cxxmap.rst @release_80view markup · raw · history · blame

llvm-cxxmap - Mangled name remapping tool

SYNOPSIS

:program:`llvm-cxxmap` [options] symbol-file-1 symbol-file-2

DESCRIPTION

The :program:`llvm-cxxmap` tool performs fuzzy matching of C++ mangled names, based on a file describing name components that should be considered equivalent.

The symbol files should contain a list of C++ mangled names (one per line). Blank lines and lines starting with # are ignored. The output is a list of pairs of equivalent symbols, one per line, of the form

where <symbol-1> is a symbol from symbol-file-1 and <symbol-2> is a symbol from symbol-file-2. Mappings for which the two symbols are identical are omitted.

OPTIONS

REMAPPING FILE

The remapping file is a text file containing lines of the form

where fragmentkind is one of name, type, or encoding, indicating whether the following mangled name fragments are <name>s, <type>s, or <encoding>s, respectively. Blank lines and lines starting with # are ignored.

For convenience, built-in <substitution>s such as St and Ss are accepted as <name>s (even though they technically are not <name>s).

For example, to specify that absl::string_view and std::string_view should be treated as equivalent, the following remapping file could be used:

Note

Symbol remapping is currently only supported for C++ mangled names following the Itanium C++ ABI mangling scheme. This covers all C++ targets supported by Clang other than Windows targets.