This manual page is for Mac OS X version 10.6.3

Reading manual pages

MONCONTROL(3)                           BSD Library Functions Manual                           MONCONTROL(3)

NAME
     moncontrol, monstartup -- control execution profile

SYNOPSIS
     moncontrol(int mode);

     monstartup(u_long *lowpc, u_long *highpc);

DESCRIPTION
     An executable program compiled using the -pg option to cc(1) automatically includes calls to collect
     statistics for the gprof(1) call-graph execution profiler.  In typical operation, profiling begins at
     program startup and ends when the program calls exit.  When the program exits, the profiling data are
     written to the file gmon.out, then gprof(1) can be used to examine the results.

     moncontrol() selectively controls profiling within a program.  When the program starts, profiling
     begins.  To stop the collection of histogram ticks and call counts use moncontrol(_); to resume the
     collection of histogram ticks and call counts use moncontrol(1).  This feature allows the cost of par-ticular particular
     ticular operations to be measured.  Note that an output file will be produced on program exit regard-less regardless
     less of the state of moncontrol().

     Programs that are not loaded with -pg may selectively collect profiling statistics by calling
     monstartup() with the range of addresses to be profiled.  lowpc and highpc specify the address range
     that is to be sampled; the lowest address sampled is that of lowpc and the highest is just below
     highpc.  Only functions in that range that have been compiled with the -pg option to cc(1) will appear
     in the call graph part of the output; however, all functions in that address range will have their exe-cution execution
     cution time measured.  Profiling begins on return from monstartup().

FILES
     gmon.out  execution data file

SEE ALSO
     cc(1), gprof(1), profil(2)

4th Berkeley Distribution                       June 4, 1993                       4th Berkeley Distribution