---
name: "pmdaresctrl"
section: "1"
platform: "linux"
package: "pcp"
version: "7.2.2-2"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/pmdaresctrl"
---

# pmdaresctrl(1)

resctrl performance metrics domain agent (PMDA)

## NAME

**pmdaresctrl** - resctrl performance metrics domain agent (PMDA)

## SYNOPSIS

**$PCP\_PMDAS\_DIR/pmdaresctrl** \[**-D** *debug*\] \[**-d** *domain*\] \[**-l** *logfile*\]

## DESCRIPTION

**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

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)](/pmcd/1.md) and should never be executed directly. The Install and Remove scripts notify [**pmcd**(1)](/pmcd/1.md) when the agent is installed or removed.

## FILES

- **$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

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)](/pcp.conf/5.md). In particular, the **$PCP\_RESCTRL\_DIR** may be set to change the default directory from **/sys/fs/resctrl**.

## DEBUGGING OPTIONS

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 than for end-users. *debug* is a comma separated list of debugging options; use [**pmdbg**(1)](/pmdbg/1.md) with the **-l** option to obtain a list of the available debugging options and their meaning.

## SEE ALSO

[**PCPIntro**(1)](/PCPIntro/1.md), [**pmcd**(1)](/pmcd/1.md), [**pcp.conf**(5)](/pcp.conf/5.md), [**pcp.env**(5)](/pcp.env/5.md) and **resctrl**(1).