NAME
kgmon
- generate a dump of the operating system's profile buffers
SYNOPSIS
kgmon
[-bdhpr]
[-M core]
[-N system]
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(1)).
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.
- -d
-
Enable debug output.
- -h
-
Stop the collection of profile data.
- -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
/netbsd
.
- -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
/netbsd
-
the default system
/dev/kmem
-
the default memory
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.
SEE ALSO
config(1),
gprof(1)
HISTORY
The
kgmon
command appeared in
4.2BSD.