PROF(CP)                 XENIX System V                  PROF(CP)



     Name
          prof - Displays profile data.

     Syntax
          prof [ -a ] [ -l ] [ file ]

     Description
          prof interprets the file mon.out 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 mon.out profile file.  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 the -a option is used, all symbols are reported rather
          than just external symbols.  If the -l option is used, the
          output is listed by symbol value rather than decreasing
          percentage.

          To cause calls to a routine to be tallied, the -p option of
          cc must have been given when the file containing the routine
          was compiled.  This option also arranges for the mon.out
          file to be produced automatically.

     Files
          mon.out  For profile

          a.out    For namelist

     See Also
          monitor(S), profil(S), cc(CP)

     Notes
          Beware of quantization errors.

          If you use an explicit call to monitor(S) you will need to
          make sure that the buffer size is equal to or smaller than
          the program size.

     Warning
          Profiling gives incorrect results for hybrid model 286
          programs (i.e.  those with 16 bit text pointers within
          modules and 32 bit text pointers between modules).










     Page 1                                           (printed 8/7/87)