*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->OpenBSD man pages -> monstartup (3)              



NAME    [Toc]    [Back]

     moncontrol, monstartup - control execution profile

SYNOPSIS    [Toc]    [Back]

     moncontrol(int mode);

     monstartup(u_long *lowpc, u_long *highpc);

DESCRIPTION    [Toc]    [Back]

     An executable program compiled using the -pg option to cc(1)
  includes  calls  to  collect statistics for the gprof(1)
call-graph execution
 profiler.  In typical operation, profiling begins  at
     startup and ends when the program calls exit.  When the program exits,
     the profiling data are written to the  file  gmon.out,  then
gprof(1) can be
     used to examine the results.

     moncontrol()  selectively  controls  profiling within a program.  When the
     program starts, profiling begins.  To stop the collection of
     ticks  and call counts use moncontrol(0); to resume the collection of histogram
 ticks and call counts use moncontrol(1).   This  feature allows the
     cost  of particular operations to be measured.  Note that an
output file
     will be produced on program exit regardless of the state  of

     Programs  that  are not loaded with -pg may selectively collect profiling
     statistics by calling monstartup() with  the  range  of  addresses to be profiled.
   lowpc  and highpc specify the address range that is
to be sampled;
     the lowest address sampled is that of lowpc and the  highest
is just below
     highpc.   Only  functions  in that range that have been compiled with the
     -pg option to cc(1) will appear in the call  graph  part  of
the output;
     however, all functions in that address range will have their
     time   measured.    Profiling   begins   on   return    from

FILES    [Toc]    [Back]

     gmon.out  execution data file

SEE ALSO    [Toc]    [Back]

     cc(1), gprof(1), profil(2)

OpenBSD      3.6                           June      4,      1993
[ Back ]
 Similar pages
Name OS Title
monstartup Tru64 Prepare execution profile
monitor_signal Tru64 Prepare execution profile
profil IRIX execution time profile
monitor Tru64 Prepare execution profile
moncontrol Tru64 Prepare execution profile
monitor IRIX prepare execution profile
profil Linux execution time profile
profil HP-UX execution time profile
sprofil IRIX execution time profile for disjoint text spaces
sprofil HP-UX execution time profile for disjointed text spaces
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service