GPROFNG-DISPLAY-GMON(1)

πŸ’– GPROFNG-DISPLAY-GMON β€” bestie's guide to the gmon glow-up πŸ’–

okay so real talk, this is gprofng-display-gmon from the gprofng world, and it does ONE thing and it does it gorgeously: it takes your crusty old gmon profile data and turns it into a shiny, slay-worthy gprofng experiment. glow-up of the century, no cap. ✨


πŸ“œ SYNOPSIS πŸ“œ

gprofng display gmon [option(s)] [target [gmon-file]]

that's it. that's the whole vibe. πŸ’…


πŸ¦‹ DESCRIPTION πŸ¦‹

So here's the tea, bestie. This command reads the gmon.out file and the profiled executable. And the way that it does it is lowkey iconic: with the executable in hand, we can reconstruct information about the profiled symbols and the memory map layout. 🧠✨

Meanwhile, the gmon.out file is out here providing details about the execution duration for each symbol, plus the data used to build the call graph. like, all the receipts. πŸ“Š

And where does this profile data come from, you ask? It's taken from the call graph profile file (gmon.out is the default, btw) which is created by programs that are compiled with profile arches (i.e., the -pg option of "cc"). periodt. πŸ’€

For example β€” and bestie this one is genuinely satisfying β€” this command converts the profile data (gmon.out) for an executable called a.out and stores the data collected in an experiment directory with the name example.er. watch:

$ gprofng display gmon -o example.er ./a.out gmon.out

ate. no crumbs. πŸ”₯


⭐ OPTIONS ⭐

  • --version β€” Print the version number and exit. short king behavior, love that for it. πŸ‘‘
  • --help β€” Print usage information and exit. when you're lost, it's giving supportive bestie. 🫢
  • -o <exp_name> β€” Specify the name for the experiment directory. the name has to end with .er and may contain an absolute path (e.g. /tmp/experiment.er). and bestie listen: an existing experiment with the same name will not be overwritten. it's protective of your data, we respect it. πŸ›‘οΈπŸ’–
  • -O <exp_name> β€” This is the same as the -o option, but unlike this option, silently overwrites an existing experiment directory with the same name. πŸ‘€ so like... it WILL eat your old experiment and not even say sorry. chaos but make it efficient.
⚠️ heads up: -o is the safe one, -O is the bold one. pick your main character energy accordingly. one preserves, one silently overwrites. that word "silently" is doing a LOT of work there, bestie. 😭

🌸 NOTES 🌸

  • Any executable in the ELF (Executable and Linkable Format) object format can be used for profiling with gprofng. so like, if it's ELF, it's invited to the party. 🧚
  • If target is missing, the default executable name is a.out.
  • If gmon-file is missing, the default profile data file name is gmon.out.

🌈 SEE ALSO 🌈

The user guide for gprofng is maintained as a Texinfo manual. If the info and gprofng programs are correctly installed, the command info gprofng should give access to this document. iykyk, the info girlies stay winning. πŸ“–βœ¨


Copyright (c) 2025-2026 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 no Invariant Sections, with no Front-Cover Texts, and with no Back-Cover Texts. A copy of the license is included in the section entitled "GNU Free Documentation License".


okay that's the whole page bestie, go forth and convert your gmon data into an experiment that SERVES πŸ’…πŸ’–

signing off from binutils-2.47, dated 2026-09-10 β€” mwah, stay iconic, and remember: -o not -O unless you're feeling reckless πŸŒΈπŸŽ€πŸ¦‹

πŸ“¦ where this page comes from