kgmon(8) - NetBSD Manual Pages

KGMON(8)                NetBSD System Manager's Manual                KGMON(8)


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 argu- ments are supplied, kgmon indicates the state of operating system profil- ing 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. NetBSD 9.4_STABLE June 6, 1993 NetBSD 9.4_STABLE

Powered by man-cgi (2024-08-26). Maintained for NetBSD by Kimmo Suominen. Based on man-cgi by Panagiotis Christias.