Teach kgmon(8) to deal with per-CPU kernel profiling.

ok mikeb@, haesbaert@

1 files changed, 19 insertions, 16 deletions

diff --git a/usr.sbin/kgmon/kgmon.8 b/usr.sbin/kgmon/kgmon.8
index dbbc34faa64..7667c9310c0 100644
--- a/usr.sbin/kgmon/kgmon.8
+++ b/usr.sbin/kgmon/kgmon.8
@@ -1,4 +1,4 @@
-.\" $OpenBSD: kgmon.8,v 1.9 2007/05/31 19:20:25 jmc Exp $
+.\" $OpenBSD: kgmon.8,v 1.10 2013/02/11 17:08:53 mpi Exp $
 .\" Copyright (c) 1983, 1991, 1993
 .\"	The Regents of the University of California.  All rights reserved.
 .\"
@@ -27,9 +27,9 @@
 .\" SUCH DAMAGE.
 .\"
 .\"     from: @(#)kgmon.8	8.1 (Berkeley) 6/6/93
-.\"	$Id: kgmon.8,v 1.9 2007/05/31 19:20:25 jmc Exp $
+.\"	$Id: kgmon.8,v 1.10 2013/02/11 17:08:53 mpi Exp $
 .\"
-.Dd $Mdocdate: May 31 2007 $
+.Dd $Mdocdate: February 11 2013 $
 .Dt KGMON 8
 .Os
 .Sh NAME
@@ -38,6 +38,7 @@
 .Sh SYNOPSIS
 .Nm kgmon
 .Op Fl bhpr
+.Op Fl c Ar cpuid
 .Op Fl M Ar core
 .Op Fl N Ar system
 .Sh DESCRIPTION
@@ -45,7 +46,7 @@
 is a tool used when profiling the operating system.
 When no arguments are supplied,
 .Nm kgmon
-indicates the state of operating system profiling as
+indicates the state of per-CPU operating system profilings as
 .Dq running ,
 .Dq off ,
 or
@@ -56,15 +57,18 @@ If the
 .Fl p
 flag is specified,
 .Nm kgmon
-extracts profile data from the operating system and produces a
-.Pa gmon.out
-file suitable for later analysis by
+extracts profile data from the operating system and produces a file for each
+CPU suitable for later analysis by
 .Xr gprof 1 .
 .Pp
 The options are as follows:
 .Bl -tag -width Ds
 .It Fl b
 Resume the collection of profile data.
+.It Fl c Ar cpuid
+Operate on the CPU specified by 
+.Pa cpuid
+instead of all of them.
 .It Fl h
 Stop the collection of profile data.
 .It Fl M Ar core
@@ -79,15 +83,16 @@ instead of the default
 .Pa /bsd .
 .It Fl p
 Dump the contents of the profile buffers into a
-.Pa gmon.out
-file.
+.Pa gmon-<id>.out
+file where 
+.Dq id
+is the id of the CPU.
 .It Fl r
 Reset all the profile buffers.
 If the
 .Fl p
-flag is also specified, the
-.Pa gmon.out
-file is generated before the buffers are reset.
+flag is also specified, the profile files are generated before the buffers are
+reset.
 .El
 .Pp
 If neither
@@ -113,10 +118,8 @@ Users with only read permission on
 .Pa /dev/kmem
 cannot change the state
 of profiling collection.
-They can get a
-.Pa gmon.out
-file with the warning that the data may be
-inconsistent if profiling is in progress.
+They can get profile files with the warning that the data may be inconsistent
+if profiling is in progress.
 .Sh SEE ALSO
 .Xr gprof 1 ,
 .Xr config 8