unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

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

MONITOR(3)                 Library Functions Manual                 MONITOR(3)



NAME
       monitor - prepare execution profile

SYNOPSIS
       monitor(lowpc, highpc, buffer, bufsize, nfunc)
       int (*lowpc)( ), (*highpc)( );
       short buffer[ ];

DESCRIPTION
       An  executable  program created by `cc -p' automatically includes calls
       for monitor with default parameters; monitor needn't be called  explic-
       itly except to gain fine control over profiling.

       Monitor  is  an  interface  to  profil(2).   Lowpc  and  highpc are the
       addresses of two functions; buffer is the address of a (user  supplied)
       array  of  bufsize  short  integers.  Monitor arranges to record a his-
       togram of periodically sampled values of the program  counter,  and  of
       counts  of  calls  of  certain  functions,  in  the buffer.  The lowest
       address sampled is that of lowpc and the highest is just below  highpc.
       At most nfunc call counts can be kept; only calls of functions compiled
       with the profiling option -p of cc(1) are recorded.  For the results to
       be  significant,  especially  where  there are small, heavily used rou-
       tines, it is suggested that the buffer be no  more  than  a  few  times
       smaller than the range of locations sampled.

       To profile the entire program, it is sufficient to use

            extern etext();
            ...
            monitor((int)2, etext, buf, bufsize, nfunc);

       Etext lies just above all the program text, see end(3).

       To stop execution monitoring and write the results on the file mon.out,
       use

            monitor(0);

       then prof(1) can be used to examine the results.

FILES
       mon.out

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



                                                                    MONITOR(3)