Man Linux: Main Page and Category List

NAME

       __pmConvertTime - convert tm structure to timeval structure

C SYNOPSIS

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

       int  __pmConvertTime(struct  tm  *tmin,  struct timeval *origin, struct
       timeval *rslt)

       cc ... -lpcp

DESCRIPTION

       __pmConvertTime accepts a tm structure  that  has  been  filled  in  by
       __pmParseCtime(3)  and  a reference time point origin, and fills in the
       given rslt structure with the time the user meant when he  specified  a
       partial ctime or positive or negative time interval.

       Typically, the argument origin is the start time for a PCP archive log,
       unless the user specified a negative interval offset, in which case  it
       is the end time of the log.

       __pmConvertTime  returns  0 if successful.  It returns -1 and writes an
       error message to stderr, if an error is detected.

       Use pmNewZone(3), pmNewContextZone(3) or pmUseZone(3)  to  establish  a
       new current timezone that will effect __pmConvertTime.

SEE ALSO

       PMAPI(3),    pmNewContextZone(3),   pmNewZone(3),   pmParseInterval(3),
       pmParseTimeWindow(3),     pmUseZone(3),      __pmParseCtime(3)      and
       __pmParseTime(3).