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       PMem 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 DDR4 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 PMem
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           •   Logical Non-volatile Device
75
76       Capacity
77           (Default) The raw capacity of the PMem module as reported in the
78           SMBIOS Type 17 table.
79
80       DimmID
81           (Default) The DIMM identifier. For DRAM DIMMs, the DimmID is "N/A".
82
83       PhysicalID
84           (Default) The PMem module physical identifier (i.e., SMBIOS Type 17
85           handle).
86
87       DeviceLocator
88           (Default) The string that identifies the physically labeled socket
89           or board position where the PMem module is located.
90
91       SocketID
92           The processor socket identifier (i.e., NUMA node) where the PMem
93           module is installed.
94
95       DieID
96           The processor die identifier where the PMem module is installed.
97
98       MemControllerID
99           The associated memory controller identifier.
100
101       ChannelID
102           The associated channel. For DRAM DIMMs, the channel identifier is
103           "N/A".
104
105       ChannelPos
106           The PMem module position in the channel.
107
108       NodeControllerID
109           The node controller identifier.
110
111       BankLabel
112           The string that identifies the physically labeled bank where the
113           PMem module is located.
114
115
116
117ipmctl                            2022-02-01           IPMCTL-SHOW-TOPOLOGY(1)
Impressum