__pmconverttime(3) - Linux man page

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