FreeBSD 7.0 manual page repository

FreeBSD is a free computer operating system based on BSD UNIX originally. Many IT companies, like DeployIS is using it to provide an up-to-date, stable operating system.

bintime, getbintime, microtime, getmicrotime, nanotime, getnanotime - get

 

NAME

      bintime, getbintime, microtime, getmicrotime, nanotime, getnanotime - get
      the current time
 

SYNOPSIS

      #include <sys/time.h>
 
      void
      bintime(struct bintime *bt);
 
      void
      getbintime(struct bintime *bt);
 
      void
      microtime(struct timeval *tv);
 
      void
      getmicrotime(struct timeval *tv);
 
      void
      nanotime(struct timespec *ts);
 
      void
      getnanotime(struct timespec *tsp);
 

DESCRIPTION

      The bintime() and getbintime() functions store the system time as a
      struct bintime at the addresses specified by bt.  The microtime() and
      getmicrotime() functions perform the same utility, but record the time as
      a struct timeval instead.  Similarly the nanotime() and getnanotime()
      functions store the time as a struct timespec.
 
      The bintime(), microtime(), and nanotime() functions always query the
      timecounter to return the current time as precisely as possible.  Whereas
      getbintime(), getmicrotime(), and getnanotime() functions are abstrac‐
      tions which return a less precise, but faster to obtain, time.
 
      The intent of the getbintime(), getmicrotime(), and getnanotime() func‐
      tions is to enforce the user’s preference for timer accuracy versus exe‐
      cution time.
      binuptime(9), getbinuptime(9), getmicrouptime(9), getnanouptime(9),
      microuptime(9), nanouptime(9), tvtohz(9)
 

HISTORY

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

AUTHORS

      This manual page was written by Kelly Yancey 〈kbyanc@posi.net〉.
 

Sections

Based on BSD UNIX
FreeBSD is an advanced operating system for x86 compatible (including Pentium and Athlon), amd64 compatible (including Opteron, Athlon64, and EM64T), UltraSPARC, IA-64, PC-98 and ARM architectures. It is derived from BSD, the version of UNIX developed at the University of California, Berkeley. It is developed and maintained by a large team of individuals. Additional platforms are in various stages of development.