NAME

       perfevent.conf - the Performance Co-Pilot perfevent PMDA configuration file

SYNOPSIS

       $PCP_PMDAS_DIRS/perfevent/perfevent.conf

DESCRIPTION

       The  perfevent.conf  configuration  file  defines  which hardware performance counters are enabled by the
       perfevent PMDA.

       The configuration file contains a list of events that should be enabled for each PMU. The perfevent  PMDA
       detects  which  PMUs  present  and  programs  the  configured events. If multiple PMUs are available, the
       perfevent PMDA uses the order of the entries in the configuration file to determine which PMU settings to
       use. The entries at the top of the configuration file have higher precedence.  Only one PMU configuration
       setting is used.

FILE FORMAT

       The file consists of one or more groups of PMUs and the events that go with them.

       The PMU identification string is enclosed in brackets and one or more events are listed  below,  one  per
       line.

              ["PMU identification string"]
              EVENT_NAME [CPU OPTION]
              ...

       The available event cpu options are as follows:

       cpu    to add the counter to all cpus in the system

       cpu_rr to add to one of the cpus in a round-robin allocation strategy

       node   to add the counter to the first cpu in each numa node

       node_rr
              to add the counter to the cpus in each numa node in a round-robin allocation strategy

       [N]    where N is the numerical digit of the CPU index

       if the CPU option is absent then the event is programmed on all cpus.

       Blank lines are ignored. Lines that begin with the # sign are ignored.

       Multiple, comma separated, PMUs may be specified in the PMU definition.

SEE ALSO

       pmdaperfevent(1).

Performance Co-Pilot                                   PCP                                     PERFEVENT.CONF(5)