LTO-DUMP(1)

📦
version 12-20220319 · 4 versions
, in ubuntu jammy

💅 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.

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. 😭💖

📦 where this page comes from