[src/trunk]: src/usr.bin/pmc Update.

[maxv <maxv%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/0b222fff1223
branches:  trunk
changeset: 355090:0b222fff1223
user:      maxv <maxv%NetBSD.org@localhost>
date:      Wed Jul 12 17:38:15 2017 +0000

description:
Update.

diffstat:

 usr.bin/pmc/pmc.1 |  33 ++++++++++++++++++++++++---------
 1 files changed, 24 insertions(+), 9 deletions(-)

diffs (88 lines):

diff -r 511c3f170644 -r 0b222fff1223 usr.bin/pmc/pmc.1
--- a/usr.bin/pmc/pmc.1 Wed Jul 12 17:33:29 2017 +0000
+++ b/usr.bin/pmc/pmc.1 Wed Jul 12 17:38:15 2017 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: pmc.1,v 1.11 2017/03/10 15:34:17 wiz Exp $
+.\"    $NetBSD: pmc.1,v 1.12 2017/07/12 17:38:15 maxv Exp $
 .\"
 .\" Copyright (c) 2017 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -58,7 +58,7 @@
 .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
 .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd March 10, 2017
+.Dd July 12, 2017
 .Dt PMC 1
 .Os
 .Sh NAME
@@ -71,7 +71,8 @@
 .Sh DESCRIPTION
 The
 .Nm
-command can be used to control and inspect the state of CPUs in the system.
+tool can be used to control and inspect the state of the
+Performance-Monitoring Counters (PMCs) in the system.
 .Pp
 The first argument,
 .Ar command ,
@@ -97,22 +98,28 @@
 .El
 .Sh EXAMPLES
 The following command prints the available counters.
-.Dl $ pmc list
+.Dl # pmc list
 .Pp
 The following command starts two counters.
 The former will count the 'l2cache-access' events that are triggered from
 userland, the latter will count the 'l1cache-access' events triggered from
 both userland and the kernel.
-.Dl $ pmc start l2cache-access:u l1cache-access:uk
+.Dl # pmc start l2cache-access:u l1cache-access:uk
 .Pp
 Note that the two following commands are not exactly identical.
-.Dl $ pmc start l1cache-access:u l1cache-access:k
-.Dl $ pmc start l1cache-access:uk
+.Dl # pmc start l1cache-access:u l1cache-access:k
+.Dl # pmc start l1cache-access:uk
 The former will start two different counters that have a different source but
 track the same event.
 The latter will start one counter that tracks the event from all sources;
 it therefore does the sum of the two counters from the first command, but
 takes only one counter to do so.
+.El
+.Sh INTERPRETING RESULTS
+For each PMC on each CPU, the value reported by the
+.Nm
+tool is the number of events counted, encoded in a 64bit integer.
+.El
 .Sh DIAGNOSTICS
 .Bl -diag
 .It PMC support not compiled into the kernel
@@ -125,6 +132,13 @@
 .Xr options 4
 for details.
 .El
+.Sh FILES
+.Pa src/sys/arch/x86/x86/pmc.c
+x86 implementation.
+.Pp
+.Pa src/usr.bin/pmc/pmc.c
+pmc tool.
+.El
 .Sh SEE ALSO
 .Xr options 4
 .Sh HISTORY
@@ -132,9 +146,10 @@
 .Nm
 command first appeared in
 .Nx 1.6 .
-It was revamped in 2017.
+It was revamped in
+.Nx 8.0 .
 .Sh BUGS
 The
 .Nm
 command currently only supports performance-monitoring counters
-on the i386 architecture.
+on the i386 and amd64 architectures.