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

# pmpost(1)

append messages to the Performance Co-Pilot notice board

## NAME

**pmpost** - append messages to the Performance Co-Pilot notice board

## SYNOPSIS

**$PCP\_BINADM\_DIR/pmpost** \[**-D** *debug*\] *message*

## DESCRIPTION

**pmpost** will append the text *message* to the end of the Performance Co-Pilot (PCP) notice board file (**$PCP\_LOG\_DIR/NOTICES**) in an atomic manner that guards against corruption of the notice board file by concurrent invocations of **pmpost**.

The PCP notice board is intended to be a persistent store and clearing house for important messages relating to the operation of the PCP and the notification of performance alerts from [**pmie**(1)](/pmie/1.md) when other notification options are either unavailable or unsuitable.

Before being written, messages are prefixed by the current time, and when the current day is different to the last time the notice board file was written, **pmpost** will prepend the message with the full date.

If the notice board file does not exist, **pmpost** will create it. **pmpost** would usually run from long-running PCP daemons executing under the (typically unprivileged) **$PCP\_USER** and **$PCP\_GROUP** accounts. The file should be owned and writable by the **$PCP\_USER** user, and readable by others.

## FILES

- *$PCP\_LOG\_DIR/NOTICES*

  the PCP notice board file

## PCP ENVIRONMENT

The file **/etc/pcp.conf** contains the local values for PCP\_ variables.

## UNIX SEE ALSO

[**logger**(1)](/logger/1.md).

## WINDOWS SEE ALSO

**pcp-eventlog**(1).

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

[**pmie**(1)](/pmie/1.md), [**pcp.conf**(5)](/pcp.conf/5.md) and [**pcp.env**(5)](/pcp.env/5.md).