PCP-UPTIME(1)

💖 PCP-UPTIME(1) 💖

okay bestie, so this is a page from the Performance Co-Pilot manual (that's the PCP thing, we'll get to it) and it's literally just pcp-uptime — the lil glow-up of the classic uptime command. sit down, grab a strawberry drink 🍓, and let's get into it.

---

✨ NAME ✨

pcp-uptime — tell how long the system has been running 🕰️

like, "how long has this machine been awake, no nap, no cap."

---

🌸 SYNOPSIS 🌸

pcp [pcp options] uptime [-V?]

that's it. that's the whole vibe. 🫶

---

🦋 DESCRIPTION 🦋

pcp-uptime gives you a one line display of the following tea ☕:

• the current time ⏰
• how long the system has been running (the uptime, the main character stat)
• how many users are currently logged on 👥
• the system load averages for the past 1, 5, and 15 minutes 📈

and when you invoke it via the pcp(1) command, a whole little squad of pcp options becomes indirectly available to you: -h/--host, -a/--archive, -O/--origin, -Z/--timezone, and several other pcp options. so like, you get the group chat, not just the DM. 💅

---

🎀 OPTIONS 🎀

the available command line options are, in order, no skips:

• -V, --version — display version number and exit. that's it, that's the whole job, bye 👋
• -?, --help — display usage message and exit. your lil instruction manual moment 📖

⚠️ okay so important one, listen up: when you're replaying from an archive using the -a option, the required information may not be available at the default starting time. in which case the reported values will be ?. like, question marks. the drama 💀. in that case, use the -S or -O options to move the starting time into a point in the archive where the required information is available. problem solved, slay. ✨

---

📝 NOTES 📝

pcp-uptime is inspired by the uptime(1) command and aims to be command line and output compatible with it. so it's giving homage, not reinvention. iconic behavior honestly 👑

---

🌈 PCP ENVIRONMENT 🌈

environment variables with the prefix PCP_ are used to parameterize the file and directory names used by PCP. very "everything is configurable, as it should be."

on each installation, the file /etc/pcp.conf contains the local values for these variables. 📂

the $PCP_CONF variable may be used to specify an alternative configuration file, as described in pcp.conf(5). so if you wanna be different, you can be different. 💜

for environment variables affecting PCP tools, see pmGetOptions(3).

---

🔍 SEE ALSO 🔍

PCPIntro(1), pcp(1), uptime(1) and environ(7).

go read them, they're all in the friend group. 🫶

---

and that's the whole page, bestie!! 💅 this was PCP-UPTIME(1) from the Performance Co-Pilot (PCP) manual, and this specific page is dated with that same PCP release energy. mwah, go check your uptime, ily 🎀✨