KGMON(8)	    UNIX Programmer's Manual		 KGMON(8)



NAME
     kgmon - generate a dump of the operating system's profile
     buffers

SYNOPSIS
     /usr/sbin/kgmon [ -b ] [ -h ] [ -r ] [ -p ] [ system ] [
     memory ]

DESCRIPTION
     _K_g_m_o_n is a tool used when profiling the operating system.
     When no arguments are supplied, _k_g_m_o_n indicates the state of
     operating system profiling as running, off, or not config-
     ured.  (see _c_o_n_f_i_g(8)) If the -p flag is specified, _k_g_m_o_n
     extracts profile data from the operating system and produces
     a _g_m_o_n._o_u_t file suitable for later analysis by _g_p_r_o_f(1).

     The following options may be specified:

     -b   Resume the collection of profile data.

     -h   Stop the collection of profile data.

     -p   Dump the contents of the profile buffers into a
	  _g_m_o_n._o_u_t file.

     -r   Reset all the profile buffers. If the -p flag is also
	  specified, the _g_m_o_n._o_u_t file is generated before the
	  buffers are reset.

     If neither -b nor -h is specified, the state of profiling
     collection remains unchanged.  For example, if the -p flag
     is specified and profile data is being collected, profiling
     will be momentarily suspended, the operating system profile
     buffers will be dumped, and profiling will be immediately
     resumed.

FILES
     /vmunix - the default system
     /dev/kmem - the default memory

SEE ALSO
     gprof(1), config(8)

DIAGNOSTICS
     Users with only read permission on /dev/kmem cannot change
     the state of profiling collection. They can get a _g_m_o_n._o_u_t
     file with the warning that the data may be inconsistent if
     profiling is in progress.







Printed 11/26/99	November 17, 1996			1