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

NAME

6       __pmConvertTime - convert tm structure to timeval structure
7

C SYNOPSIS

9       #include "pmapi.h"
10       #include "libpcp.h"
11
12       int __pmConvertTime(struct tm *tmin, struct timeval *origin,
13               struct timeval *rslt);
14
15       cc ... -lpcp
16

CAVEAT

18       This documentation is intended for internal Performance Co-Pilot  (PCP)
19       developer use.
20
21       These  interfaces  are  not part of the PCP APIs that are guaranteed to
22       remain fixed across releases, and they may not  work,  or  may  provide
23       different semantics at some point in the future.
24

DESCRIPTION

26       __pmConvertTime accepts a tm structure that has been filled in by __pm‐
27       ParseCtime(3) and a reference time point origin, and fills in the given
28       rslt structure with the time the user meant when he specified a partial
29       ctime or positive or negative time interval.
30
31       Typically, the argument origin is the start time for a set of  PCP  ar‐
32       chive  logs,  unless  the user specified a negative interval offset, in
33       which case it is the end time of the log.
34
35       __pmConvertTime returns 0 if successful.  It returns -1 and  writes  an
36       error message to stderr, if an error is detected.
37
38       Use  pmNewZone(3),  pmNewContextZone(3)  or pmUseZone(3) to establish a
39       new current timezone that will effect __pmConvertTime.
40

SEE ALSO

42       PMAPI(3), pmNewContextZone(3),  pmNewZone(3),  pmParseInterval(3),  pm‐
43       ParseTimeWindow(3),   pmUseZone(3),  __pmParseCtime(3)  and  __pmParse‐
44       Time(3).
45
46
47
48Performance Co-Pilot                  PCP                     PMCONVERTTIME(3)
Impressum