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-device to view more detailed information about a
14       DCPMM.
15

OPTIONS

17       -a, -all
18           Shows all attributes.
19
20           Note
21           The all and display options are exclusive and may not be used
22           together.
23
24       -d (attributes), -display (attributes)
25           Filters the returned attributes by explicitly specifying a
26           comma-separated list of any of the attributes defined in the Return
27           Data section.
28
29           Note
30           The all and display options are exclusive and may not be used
31           together.
32
33       -h, -help
34           Displays help for the command.
35
36       -o (text|nvmxml), -output (text|nvmxml)
37           Changes the output format. One of: "text" (default) or "nvmxml".
38
39       -u (B|MB|MiB|GB|GiB|TB| TiB), -units (B|MB|MiB|GB|GiB|TB| TiB)
40           Changes the units that capacities are displayed in for this
41           command. One of: bytes (B), megabytes (MB), mebibytes (MiB),
42           gigabytes (GB), gibibytes (GiB), terabytes (TB) or tebibytes (TiB).
43

TARGETS

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

EXAMPLES

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

RETURN DATA

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