benchmark_timestamp(3)

📦
version 0.7.1 · 2 versions
, in nixos 26.05

✨ benchmark_timestamp(3) ✨

okay so welcome to the Arcan Lua API page for benchmark_timestamp, bestie — we're sampling a timekeeping source and it's gonna be cute. 💅

🎀 NAME 🎀

benchmark_timestamp — sample a timekeeping source. 🕰️

🌸 SYNOPSIS 🌸

number:timestamp
benchmark_timestamp( number:stratum=0 )

🦋 DESCRIPTION 🦋

This function queries some system specific timestamp source for a value that's usable for tracing and benchmarking purposes. ✨

The accuracy and precision may vary depending on if benchmark trace data collection is enabled or not, as well as the security level of the application running. No cap, it's giving "depends on the situation." 💀

The optional stratum argument specifies what kind of timekeeping source should be used. The default value (0) will be some kind of monotonic system clock in millisecond resolution. 🕰️ The other defined stratum values are:

  • 1 — seconds since epoch (1970-01-01), non-monotonic. ⏳
  • -1 — microseconds in system clock. 🔬
Selecting an invalid stratum is a terminal state transition. Like, literally terminal — do not do this unless you're trying to end the whole thing. 💀🙈

👑 NOTES 👑

  1. As the name implies, this is primarily intended for benchmarking purposes. Real-world timekeeping cases should be avoided if possible as the API does not contain sufficient functions for handling the usecases that appear when dealing with locales, adjustments etc. 🫶

mwah 💋 this page is from the system manual, October 2026 edition, and the manual name is benchmark_timestamp(3) — bestie, you're all caught up. 🎀💖

📦 where this page comes from