1PMCONVERTTIME(3)           Library Functions Manual           PMCONVERTTIME(3)
2
3
4

NAME

6       __pmConvertTime - convert tm structure to timeval structure
7

C SYNOPSIS

9       #include <pcp/pmapi.h>
10       #include <pcp/impl.h>
11
12       int  __pmConvertTime(struct  tm  *tmin,  struct timeval *origin, struct
13       timeval *rslt)
14
15       cc ... -lpcp
16

DESCRIPTION

18       __pmConvertTime accepts a tm structure  that  has  been  filled  in  by
19       __pmParseCtime(3)  and  a reference time point origin, and fills in the
20       given rslt structure with the time the user meant when he  specified  a
21       partial ctime or positive or negative time interval.
22
23       Typically, the argument origin is the start time for a PCP archive log,
24       unless the user specified a negative interval offset, in which case  it
25       is the end time of the log.
26
27       __pmConvertTime  returns  0 if successful.  It returns -1 and writes an
28       error message to stderr, if an error is detected.
29
30       Use pmNewZone(3), pmNewContextZone(3) or pmUseZone(3)  to  establish  a
31       new current timezone that will effect __pmConvertTime.
32

SEE ALSO

34       PMAPI(3),    pmNewContextZone(3),   pmNewZone(3),   pmParseInterval(3),
35       pmParseTimeWindow(3), pmUseZone(3),  __pmParseCtime(3)  and  __pmParse‐
36       Time(3).
37
38
39
40Performance Co-Pilot                  SGI                     PMCONVERTTIME(3)