svn commit: r204781 - stable/7/usr.sbin/pmcstat

[Fabien Thomas]

Author: fabient
Date: Fri Mar  5 22:59:49 2010
New Revision: 204781
URL: http://svn.freebsd.org/changeset/base/204781

Log:
  MFC 180091:
  Document messages printed in verbose mode.

Modified:
  stable/7/usr.sbin/pmcstat/pmcstat.8
Directory Properties:
  stable/7/usr.sbin/pmcstat/   (props changed)

Modified: stable/7/usr.sbin/pmcstat/pmcstat.8
==============================================================================
--- stable/7/usr.sbin/pmcstat/pmcstat.8	Fri Mar  5 22:53:31 2010	(r204780)
+++ stable/7/usr.sbin/pmcstat/pmcstat.8	Fri Mar  5 22:59:49 2010	(r204781)
@@ -1,4 +1,4 @@
-.\" Copyright (c) 2003-2007 Joseph Koshy
+.\" Copyright (c) 2003-2008 Joseph Koshy
 .\" Copyright (c) 2007 The FreeBSD Foundation
 .\" All rights reserved.
 .\"
@@ -383,6 +383,40 @@ To print a system-wide profile with call
 use:
 .Dl "pmcstat -R /tmp/sample.out -G foo.graph"
 .Sh DIAGNOSTICS
+If option
+.Fl v
+is specified,
+.Nm
+may issue the following diagnostic messages:
+.Bl -diag -width indent
+.It "#callchain/dubious-frames"
+The number of callchain records that had an
+.Dq impossible
+value for a return address.
+.It "#exec handling errors"
+The number of
+.Xr exec 2
+events in the log file that named executables that could not be
+analyzed.
+.It "#exec/elf"
+The number of
+.Xr exec 2
+events that named ELF executables.
+.It "#exec/unknown"
+The number of
+.Xr exec 2
+events that named executables with unrecognized formats.
+.It "#samples/total"
+The total number of samples in the log file.
+.It "#samples/unclaimed"
+The number of samples that could not be correlated to a known
+executable object (i.e., to an executable, shared library, the
+kernel or the runtime loader).
+.It "#samples/unknown-object"
+The number of samples that were associated with an executable
+with an unrecognized object format.
+.El
+.Pp
 .Ex -std
 .Sh COMPATIBILITY
 Due to the limitations of the