DataMuseum.dk

top - metrics - download

    Length: 1734 (0x6c6)
    Types: TextFile
    Notes: UNIX file
    Names: »prof.1«

└─⟦26887b7e0⟧ Bits:30009717 Comet 32 harddisk image
    └─⟦28c352965⟧ »/a« UNIX Filesystem
        └─⟦this⟧ »usr/man/man1/prof.1« 

TextFile

.ig
	@(#)prof.1	2.1	7/1/84
	@(#)Copyright (C) 1983 by National Semiconductor Corp.
..
.TH PROF 1 
.UC 4
.SH NAME
prof \- display profile data
.SH SYNOPSIS
.B prof
[
.B \-a
] [
.B \-l
] [
.B \-n
] [
.B \-z
] [
.B \-s
] [
.B \-v
[
.BI \- "low\fR [ \fB\-\fIhigh\fR ]"
] ]
[ a.out
[ mon.out ... ] ]
.SH DESCRIPTION
.I Prof
interprets the file
produced by the
.I monitor
subroutine.
Under default modes,
the symbol table in the
named object file
.I (a.out
default)
is read and correlated with the
profile file
.I (mon.out
default).
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.
If more than one profile file is specified,
the output represents the sum of the profiles.
.PP
In order for the number of calls to a routine to be tallied,
the
.B \-p
option of
.I cc
must have been given when the file containing the
routine was compiled.
This option also arranges for the
profile file to be produced automatically.
.PP
Options are:
.TP
.B \-a
all symbols are reported rather than
just external symbols.
.TP
.B \-l
the output is sorted by symbol value.
.TP
.B \-n
the output is sorted by number of calls
.TP
.B \-s
a summary profile file is produced in
.I mon.sum.
This is really only useful
when more than one profile file is specified.
.TP
.B \-z
routines which have zero usage (as indicated by call counts
and accumulated time) are nevertheless printed in the output.
.SH FILES
.ta \w'mon.out  'u
mon.out	for profile
.br
a.out		for namelist
.br
mon.sum	for summary profile
.SH "SEE ALSO"
monitor(3), profil(2), cc(1)
.SH BUGS
Beware of quantization errors.