profiler(1M)                                         profiler(1M)



NAME
     prfld, prfstat, prfdc, prfsnap, prfpr - operating system
     profiler

SYNOPSIS
     /etc/prfld [ namelist ]
     /etc/prfstat on
     /etc/prfstat off
     /etc/prfdc file [ period [ off_hour ] ]
     /etc/prfsnap file
     /etc/prfpr file [ cutoff [ namelist ] ]

DESCRIPTION
     Prfld, prfstat, prfdc, prfsnap, and prfpr form a system of
     programs to facilitate an activity study of the UNIX operat-
     ing 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 namel-
     ist.

     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 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 namelist file

SEE ALSO
     prf(7).









Page 1                            CX/UX Administrator's Reference