smonitor man page on HP-UX

Man page or keyword search:  
man Server   10987 pages
apropos Keyword Search (all sections)
Output format
HP-UX logo
[printable version]

smonitor(3C)							  smonitor(3C)

NAME
       smonitor() - prepare execution profile

SYNOPSIS
DESCRIPTION
       is  an  interface to sprofil(2) for collecting sampling information for
       execution profiles.

       To use link in the library by specifying on the linker command line  or
       on the compiler command line.  See gprof(1).

       For any application compiled with the option, the library collects pro‐
       filing sampling information.  But if an application requires finer con‐
       trol  over profiling, the library yields control to an application that
       uses

       To stop the collection of sampling information, use:

       Use gprof(1) to examine the results.

Parameters
       is an array of structures describing the regions to be profiled.	 It is
       defined in header The structure has the following fields:

       The fields are as follows:

	      is the start address of the text segment of the load module.

	      is the end address of the text segment of the load module.

	      is the name of the load module (not the path name).  The name of
	      the load module should be the same as recorded in the executable
	      by

       is the number of elements in the array regions.

       is the starting address a buffer to collect sampling information.

       is the length of is the only memory region used by to collect profiling
       information, so it should be big	 enough	 for  all  specified  regions.
       does  not  initialize  With  more than one call to in the same process,
       dumps the sampling information collected with the last call.  does  not
       discard the information collected in previous calls if it is present in
       the buffer passed to last call of

       is unused and kept for future usage.

       is used to choose 16-bit or 32-bit buckets to collect sampling informa‐
       tion.  If is set to treats the buffer as an array of 16-bit buckets; if
       set to treats the buffer as an  array  of  32-bit  buckets.   For  more
       information refer to sprofil(2).

EXTERNAL INFLUENCES
   Environment Variables
       The  behavior  of  is  controlled  by  the  environment	variable.  See
       gprof(1).  behaves with different settings of as follows:

       does not set up the buffers to collect sampling information.
	      It is expected that will be called  explicitly  to  collect  the
	      sampling	information.   So  it  is  the	ideal case to call the
	      explicitly.

       sets up the sampling buffer for all the load modules and starts
	      to collect the sampling information.  Now if is invoked  explic‐
	      itly,  is	 stopped,  the buffer allocated by is deallocated, and
	      all the sampling information collected prior to calling is lost.
	      uses the buffer passed as an argument and starts again.

       sets up the sampling buffer for the load modules
	      ldm1  and	 ldm2  and starts to collect the sampling information.
	      Now if is invoked explicitly, is stopped, the  buffer  allocated
	      by  is  deallocated,  and all the sampling information collected
	      prior to calling is lost.	 uses the buffer passed as an argument
	      and starts again.

       If is not set, behaves as though

FILES
SEE ALSO
       cc(1), gprof(1), sprofil(2).

								  smonitor(3C)
[top]

List of man pages available for HP-UX

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