GPROFNG-DISPLAY-GUI(1)

💅 GPROFNG-DISPLAY-GUI 💅

okay bestie, pull up a chair, we're talking about gprofng-display-gui — it's a User Command, and it's literally the glow-up your performance data has been waiting for.

---

✨ NAME ✨

gprofng-display-gui — a graphical tool to analyze one or more gprofng experiments 🎀

---

✨ SYNOPSIS ✨

gprofng display gui [option(s)] [[-c] experiment(s) | target [target-options]]

---

✨ DESCRIPTION ✨

So gprofng display gui starts up the GUI — and this GUI is a Java based graphical tool 🦋 that lets you analyze performance data you collected earlier with the gprofng collect app tool. It's giving "you did the work, now let's look at the receipts."

You can put multiple experiments on the command line, no cap. All of that data gets loaded and is just sitting there, ready for analysis. ✨

And once the tool is up? You can also drop or load other experiments. Flexible queen behavior. 👑

By default, if you specified multiple experiments, the data is aggregated across the experiments — like one big group hug of data. 🫶

If you use the -c option, the tool starts in comparison mode instead, where the data for the various experiments can be compared against each other. Heads up though: if you use this option, you must specify at least two experiments on the command line. No solo acts in comparison mode, bestie. 💀

Alternatively — plot twist — you can invoke the tool without specifying experiments at all. In that case, a target program is expected. And optionally, there may be options for the target too.

If you start it that way, a window with user settings opens up. These let you specify the options and other preferences that define the data collection experiment. Then you can run the experiment right from that window, and once it completes successfully, analyze the results. Slay. 💅

And if you invoke gprofng display gui with no experiments and no target? You get a welcome screen. 🌸 From there you can choose whether to analyze an existing experiment, or create a new one by specifying the data collection settings that define and run a brand-new performance experiment. Choose your own adventure, fr fr.

---

✨ OPTIONS ✨

• --version — prints the version number and dips. 👋
• --help — prints usage information and exits.
• -v, --verbose — by default, verbose mode is disabled. This option enables it. Turn the volume UP. 🔊
• -j jvmpath, --jdkhome jvmpath — specify the path to the Java Virtual Machine (JVM) that'll be used for running gprofng display gui. The default path gets figured out in this order: first it examines environment variables for a path to the JVM, checking JDK_HOME, and then JAVA_PATH.

If neither environment variable is set, then the version found in the search path set with the PATH environment variable is used. And if none is found? /usr/java/bin/java gets tried. The backup plan's backup plan. 🙈

• -Jjvm-setting — use this option to pass on settings to the JVM. You can supply multiple -J options with corresponding settings. Important detail: there is no space between the -J option and the jvm-setting setting to the JVM. Not me warning you twice about the space thing. 😭
• -c base-group compare-group — by default, the results for multiple experiments are aggregated. With this option, the GUI starts in comparison mode instead. If this option is specified, two or more experiments must be provided as arguments. The first experiment is the base group — the reference — and the results in the other experiment(s) are compared to it.

Also note: the user can toggle between aggregation and comparison mode from within the GUI. So you're never locked in. ✨

• -f size, --fontsize size — specify the font size to be used in the GUI. Aesthetic matters. 🎀
• -u dir-path, --userdir dir-path — specify the path to the user directory in which to store user settings. Your settings, your house, your rules. 🏠

---

✨ NOTES ✨

The gprofng display gui tool relies on other gprofng components. So it's necessary to also install the other components — either by using one of the available RPM's, installing from a tar file distribution, or building and installing gprofng directly from the source. Can't run the group chat with only one member, bestie. 🫶

---

✨ SEE ALSO ✨

gprofng(1), gp-archive(1), gp-collect-app(1), gp-display-html(1), gp-display-src(1), gp-display-text(1)

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

---

✨ COPYRIGHT ✨

Copyright (c) 2022-2025 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".

---

k that's the whole thing, you're fully caught up bestie 💖 this was gprofng-gui-2.2, dated 2025-08-19, and it's been a whole pleasure. go analyze something iconic. 🌈⭐👑