June 6, 1993 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 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.