NAME

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

SYNOPSIS

/etc/kgmon [ options ] [ 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). 

OPTIONS

The following options may be specified:

−b Resumes the collection of profile data. 

−h Stops the collection of profile data. 

−p Dumps the contents of the profile buffers into a gmon.out file suitable for later analysis by gprof(1). 

−r Resets 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. 

5 BSD  —  April 27, 1985