---
name: "getsbinuptime"
section: "9"
platform: "freebsd"
package: "base"
version: "16.0-CURRENT-20261027-61c70dc16a79"
release: "FreeBSD 16.0-CURRENT (2026-10-27)"
platforms: ["freebsd"]
url: "https://carta.tech/man/microuptime"
---

# getsbinuptime(9)

get the time elapsed since boot

Part of [microuptime(9)](/man/microuptime/9.md).

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

## AUTHORS

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