pmerr(1)

pmerr1

Translate performance co-pilot error codes into error messages

Usage

pmerr [-?] code ...

pmerr -l

Overview

pmerr accepts standard Performance Co-Pilot (PCP) error codes via the code argument(s) and generates the corresponding error text.

Each code may be an integer, a hexadecimal value or a hexadecimal value prefixed by either ``0x'' or ``0X''.

Error codes must be less than zero, so if code is a positive number, a warning message is produced, and the negated value is used.

Options

The available command line options are:

-l, --list

This alternative invocation causes all known error codes to be listed, along with their symbolic names and error text.

-?, --help

Display usage message and exit.

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).

Releases

8 releases since Debian 5.0 (Lenny); the text changed 4 times.

  1. 5.0
  2. 6.0
  3. 8–10
  4. 11
  5. 12–Arch

--help since Debian 11 (Bullseye); --list since Debian 11 (Bullseye); -? since Debian 11 (Bullseye); -l since Debian 11 (Bullseye).

From pcp 7.2.2-2 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.