NAME

       binuptime,    getbinuptime,   microuptime,   getmicrouptime,   nanouptime,   getnanouptime,   sbinuptime,
       getsbinuptime — get the time elapsed since boot

SYNOPSIS

       #include <sys/time.h>

       void
       binuptime(struct bintime *bt);

       void
       getbinuptime(struct bintime *bt);

       void
       microuptime(struct timeval *tv);

       void
       getmicrouptime(struct timeval *tv);

       void
       nanouptime(struct timespec *ts);

       void
       getnanouptime(struct timespec *tsp);

       sbintime_t
       sbinuptime(void);

       sbintime_t
       getsbinuptime(void);

DESCRIPTION

       The binuptime() and getbinuptime() functions store the time elapsed since boot as a struct bintime at the
       address specified by bt.  The microuptime() and getmicrouptime() functions perform the same utility,  but
       record  the  elapsed  time  as  a struct timeval instead.  Similarly the nanouptime() and getnanouptime()
       functions store the elapsed time as a struct timespec.  The sbinuptime()  and  getsbinuptime()  functions
       return the time elapsed since boot as a sbintime_t.

       The  binuptime(), microuptime(), nanouptime(), and sbinuptime() functions always query the timecounter to
       return  the  current  time  as  precisely  as  possible.    Whereas   getbinuptime(),   getmicrouptime(),
       getnanouptime(),  and  getsbinuptime() functions are abstractions which return a less precise, but faster
       to obtain, time.

       The intent of the getbinuptime(), getmicrouptime(), getnanouptime(), and getsbinuptime() functions is  to
       enforce the user's preference for timer accuracy versus execution time.

SEE ALSO

       bintime(9), get_cyclecount(9), getbintime(9), getmicrotime(9), getnanotime(9), microtime(9), nanotime(9),
       tvtohz(9)

AUTHORS

       This manual page was written by Kelly Yancey <kbyanc@posi.net>.

Debian                                          February 21, 2015                                 MICROUPTIME(9)