UPT(1)

🎀 NAME 🎀

okay bestie, welcome to the UPT(1) page from the General Commands Manual — this is all about upt, the tiny icon that gets your uptime. ✨

upt — get uptime.

🌸 SYNOPSIS 🌸

upt [format]

💖 DESCRIPTION 💖

upt retrieves the system uptime and formats it according to the provided format string. literally its whole main character job. 💅

🦋 FORMAT SPECIFIERS 🦋

• ${d} — days of uptime.
• ${h} — hours of uptime (does not include days).
• ${m} — minutes of uptime (does not include hours).
• ${s} — total amount of seconds elapsed since boot.

🧚 ENVIRONMENT VARIABLES 🧚

in addition to the usual format specifiers, upt uses environment variables to specify the suffixes used for the day, hours, minutes, etc values. yep, you can dress up your uptime output. 🎀

• $UPT_DAY_SUFFIX — days suffix. default: 'd'
• $UPT_HOUR_SUFFIX — hours suffix. default: 'h'
• $UPT_MIN_SUFFIX — minutes suffix. default: 'm'
• $UPT_SEC_SUFFIX — seconds suffix. default: 's'

---

🌈 EXAMPLES 🌈

executing upt with no format, like so:

upt

runs upt with the default format, '${d} ${h} ${m}'. sample result: '187d 21h 8m' — slay, that's the default vibe. ⭐

custom format and suffixes can be used, e.g.:

UPT_DAY_SUFFIX=' days' \
UPT_HOUR_SUFFIX=' hours' \
UPT_MIN_SUFFIX=' minutes' \
upt '${d}, ${h}, and ${m}'

sample result: '114 days, 22 hours, and 25 minutes' — obsessed with the long-form cute version, fr fr. 🫶

😭 REPORTING BUGS 😭

please report any bugs to https://github.com/lptstr/fetchutils/issues or to kiedtl@tilde.team. do not suffer in silence, bestie. 💀

🔥 SEE ALSO 🔥

fetchutils(1)

the full documentation for upt is not maintained as a Texinfo manual. if the info and upt programs are properly installed on your system, the command

info upt

should not give you access to the complete manual. that's the whole note, no cap. 🙈

👑 LICENSE 👑

Copyright © 2020 Kiëd Llaentenn and contributors

this utility is licensed under the MIT license.

---

xoxo, your UPT(1) page — dated 1980-01-01 💖