NAME | C SYNOPSIS | DESCRIPTION | SEE ALSO | COLOPHON

PMCONVERTTIME(3)          Library Functions Manual          PMCONVERTTIME(3)

NAME         top

       __pmConvertTime - convert tm structure to timeval structure

C SYNOPSIS         top

       #include <pcp/pmapi.h>
       #include <pcp/impl.h>
       int __pmConvertTime(struct tm *tmin, struct timeval *origin,
               struct timeval *rslt);
       cc ... -lpcp

DESCRIPTION         top

       __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 set of  PCP
       archive logs, 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         top

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

COLOPHON         top

       This page is part of the PCP (Performance Co-Pilot) project.
       Information about the project can be found at ⟨http://www.pcp.io/⟩.
       If you have a bug report for this manual page, send it to
       pcp@oss.sgi.com.  This page was obtained from the project's upstream
       Git repository ⟨git://git.pcp.io/pcp⟩ on 2017-07-05.  If you discover
       any rendering problems in this HTML version of the page, or you
       believe there is a better or more up-to-date source for the page, or
       you have corrections or improvements to the information in this
       COLOPHON (which is not part of the original manual page), send a mail
       to man-pages@man7.org
Performance Co-Pilot                 PCP                    PMCONVERTTIME(3)

Pages that refer to this page: pmparsectime(3)pmparsetime(3)