Date: Sat, 15 Nov 2008 11:34:30 +0000 (UTC) From: Joseph Koshy <jkoshy@FreeBSD.org> To: src-committers@freebsd.org, svn-src-all@freebsd.org, svn-src-head@freebsd.org Subject: svn commit: r184995 - head/lib/libpmc Message-ID: <200811151134.mAFBYUvY019711@svn.freebsd.org>
next in thread | raw e-mail | index | archive | help
Author: jkoshy Date: Sat Nov 15 11:34:30 2008 New Revision: 184995 URL: http://svn.freebsd.org/changeset/base/184995 Log: - Document the class name prefix for these PMCs. - Document the "anythread" qualifier, available on Atom CPUs. - Add examples. Modified: head/lib/libpmc/pmc.iaf.3 Modified: head/lib/libpmc/pmc.iaf.3 ============================================================================== --- head/lib/libpmc/pmc.iaf.3 Sat Nov 15 11:11:32 2008 (r184994) +++ head/lib/libpmc/pmc.iaf.3 Sat Nov 15 11:34:30 2008 (r184995) @@ -23,7 +23,7 @@ .\" .\" $FreeBSD$ .\" -.Dd October 3, 2008 +.Dd November 14, 2008 .Os .Dt PMC.IAF 3 .Sh NAME @@ -72,6 +72,9 @@ Fixed-function PMCs support the followin .It PMC_CAP_USER Ta Yes .It PMC_CAP_WRITE Ta Yes .El +.Ss Class Name Prefix +These pmcs are named using a class name prefix of +.Dq Li iaf- . .Ss Event Qualifiers (Fixed Function PMCs) These PMCs support the following modifiers: .Bl -tag -width indent @@ -80,6 +83,11 @@ Configure the PMC to count events occurr .It Li usr Configure the PMC to count events occurring at ring levels 1, 2 or 3. +.It Li anythread +.Pq Tn Atom CPUs +Configure the PMC to count events on all logical processors sharing a +processor core. +The default is to count events on the current logical processor. .El .Pp If neither of the @@ -101,6 +109,19 @@ The number of core cycles for which the .Pq Fixed Function Counter 2 The number of reference cycles for which the core is not halted. .El +.Sh EXAMPLES +To measure the number of core cycles for which the core was not halted +use the event specifier +.Qq iaf-cpu-clk-unhalted.core . +.Pp +To measure the number of user instructions retired use the event specifier +.Qq iaf-instr-retired.any,usr . +.Pp +To measure the number of user instructions retired on all logical processors +in an +.Tn Atom +CPU, use the event specifier +.Qq iaf-instr-retired.any,usr,anythread . .Sh SEE ALSO .Xr pmc 3 , .Xr pmc.atom 3 ,
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?200811151134.mAFBYUvY019711>