prof(XNX)                      6 January 1993                      prof(XNX)


 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 sym-
    bol and the next is printed (in decreasing order), together with the num-
    ber 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 sym-
    bol 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


 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 (for
    example those with 16 bit text pointers within modules and 32 bit text
    pointers between modules).

 See also

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

 Standards conformance

    prof is conformant with:
    AT&T SVID Issue 2;
    and X/Open Portability Guide, Issue 3, 1989.