.TH LIBPFM 3  "October, 2007" "" "Linux Programmer's Manual"
.SH NAME
libpfm_powerpc - support for IBM PowerPC and POWER processor families
.SH SYNOPSIS
.nf
.B #include <perfmon/pfmlib.h>
.B #include <perfmon/pfmlib_powerpc.h>
.sp
.SH DESCRIPTION
The libpfm library provides support for the IBM PowerPC and POWER processor
families.  Specifically, it currently provides support for the following
processors: PPC970(FX,GX), PPC970MP POWER4, POWER4+, POWER5, POWER5+, and POWER6.
.sp
.SH MODEL-SPECIFIC PARAMETERS
At present, the model_in and model_out model-specific input and output
parameters are not used by \fBpfm_dispatch_events()\fR function.  For future
compatibility, NULLs must be passed for these arguments.
.sp
.SH COMBINING EVENTS IN A SET
As with many architecture's PMU hardware design, events can not be combined
together arbitrarily in the same event set, even if there are a sufficient
number of counters available.  This implementation for IBM PowerPC/POWER
bases the event compatibility on a set of previously-defined compatible
event groups.  If the events placed in an event set are all members of one
of the predefined event groups, a call to the \fBpfm_dispatch_events()\fR function will be
successful.  With the current interface, there is no way to discover
apriori which events are compatible, so application software that wishes to
combine events must do so by trial and error, possibly using multiplexed
event sets to count events that cannot otherwise be combined in the same
set.
.sp
.SH ERRORS
Refer to the description of the \fBpfm_dispatch_events()\fR function for errors.
.SH SEE ALSO
pfm_dispatch_events(3) and set of examples shipped with the library
.SH AUTHOR
Corey Ashford <cjashfor@us.ibm.com>
.PP