KGMON

Section: Maintenance Commands (8)
Updated: April 27, 1985
Index Return to Main Contents

NAME

kgmon - generate a dump of the operating system's profile buffers

SYNOPSIS

/usr/etc/kgmon [ -b ] [ -h ] [ -r ] [ -p ] [ system ] [ memory ]

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(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 following options may be specified:

-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.

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

/mach - 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.

This document was created by man2html, using the manual pages.
Time: 00:58:19 GMT, September 26, 2024