NAME    [Toc]    [Back]

     microtime - realtime system clock

SYNOPSIS    [Toc]    [Back]

     #include <sys/time.h>

     void
     microtime(struct timeval *tv);

DESCRIPTION    [Toc]    [Back]

     microtime() returns the current value of the system realtime clock in the
     structure pointed to by the argument tv.  The system realtime clock is
     guaranteed to be monotonically increasing at all times.  As such, all
     calls to microtime() are guaranteed to return a system time greater than
     or equal to the system time returned in any previous calls.

SEE ALSO    [Toc]    [Back]

     settimeofday(2),

     hz(9), inittodr(9), time(9)

CODE REFERENCES    [Toc]    [Back]

     The implementation of the microtime() function is machine dependent,
     hence its location in the source code tree varies from architecture to
     architecture.

BUGS    [Toc]    [Back]

     Despite the guarantee that the system realtime clock will always be monotonically
 increasing, it is always possible for the system clock to be
     manually reset by the system administrator to any date.

BSD                           September 14, 1998                           BSD