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
core
- Extract values associated with the name list from the
specified core instead of the default
/dev/kmem.
-
-
- -N
system
- 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.