11fa7f10bSFabien Thomas.\" Copyright (c) 2010 Fabien Thomas. All rights reserved. 21fa7f10bSFabien Thomas.\" 31fa7f10bSFabien Thomas.\" Redistribution and use in source and binary forms, with or without 41fa7f10bSFabien Thomas.\" modification, are permitted provided that the following conditions 51fa7f10bSFabien Thomas.\" are met: 61fa7f10bSFabien Thomas.\" 1. Redistributions of source code must retain the above copyright 71fa7f10bSFabien Thomas.\" notice, this list of conditions and the following disclaimer. 81fa7f10bSFabien Thomas.\" 2. Redistributions in binary form must reproduce the above copyright 91fa7f10bSFabien Thomas.\" notice, this list of conditions and the following disclaimer in the 101fa7f10bSFabien Thomas.\" documentation and/or other materials provided with the distribution. 111fa7f10bSFabien Thomas.\" 12026dbd29SChristian Brueffer.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND 13026dbd29SChristian Brueffer.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 14026dbd29SChristian Brueffer.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 15026dbd29SChristian Brueffer.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE 16026dbd29SChristian Brueffer.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 17026dbd29SChristian Brueffer.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 18026dbd29SChristian Brueffer.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 19026dbd29SChristian Brueffer.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 20026dbd29SChristian Brueffer.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 21026dbd29SChristian Brueffer.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 22026dbd29SChristian Brueffer.\" SUCH DAMAGE. 231fa7f10bSFabien Thomas.\" 241fa7f10bSFabien Thomas.Dd March 30, 2010 251fa7f10bSFabien Thomas.Dt PMC.UCF 3 26aa12cea2SUlrich Spörlein.Os 271fa7f10bSFabien Thomas.Sh NAME 281fa7f10bSFabien Thomas.Nm pmc.ucf 291fa7f10bSFabien Thomas.Nd measurement events for 301fa7f10bSFabien Thomas.Tn Intel 311fa7f10bSFabien Thomasuncore fixed function performance counters. 321fa7f10bSFabien Thomas.Sh LIBRARY 331fa7f10bSFabien Thomas.Lb libpmc 341fa7f10bSFabien Thomas.Sh SYNOPSIS 351fa7f10bSFabien Thomas.In pmc.h 361fa7f10bSFabien Thomas.Sh DESCRIPTION 371fa7f10bSFabien ThomasEach fixed-function PMC measures a specific hardware event. 381fa7f10bSFabien ThomasThe number of fixed-function PMCs implemented in a CPU can vary. 391fa7f10bSFabien ThomasThe number of fixed-function PMCs present can be determined at runtime 401fa7f10bSFabien Thomasby using function 411fa7f10bSFabien Thomas.Xr pmc_cpuinfo 3 . 421fa7f10bSFabien Thomas.Pp 431fa7f10bSFabien ThomasIntel uncore fixed-function PMCs are documented in 441fa7f10bSFabien Thomas.Rs 451fa7f10bSFabien Thomas.%B "Intel(R) 64 and IA-32 Architectures Software Developes Manual" 461fa7f10bSFabien Thomas.%T "Volume 3B: System Programming Guide, Part 2" 471fa7f10bSFabien Thomas.%N "Order Number: 253669-033US" 481fa7f10bSFabien Thomas.%D December 2009 491fa7f10bSFabien Thomas.%Q "Intel Corporation" 501fa7f10bSFabien Thomas.Re 511fa7f10bSFabien Thomas.Pp 521fa7f10bSFabien Thomas.Ss PMC Capabilities 531fa7f10bSFabien ThomasFixed-function PMCs support the following capabilities: 541fa7f10bSFabien Thomas.Bl -column "PMC_CAP_INTERRUPT" "Support" 551fa7f10bSFabien Thomas.It Em Capability Ta Em Support 561fa7f10bSFabien Thomas.It PMC_CAP_CASCADE Ta \&No 571fa7f10bSFabien Thomas.It PMC_CAP_EDGE Ta \&No 581fa7f10bSFabien Thomas.It PMC_CAP_INTERRUPT Ta \&No 591fa7f10bSFabien Thomas.It PMC_CAP_INVERT Ta \&No 601fa7f10bSFabien Thomas.It PMC_CAP_READ Ta Yes 611fa7f10bSFabien Thomas.It PMC_CAP_PRECISE Ta \&No 621fa7f10bSFabien Thomas.It PMC_CAP_SYSTEM Ta \&No 631fa7f10bSFabien Thomas.It PMC_CAP_TAGGING Ta \&No 641fa7f10bSFabien Thomas.It PMC_CAP_THRESHOLD Ta \&No 651fa7f10bSFabien Thomas.It PMC_CAP_USER Ta \&No 661fa7f10bSFabien Thomas.It PMC_CAP_WRITE Ta Yes 671fa7f10bSFabien Thomas.El 681fa7f10bSFabien Thomas.Ss Class Name Prefix 691fa7f10bSFabien ThomasThese PMCs are named using a class name prefix of 701fa7f10bSFabien Thomas.Dq Li ucf- . 711fa7f10bSFabien Thomas.Ss Event Specifiers (Fixed Function PMCs) 721fa7f10bSFabien ThomasThe fixed function PMCs are selectable using the following 731fa7f10bSFabien Thomasevent names: 741fa7f10bSFabien Thomas.Bl -tag -width indent 751fa7f10bSFabien Thomas.It Li UCLOCK 761fa7f10bSFabien Thomas.Pq Fixed Function Counter 0 771fa7f10bSFabien ThomasThe fixed-function uncore counter increments at the rate of the U-clock. 781fa7f10bSFabien ThomasThe frequency of the uncore clock domain can be determined from the uncore 791fa7f10bSFabien Thomasclock ratio which is available in the PCI configuration space register at 801fa7f10bSFabien Thomasoffset C0H under device number 0 and Function 0. 811fa7f10bSFabien Thomas.El 821fa7f10bSFabien Thomas.Sh SEE ALSO 831fa7f10bSFabien Thomas.Xr pmc 3 , 84*b2934971SMitchell Horne.Xr pmc.amd 3 , 851fa7f10bSFabien Thomas.Xr pmc.atom 3 , 861fa7f10bSFabien Thomas.Xr pmc.core 3 , 871fa7f10bSFabien Thomas.Xr pmc.core2 3 , 8873461c24SJoel Dahl.Xr pmc.corei7 3 , 8973461c24SJoel Dahl.Xr pmc.corei7uc 3 , 901fa7f10bSFabien Thomas.Xr pmc.iaf 3 , 91f5f9340bSFabien Thomas.Xr pmc.soft 3 , 921fa7f10bSFabien Thomas.Xr pmc.tsc 3 , 9373461c24SJoel Dahl.Xr pmc.westmere 3 , 9473461c24SJoel Dahl.Xr pmc.westmereuc 3 , 951fa7f10bSFabien Thomas.Xr pmc_cpuinfo 3 , 961fa7f10bSFabien Thomas.Xr pmclog 3 , 971fa7f10bSFabien Thomas.Xr hwpmc 4 981fa7f10bSFabien Thomas.Sh HISTORY 991fa7f10bSFabien ThomasThe 1001fa7f10bSFabien Thomas.Nm pmc 1011fa7f10bSFabien Thomaslibrary first appeared in 1021fa7f10bSFabien Thomas.Fx 6.0 . 1031fa7f10bSFabien Thomas.Sh AUTHORS 1041fa7f10bSFabien ThomasThe 1051fa7f10bSFabien Thomas.Lb libpmc 1061fa7f10bSFabien Thomaslibrary was written by 1072b7af31cSBaptiste Daroussin.An Joseph Koshy Aq Mt jkoshy@FreeBSD.org . 108