DOKK / manpages / debian 12 / binutils-x86-64-linux-gnu / x86_64-linux-gnu-gp-collect-app.1.en
GP-COLLECT-APP(1) User Commands GP-COLLECT-APP(1)

gp-collect-app - collect performance data for the target application

gprofng collect app [OPTION(S)] TARGET [TARGET_ARGUMENTS]

Collect performance data on the target program. In addition to Program Counter PC) sampling, hardware event counters and various tracing options are supported.

print the version number and exit.
print usage information and exit.
enable (on) or disable (off) verbose mode; the default is "off".
disable (off) or enable (on) clock-profiling using a default sampling granularity, or enable clock-profiling implicitly by setting the sampling granularity (lo, hi, or a specific value in ms); by default clock profiling is enabled.
enable hardware event counter profiling and select the counter(s); to see the supported counters on this system use the -h option without other arguments.
specify the name for (and path to) the experiment directory; the the default path is the current directory.
the same as -o, but unlike the -o option, silently overwrite an existing experiment directory with the same name.
add up to 10 comment labels to the experiment; comments appear in the notes section of the header.
program is a JVM; optionally set the <path> to a non-default JVM; the default is "-j on".
specify arguments to the JVM.
specify the duration over which to record data; the default unit is seconds (s), but can be set to minutes (m).
dry run; display several run-time settings, but do not run the target, or collect performance data.
specify delayed initialization and a pause/resume signal; by default the target starts in paused mode; if the optional r keyword is provided, start in resumed mode.
control to follow descendant processes; disable (off), enable (on), or collect data on all descendant processes whose name matches the specified regular expression; the default is "-F on".
specify archiving of binaries and other files; in addition to disable this feature (off), or enable archiving off all loadobjects and sources (on), the other options support a more refined selection. All of these options enable archiving, but the keyword controls what exactly is selected: all load objects (ldobjects), all source files (src), the loadobjects asscoiated with a program counter (usedldobjects), or the source files associated with a program counter (usedsrc); the default is "-a ldobjects".
disable (off) or enable (on) periodic sampling of process-wide resource utilization; by default sampling occurs every second; use the <seconds> option to change this; the default is "-S on".
specify a signal that will trigger a sample of process-wide resource utilization.
enable synchronization wait tracing; <option> is used to define the specifics of the tracing (on, off, <threshold>, or all); <API> is used to select the API: "n" selects native/Pthreads, "j" selects Java, and "nj" selects both; the default is "-s off".
disable (off), or enable (on) heap tracing; the default is "-H off".
disable (off), or enable (on) I/O tracing; the default is "-i off".

A getting started guide for gprofng is maintained as a Texinfo manual. If the info and gprofng programs are properly installed at your site, the command "info gprofng" should give you access to this document.

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

Copyright © 2023 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>.
This is free software: you are free to change and redistribute it. There is NO WARRANTY, to the extent permitted by law.

January 2023 GNU gp-collect-app binutils version 2.40.00