Man Linux: Main Page and Category List

NAME

       pmLookupInDomText,   pmRequestInDomText  -  return  text  describing  a
       performance metrics instance domain

C SYNOPSIS

       #include <pcp/pmapi.h>

       int pmLookupInDomText(pmInDom indom, int level, char **buffer)
       int pmRequestInDomText(int ctx, pmInDom indom, int level)

       cc ... -lpcp

DESCRIPTION

       Provided the source of metrics from  the  current  Performance  Metrics
       Application  Programming  Interface (PMAPI) context is a host, retrieve
       descriptive  text  about  the  performance  metrics   instance   domain
       identified by indom.

       The  value  for the instance domain indom is typically extracted from a
       pmDesc structure, following a call to pmLookupDesc(3) for a  particular
       performance metric.

       The  argument  level  should be PM_TEXT_ONELINE for a one-line summary,
       else PM_TEXT_HELP for a more verbose  description,  suited  to  a  help
       dialog.

       The   space   pointed   to  by  buffer  will  have  been  allocated  in
       pmLookupInDomText with malloc(3C), and it is the responsibility of  the
       caller to free(3C) the space when it is no longer required.

       pmLookupInDomText returns zero on success.

       pmRequestInDomText  and  pmReceiveText  are  used by applications which
       must  communicate with the PMCD asynchronously.  These  functions  take
       explict  context  handle  ctx  which must refer to a host context (i.e.
       created by passing PM_CONTEXT_HOST to pmNewContext). pmRequestInDomText
       sends  request  to  PMCD  to provide descriptive text about performance
       metrics instance domain identified by indom and returns without waiting
       for  the  response,  pmReceiveText  reads  reply  from  PMCD. It is the
       responsibility of the application to  make  sure  the  data  are  ready
       before calling pmReceiveText to avoid blocking.

SEE ALSO

       chkhelp(1),   newhelp(1),  PMAPI(3),  pmGetConfig(3),  pmLookupDesc(3),
       pmLookupText(3), pmReceiveText(3), pcp.conf(4) and pcp.env(4).

DIAGNOSTICS

       PM_ERR_NOTHOST
              if the current PMAPI context is an archive log  (help  and  one-
              line text is not maintained in the archive logs)

       PM_ERR_CTXBUSY
              Context is currently in use by another asynchronous call.