LLVM-CXXFILT(1)

📦
version 13.0.1 · 5 versions
, in ubuntu jammy

LLVM-CXXFILT(1) 💅✨ — the demangler bestie era

Okay so bestie, gather round, because this page is all about llvm-cxxfilt — the LLVM symbol name demangler that's giving main character energy in the demangling department. If you've ever stared at a C++ symbol like _Z3foov and thought "what even is that 😭", this tool is about to be your new obsession. ✨

📛 NAME 📛

llvm-cxxfilt — LLVM symbol name demangler. That's it, that's the whole vibe. It takes the cursed mangled names and makes them make sense. Iconic behavior, no cap. 💅

📜 SYNOPSIS 📜

llvm-cxxfilt [options] [mangled names…]

Short, sweet, and ready to serve. 🫶

🦋 DESCRIPTION 🦋

So here's the tea: llvm-cxxfilt is a symbol demangler that can be used as a replacement for the GNU c++filt tool. It takes a series of symbol names and prints their demangled form on the standard output stream. Slay. 💖 And if a name cannot be demangled? It is simply printed as is. No drama, no error, just vibes. ✨

If no names are specified on the command-line, names are read interactively from the standard input stream. That's right, bestie — it's a whole interactive moment. 🎀 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 _. And the separators between names? Copied to the output as is. Respectful, preserved, periodt. 🔥

🌸 EXAMPLE 🌸

Like, just look at this and tell me it's not iconic:

$ 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 |

The way that it just works 😭💖 not_mangled stays exactly as it was, because it already understood the assignment. No notes. 👑

✨ OPTIONS ✨

  • --format=<value>, -s — Mangling scheme to assume. Valid values are auto (default, auto-detect the style) and gnu (assume GNU/Itanium style). Choose your fighter. 💅
  • --help, -h — Print a summary of command line options. When you need a little recap, bestie. 🎀
  • --no-strip-underscore, -n — Do not strip a leading underscore. This is the default for all platforms except Mach-O based hosts. FYI, iykyk. 🦋
  • --strip-underscore, -_ — Strip a single leading underscore, if present, from each input name before demangling. On by default on Mach-O based platforms. Lowkey important. ✨
  • --types, -t — Attempt to demangle names as type names as well as function names. Because types deserve love too. 💖
  • --version — Display the version of the llvm-cxxfilt executable. Gotta know which era of slay you're running. 🌈
  • @<FILE> — Read command-line options from response file <FILE>. A whole file of options? The convenience is real. 🫶

💀 EXIT STATUS 💀

llvm-cxxfilt returns 0 unless it encounters a usage error, in which case a non-zero exit code is returned. So if you see a non-zero, something went wrong — but like, respectfully. 🙈

🔗 SEE ALSO 🔗

  • llvm-nm(1) — the other tool in the LLVM cinematic universe. Go check it out. 👑

👑 AUTHOR 👑

Maintained by the LLVM Team (https://llvm.org/). Legends, honestly. 💜

2003-2023, LLVM Project. Respect the legacy. 🎀

And that's the whole page, bestie! This iconic manual was brought to you by the LLVM Project, version 13, dated 2023-07-14. Now go demangle something and feel powerful. 💖✨🦋🌸💅🫶😭🔥👑🌈⭐💀🙈🍓🧚💜

📦 where this page comes from