profiler(1M)                     DG/UX 5.4.2                    profiler(1M)


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

SYNOPSIS
       /usr/sbin/prfld [-f device_name] [ namelist ]
       /usr/sbin/prfstat on
       /usr/sbin/prfstat [-f device_name] off
       /usr/sbin/prfdc [-f device_name] file [ period [ off_hour ] ]
       /usr/sbin/prfsnap [-f device_name] file
       /usr/sbin/prfpr file [ cutoff [ namelist ] ]

DESCRIPTION
       Prfld, prfstat, prfdc, prfsnap, and prfpr form a system of programs
       to study activity on a DG/UX 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 namelist.

       Prfstat is used to enable or disable the sampling mechanism.  Prfstat
       also reveals the number of text addresses being measured.

       Prfdc and prfsnap collect data by copying the current value of all
       the text address counters to a file for analysis.  Prfdc stores the
       counters into file every period minutes and turns 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 percentage activity for that range is
       greater than cutoff.

       These commands accept the following option:

       -f device_name
              This option allows profiling on a specific CPU rather than on
              all CPUs at once.  Device_names indicate the processor as
              defined in the /dev directory.  Valid device_names are of the
              form /dev/prf0, /dev/prf1...to /dev/prfn.  To perform
              profiling on all processors specify /dev/prf, without a
              processor number.

FILES
       /dev/prf*  Interface(s) to profile data and text addresses
       /dgux      Default for namelist file

SEE ALSO
       prf(7).








Licensed material--property of copyright holder(s)                         1