unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (v7man)
Page:
Section:
Apropos / Subsearch:
optional field

PROF(1)                     General Commands Manual                    PROF(1)



NAME
       prof - display profile data

SYNOPSIS
       prof [ -v ] [ -a ] [ -l ] [ -low [ -high ] ] [ 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 mil-
       liseconds 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 graphic ver-
       sion of the profile is produced on the standard output for  display  by
       the  plot(1)  filters.  The numbers low and high, by default 0 and 100,
       cause a selected percentage of the profile to be plotted  with  accord-
       ingly higher resolution.

       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

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

BUGS
       Beware of quantization errors.



                                                                       PROF(1)