monitor man page on Xenix

Man page or keyword search:  
man Server   1130 pages
apropos Keyword Search (all sections)
Output format
Xenix logo
[printable version]



     MONITOR(S)		      XENIX System V		    MONITOR(S)

     Name
	  monitor - Prepares execution profile.

     Syntax
	  void monitor(lowpc,highpc,buffer,bufsize,nfunc)
	  int (*lowpc)( ), (*highpc)( );
	  short *buffer;
	  int bufsize, nfunc;

     Description
	  monitor is an interface to profil(S).	 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 histogram 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(CP)
	  are recorded.	 For the results to be significant, especially
	  where there are small, heavily used routines, 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.

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

	       monitor((int (*)())0);

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

     Files
	  mon.out

     See Also
	  cc(CP), prof(CP), profil(S)

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

     Warning

     Page 1					      (printed 8/7/87)

     MONITOR(S)		      XENIX System V		    MONITOR(S)

	  Profiling gives incorrect results for hybrid model 286
	  programs (i.e.  those with 16 bit text pointers within
	  modules and 32 bit text pointers between modules).

     Page 2					      (printed 8/7/87)

[top]
                             _         _         _ 
                            | |       | |       | |     
                            | |       | |       | |     
                         __ | | __ __ | | __ __ | | __  
                         \ \| |/ / \ \| |/ / \ \| |/ /  
                          \ \ / /   \ \ / /   \ \ / /   
                           \   /     \   /     \   /    
                            \_/       \_/       \_/ 
More information is available in HTML format for server Xenix

List of man pages available for Xenix

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net