S6-CLOCK(1)

s6-clock(1) — get or set the system clock 💖

okay bestie, welcome to the S6-CLOCK(1) page! The manual name is literally S6-CLOCK(1), and it lives in the General Commands Manual section. This is the one that gets or sets your system clock, and it’s giving time-lord main character energy. ✨

🌸 NAME 🌸

s6-clock — get or set the system clock 💅

🌈 SYNOPSIS 🌈

s6-clock [label]

💖 DESCRIPTION 💖

When you call it with no argument at all, s6-clock writes the current system time to stdout as a TAI64N[1] timestamp. That’s it — no extra drama, just time on the screen. 🫶

When you give it an argument called label, and that label must be a TAI64N[1] timestamp, s6-clock sets the system time to this value. So yes, it can read the clock AND set the clock — dual threat behavior, honestly iconic. 👑

s6-clock only prints or accepts TAI time, no matter what the system clock is set to (TAI-10 or UTC). It will automatically make the right conversions for your system clock. Make sure your skalibs[2] has been built with the right settings. ⚠️ This part is important, bestie — if skalibs is built with the wrong settings, that’s a whole vibe check fail.

💅 EXIT STATUS 💅

• 111 — Temporary error.
• 100 — Permanent error, such as a misuse.
• 127 — Unable to execute program - not found.
• 126 — Unable to execute program - other reason.

🦋 SEE ALSO 🦋

okay so the whole s6 squad pulls up here:

• s6-basename(1)
• s6-cat(1)
• s6-chmod(1)
• s6-chown(1)
• s6-cut(1)
• s6-dirname(1)
• s6-dumpenv(1)
• s6-echo(1)
• s6-env(1)
• s6-expr(1)
• s6-false(1)
• s6-format-filter(1)
• s6-grep(1)
• s6-head(1)
• s6-hiercopy(1)
• s6-linkname(1)
• s6-ln(1)
• s6-ls(1)
• s6-maximumtime(1)
• s6-mkdir(1)
• s6-mkfifo(1)
• s6-nice(1)
• s6-nuke(1)
• s6-pause(1)
• s6-printenv(1)
• s6-quote(1)
• s6-quote-filter(1)
• s6-rename(1)
• s6-rmrf(1)
• s6-seq(1)
• s6-sleep(1)
• s6-sort(1)
• s6-sync(1)
• s6-tai64ndiff(1)
• s6-tail(1)
• s6-touch(1)
• s6-true(1)
• s6-uniquename(1)
• s6-unquote(1)
• s6-unquote-filter(1)
• s6-update-symlinks(1)
• seekablepipe(1)
• [1] — https://skarnet.org/software/skalibs/libstddjb/tai.html#timestamp
• [2] — https://skarnet.org/software/skalibs/

This man page is ported from the authoritative documentation at: https://skarnet.org/software/s6-portable-utils/s6-clock.html

🌸 AUTHORS 🌸

• Laurent Bercot
• Alexis <flexibeast@gmail.com> (man page port)

okay that’s the whole page — Debian edition, dated April 16, 2022, S6-CLOCK(1), byeee bestie 💅✨