IPMCTL-SET-SENSOR(1)

💅 ipmctl-set-sensor — the glow-up for your PMem sensors

okay bestie, so this is the ipmctl manual, and today's episode is ipmctl-set-sensor. no cap.

---

✨ NAME ✨

ipmctl-set-sensor — sets the threshold or the enabled state for PMem modules sensors 🎀

---

🌸 SYNOPSIS 🌸

ipmctl set [OPTIONS] -sensor (SENSORS) [TARGETS]
AlarmThreshold=(temperature) AlarmEnabled=(0|1)

---

🦋 DESCRIPTION 🦋

So like, this command changes the alarm threshold or the enabled state for the sensors on one or more PMem modules. that's the whole vibe.

want to peek at what's currently set before you start messing with it? use the command Show Sensor. yes queen, look before you leap 💖

---

⭐ OPTIONS ⭐

• -f, -force — bestie, changing sensor settings is a potentially destructive operation and it needs you to confirm for each and every PMem module. this option suppresses that confirmation. use with intention, not on autopilot 🙈
• -h, -help — shows help for the command. the classic.
• -ddrt — used to specify DDRT as the desired transport protocol for the current invocation of ipmctl.
• -smbus — used to specify SMBUS as the desired transport protocol for the current invocation of ipmctl.

Note — -ddrt and -smbus are mutually exclusive and may not be used together. pick a lane bestie, you literally cannot have both 😭

• -o (text|nvmxml), -output (text|nvmxml) — changes the output format. one of: "text" (default) or "nvmxml".

---

🧚 SENSORS 🧚

• MediaTemperature — the PMem module media temperature in Celsius 🌡️
• ControllerTemperature — the PMem module controller temperature in Celsius 🌡️
• PercentageRemaining — remaining PMem module's life as a percentage value of factory expected life span. it's giving ✨lifespan✨

---

🎀 TARGETS 🎀

• -dimm [DimmIDs] — update the specified sensors on specific PMem modules. you optionally supply the PMem module target plus one or more comma separated PMem module identifiers. the default is to update the specified sensors for all manageable PMem modules.

---

👑 PROPERTIES 👑

• AlarmThreshold — the threshold value at which an alarm for the respective sensor will be triggered. it's the upper alarm threshold of the sensor for temperatures, and the lower one for percentage remaining. temperatures may be specified to a precision of 1 degree Celsius.

Table 1. Allowed AlarmThreshold

• MediaTemperature — allowed AlarmThreshold values: 0-85 — units: Celsius
• ControllerTemperature — allowed AlarmThreshold values: 0-102 — units: Celsius
• PercentageRemaining — allowed AlarmThreshold values: 1-99 — units: %

• AlarmEnabled — enable or disable the alarm threshold, where applicable. one of:
  • "0": Disable
  • "1": Enable

---

🌈 EXAMPLES 🌈

changes the media temperature alarm threshold to 51C on the specified PMem module and enables the alarm. iconic behavior honestly 🔥

ipmctl set -sensor MediaTemperature -dimm 0x0001 AlarmThreshold=51 AlarmEnabled=1

---

💀 LIMITATIONS 💀

in order to successfully execute this command:

• the caller must have the appropriate privileges.
• the specified PMem modules must be manageable by the host software.

no privileges, no party. that's just how it is 🫶

---

🍓 RETURN DATA 🍓

for each PMem module, the CLI will indicate the status of the operation. and listen — if a failure occurs when modifying multiple PMem modules, the process will exit and not continue modifying the remaining PMem modules. so it stops right there. fr fr.

---

💜 SAMPLE OUTPUT 💜

Modify (Sensor) settings on DIMM (DimmID): Success

Modify (Sensor) settings on DIMM (DimmID): Error (Code) - (Description)

---

okay that's the whole page, you're officially sensor-literate 💅 go forth and set those thresholds responsibly, bestie. mwah.

this page came to you from ipmctl, dated 2024-04-22, and it lives under the name IPMCTL-SET-SENSOR(1) in the manual. take care of her 🎀