NAME

       pmtimespecNow,     pmtimespecInc,     pmtimespecDec,     pmtimespecAdd,     pmtimespecSub,
       pmtimespecToReal, pmtimespecFromReal,  pmPrintHighResStamp  -  helper  routines  for  time
       stored as a struct timespec

C SYNOPSIS

       #include <pcp/pmapi.h>

       void pmtimespecNow(struct timespec *tp);
       void pmtimespecInc(struct timespec *ap, const struct timespec *bp);
       void pmtimespecDec(struct timespec *ap, const struct timespec *bp);
       double pmtimespecAdd(const struct timespec *ap, const struct timespec *bp);
       double pmtimespecSub(const struct timespec *ap, const struct timespec *bp);
       double pmtimespecToReal(const struct timespec *tp);
       void pmtimespecFromReal(double secs, struct timespec *tp);
       void pmPrintHighResStamp(FILE *f, const struct timespec *tp);

       cc ... -lpcp

DESCRIPTION

       pmtimespecNow  is a platform-independent method that returns the current system time since
       the Epoch in tp.

       pmtimespecInc adds the time in ap to  the  time  in  bp  and  stores  the  result  in  ap.
       Similarly pmtimespecDec subtracts the time in bp from the time in ap and stores the result
       in ap.

       pmtimespecAdd (and pmtimespecSub) add (and subtract) times and  return  the  result  as  a
       double value.  The time in the ap argument is not changed.

       pmtimespecToReal   converts   the   time   in   tp   to   an   equivalent   double  value.
       pmtimespecFromReal provides the reverse conversion, taking the time in secs and  returning
       the equivalent time in tp.

       pmPrintHighResStamp  prints  the  timestamp  from tp on the stream f in the local time (as
       returned by pmLocaltime(3)) in the format HH:MM:SS.XXXXXXXXX.

NOTES

       For variants of these interfaces using microsecond precision and  the  timeval  structure,
       refer to pmtimevalNow(3).

SEE ALSO

       PMAPI(3), pmLocaltime(3) and pmtimevalNow(3).