pmpost(1)

1PMPOST(1)                   General Commands Manual                  PMPOST(1)
2
3
4

NAME

6       pmpost - append messages to the Performance Co-Pilot notice board
7

SYNOPSIS

9       $PCP_BINADM_DIR/pmpost message
10

DESCRIPTION

12       pmpost  will  append the text message to the end of the Performance Co-
13       Pilot (PCP) notice board file ($PCP_LOG_DIR/NOTICES) in an atomic  man‐
14       ner  that guards against corruption of the notice board file by concur‐
15       rent invocations of pmpost.
16
17       The PCP notice board is intended to be a persistent store and  clearing
18       house  for  important messages relating to the operation of the PCP and
19       the notification of performance alerts from pmie(1) when other  notifi‐
20       cation options are either unavailable or unsuitable.
21
22       Before  being  written,  messages are prefixed by the current time, and
23       when the current day is different to the last  time  the  notice  board
24       file was written, pmpost will prepend the message with the full date.
25
26       If the notice board file does not exist, pmpost will create it.  Due to
27       the importance of the notice board file, pmpost is typically  installed
28       as  a  setuid(2)  root program and so the notice board is owned by, and
29       writable only by, root.
30

FILES

32       $PCP_LOG_DIR/NOTICES
33                 the PCP notice board file
34

PCP ENVIRONMENT

36       The file /etc/pcp.conf contains the local values  for  PCP_  variables.
37       Because  pmpost  is  setuid(1),  only the settings in /etc/pcp.conf are
38       used.  In addition, the $PCP_CONF variable may not be used  to  specify
39       an alternative configuration file for pmpost.
40

UNIX SEE ALSO

42       logger(1).
43

WINDOWS SEE ALSO

45       pcp-eventlog(1).
46