IPMCTL-SHOW-PERFORMANCE(1)

🎀 NAME 🎀

ipmctl-show-performance — the lil glow-up where you get the performance metrics for one or more PMem modules ✨

(that's ipmctl-show-performance(1), section 1, if you're keeping receipts bestie 💅)

---

📜 SYNOPSIS 📜

ipmctl show [OPTIONS] -performance [METRICS] [TARGETS]

---

💖 DESCRIPTION 💖

Shows performance metrics for one or more PMem modules. That's it, that's the whole vibe. You ask, it spills the stats. 🫶

---

✨ OPTIONS ✨

• -h, -help — the "help me bestie" flag. Displays help for the command.
• -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 one, you can't have both, it's giving monogamy 💀

• -o (text|nvmxml), -output (text|nvmxml) — changes the output format. One of: "text" (that's the default, btw) or "nvmxml".

---

📊 METRICS 📊

Restricts output to a specific performance metric by supplying the metric name. See RETURN DATA for more information. One of:

• MediaReads
• MediaWrites
• ReadRequests
• WriteRequests
• TotalMediaReads
• TotalMediaWrites
• TotalReadRequests
• TotalWriteRequests

The default is to display all performance metrics. No picking favourites, you get the whole buffet 🍓

---

🎯 TARGETS 🎯

• -dimm [DimmIDs] — restricts output to the performance metrics for specific PMem module by supplying one or more comma separated PMem module identifiers. The default is to display performance metrics for all manageable PMem module. (yes, "module" singular, that's how the page says it, iykyk 😭)

---

🌈 EXAMPLES 🌈

Shows all performance metrics for all PMem modules in the server:

ipmctl show -dimm -performance

Shows the number of 64 byte reads since last AC cycle for all PMem modules in the server:

ipmctl show -dimm -performance MediaReads

---

🚧 LIMITATIONS 🚧

In order to successfully execute this command:

• The caller must have the appropriate privileges. 👑 (yes bestie, perms are the main character here)
• The specified PMem modules must be manageable by the host software.

---

💅 RETURN DATA 💅

This command displays a table of the specified metrics for each specified PMem module. Applying a specific PMem module target limits the rows in the table. Applying a specific metric name target limits the columns in the table. Shrink the table, not your dreams ✨

• DimmID — the PMem module identifier
• MediaReads — number of 64 byte reads from media on the PMem module since last AC cycle.
• MediaWrites — number of 64 byte writes to media on the PMem module since last AC cycle.
• ReadRequests — number of DDRT read transactions the PMem module has serviced since last AC cycle.
• WriteRequests — number of DDRT write transactions the PMem module has serviced since last AC cycle.
• TotalMediaReads — number of 64 byte reads from media on the PMem module over its lifetime.
• TotalMediaWrites — number of 64 byte writes to media on the PMem module over its lifetime.
• TotalReadRequest — number of DDRT read transactions the PMem module has serviced over its lifetime.
• TotalWriteRequest — number of DDRT write transactions the PMem module has serviced over its lifetime.

🙈 ngl the last two are spelled TotalReadRequest and TotalWriteRequest right there in the page — no s — so copy them exactly as written and don't let autocorrect gaslight you 💀

---

And that's a wrap, bestie! 🦋 This lil masterpiece lives in the ipmctl manual, dated 2024-04-22, and you can find it filed under IPMCTL-SHOW-PERFORMANCE(1). Go forth and measure things, you icon 👑💖