---
name: "getbinuptime"
section: "9"
platform: "linux"
package: "freebsd-manpages"
version: "6.0-5"
release: "Debian 4.0 (Etch)"
platforms: ["linux", "freebsd"]
url: "https://new.carta.tech/getbinuptime"
---

# getbinuptime(9)

get the time elapsed since boot

## NAME

**binuptime**, **getbinuptime**, **microuptime**, **getmicrouptime**, **nanouptime**, **getnanouptime** – 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*);

## 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 **binuptime**(), **microuptime**(), and **nanouptime**() functions always query the timecounter to return the current time as precisely as possible. Whereas **getbinuptime**(), **getmicrouptime**(), and **getnanouptime**() functions are abstractions which return a less precise, but faster to obtain, time.

The intent of the **getbinuptime**(), **getmicrouptime**(), and **getnanouptime**() functions is to enforce the user's preference for timer accuracy versus execution time.

## SEE ALSO

[bintime(9)](/bintime/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⟩.