SysIII/usr/src/man/man1/profiler.1m

.TH PROFILER 1M
.SH NAME
prfld, prfstat, prfdc, prfsnap, prfpr \- operating system profiler
.SH SYNOPSIS
.B /etc/prfld
[ namelist ]
.br
\fB/etc/prfstat\fP [ \fBon\fP | \fBoff\fP ]
.br
.B /etc/prfdc
[ period [ off_hour ] ]
.br
.B /etc/prfsnap
file
.br
.B /etc/prfpr
file [ cutoff [ namelist ] ]
.SH DESCRIPTION
.IR Prfld ,
.IR prfstat ,
.IR prfdc ,
.IR prfsnap ,
and
.I prfpr\^
form a system of programs
to facilitate an activity study of the
.SM UNIX
operating system.
.PP
.I Prfld\^
is used to initialize the recording
mechanism in the system.
It generates a table
containing the starting address of each
system subroutine as extracted from
.IR namelist .
.PP
.I Prfstat\^
is used to enable or disable the sampling mechanism.
Profiler overhead is less than 1% as calculated
for 500 text addresses.
.I Prfstat\^
will also reveal the number of
text addresses
being measured.
.PP
.I Prfdc\^
and
.I prfsnap\^
perform the data collection function of the profiler
by copying the current value of all the text address counters
to a file where the data can be analyzed.
.I Prfdc\^
will store the counters into
.I file\^
every
.I period\^
minutes and will turn off at
.IR off_hour .
.I Prfsnap\^
collects data at the time of invocation only,
appending the counter values to
.IR file .
.PP
.I Prfpr\^
formats the data collected by
.I prfdc\^
or
.IR prfsnap .
Each text address is converted to the nearest text symbol
(as found in
.IR namelist )
and is printed if the percent activity
for that range is greater than
.IR cutoff .
.SH FILES
/dev/prf	interface to profile data and text addresses
.br
/unix		default for namelist file
.SH "SEE ALSO"
prf(4).