IPMCTL-DELETE-GOAL(1)

💅 IPMCTL-DELETE-GOAL 💅

okay bestie, gather round, because this is the ipmctl manual page for the delete goal command — it lives in the ipmctl manual, and it's literally the "undo button" for your memory allocation goal. let's get into it 🫶

---

✨ NAME ✨

ipmctl-delete-goal — deletes the memory allocation goal from PMem modules 🧹

---

🌸 SYNOPSIS 🌸

ipmctl delete [OPTIONS] -goal [TARGETS]

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

---

🦋 DESCRIPTION 🦋

so what this does: it deletes the memory allocation goal from one or more PMem modules. no cap.

but here's the tea, and it's important tea: this command only deletes a memory allocation goal request that has not yet been processed by platform firmware (BIOS). if BIOS already ate it, this isn't the move. 🙈

and now the scary part, listen up:

if you use the PMem module target and the PMem modules you specify do not include all PMem modules that are part of a memory allocation goal request, the result will be PMem modules (the ones you didn't include) that have a broken request — which platform firmware (BIOS) will reject upon the next reboot. 💀

so yeah. include all of them. don't leave your modules hanging. fr fr.

---

🎀 OPTIONS 🎀

• -h, -help — shows you the help for this command. 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 — the -ddrt and -smbus options are mutually exclusive and may not be used together. pick one, bestie, you can't have both 💅

• -lpmb — used to specify large transport payload size for the current invocation of ipmctl.
• -spmb — used to specify small transport payload size for the current invocation of ipmctl.

Note — the -lpmb and -spmb options are mutually exclusive and may not be used together. again: one. not both. 😭

• -o (text|nvmxml), -output (text|nvmxml) — changes the output format. one of: "text" (default) or "nvmxml". yes the default is text, she's the moment ✨

---

👑 TARGETS 👑

• -dimm [DimmIDs] — deletes the memory allocation goal from specific PMem modules by optionally supplying one or more comma separated PMem module identifiers. the default is to delete the memory allocation goals from all manageable PMem modules.
• -socket [SocketIDs] — deletes the memory allocation goal from the PMem modules on specific sockets by supplying the socket target and one or more comma separated socket identifiers. the default is to delete the memory allocation goals from manageable PMem modules on all sockets.

---

🌈 EXAMPLES 🌈

deletes the memory allocation goal from all PMem modules on all sockets. the full send 🚀

ipmctl delete -goal

---

🔥 LIMITATIONS 🔥

in order to successfully execute this command (aka for it to actually slay):

• the caller must have the appropriate privileges. 🔐
• the specified PMem modules must be manageable by the host software and unlocked if security is enabled.
• given socket and all specified PMem modules must contain a memory allocation goal.

---

💜 RETURN DATA 💜

for each PMem module, the CLI will indicate the status of the operation.

and if a failure occurs when deleting the memory allocation goals from multiple PMem modules, the process will output a failure message for those PMem modules that failed and a success message for those that succeeded. so you get the receipts either way 📝

---

⭐ SAMPLE OUTPUT ⭐

Delete memory allocation goal from PMem module (DimmID): Success

Delete memory allocation goal from PMem module (DimmID): Error (Code) - (Description)

---

okay and that's the whole page!! 🦋 this one's from the ipmctl manual, dated 2024-04-22, and it's the IPMCTL-DELETE-GOAL(1) page — now go delete those goals responsibly, bestie, and remember: include all the modules in the goal or BIOS will be so mad at you next reboot. mwah 💖✨🎀