Return to kgmon.8 CVS log

Up to [Power 6/32 Unix Tahoe 4.2BSD] / cci / usr / src / man / man8

Annotation of cci/usr/src/man/man8/kgmon.8, revision 1.1.1.1

1.1       root        1: .TH KGMON 8 "18 July 1983"
                      2: .UC 4
                      3: .SH NAME
                      4: kgmon \- generate a dump of the operating system's profile buffers
                      5: .SH SYNOPSIS
                      6: .B /etc/kgmon
                      7: [
                      8: .B \-b
                      9: ] [
                     10: .B \-h
                     11: ] [
                     12: .B \-r
                     13: ] [
                     14: .B \-p
                     15: ] [ system ] [ memory ]
                     16: .SH DESCRIPTION
                     17: .I Kgmon
                     18: is a tool used when profiling the operating system.
                     19: When no arguments are supplied,
                     20: .I kgmon 
                     21: indicates the state of operating system profiling as running,
                     22: off, or not configured.
                     23: (see
                     24: .IR config (8))
                     25: If the
                     26: .B \-p
                     27: flag is specified,
                     28: .I kgmon
                     29: extracts profile data from the operating system and produces a
                     30: .I gmon.out
                     31: file suitable for later analysis by
                     32: .IR gprof (1).
                     33: .PP
                     34: The following options may be specified:
                     35: .TP
                     36: .B \-b
                     37: Resume the collection of profile data.
                     38: .TP
                     39: .B \-h
                     40: Stop the collection of profile data.
                     41: .TP
                     42: .B \-p
                     43: Dump the contents of the profile buffers into a
                     44: .I gmon.out
                     45: file.
                     46: .TP
                     47: .B \-r
                     48: Reset all the profile buffers. 
                     49: If the
                     50: .B \-p
                     51: flag is also specified, the
                     52: .I gmon.out
                     53: file is generated before the buffers are reset.
                     54: .PP
                     55: If neither 
                     56: .B \-b
                     57: nor
                     58: .B \-h
                     59: is specified, the state of profiling collection remains unchanged.
                     60: For example, if the
                     61: .B \-p
                     62: flag is specified and profile data is being collected,
                     63: profiling will be momentarily suspended,
                     64: the operating system profile buffers will be dumped,
                     65: and profiling will be immediately resumed.
                     66: .SH FILES
                     67: /vmunix \- the default system
                     68: .br
                     69: /dev/kmem \- the default memory
                     70: .SH "SEE ALSO"
                     71: gprof(1),
                     72: config(8)
                     73: .SH DIAGNOSTICS
                     74: Users with only read permission on /dev/kmem cannot change the state
                     75: of profiling collection. 
                     76: They can get a 
                     77: .I gmon.out
                     78: file with the warning that the data may be
                     79: inconsistent if profiling is in progress.

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.