---
name: "binuptime"
section: "9freebsd"
platform: "linux"
package: "freebsd-manpages"
version: "12.2-2"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/binuptime/9freebsd"
---

# binuptime(9freebsd)

get the time elapsed since boot

## 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)](/bintime/9.md), [get\_cyclecount(9)](/get_cyclecount/9.md), [getbintime(9)](/getbintime/9.md), [getmicrotime(9)](/getmicrotime/9.md), [getnanotime(9)](/getnanotime/9.md), [microtime(9)](/microtime/9.md), [nanotime(9)](/nanotime/9.md), [tvtohz(9)](/tvtohz/9.md)

## AUTHORS

This manual page was written by Kelly Yancey ⟨*kbyanc@posi.net*⟩.