diff options
author | gonzo <gonzo@FreeBSD.org> | 2012-03-25 02:22:32 +0000 |
---|---|---|
committer | gonzo <gonzo@FreeBSD.org> | 2012-03-25 02:22:32 +0000 |
commit | 4dabba6aea432d6bf5e1baf9e344fc143410af0d (patch) | |
tree | 04a6acc24a35a437e3b3410e760525a1703417d8 /lib | |
parent | ea8ccc536c95fec2efc90df6963a51d41ffac77b (diff) | |
download | FreeBSD-src-4dabba6aea432d6bf5e1baf9e344fc143410af0d.zip FreeBSD-src-4dabba6aea432d6bf5e1baf9e344fc143410af0d.tar.gz |
Update manual pages for MIPS-related CPUs:
- Rename pmc.mips to pmc.mips24k since it covers just one CPU,
no whole architecture
- Add documetnations for Octeon's PMC counters
- Remove CAVEATS section from pmc.mips24k page: PMC for MIPS supports
sampling now.
Diffstat (limited to 'lib')
-rw-r--r-- | lib/libpmc/Makefile | 3 | ||||
-rw-r--r-- | lib/libpmc/pmc.mips24k.3 (renamed from lib/libpmc/pmc.mips.3) | 11 | ||||
-rw-r--r-- | lib/libpmc/pmc.octeon.3 | 253 |
3 files changed, 261 insertions, 6 deletions
diff --git a/lib/libpmc/Makefile b/lib/libpmc/Makefile index 350c22f..95da88e 100644 --- a/lib/libpmc/Makefile +++ b/lib/libpmc/Makefile @@ -42,6 +42,9 @@ MAN+= pmc.westmereuc.3 MAN+= pmc.tsc.3 .elif ${MACHINE_CPUARCH} == "arm" && ${CPUTYPE} == "xscale" MAN+= pmc.xscale.3 +.elif ${MACHINE_CPUARCH} == "mips" +MAN+= pmc.mips24k.3 +MAN+= pmc.octeon.3 .endif MLINKS+= \ diff --git a/lib/libpmc/pmc.mips.3 b/lib/libpmc/pmc.mips24k.3 index 134dd63..84e8c01 100644 --- a/lib/libpmc/pmc.mips.3 +++ b/lib/libpmc/pmc.mips24k.3 @@ -23,13 +23,13 @@ .\" .\" $FreeBSD$ .\" -.Dd February 25, 2012 -.Dt PMC.MIPS 3 +.Dd March 24, 2012 +.Dt PMC.MIPS24K 3 .Os .Sh NAME -.Nm pmc.mips +.Nm pmc.mips24k .Nd measurement events for -.Tn MIPS +.Tn MIPS24K family CPUs .Sh LIBRARY .Lb libpmc @@ -388,6 +388,7 @@ and the underlying hardware events used. .Xr pmc.iaf 3 , .Xr pmc.k7 3 , .Xr pmc.k8 3 , +.Xr pmc.octeon 3 , .Xr pmc.p4 3 , .Xr pmc.p5 3 , .Xr pmc.p6 3 , @@ -409,5 +410,3 @@ library was written by MIPS support was added by .An "George Neville-Neil" .Aq gnn@FreeBSD.org . -.Sh CAVEATS -The MIPS code does not yet support sampling. diff --git a/lib/libpmc/pmc.octeon.3 b/lib/libpmc/pmc.octeon.3 new file mode 100644 index 0000000..e8851425 --- /dev/null +++ b/lib/libpmc/pmc.octeon.3 @@ -0,0 +1,253 @@ +.\" Copyright (c) 2010 George Neville-Neil. All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND +.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE +.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS +.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY +.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF +.\" SUCH DAMAGE. +.\" +.\" $FreeBSD$ +.\" +.Dd March 24, 2012 +.Dt PMC.OCTEON 3 +.Os +.Sh NAME +.Nm pmc.octeon +.Nd measurement events for +.Tn Octeon +family CPUs +.Sh LIBRARY +.Lb libpmc +.Sh SYNOPSIS +.In pmc.h +.Sh DESCRIPTION +.Pp +There are two counters per core supported by the hardware and each is 64 bits +wide. +.Ss Event Specifiers (Programmable PMCs) +MIPS programmable PMCs support the following events: +.Bl -tag -width indent +.It Li CLK +.Pq Event 1 +Conditionally clocked cycles (as opposed to count/cvm_count which count even with no clocks) +.It Li ISSUE +.Pq Event 2 +Instructions issued but not retired +.It Li RET +.Pq Event 3 +Instructions retired +.It Li NISSUE +.Pq Event 4 +Cycles no issue +.It Li SISSUE +.Pq Event 5 +Cycles single issue +.It Li DISSUE +.Pq Event 6 +Cycles dual issue +.It Li IFI +.Pq Event 7 +Cycle ifetch issued (but not necessarily commit to pp_mem) +.It Li BR +.Pq Event 8 +Branches retired +.It Li BRMIS +.Pq Event 9 +Branch mispredicts +.It Li J +.Pq Event 10 +Jumps retired +.It Li JMIS +.Pq Event 11 +Jumps mispredicted +.It Li REPLAY +.Pq Event 12 +Mem Replays +.It Li IUNA +.Pq Event 13 +Cycles idle due to unaligned_replays +.It Li TRAP +.Pq Event 14 +trap_6a signal +.It Li UULOAD +.Pq Event 16 +Unexpected unaligned loads (REPUN=1) +.It Li UUSTORE +.Pq Event 17 +Unexpected unaligned store (REPUN=1) +.It Li ULOAD +.Pq Event 18 +Unaligned loads (REPUN=1 or USEUN=1) +.It Li USTORE +.Pq Event 19 +Unaligned store (REPUN=1 or USEUN=1) +.It Li EC +.Pq Event 20 +Exec clocks(must set CvmCtl[DISCE] for accurate timing) +.It Li MC +.Pq Event 21 +Mul clocks(must set CvmCtl[DISCE] for accurate timing) +.It Li CC +.Pq Event 22 +Crypto clocks(must set CvmCtl[DISCE] for accurate timing) +.It Li CSRC +.Pq Event 23 +Issue_csr clocks(must set CvmCtl[DISCE] for accurate timing) +.It Li CFETCH +.Pq Event 24 +Icache committed fetches (demand+prefetch) +.It Li CPREF +.Pq Event 25 +Icache committed prefetches +.It Li ICA +.Pq Event 26 +Icache aliases +.It Li II +.Pq Event 27 +Icache invalidates +.It Li IP +.Pq Event 28 +Icache parity error +.It Li CIMISS +.Pq Event 29 +Cycles idle due to imiss (must set CvmCtl[DISCE] for accurate timing) +.It Li WBUF +.Pq Event 32 +Number of write buffer entries created +.It Li WDAT +.Pq Event 33 +Number of write buffer data cycles used (may need to set CvmCtl[DISCE] for accurate counts) +.It Li WBUFLD +.Pq Event 34 +Number of write buffer entries forced out by loads +.It Li WBUFFL +.Pq Event 35 +Number of cycles that there was no available write buffer entry (may need to set CvmCtl[DISCE] and CvmMemCtl[MCLK] for accurate counts) +.It Li WBUFTR +.Pq Event 36 +Number of stores that found no available write buffer entries +.It Li BADD +.Pq Event 37 +Number of address bus cycles used (may need to set CvmCtl[DISCE] for accurate counts) +.It Li BADDL2 +.Pq Event 38 +Number of address bus cycles not reflected (i.e. destined for L2) (may need to set CvmCtl[DISCE] for accurate counts) +.It Li BFILL +.Pq Event 39 +Number of fill bus cycles used (may need to set CvmCtl[DISCE] for accurate counts) +.It Li DDIDS +.Pq Event 40 +Number of Dstream DIDs created +.It Li IDIDS +.Pq Event 41 +Number of Istream DIDs created +.It Li DIDNA +.Pq Event 42 +Number of cycles that no DIDs were available (may need to set CvmCtl[DISCE] and CvmMemCtl[MCLK] for accurate counts) +.It Li LDS +.Pq Event 43 +Number of load issues +.It Li LMLDS +.Pq Event 44 +Number of local memory load +.It Li IOLDS +.Pq Event 45 +Number of I/O load issues +.It Li DMLDS +.Pq Event 46 +Number of loads that were not prefetches and missed in the cache +.It Li STS +.Pq Event 48 +Number of store issues +.It Li LMSTS +.Pq Event 49 +Number of local memory store issues +.It Li IOSTS +.Pq Event 50 +Number of I/O store issues +.It Li IOBDMA +.Pq Event 51 +Number of IOBDMAs +.It Li DTLB +.Pq Event 53 +Number of dstream TLB refill, invalid, or modified exceptions +.It Li DTLBAD +.Pq Event 54 +Number of dstream TLB address errors +.It Li ITLB +.Pq Event 55 +Number of istream TLB refill, invalid, or address error exceptions +.It Li SYNC +.Pq Event 56 +Number of SYNC stall cycles (may need to set CvmCtl[DISCE] for accurate counts) +.It Li SYNCIOB +.Pq Event 57 +Number of SYNCIOBDMA stall cycles (may need to set CvmCtl[DISCE] for accurate counts) +.It Li SYNCW +.Pq Event 58 +Number of SYNCWs +.It Li ERETMIS +.Pq Event 64 +D/eret mispredicts (CN63XX specific) +.It Li LIKMIS +.Pq Event 65 +Branch likely mispredicts (CN63XX specific) +.It Li HAZTR +.Pq Event 66 +Hazard traps due to *MTC0 to CvmCtl, Perf counter control, EntryHi, or CvmMemCtl registers (CN63XX specific) +.El +.Ss Event Name Aliases +The following table shows the mapping between the PMC-independent +aliases supported by +.Lb libpmc +and the underlying hardware events used. +.Bl -column "branch-mispredicts" "cpu_clk_unhalted.core_p" +.It Em Alias Ta Em Event Ta +.It Li instructions Ta Li RET Ta +.It Li branches Ta Li BR Ta +.It Li branch-mispredicts Ta Li BRMIS Ta +.El +.Sh SEE ALSO +.Xr pmc 3 , +.Xr pmc.atom 3 , +.Xr pmc.core 3 , +.Xr pmc.iaf 3 , +.Xr pmc.k7 3 , +.Xr pmc.k8 3 , +.Xr pmc.mips24k 3 , +.Xr pmc.p4 3 , +.Xr pmc.p5 3 , +.Xr pmc.p6 3 , +.Xr pmc.tsc 3 , +.Xr pmc_cpuinfo 3 , +.Xr pmclog 3 , +.Xr hwpmc 4 +.Sh HISTORY +The +.Nm pmc +library first appeared in +.Fx 6.0 . +.Sh AUTHORS +The +.Lb libpmc +library was written by +.An "Joseph Koshy" +.Aq jkoshy@FreeBSD.org . +MIPS support was added by +.An "George Neville-Neil" +.Aq gnn@FreeBSD.org . |