KGMON(8) BSD System Manager's Manual KGMON(8)NAMEkgmon - generate a dump of the operating system's profile buffers
SYNOPSISkgmon [-bhpr] [-M -core] [-N -system]
DESCRIPTION
Kgmon is a tool used when profiling the operating system. When no argu-
ments are supplied, kgmon indicates the state of operating system profil-
ing 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 options are as follows:
-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.
-M Extract values associated with the name list from the specified
core instead of the default ``/dev/kmem''.
-N Extract the name list from the specified system instead of the
default ``/bsd''.
If neither -b nor -h is specified, the state of profiling collection re-
mains unchanged. For example, if the -p flag is specified and profile
data is being collected, profiling will be momentarily suspended, the op-
erating system profile buffers will be dumped, and profiling will be im-
mediately resumed.
FILES
/bsd the default system
/dev/kmem the default memory
SEE ALSOgprof(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.
HISTORY
The kgmon command appeared in 4.2BSD.
4.2 Berkeley Distribution June 6, 1993 1
