2.11BSD#431 - /usr/man/cat8/kgmon.0

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
     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 config-
     ured.  (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
	  specified, 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 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 gmon.out
     file with the warning that the data may be inconsistent if
     profiling is in progress.


Printed 11/26/99	November 17, 1996			1