PMDAPERFEVENT(1)            General Commands Manual           PMDAPERFEVENT(1)

<?><?><?> (NAME)
       pmdaperfevent - <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?> (PMDA) <?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?>

<?><?><?><?><?> <?><?><?><?><?> (SYNOPSIS)
       $PCP_PMDAS_DIR/perfevent/pmdaperfevent [-d domain] [-l logfile] [-U
       username] [-i port] [-p] [-u socket] [-6]

<?><?><?><?><?><?><?> (DESCRIPTION)
       <?><?><?><?><?><?> pmdaperfevent <?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?> (PMDA) <?><?><?> <?><?>
       <?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?> (API) perf_event <?><?>
       <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?> <?> <?><?><?><?><?><?><?><?>.

       <?><?><?><?> perfevent <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?> API<?>
       perf_event <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?>.  <?><?><?> PMDA <?><?> <?><?><?><?><?><?><?><?>
       libpfm4 <?><?><?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?><?> <?><?>
       <?><?> libpfm4 <?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?>.  <?><?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?> Intel RAPL <?><?>
       <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?> MSR
       <?><?><?><?><?> <?><?><?> <?><?><?>.  <?><?><?> PMDA <?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?>.  <?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?>
       <?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> (PMU) <?><?><?><?><?><?><?>
       <?><?><?><?><?><?>.  <?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?> CPU<?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?> <?><?>
       <?><?><?><?><?> <?><?><?><?><?> (round-robin)
       <?><?><?><?><?><?><?><?><?><?><?> uncore <?><?> <?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?><?><?><?> AMD <?><?><?><?> <?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?>.

       <?><?><?> PMDA <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?> <?><?>
       <?><?> <?><?> <?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?> /sys/bus/event_source/devices
       <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?>. <?><?><?> <?><?><?><?><?><?> PMU <?> <?><?><?>
       <?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?> <?><?><?>
       <?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?> PMDA <?><?>
       <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?>.

       <?><?><?> PMDA <?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?> <?><?>
       <?><?><?><?> <?><?><?><?><?> (user mode) <?> <?><?><?><?> (kernel mode)
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?>.  <?><?><?> <?><?><?><?>
       <?><?><?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?> PMDA <?><?> <?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?> <?> <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?>
       (unprivileged) <?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?>.  <?><?><?> PMDA
       <?><?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?>.  <?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?> <?><?> perfalloc(1) <?><?><?><?><?><?> <?><?><?><?>.

       <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?> pmdaperfevent
       <?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
       kernel.perf_event_paranoid <?><?><?><?> <?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?> sysctl(8) <?><?><?><?><?>
       <?><?><?>.

       <?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?>
       <?><?> <?><?><?><?><?> pmdaperfevent <?><?> <?><?><?><?><?>
       <?><?><?><?> <?><?><?>:

       -d   <?><?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?> <?><?><?><?><?>
            <?><?><?><?><?> (domain) <?><?><?><?><?><?><?><?>
            <?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?> <?><?><?><?>
            <?><?><?><?><?><?><?> <?><?><?><?> <?> <?><?><?><?><?><?>
            <?><?><?><?>.  <?><?> <?><?><?> <?><?><?><?> <?><?> domain
            <?><?><?><?> <?><?><?><?> <?><?> PMDA <?><?><?> <?><?>
            <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?> <?>
            <?><?><?><?><?> domain <?><?><?><?><?> <?><?><?><?> <?><?><?><?>
            <?><?><?><?> PMDA <?><?><?> <?><?><?><?>
            <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?>.

       -l   <?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?><?> (log).
            <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?>
            <?><?> pmdaperfevent <?><?><?><?><?><?><?><?><?><?>
            <?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?> <?><?>
            <?><?><?> perfevent.log <?><?> <?><?><?><?><?><?><?><?><?>
            <?><?><?><?> pmcd(1) <?><?><?><?><?> <?><?><?><?><?><?><?>
            <?><?><?><?> $PCP_LOG_DIR/pmcd.  <?><?><?> <?><?><?><?> <?><?><?>
            <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?> <?><?><?><?>
            <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>
            <?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?>
            <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
            <?><?>.

       -U   <?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?>
            <?><?> <?><?><?><?> <?><?><?><?><?><?>.  <?><?><?><?><?><?><?><?>
            <?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?> (root)
            <?><?><?>.

       -i   <?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?>
            <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?>
            <?><?><?> pmcd(1)

       -p   <?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?> pmcd(1) <?><?>
            <?><?><?><?> stdin/stdout

       -u   <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> pmcd(1) <?><?><?>
            <?><?><?><?> <?><?><?><?><?><?> (unix domain socket)
            <?><?><?><?><?><?><?><?>

       -6   <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> pmcd(1) <?><?><?>
            <?><?><?><?> ipv6 <?><?><?><?><?><?><?><?> (<?><?><?><?><?> <?><?>
            <?><?><?>)

