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.
-Mcore- Extract values associated with the name list from the specified core instead of the default /dev/kmem.
-Nsystem- 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
-pflag 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
HISTORY
The kgmon command appeared in
4.2BSD.