V6/usr/man/man1/prof.1

.th PROF I 3/12/73
.sh NAME
prof \*- display profile data
.sh SYNOPSIS
.bd prof
[
.bd \*-v
] [
.bd \*-a
] [
.bd \*-l
] [ file ]
.sh DESCRIPTION
.it Prof
interprets the file
.it mon.out
produced by the
.it monitor
subroutine.
Under default modes,
the symbol table in the
named object file
.it (a.out
default)
is read and correlated with the
.it mon.out
profile file.
For each external symbol, the percentage
of time spent executing between that symbol
and the next
is printed (in decreasing order),
together with the number of times that routine was called
and the number of milliseconds per call.
.s3
If the
.bd \*-a
option is used,
all symbols are reported rather than
just external symbols.
If the
.bd \*-l
option
is used,
the output is listed by
symbol value rather than
decreasing percentage.
If the
.bd \*-v
option is used,
all printing is suppressed
and a profile plot is produced
on the 611 display.
.s3
In order for the number of calls to a routine to be tallied,
the
.bd \*-p
option of
.it cc
must have been given when the file containing the
routine was compiled.
This option also arranges for the
.it mon.out
file to be produced automatically.
.sh FILES
mon.out	for profile
.br
a.out		for namelist
.br
/dev/vt0	for plotting
.sh "SEE ALSO"
monitor (III), profil (II), cc (I)
.sh BUGS
Beware of quantization errors.