LSCLOCKS(1)

💖 LSCLOCKS 💖

okay bestie so you know how your computer has like... a million different clocks ticking away in there and you've never once thought about it? yeah. this is lsclocks, from the User Commands section of the manual, and it's here to show you all of them. 🕐✨

---

🌸 NAME 🌸

lsclocks — display system clocks 💅

---

🦋 SYNOPSIS 🦋

lsclocks [option]

---

✨ DESCRIPTION ✨

lsclocks is a simple command to display system clocks. that's the whole vibe. it's not doing the most, it's just showing you the clocks. 🎀

It allows to display information like current time and resolution of clocks. Different kinds of clocks are supported, and when I say different kinds, I mean different kinds, like:

• POSIX clocks: CLOCK_MONOTONIC, CLOCK_REALTIME, CLOCK_BOOTTIME, etc.
• CPU clocks: clock_getcpuclockid(3).
• PTP clocks: /dev/ptp0.
• RTC clocks: /dev/rtc0.
• Auxiliary clocks: CLOCK_AUX0, CLOCK_AUX1, etc.

it's giving clock census. it's giving time archaeology. periodt. 👑

---

💅 OPTIONS 💅

• -J, --json — Use JSON output format. for when you want your clocks machine-readable, slay.
• -n, --noheadings — Don't print headings. minimalism era.
• -o, --output list — Specify which output columns to print. See the OUTPUT COLUMNS section for details of available columns.
• --output-all — Output all columns. all of them. every single one. no notes. 🔥
• -r, --raw — Use raw output format.
• -t, --time clock — Show current time of one specific clock. just the one. your fave.
• --no-discover-dynamic — Do not try to discover dynamic clocks.
• -d, --dynamic-clock path — Also display specified dynamic clock. Can be specified multiple times.
• --no-discover-rtc — Do not try to discover RTCs.
• -x, --rtc path — Also display specified RTC. Can be specified multiple times.
• -c, --cpu-clock pid — Also display CPU clock of specified process. Can be specified multiple times.
• -h, --help — Display help text and exit.
• -V, --version — Display version and exit.

lowkey note: -d, -x, and -c are all repeatable, so if you got multiple clocks you wanna add, just keep stacking them. 🫶

---

🌈 ENVIRONMENT 🌈

• LSCLOCKS_COLUMNS= — Specifies a comma-separated list of output columns to print. All columns listed in OUTPUT COLUMNS can be used.
• LIBSMARTCOLS_DEBUG=all — enables libsmartcols debug output.
• LIBSMARTCOLS_DEBUG_PADDING=on — use visible padding characters.
• LIBSMARTCOLS_JSON=compact|lines — Controls JSON output format when using --json. Supported values are compact for JSON output with minimal whitespace, and lines for JSON Lines format (one JSON object per line). If unset or set to any other value, pretty-printed JSON is used.

---

⭐ OUTPUT COLUMNS ⭐

Each column has a type. Types are surround by < and >.

• TYPE <string> — Clock type.
• ID <number> — Numeric clock ID.
• CLOCK <string> — Name in the form CLOCK_
• NAME <string> — Shorter, easier to read name.
• TIME <number> — Current clock timestamp as returned by clock_gettime(2).
• ISO_TIME <string> — ISO8601 formatted version of TIME.
• RESOL_RAW <number> — Clock resolution as returned by clock_getres(2).
• RESOL <number> — Human readable version of RESOL_RAW.
• REL_TIME <string> — TIME time formatted as time range.
• NS_OFFSET <number> — Offset of the current namespace to the parent namespace as read from /proc/self/timens_offsets.

ngl REL_TIME being formatted as a time range is such a cute touch. time, but make it a range. 🍓

---

👑 AUTHORS 👑

Thomas Weißschuh <thomas@t-8ch.de>

---

🔍 SEE ALSO 🔍

clock_getres(2) clock_gettime(2)

---

🙈 REPORTING BUGS 🙈

For bug reports, use the issue tracker <https://github.com/util-linux/util-linux/issues>.

---

🧚 AVAILABILITY 🧚

The lsclocks command is part of the util-linux package which can be downloaded from Linux Kernel Archive <https://www.kernel.org/pub/linux/utils/util-linux/>.

---

okay that's the whole page bestie, you ate that. this was util-linux 2.42.4, dated 2026-09-21, and it lives in the LSCLOCKS(1) corner of the manual. go check your clocks, they're literally ticking rn. 💜🕰️✨