|
HTML rendering created 2025-09-06 by Michael Kerrisk, author of The Linux Programming Interface. For details of in-depth Linux/UNIX system programming training courses that I teach, look here. Hosting by jambit GmbH. |
|
|
NAME | SYNOPSIS | DESCRIPTION | INSTALLATION | FILES | PCP ENVIRONMENT | DEBUGGING OPTIONS | SEE ALSO | COLOPHON |
|
|
|
PMDARESCTRL(1) General Commands Manual PMDARESCTRL(1)
pmdaresctrl - resctrl performance metrics domain agent (PMDA)
$PCP_PMDAS_DIR/pmdaresctrl [-D debug] [-d domain] [-l logfile]
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 .
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.
$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
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.
The -D or --debug option enables the output of additional
diagnostics on stderr to help triage problems, although the
information is sometimes cryptic and primarily intended to provide
guidance for developers rather end-users. debug is a comma
separated list of debugging options; use pmdbg(1) with the -l
option to obtain a list of the available debugging options and
their meaning.
PCPIntro(1), pmcd(1), pcp.conf(5), pcp.env(5) and resctrl(1).
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 [email protected]. This page was obtained from the
project's upstream Git repository
⟨https://github.com/performancecopilot/pcp.git⟩ on 2025-08-11.
(At that time, the date of the most recent commit that was found
in the repository was 2025-08-11.) 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
[email protected]
Performance Co-Pilot PCP PMDARESCTRL(1)
|
HTML rendering created 2025-09-06 by Michael Kerrisk, author of The Linux Programming Interface. For details of in-depth Linux/UNIX system programming training courses that I teach, look here. Hosting by jambit GmbH. |
|