POWERCAP-SET(1)

💖 NAME 💖

powercap-set — the lil tool that manages power capping devices using the Linux power capping framework. yes bestie, we're out here capping power. ⚡

---

✨ SYNPOSIS ✨

powercap-set NAME [OPTION]...

---

🌸 DESCRIPTION 🌸

Okay so basically: it sets configurations for a powercap control type. that's the whole vibe. 🫶

And heads up — the control type NAME must not be empty, and it must not contain a . or a /. no exceptions, no cap. 💅

---

🎀 OPTIONS 🎀

• -h, --help — prints the help screen, slay ✨
• -p, --control-type=NAME — deprecated!! just hand over NAME as the first positional argument instead, bestie. it's giving legacy. 💀
• -z, --zone=ZONE(S) — the zone/subzone numbers in the control type's powercap tree. separate zones/subzones with a colon. e.g., for zone 0, subzone 2:

-z 0:2

• -c, --constraint=CONSTRAINT — the constraint number (none by default)
• -E, --enabled=1|0 — enable/disable a control type, iconic toggle behavior 🎚️

The following zone-level arguments may be used together and require -z/--zone:

• -j, --z-energy — reset zone energy counter 🔄
• -e, --z-enabled=1|0 — enable/disable a zone

The following constraint-level arguments may be used together and require -z/--zone and -c/--constraint:

• -l, --c-power-limit=UW — set constraint power limit
• -s, --c-time-window=US — set constraint time window

---

🦋 EXAMPLES 🦋

• powercap-set intel-rapl -z 0 -e 1 — enable zone 0 for the intel-rapl control type.
• powercap-set intel-rapl -z 0:1 -e 1 — enable zone 0, subzone 1 for the intel-rapl control type.
• powercap-set intel-rapl -z 0 -c 1 -l 25000000 — set a power cap of 25 Watts (25000000 uW) on zone 0, constraint 1 for the intel-rapl control type.
• powercap-set intel-rapl -z 1:0 -c 0 -l 15000000 -s 976 — set a power cap of 15 Watts (15000000 uW) and time window of 976 microseconds on zone 1, subzone 0, constraint 0 for the intel-rapl control type.

---

💅 REMARKS 💅

Administrative (root) privileges are usually needed to use powercap-set. so like, sudo or go home. 🔐

Setting constraint power cap and/or time limit values may not enable or disable a zone/subzone — set the -e/--z-enabled flag explicitly. the way that these two things are separate... 😭

The kernel may round power limits and time windows to discrete values supported by the hardware, e.g., 28 seconds might round to 27983872 microseconds. so yeah, expect the math to get a lil quirky fr fr.

• Power units: microwatts (uW)
• Time units: microseconds (us)

---

💀 BUGS 💀

Report bugs upstream at <https://github.com/powercap/powercap> — pls don't suffer in silence, bestie. 🐛

---

🍓 FILES 🍓

• /sys/devices/virtual/powercap/*
• /sys/class/powercap/*

---

👑 AUTHORS 👑

Connor Imes <connor.k.imes@gmail.com> — main character energy, honestly. 🫡

---

🌈 SEE ALSO 🌈

• powercap-info(1)

---

and that's the whole page, bestie 💖 this one comes from powercap, dated 2021-12-12, and it lives under the name POWERCAP-SET(1). go cap some power responsibly ✨🎀