PROF(I)                      3/12/73                      PROF(I)







NAME

     prof - display profile data



SYNOPSIS

     prof [ -v ] [ -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.   If  the  -v  option  is  used, all printing is

     suppressed and  a  profile  plot  is  produced  on  the  611

     display.



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

     /dev/vt0        for plotting



SEE ALSO

     monitor (III), profil (II), cc (I)



BUGS

     Beware of quantization errors.