KGMON(8)                                                              KGMON(8)



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

SYNOPSIS
       /etc/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 configured.  (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  speci‐
              fied,  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 pro‐
       file 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.



4.2 Berkeley Distribution       April 27, 1985                        KGMON(8)