getmicrotime.9freebsd

Langue: en

Version: 308087 (debian - 07/07/09)

Section: 9 (Appels noyau Linux)


BSD mandoc

NAME

bintime getbintime microtime getmicrotime nanotime getnanotime - get the current time

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.

SEE ALSO

binuptime(9), getbinuptime(9), getmicrouptime(9), getnanouptime(9), microuptime(9), nanouptime(9), tvtohz(9)

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 kbyanc@posi.net .