LTO-DUMP(1)

💅 lto-dump — the GNU manual page, section 1, bestie edition

okay so picture this: you're deep in GCC land, and you've got these link time optimization object files just sitting there, being all mysterious and unreadable. and you're like "girl. what is IN you." 🦋

that's literally what lto-dump is for. it's the tool you pair up with GCC to dump LTO object files. that's the whole vibe. it's giving x-ray vision for your build artifacts, no cap.

---

✨ SYNOPSIS ✨

lto-dump [-list]
     [-demangle]
     [-defined-only]
     [-print-value]
     [-name-sort]
     [-size-sort]
     [-reverse-sort]
     [-no-sort]
     [-symbol=]
     [-objects]
     [-type-stats]
     [-tree-stats]
     [-gimple-stats]
     [-dump-level=]
     [-dump-body=]
     [-help] lto-dump

yes bestie, that last lto-dump is just chillin' there at the end of the synopsis. iconic behaviour honestly. we don't question it. 💀

---

🌸 DESCRIPTION 🌸

so. lto-dump is a tool you can use in conjunction with GCC to dump link time optimization object files. that's it, that's the whole job, and it does it beautifully. 🎀

---

👑 OPTIONS 👑

okay this is the main character section, let's go one by one, no skipping, we are NOT doing that today 💖

• -list — dumps you a whole list of details about functions and variables. the whole roster. everybody gets named.
• -demangle — dumps the demangled output. because mangled names are giving cryptic and we're not about that life.
• -defined-only — dumps only the defined symbols. if it's not defined, it's not invited to the party. 🙈
• -print-value — dumps the initial values of the variables. sneak peek at where they start.
• -name-sort — sorts the symbols alphabetically. a-z, tidy, organized, the way a real one does it. ✨
• -size-sort — sorts the symbols according to size. big ones, little ones, all ranked.
• -reverse-sort — dumps the symbols in reverse order. flipping the whole thing around, backwards queen. 💅
• -no-sort — dumps the symbols in order of occurrence. no sorting, just raw arrival order, keeping it real.
• -symbol= — dumps the details of a specific symbol. just the one. the chosen one. ⭐
• -objects — dumps the details of LTO objects. object file lore unlocked.
• -type-stats — dumps the statistics of tree types. numbers! about types! in trees!
• -tree-stats — dumps the statistics of trees. yes, more trees. we love a theme. 🌈
• -gimple-stats — dumps the statistics of gimple statements. gimple stans rise up.
• -dump-level= — for deciding the optimization level of body. (that's the official wording and we are keeping it, fr fr)
• -dump-body= — dumps the specific gimple body. one body, hand-picked, on display. 🫶
• -help — displays the dump tool help. when in doubt, ask the tool itself. it knows.

---

💜 COPYRIGHT 💜

okay legal era, but make it cute because the law is the law and we respect it:

Copyright (c) 2017-2022 Free Software Foundation, Inc.

Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.3 or any later version published by the Free Software Foundation; with the Invariant Sections being "GNU General Public License" and "Funding Free Software", the Front-Cover texts being (a) (see below), and with the Back-Cover Texts being (b) (see below). A copy of the license is included in the gfdl(7) man page.

(a) The FSF's Front-Cover Text is:

A GNU Manual

(b) The FSF's Back-Cover Text is:

You have freedom to copy and modify this GNU Manual, like GNU
software.  Copies published by the Free Software Foundation raise
funds for GNU development.

---

and that's the page bestie!! this whole thing is from gcc-12, dated 2022-03-19, and it's the lto-dump manual page, section 1. go forth and dump your LTO objects, you absolute icon. mwah. 😭💖