1PMDARESCTRL(1)              General Commands Manual             PMDARESCTRL(1)
2
3
4

NAME

6       pmdaresctrl - resctrl performance metrics domain agent (PMDA)
7

SYNOPSIS

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

DESCRIPTION

12       pmdaresctrl  is a resctrl Performance Metrics Domain Agent (PMDA) which
13       exposes performance metrics values from the  /sys/fs/resctrl  interface
14       to provide information on the last level cache.
15
16
17       Further  details  on  linux support for last level cache metrics can be
18       found    at    https://github.com/torvalds/linux/tree/master/Documenta‐
19       tion/arch/x86/resctrl.rst.
20

INSTALLATION

22       If  you  want access to the names, help text and values for the resctrl
23       performance metrics, do the following as root:
24
25            # cd $PCP_PMDAS_DIR/resctrl
26            # ./Install
27
28       If you want to undo the installation (and remove both  PMDAs),  do  the
29       following as root:
30
31            # cd $PCP_PMDAS_DIR/resctrl
32            # ./Remove
33
34       pmdaresctrl  is  launched  by  pmcd(1) and should never be executed di‐
35       rectly.  The Install and Remove scripts notify pmcd(1) when  the  agent
36       is installed or removed.
37

FILES

39       $PCP_PMCDCONF_PATH
40                 command line options used to launch pmdaresctrl
41       $PCP_PMDAS_DIR/resctrl/help
42                 default help text file for the resctrl metrics
43       $PCP_PMDAS_DIR/resctrl/Install
44                 installation script for the pmdaresctrl agent
45       $PCP_PMDAS_DIR/resctrl/Remove
46                 undo installation script for the pmdaresctrl agent
47

PCP ENVIRONMENT

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

SEE ALSO

57       PCPIntro(1), pmcd(1), pcp.conf(5), pcp.env(5) and resctrl(1).
58
59
60
61Performance Co-Pilot                  PCP                       PMDARESCTRL(1)
Impressum