Index: llvm/trunk/docs/CommandGuide/llvm-cxxfilt.md =================================================================== --- llvm/trunk/docs/CommandGuide/llvm-cxxfilt.md +++ llvm/trunk/docs/CommandGuide/llvm-cxxfilt.md @@ -1,10 +0,0 @@ -# llvm-cxxfilt - a symbol demangler - -## SYNOPSIS - -**llvm-cxxfilt** [*options*] - -## DESCRIPTION - -**llvm-cxxfilt** is symbol demangler that can be used as a replacement for the -GNU **c++filt** tool. Index: llvm/trunk/docs/CommandGuide/llvm-cxxfilt.rst =================================================================== --- llvm/trunk/docs/CommandGuide/llvm-cxxfilt.rst +++ llvm/trunk/docs/CommandGuide/llvm-cxxfilt.rst @@ -0,0 +1,79 @@ +llvm-cxxfilt - LLVM symbol name demangler +========================================= + +SYNOPSIS +-------- + +:program:`llvm-cxxfilt` [*options*] [*mangled names...*] + +DESCRIPTION +----------- + +:program:`llvm-cxxfilt` is a symbol demangler that can be used as a replacement +for the GNU :program:`c++filt` tool. It takes a series of symbol names and +prints their demangled form on the standard output stream. If a name cannot be +demangled, it is simply printed as is. + +If no names are specified on the command-line, names are read interactively from +the standard input stream. When reading names from standard input, each input +line is split on characters that are not part of valid Itanium name manglings, +i.e. characters that are not alphanumeric, '.', '$', or '_'. Separators between +names are copied to the output as is. + +EXAMPLE +------- + +.. code-block:: console + + $ llvm-cxxfilt _Z3foov _Z3bari not_mangled + foo() + bar(int) + not_mangled + $ cat input.txt + | _Z3foov *** _Z3bari *** not_mangled | + $ llvm-cxxfilt < input.txt + | foo() *** bar(int) *** not_mangled | + +OPTIONS +------- + +.. option:: --format=, -s + + Mangling scheme to assume. Valid values are ``auto`` (default, auto-detect the + style) and ``gnu`` (assume GNU/Itanium style). + +.. option:: --help, -h + + Print a summary of command line options. + +.. option:: --help-list + + Print an uncategorized summary of command line options. + +.. option:: --strip-underscore, -_ + + Discard a single leading underscore, if present, from each input name before + demangling. + +.. option:: --types, -t + + Attempt to demangle names as type names as well as function names. + +.. option:: --version + + Display the version of this program. + +.. option:: @ + + Read command-line options from response file ``. + +EXIT STATUS +----------- + +:program:`llvm-cxxfilt` returns 0 unless it encounters a usage error, in which +case a non-zero exit code is returned. + +SEE ALSO +-------- + +:manpage:`llvm-nm(1)`