NAME

       pmdatrivial  -  trivial  performance  metrics domain agent
       (PMDA)


SYNOPSIS

       $PCP_PMDAS_DIR/trivial/pmdatrivial [-d  domain]  [-l  log­
       file]


DESCRIPTION

       pmdatrivial  is  the simplest possible Performance Metrics
       Domain Agent (PMDA) which  exports  a  single  performance
       metric,  the  time  in  seconds  since the 1st of January,
       1970.

       The trivial PMDA is shipped as source code and is designed
       to be an aid for PMDA developers.

       A  brief  description  of  the  pmdatrivial  command  line
       options follows:

       -d   It is absolutely crucial that the performance metrics
            domain  number  specified  here is unique and consis­
            tent.  That is, domain should be different for  every
            PMDA  on  the  one  host,  and the same domain number
            should be used for the same PMDA on all hosts.

       -l   Location of the log file.  By  default,  a  log  file
            named trivial.log is written in the current directory
            of  pmcd(1)  when  pmdatrivial   is   started,   i.e.
            $PCP_LOG_DIR/pmcd.  If the log file cannot be created
            or is not writable, output is written to the standard
            error instead.


INSTALLATION

       If  you want access to the names, help text and values for
       the trivial performance metrics, do the following as root:

            # cd $PCP_PMDAS_DIR/trivial
            # ./Install

       If  you want to undo the installation, do the following as
       root:

            # cd $PCP_PMDAS_DIR/trivial
            # ./Remove

       pmdatrivial is launched by pmcd(1)  and  should  never  be
       executed  directly.  The Install and Remove scripts notify
       pmcd(1) when the agent is installed or removed.


FILES


                 command line options used to launch pmdatrivial
       $PCP_PMDAS_DIR/trivial/help
                 default help text file for the trivial metrics
       $PCP_PMDAS_DIR/trivial/Install
                 installation script for the pmdatrivial agent
       $PCP_PMDAS_DIR/trivial/Remove
                 undo installation  script  for  the  pmdatrivial
                 agent
       $PCP_LOG_DIR/pmcd/trivial.log
                 default  log  file  for error messages and other
                 information from pmdatrivial


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


SEE ALSO

       PCPIntro(1),    pmcd(1),   pmdasample(1),   pmdasimple(1),
       pmdatxmon(1) and PMDA(3).


CAVEATS

       On Irix the trivial PMDA is part of the  pcp.sw.demo  sub­
       system and is not installed by default, it must be explic­
       itly installed using inst(1) or swmgr(1).

       Since the trivial PMDA is shipped as source, the installa­
       tion  requires the pmdatrivial binary to be created, which
       means the C compiler and development environment must also
       be installed.


Man(1) output converted with man2html