pmpost(1)

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

SYNOPSIS
     /usr/pcp/bin/pmpost message

DESCRIPTION
     pmpost will append the text message to the end of the Performance Co-
     Pilot (PCP) notice board file (/var/adm/pcplog/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 create 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
     /var/adm/pcplog/NOTICES the PCP notice board file

SEE ALSO
     logger(1), pmie(1) and setuid(2).