Man Linux: Main Page and Category List

NAME

       pmPrintValue - print a performance metric value

C SYNOPSIS

       #include <stdio.h>
       #include <pcp/pmapi.h>

       void  pmPrintValue(FILE  *f,  int valfmt, int type, const pmValue *val,
       int minwidth)

       cc ... -lpcp

DESCRIPTION

       The value of a single performance metric  (as  identified  by  val)  is
       printed on the standard I/O stream identified by f.

       The  value  of  the  performance metric is interpreted according to the
       format of val as defined by valfmt (from a pmValueSet within a pmResult
       structure;  see  pmFetch(3)) and the generic description of the metrics
       type passed in via type.

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

       The output will be optionally padded to be at least minwidth characters
       wide.

       pmPrintValue  is  most  useful  for  displaying  values  of performance
       metrics from pmFetch(3) (which returns a set of valfmt  and  val  pairs
       for  each  requested  metric),  based upon the metrics type as returned
       from pmLookupDesc(3).

SEE ALSO

       PMAPI(3), pmAtomStr(3), pmConvScale(3), pmExtractValue(3),  pmFetch(3),
       pmLookupDesc(3), pmTypeStr(3) and pmUnitsStr(3).