NAME
pgprof - execution performance analysis tool incorporating
an easy-to-use graphical interface.
SYNOPSIS
pgprof [options] [datafile]
DESCRIPTION
pgprof is a tool which analyzes data generated during execu-
tion of specially compiled HPF programs (using the
-Mprof=func or -Mprof=lines compiler command line options).
pgprof allows users to discover which functions and lines
were executed as well as how often they were executed and
how much of the total execution time they consumed. pgprof
also allows users to compare execution differences between
processors on systems with multiple processors, and to
analyze communications data. This information can be used
to identify which portions of a program will benefit the
most from performance tuning.
An initialization file named .pgprofrc may be placed in the
current directory. The data in this file will be interpreted
as command line arguments, with any number of arguments per
line. A word beginning with # is a comment and causes the
rest of the line to be ignored. A typical use of this file
would be to specify multiple source directories. The
.pgprofrc file is read after the command line arguments have
been processed. Any arguments provided on the invocation
line will override conflicting arguments found in the
.pgprofrc file.
OPTIONS
datafile A single datafile name may be specified on the
command line. The datafile should be in standard
pgprof.out format, in which case the default exe-
cutable name is stored in the datafile.
-I srcdir Add a directory to the source file search path.
pgprof will always look for a program source file
in the current directory first. Use the -I option
multiple times to append additional directories to
the search path. Directories will be searched in
the order specified. It is acceptable to leave
white space between the -I and the srcdir argu-
ments.
-o prog Use prog as the executable name rather than the
default.
-s Read commands from standard input. On hosts which
support a profiler GUI, this causes pgprof to
operate in a non-graphical mode. This is useful if
input is being redirected from a file or if the
user is remotely logged in to the host system.
USAGE
This section describes the pgprof command set. Arguments
contained in [ and ] are optional. Separating two or more
arguments by | indicates that any one is acceptable.
d[isplay] [display options] | all | none
Specify which information is displayed. This
includes information on minimum values, maximum
values, average values, or per processor data.
[no]func_calls | [no]1
[no]func_mp_calls | [no]2
[no]func_time | [no]3
[no]func_calltime | [no]4
[no]func_cost | [no]5
[no]func_process | [no]6
[no]func_send | [no]7
[no]func_receive | [no]8
[no]line_visits | [no]9
[no]line_mp_visits | [no]10
[no]line_time | [no]11
[no]line_process | [no]12
[no]line_send | [no]13
[no]line_receive | [no]14
h[elp] [command]
Provide brief command synopsis. If the command
argument is present only information for that com-
mand will be displayed. The character "?" may be
used as an alias for help.
h[istory] [ size ]
Display the history list, which stores previous
commands in a manner similar to that available
with csh or dbx . The optional size argument
specifies the number of lines to store in the his-
tory list.
li[nes] function [[>] filename]
Print (display) the line level data together with
the source for the specified function. If the
filename argument is present the output will be
placed in the named file. The '>' means redirect
output, and is optional.
lo[ad] [[ program] datafile]
Load a new dataset. With no arguments reloads the
current dataset. A single argument is interpreted
as a new data file. With two arguments, the first
is interpreted as the program and the second as
the data file.
me[rge] datafile
Merge the profile data from the named datafile
into the current loaded dataset. The datafile
must be in standard pgprof.out format, and must
have been generated by the same executable file as
the original dataset (no datafiles are modified.)
pro[cess] processor_num
Specify the processor number of the data to
display.
pr[int] [[>] filename]
Print (display) the currently selected function
data. If the filename argument is present the out-
put will be placed in the named file. The '>'
means redirect output, and is optional.
q[uit] Exit the profiler.
sel[ect] calls | time/call | time | cost | all [[>] cutoff]
You can choose to display data for a selected sub-
set of the functions. This command allows you to
set the selection key and establish a cutoff per-
centage or value. The cutoff value must be a posi-
tive integer, and for time related fields is
interpreted as a percentage. The '>' means greater
than, and is optional. The default is time > 1%.
sh[ell] arg1, arg2, argn...
For a shell using the given arguments.
so[rt] [by] calls | time/call | time | cost | name
(Profile Mode) Function level data is displayed as
a sorted list. This command establishes the basis
for sorting. The default is time.
src[dir] directory
Add the named directory to the source file search
path. This is useful if you neglected to specify
source directories at invocation.
stat [no]min|[no]avg|[no]max|[no]proc|[no]all]
Set which HPF fields to display or to not display
with the no options.
st[ore] datafile [nolines] [notimes]
Store the loaded dataset into datafile in standard
pgprof.out format. The nolines and notimes options
exclude line level and time related data from
begin stored. The store command is used to save
merge results.
ti[mes] raw | pct
(Profile Mode Only) Specify whether time related
values should be displayed as raw numbers or as
percentages. The default is pct (percentages).
!! repeat previous command.
!! [num ]
repeat previous command numbered num in the his-
tory list.
!! [string ]
repeat previous command containing the string
string from the history list.
SEE ALSO
pghpf, Fortran 77 node compiler documentation. The PGI Pro-
filer User's Guide.