*** UNIX MANUAL PAGE BROWSER ***

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)