NAME
pmpost - append messages to the Performance Co-Pilot
notice board
SYNOPSIS
$PCP_BINADM_DIR/pmpost message
DESCRIPTION
pmpost will append the text message to the end of the Per
formance 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) 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 cre
ate it. Due to the importance of the notice board file,
pmpost is typically installed as a setuid(2) root program
and so the notice board is owned by, and writable only by,
root.
FILES
$PCP_LOG_DIR/NOTICES
the PCP notice board file
PCP ENVIRONMENT
The file /etc/pcp.conf contains the local values for PCP_
variables. Because pmpost is setuid(1), only the settings
in /etc/pcp.conf are used. In addition, the $PCP_CONF
variable may not be used to specify an alternative config
uration file for pmpost.
SEE ALSO
logger(1), pmie(1), setuid(2), pcp.conf(4) and pcp.env(4).
Man(1) output converted with
man2html