Poster of Linux kernelThe best gift for a Linux geek
PMPRINTVALUE

PMPRINTVALUE

Section: C Library Functions (3) Updated: SGI
Local index Up
 

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


 

Index

NAME
C SYNOPSIS
DESCRIPTION
SEE ALSO

This document was created by man2html, using the manual pages.
Time: 21:52:39 GMT, April 16, 2011