4.3BSD - /usr/man/cat8/kgmon.0

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
       Kgmon  is  a  tool  used  when profiling the operating system.  When no
       arguments are supplied, kgmon indicates the state of  operating  system
       profiling  as  running, off, or not configured.  (see config(8)) If the
       -p flag is specified, kgmon extracts profile data  from  the  operating
       system  and  produces  a  gmon.out  file suitable for later analysis by
       gprof(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 gmon.out file.

       -r     Reset all the profile buffers.  If the -p flag  is  also  speci‐
              fied,  the  gmon.out  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 gmon.out file with the warning
       that the data may be inconsistent if profiling is in progress.


4.2 Berkeley Distribution       April 27, 1985                        KGMON(8)