'\" t
.\"     Title: ipmctl-show-topology
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.16
.\"      Date: 2022-09-26
.\"    Manual: ipmctl
.\"    Source: ipmctl
.\"  Language: English
.\"
.TH "IPMCTL\-SHOW\-TOPOLOGY" "1" "2022-09-26" "ipmctl" "ipmctl"
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.ss \n[.ss] 0
.nh
.ad l
.de URL
\fI\\$2\fP <\\$1>\\$3
..
.als MTO URL
.if \n[.g] \{\
.  mso www.tmac
.  am URL
.    ad l
.  .
.  am MTO
.    ad l
.  .
.  LINKSTYLE blue R < >
.\}
.SH "NAME"
ipmctl-show-topology \- Shows the topology of the memory installed
.SH "SYNOPSIS"
.sp
.if n .RS 4
.nf
.fam C
ipmctl show [OPTIONS] \-topology [TARGETS]
.fam
.fi
.if n .RE
.SH "DESCRIPTION"
.sp
Shows the topology of the memory installed in the host server. Use the command
ipmctl\-show\-dimm to view more detailed information about a PMem module.
.SH "OPTIONS"
.sp
\-a, \-all
.RS 4
Shows all attributes.
.RE
.sp
\-h, \-help
.RS 4
Displays help for the command.
.RE
.sp
\-ddrt
.RS 4
Used to specify DDRT as the desired transport protocol for the current invocation of ipmctl.
.RE
.sp
\-smbus
.RS 4
Used to specify SMBUS as the desired transport protocol for the current invocation of ipmctl.
.RE
.if n .sp
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
.B Note
.ps -1
.br
.sp
The \-ddrt and \-smbus options are mutually exclusive and may not be used together.
.sp .5v
.RE
.sp
\-o (text|nvmxml), \-output (text|nvmxml)
.RS 4
Changes the output format. One of: "text" (default) or "nvmxml".
.RE
.sp
\-u (B|MB|MiB|GB|GiB|TB| TiB), \-units (B|MB|MiB|GB|GiB|TB| TiB)
.RS 4
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).
.RE
.SH "TARGETS"
.sp
\-dimm [DimmIDs]
.RS 4
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.
.RE
.sp
\-socket [SocketIDs]
.RS 4
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.
.RE
.if n .sp
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
.B Note
.ps -1
.br
.sp
If ACPI PMTT table is not present, then DDR memory will not be
displayed in the filtered socket list.
.sp .5v
.RE
.SH "EXAMPLES"
.sp
Displays the system memory topology.
.sp
.if n .RS 4
.nf
.fam C
ipmctl show \-topology
.fam
.fi
.if n .RE
.SH "RETURN DATA"
.sp
Displays a table with the attributes listed below for each memory module installed
in the host server.
.sp
MemoryType
.RS 4
(Default) The DIMM type. One of:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Unknown
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
DDR4
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
DDR5
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Logical Non\-volatile Device
.RE
.RE
.sp
Capacity
.RS 4
(Default) The raw capacity of the PMem module as reported in the SMBIOS Type 17
table.
.RE
.sp
DimmID
.RS 4
(Default) The DIMM identifier. For DRAM DIMMs, the DimmID is "N/A".
.RE
.sp
PhysicalID
.RS 4
(Default) The PMem module physical identifier (i.e., SMBIOS Type 17 handle).
.RE
.sp
DeviceLocator
.RS 4
(Default) The string that identifies the physically labeled socket or board
position where the PMem module is located.
.RE
.sp
SocketID
.RS 4
The processor socket identifier (i.e., NUMA node) where the PMem module is installed.
.RE
.sp
DieID
.RS 4
The processor die identifier where the PMem module is installed.
.RE
.sp
MemControllerID
.RS 4
The associated memory controller identifier.
.RE
.sp
ChannelID
.RS 4
The associated channel. For DRAM DIMMs, the channel identifier is "N/A".
.RE
.sp
ChannelPos
.RS 4
The PMem module position in the channel.
.RE
.sp
NodeControllerID
.RS 4
The node controller identifier.
.RE
.sp
BankLabel
.RS 4
The string that identifies the physically labeled bank where the PMem module is
located.
.RE