unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (SunOS-4.1.3)
Page:
Section:
Apropos / Subsearch:
optional field

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



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

SYNOPSIS
       /usr/etc/kgmon [ -bhpr ] [ filesystem ] [ 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).

OPTIONS
       -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  speci-
              fied,  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 pro-
       file data is being collected, profiling is momentarily  suspended,  the
       operating  system  profile buffers are dumped, and profiling is immedi-
       ately resumed.

FILES
       /vmunix             the default system
       /dev/kmem           the default memory
       gmon.out

SEE ALSO
       gprof(1), config(8)

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.



                               9 September 1987                       KGMON(8)