PROF(1)                 GENIX Programmer's Manual                 PROF(1)



      NAME
           prof - display profile data

      SYNOPSIS
           prof [ -a ] [ -l ] [ -n ] [ -z ] [ -s ] [ -v [ -low [ -high ] ] ]  [
           a.out [ mon.out ... ] ]

      DESCRIPTION
           Prof interprets the file produced by the monitor subroutine.   Under
           default  modes,  the  symbol  table  in the named object file (a.out
           default) is read and  correlated  with  the  profile  file  (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.

           In order for the number of calls to a routine to be tallied, the  -p
           option  of cc must have been given when the file containing the rou-
           tine was compiled.  This option also arranges for the  profile  file
           to be produced automatically.

           Options are:

           -a   all symbols are reported rather than just external symbols.

           -l   the output is sorted by symbol value.

           -n   the output is sorted by number of calls

           -s   a summary profile file is produced in mon.sum. This  is  really
                only useful when more than one profile file is specified.

           -z   routines which have zero usage (as indicated by call counts and
                accumulated time) are nevertheless printed in the output.

      FILES
           mon.out  for profile
           a.out    for namelist
           mon.sum  for summary profile

      SEE ALSO
           monitor(3), profil(2), cc(1)

      BUGS
           Beware of quantization errors.









      Printed 11/16/83                                                        1