IPMCTL-SHOW-TOPOLOGY(1)

✨ ipmctl-show-topology — the manual, but make it cute ✨

okay bestie, so this is ipmctl-show-topology, part of the ipmctl manual fam 💖. It shows you the topology of the memory installed — like, the whole layout of what's plugged into your server and where. Think of it as a floor plan for your RAM. 🏠✨

---

🌸 SYNOPSIS 🌸

ipmctl show [OPTIONS] -topology [TARGETS]

that's it, that's the whole vibe. 💅

---

🦋 DESCRIPTION 🦋

Shows the topology of the memory installed in the host server</>, periodt. It's giving "map of everything in the memory slots."

And like, if you want the tea on one specific PMem module instead of the whole layout? Use ipmctl-show-dimm — that one spills way more detailed info. 🫖✨

---

💖 OPTIONS 💖

• -a, -all — shows all the attributes. all of them. every single one. no crumbs left. 👑
• -h, -help — displays help for the command. your lil bestie when you're lost. 🫶
• -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, they do NOT coexist. 💀

• -o (text|nvmxml), -output (text|nvmxml) — changes the output format. One of: "text" (the default, obviously) or "nvmxml".
• -u (B|MB|MiB|GB|GiB|TB| TiB), -units (B|MB|MiB|GB|GiB|TB| TiB) — changes the units that capacities are displayed in for this command. One of: bytes (B), megabytes (MB), mebibytes (MiB), gigabytes (GB), gibibytes (GiB), terabytes (TB) or tebibytes (TiB). pick your unit, glow up your numbers. 📏✨

---

🎀 TARGETS 🎀

• -dimm [DimmIDs] — restricts output to specific PMem modules by optionally supplying the PMem module target and one or more comma separated PMem module identifiers. The default is to display all PMem modules.
• -socket [SocketIDs] — restricts output to the PMem modules installed on specific sockets by supplying the socket target and one or more comma separated socket identifiers. The default is to display all sockets.

⚠️ Note: if the ACPI PMTT table is not present, then DDR memory will not be displayed in the filtered socket list. no table, no DDR, that's the rule. 😭

---

🌈 EXAMPLES 🌈

Displays the system memory topology. iconic. 💅

ipmctl show -topology

---

👑 RETURN DATA 👑

Displays a table</> with the attributes listed below for each memory module installed in the host server. here's the whole cast of characters: 🎭

• MemoryType — (Default) The DIMM type. One of:
  • Unknown
  • DDR4
  • DDR5
  • Logical Non-volatile Device
• Capacity — (Default) The raw capacity of the PMem module as reported in the SMBIOS Type 17 table.
• DimmID — (Default) The DIMM identifier. For DRAM DIMMs, the DimmID is "N/A".
• PhysicalID — (Default) The PMem module physical identifier (i.e., SMBIOS Type 17 handle).
• DeviceLocator — (Default) The string that identifies the physically labeled socket or board position where the PMem module is located.
• SocketID — The processor socket identifier (i.e., NUMA node) where the PMem module is installed.
• DieID — The processor die identifier where the PMem module is installed.
• MemControllerID — The associated memory controller identifier.
• ChannelID — The associated channel. For DRAM DIMMs, the channel identifier is "N/A".
• ChannelPos — The PMem module position in the channel.
• NodeControllerID — The node controller identifier.
• BankLabel — The string that identifies the physically labeled bank where the PMem module is located.

---

and that's the whole page bestie!! 🌟

cute lil sign-off time: this manual page is brought to you by ipmctl, dated 2024-04-22 — so if you're reading this and it feels vintage, that's why. 💖 stay slaying, go check your topology, and remember: DimmID is "N/A" for DRAM and that's on periodt. 🎀🦋✨