PROFILER(1M) RISC/os Reference Manual PROFILER(1M)
NAME
profiler: prfld, prfstat, prfdc, prfsnap, prfpr - UNIX sys-
tem profiler
SYNOPSIS
/etc/prfld [ -U ] [ -T ] [ system_namelist ]
/etc/prfstat on
/etc/prfstat off
/etc/prfdc file [ period [ off_hour ] ]
/etc/prfsnap file
/etc/prfpr file [ cutoff [ system_namelist ] ]
DESCRIPTION
prfld, prfstat, prfdc, prfsnap, and prfpr form a system of
programs to facilitate an activity study of the RISC/os
operating system.
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
system_namelist. If the -U option is set, only the first
symbol for a given address will be entered in the table,
thereby reducing the number of table entries. If the -T
option is set, any symbols which do not fit in the available
table space (currently 2048 entries) will be ignored. This
allows prfld to be used even if the system has more system
subroutines than there are table entries.
prfstat is used to enable or disable the sampling mechanism.
Profiler overhead is less than 1% as calculated for 500 text
addresses. prfstat will also reveal the number of text
addresses being measured.
prfdc and 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.
prfdc will store the counters into file every period minutes
and will turn off at off_hour (valid values for off_hour are
0 - 24). prfsnap collects data at the time of invocation
only, appending the counter values to file.
prfpr formats the data collected by prfdc or prfsnap. Each
text address is converted to the nearest text symbol (as
found in system_namelist) and is printed if the percent
activity for that range is greater than cutoff.
FILES
/dev/prf interface to profile data and text addresses
/unix default for system namelist file
Printed 11/19/92 Page 1