1IPMCTL-SHOW-TOPOLOGY(1)             ipmctl             IPMCTL-SHOW-TOPOLOGY(1)
2
3
4

NAME

6       ipmctl-show-topology - Shows the topology of the memory installed
7

SYNOPSIS

9           ipmctl show [OPTIONS] -topology [TARGETS]
10

DESCRIPTION

12       Shows the topology of the memory installed in the host server. Use the
13       command ipmctl-show-dimm to view more detailed information about a PMem
14       module.
15

OPTIONS

17       -a, -all
18           Shows all attributes.
19
20       -h, -help
21           Displays help for the command.
22
23       -ddrt
24           Used to specify DDRT as the desired transport protocol for the
25           current invocation of ipmctl.
26
27       -smbus
28           Used to specify SMBUS as the desired transport protocol for the
29           current invocation of ipmctl.
30
31           Note
32           The -ddrt and -smbus options are mutually exclusive and may not be
33           used together.
34
35       -o (text|nvmxml), -output (text|nvmxml)
36           Changes the output format. One of: "text" (default) or "nvmxml".
37
38       -u (B|MB|MiB|GB|GiB|TB| TiB), -units (B|MB|MiB|GB|GiB|TB| TiB)
39           Changes the units that capacities are displayed in for this
40           command. One of: bytes (B), megabytes (MB), mebibytes (MiB),
41           gigabytes (GB), gibibytes (GiB), terabytes (TB) or tebibytes (TiB).
42

TARGETS

44       -dimm [DimmIDs]
45           Restricts output to specific PMem modules by optionally supplying
46           the PMem module target and one or more comma separated PMem module
47           identifiers. The default is to display all PMem modules.
48
49       -socket [SocketIDs]
50           Restricts output to the PMem modules installed on specific sockets
51           by supplying the socket target and one or more comma separated
52           socket identifiers. The default is to display all sockets.
53
54           Note
55           If ACPI PMTT table is not present, then DDR memory will not be
56           displayed in the filtered socket list.
57

EXAMPLES

59       Displays the system memory topology.
60
61           ipmctl show -topology
62

RETURN DATA

64       Displays a table with the attributes listed below for each memory
65       module installed in the host server.
66
67       MemoryType
68           (Default) The DIMM type. One of:
69
70           •   Unknown
71
72           •   DDR4
73
74           •   DDR5
75
76           •   Logical Non-volatile Device
77
78       Capacity
79           (Default) The raw capacity of the PMem module as reported in the
80           SMBIOS Type 17 table.
81
82       DimmID
83           (Default) The DIMM identifier. For DRAM DIMMs, the DimmID is "N/A".
84
85       PhysicalID
86           (Default) The PMem module physical identifier (i.e., SMBIOS Type 17
87           handle).
88
89       DeviceLocator
90           (Default) The string that identifies the physically labeled socket
91           or board position where the PMem module is located.
92
93       SocketID
94           The processor socket identifier (i.e., NUMA node) where the PMem
95           module is installed.
96
97       DieID
98           The processor die identifier where the PMem module is installed.
99
100       MemControllerID
101           The associated memory controller identifier.
102
103       ChannelID
104           The associated channel. For DRAM DIMMs, the channel identifier is
105           "N/A".
106
107       ChannelPos
108           The PMem module position in the channel.
109
110       NodeControllerID
111           The node controller identifier.
112
113       BankLabel
114           The string that identifies the physically labeled bank where the
115           PMem module is located.
116
117
118
119ipmctl                            2023-07-20           IPMCTL-SHOW-TOPOLOGY(1)
Impressum