getbintime(9) get the current time

Other Alias

bintime, microtime, getmicrotime, nanotime, getnanotime

SYNOPSIS

In sys/time.h Ft void Fn bintime struct bintime *bt Ft void Fn getbintime struct bintime *bt Ft void Fn microtime struct timeval *tv Ft void Fn getmicrotime struct timeval *tv Ft void Fn nanotime struct timespec *ts Ft void Fn getnanotime struct timespec *tsp

DESCRIPTION

The Fn bintime and Fn getbintime functions store the system time as a Vt struct bintime at the addresses specified by Fa bt . The Fn microtime and Fn getmicrotime functions perform the same utility, but record the time as a Vt struct timeval instead. Similarly the Fn nanotime and Fn getnanotime functions store the time as a Vt struct timespec .

The Fn bintime , Fn microtime , and Fn nanotime functions always query the timecounter to return the current time as precisely as possible. Whereas Fn getbintime , Fn getmicrotime , and Fn getnanotime functions are abstractions which return a less precise, but faster to obtain, time.

The intent of the Fn getbintime , Fn getmicrotime , and Fn getnanotime functions is to enforce the user's preference for timer accuracy versus execution time.

HISTORY

The bintime functions first appeared in Fx 5.0 . The microtime and nanotime functions first appeared in Fx 3.0 but have existed in other incarnations since BSD 4.4

AUTHORS

This manual page was written by An Kelly Yancey Aq [email protected] .