pmdaresctrl(1) — Linux manual page

NAME | SYNOPSIS | DESCRIPTION | INSTALLATION | FILES | PCP ENVIRONMENT | SEE ALSO | COLOPHON

PMDARESCTRL(1)           General Commands Manual          PMDARESCTRL(1)

NAME         top

       pmdaresctrl - resctrl performance metrics domain agent (PMDA)

SYNOPSIS         top

       $PCP_PMDAS_DIR/pmdaresctrl [-d domain] [-l logfile]

DESCRIPTION         top

       pmdaresctrl is a resctrl Performance Metrics Domain Agent (PMDA)
       which exposes performance metrics values from the /sys/fs/resctrl
       interface to provide information on the last level cache.

       Further details on linux support for last level cache metrics can
       be found at
       https://github.com/torvalds/linux/tree/master/Documentation/arch/x86/resctrl.rst .

INSTALLATION         top

       If you want access to the names, help text and values for the
       resctrl performance metrics, do the following as root:

            # cd $PCP_PMDAS_DIR/resctrl
            # ./Install

       If you want to undo the installation (and remove both PMDAs), do
       the following as root:

            # cd $PCP_PMDAS_DIR/resctrl
            # ./Remove

       pmdaresctrl is launched by pmcd(1) and should never be executed
       directly.  The Install and Remove scripts notify pmcd(1) when the
       agent is installed or removed.

FILES         top

       $PCP_PMCDCONF_PATH
              command line options used to launch pmdaresctrl
       $PCP_PMDAS_DIR/resctrl/help
              default help text file for the resctrl metrics
       $PCP_PMDAS_DIR/resctrl/Install
              installation script for the pmdaresctrl agent
       $PCP_PMDAS_DIR/resctrl/Remove
              undo installation script for the pmdaresctrl agent

PCP ENVIRONMENT         top

       Environment variables with the prefix PCP_ are used to
       parameterize the file and directory names used by PCP.  On each
       installation, the file /etc/pcp.conf contains the local values
       for these variables.  The $PCP_CONF variable may be used to
       specify an alternative configuration file, as described in
       pcp.conf(5).  In particular, the $PCP_RESCTRL_DIR may be set to
       change the default directory from /sys/fs/resctrl.

SEE ALSO         top

       PCPIntro(1), pmcd(1), pcp.conf(5), pcp.env(5) and resctrl(1).

COLOPHON         top

       This page is part of the PCP (Performance Co-Pilot) project.
       Information about the project can be found at 
       ⟨http://www.pcp.io/⟩.  If you have a bug report for this manual
       page, send it to pcp@groups.io.  This page was obtained from the
       project's upstream Git repository
       ⟨https://github.com/performancecopilot/pcp.git⟩ on 2024-06-14.
       (At that time, the date of the most recent commit that was found
       in the repository was 2024-06-14.)  If you discover any rendering
       problems in this HTML version of the page, or you believe there
       is a better or more up-to-date source for the page, or you have
       corrections or improvements to the information in this COLOPHON
       (which is not part of the original manual page), send a mail to
       man-pages@man7.org

Performance Co-Pilot               PCP                    PMDARESCTRL(1)