NAME

       gprofng-display-gui - Graphical tool to analyze one or more gprofng experiments

SYNOPSIS

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

DESCRIPTION

       The gprofng display gui tool starts the GUI, which is a Java based graphical tool that can be used to
       analyze performance data that has been collected with the gprofng collect app tool.

       Multiple experiments may be specified on the command line.  The data for all these experiments is loaded
       and ready for analysis.

       Once the tool has started, it is also possible to drop or load other experiments.

       By default, if multiple experiments are specified, the data is aggregated across the experiments.

       If the -c option is used, the tool starts in comparison mode.  In this case, the data for the various
       experiments can be compared.  If this option is used, at least two experiments must be specified on the
       command line.

       Alternatively, the tool can be invoked without specifying experiments.  In this case, a target program is
       expected to be specified.  Optionally, there may be options for the target.

       If started this way, a window with user settings will be opened.  These may be used to specify the
       options and other preferences that define the data collection experiment.  The user can then run the
       experiment from this window and upon successful completion, analyze the results.

       If gprofng display gui is invoked without specifying one or more experiments, or a target, a welcome
       screen is shown.  In this screen, the user can specify whether to analyze an existing experiment, or to
       create a new experiment by specifying the data collection settings to define and run a new performance
       experiment.

OPTIONS

       --version
           Print the version number and exit.

       --help
           Print usage information and exit.

       -v, --verbose
           By default, verbose mode is disabled.  This option enables it.

       -j jvmpath, --jdkhome jvmpath
           Specify  the  path to the Java Virtual Machine (JVM) to be used for running gprofng display gui.  The
           default path is taken first by examining environment variables for a path to the JVM,  in  the  order
           JDK_HOME, and then JAVA_PATH.

           If  neither  environment  variable  is  set,  the  version found in the search path set with the PATH
           environment variable is used.  If none is found, /usr/java/bin/java is tried.

       -Jjvm-setting
           Use this option to pass on settings to the JVM.  Multiple -J options and corresponding  settings  may
           be  supplied.   Note  that there is no space between the -J option and the jvm-setting setting to the
           JVM.

       -c base-group compare-group
           By default, the results for multiple experiments are aggregated.  With this option, the GUI starts in
           comparison mode.  If this option is specified, two or more experiments must be provided as arguments.
           The first experiment is the base group.  The results in the other experiment(s) are compared to  this
           reference experiment.

           Note that the user can toggle between aggregation and comparison mode from within the GUI.

       -f size, --fontsize size
           Specify the font size to be used in the GUI.

       -u dir-path, --userdir dir-path
           Specify the path to the user directory in which to store user settings.

NOTES

       The  gprofng  display  gui  tool  relies on other gprofng components.  Therefore, it is necessary to also
       install the other components, either by using one of  the  available  RPM's,  install  from  a  tar  file
       distribution, or to build and install gprofng directly from the source.

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.

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

gprofng-gui-2.2                                    2025-08-19                             GPROFNG-DISPLAY-GUI(1)