<?><?><?> (INSTALLATION)
       <?><?><?><?> perfevent <?><?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?>.  <?><?><?><?> <?><?><?> <?><?><?> PMDA<?>
       <?><?><?><?><?> <?><?><?> <?><?> <?><?> <?><?><?><?><?><?> root
       <?><?><?><?><?> <?><?><?><?>:

            # cd $PCP_PMDAS_DIR/perfevent
            # ./Install

       <?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?> <?><?> <?><?><?>
       <?><?><?><?> (<?><?><?> <?><?><?>)<?> <?><?><?><?><?> <?><?><?> <?><?>
       <?><?> <?><?><?><?><?><?> root <?><?><?><?><?> <?><?><?><?>:

            # cd $PCP_PMDAS_DIR/perfevent
            # ./Remove

       <?><?><?><?><?><?> pmdaperfevent <?><?><?><?> pmcd(1)
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?> <?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>.
       <?><?><?><?><?><?><?><?><?><?><?> Install <?> Remove <?><?><?><?><?>
       <?><?><?> <?><?> <?><?><?> <?><?><?><?><?> <?><?> pmcd(1)
       <?><?><?><?><?> <?><?><?><?><?><?><?>.

<?><?><?><?><?><?><?> (FILES)
       $PCP_PMCDCONF_PATH
                 <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
                 <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>
                 <?><?><?><?><?><?><?><?><?><?> pmdaperfevent
       $PCP_PMDAS_DIR/perfevent/perfevent.conf
                 <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
                 <?><?><?><?> <?><?><?> PMDA.  <?><?><?><?>
                 <?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?>
                 perfevent.conf(5) <?><?><?><?><?><?> <?><?><?><?>.
       $PCP_PMDAS_DIR/perfevent/help
                 <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>
                 <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
                 perfevent
       $PCP_PMDAS_DIR/perfevent/Install
                 <?><?><?><?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?>
                 pmdaperfevent
       $PCP_PMDAS_DIR/perfevent/Remove
                 <?><?><?><?><?><?><?> <?><?><?> <?><?><?> <?><?><?><?>
                 <?><?><?><?> pmdaperfevent
       $PCP_LOG_DIR/pmcd/perfevent.log
                 <?><?><?><?> <?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>
                 <?><?><?><?><?><?><?><?> <?><?><?> <?> <?><?><?><?>
                 <?><?><?><?><?><?><?> <?><?><?><?> <?><?> pmdaperfevent

<?><?><?><?><?> (UPGRADING)
       <?><?> <?><?><?><?> <?>.<?><?>.<?> <?><?><?><?> <?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?> <?><?><?><?><?><?><?><?><?><?> PMNS <?><?><?><?><?>
       <?><?><?><?><?>.  <?><?><?><?><?><?><?> <?><?> pmlogrewrite(1)
       <?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?>.  <?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?>
       $PCP_PMDAS_DIR/perfevent/perfevent-makerewrite.pl <?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?> <?><?> pmlogrewrite(1) <?><?><?><?><?>
       <?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?>.

<?><?><?><?><?> <?><?><?><?><?><?> (BUGS)
       <?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?> <?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?> <?><?><?><?><?> <?><?><?> <?><?> <?><?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?>.  <?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?>
       <?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?> <?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?>.  <?><?><?> <?><?><?> <?><?><?><?>
       <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> (time-multiplexed)
       <?><?><?><?><?> <?> <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>.

<?><?><?><?> PCP (PCP ENVIRONMENT)
       <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?><?> PCP_
       <?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?>
       <?><?><?><?><?><?><?> <?> <?><?><?><?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?> PCP <?><?> <?><?><?>
       <?><?><?><?><?><?><?>.  <?><?> <?><?> <?><?><?><?> <?><?><?><?>
       /etc/pcp.conf <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?> <?><?><?><?><?><?><?> <?><?><?>.  <?><?><?><?><?> $PCP_CONF
       <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?>
       <?><?> pcp.conf(5) <?><?><?> <?><?><?><?> <?><?><?> <?><?><?>.

<?><?><?><?><?><?> <?><?><?><?><?><?> (SEE ALSO)
       perfalloc(1)<?> perfevent.conf(5)<?> PCPIntro(1)<?> pmcd(1)<?>
       pmlogrewrite(1)<?> PMAPI(3)<?> pcp.conf(5)<?> pcp.env(5) <?> sysctl(8).


Performance Co-Pilot                  PCP                     PMDAPERFEVENT(1)