glenda.party
term% ls -F
term% cat index.txt
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 ad‐
       dresses 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 ad‐
       dress 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)