Automatically generated by Pod::Man 5.01 (Pod::Simple 3.43)
Standard preamble:
========================================================================
..
.... \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
. ds C` "" . ds C' "" 'br\} . ds C` . ds C' 'br\}
Escape single quotes in literal strings from groff's Unicode transform.
If the F register is >0, we'll generate index entries on stderr for
titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
entries marked with X<> in POD. Of course, you'll have to process the
output yourself in some meaningful fashion.
Avoid warning from groff about undefined register 'F'.
.. .nr rF 0 . if \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . if !\nF==2 \{\ . nr % 0 . nr F 2 . \} . \} .\} .rr rF ========================================================================
Title "GPROFNG.1 1"
way too many mistakes in technical documents.
The driver executes the action specified. An example of an action is \fBcollect to collect performance data. Depending on the action, a \fIqualifier may be needed to further define the command. The last item is the target that the command applies to.
There are three places where options are supported. The driver supports options. These can be found below. The action, possibly in combination with the qualifier also supports options. A description of these can be found in the man page for the command. Any options needed to execute the target command should follow the target name.
For example, to collect performance data for an application called \fBa.out and store the results in experiment directory mydata.er, the following command may be used:
.Vb 1 $ gprofng collect app -o mydata.er a.out -t 2 .Ve
In this example, the action is collect, the qualifier is app, the single argument to the command is \*(C`-o mydata.er\*(C' and the target is \fBa.out. The target command is invoked with the -t 2 option.
If gprofng is executed without any additional option, action, or target, a usage overview is printed.
\fICollect performance data: Item "gprofng collect app" Collect application performance data.
\fIDisplay the performance results: Item "gprofng display text" Display the performance data in ASCII format. Item "gprofng display html" Generate an HTML file from one or more experiments. Item "gprofng display gui" Start the GUI. Note that this tool is not available by default and needs to be installed seperately.
\fIMiscellaneous commands: Item "gprofng display src" Display source or disassembly with compiler annotations. Item "gprofng archive" Include binaries and source code in an experiment directory.
It is also possible to invoke the lower level commands directly, but since these are subject to change, in particular the options, we recommend to use the driver.
Each gprofng command also supports the --help option. This lists the options and a short description for each option.
For example this displays the options supported on the \fBgprofng collect app command:
.Vb 1 $ gprofng collect app --help .Ve
The user guide for gprofng is maintained as a Texinfo manual. If the \fBinfo and gprofng programs are correctly installed, the command info gprofng should give access to this document.
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".