# 2.11BSD#431 - /usr/man/cat1/prof.0

    PROF(1)             UNIX 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 per-
         centage 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, f77 or pc must have been given when the
         file containing the routine 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 sym-
    	  bols.

         -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.

         -v   all printing is suppressed and a graphic version of the
    	  profile is produced on the standard output for display
    	  by the plot(1) filters.  When plotting, the numbers low
    	  and high, by default 0 and 100, may be given to cause a
    	  selected percentage of the profile to be plotted with
    	  accordingly higher resolution.

         -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

    Printed 11/26/99	 April 29, 1985                         1

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

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

    BUGS
         Beware of quantization errors.

         Is confused by f77 which puts the entry points at the bottom
         of subroutines and functions.

    Printed 11/26/99	 April 29, 1985                         2

Generated: 2016-12-26 | Generated by man2html V0.25 page hit count: 339 |