# Show Topology

Shows the topology of DDR and persistent memory modules installed in the host server.

```
ipmctl show [OPTIONS] -topology [TARGETS]
```

## **Targets**

* `-dimm [(DimmIDs)]`: Restricts output to specific DIMMs by optionally supplying the DIMM target and one or more comma-separated DIMM identifiers. The default is to display all DIMMs.
* `-socket (SocketIDs)`: Restricts output to the DIMMs installed on specific sockets by supplying the socket target and one or more comma-separated socket identifiers. The default is to display all sockets.
  * If ACPI PMTT table is not present, then DDR4 memory will not be displayed in the filtered socket list.

## **Examples**

Display all DDR and Optane persistent memory modules installed in the system

```
$ ipmctl show -topology

 DimmID | MemoryType                  | Capacity  | PhysicalID| DeviceLocator
==============================================================================
 0x0001 | Logical Non-Volatile Device | 126.3 GiB | 0x0028    | CPU1_DIMM_A2
 0x0011 | Logical Non-Volatile Device | 126.3 GiB | 0x002c    | CPU1_DIMM_B2
 0x0021 | Logical Non-Volatile Device | 126.3 GiB | 0x0030    | CPU1_DIMM_C2
 0x0101 | Logical Non-Volatile Device | 126.3 GiB | 0x0036    | CPU1_DIMM_D2
 0x0111 | Logical Non-Volatile Device | 126.3 GiB | 0x003a    | CPU1_DIMM_E2
 0x0121 | Logical Non-Volatile Device | 126.3 GiB | 0x003e    | CPU1_DIMM_F2
 0x1001 | Logical Non-Volatile Device | 126.3 GiB | 0x0044    | CPU2_DIMM_A2
 0x1011 | Logical Non-Volatile Device | 126.3 GiB | 0x0048    | CPU2_DIMM_B2
 0x1021 | Logical Non-Volatile Device | 126.3 GiB | 0x004c    | CPU2_DIMM_C2
 0x1101 | Logical Non-Volatile Device | 126.3 GiB | 0x0052    | CPU2_DIMM_D2
 0x1111 | Logical Non-Volatile Device | 126.3 GiB | 0x0056    | CPU2_DIMM_E2
 0x1121 | Logical Non-Volatile Device | 126.3 GiB | 0x005a    | CPU2_DIMM_F2
 N/A    | DDR4                        | 16.0 GiB  | 0x0026    | CPU1_DIMM_A1
 N/A    | DDR4                        | 16.0 GiB  | 0x002a    | CPU1_DIMM_B1
 N/A    | DDR4                        | 16.0 GiB  | 0x002e    | CPU1_DIMM_C1
 N/A    | DDR4                        | 16.0 GiB  | 0x0034    | CPU1_DIMM_D1
 N/A    | DDR4                        | 16.0 GiB  | 0x0038    | CPU1_DIMM_E1
 N/A    | DDR4                        | 16.0 GiB  | 0x003c    | CPU1_DIMM_F1
 N/A    | DDR4                        | 16.0 GiB  | 0x0042    | CPU2_DIMM_A1
 N/A    | DDR4                        | 16.0 GiB  | 0x0046    | CPU2_DIMM_B1
 N/A    | DDR4                        | 16.0 GiB  | 0x004a    | CPU2_DIMM_C1
 N/A    | DDR4                        | 16.0 GiB  | 0x0050    | CPU2_DIMM_D1
 N/A    | DDR4                        | 16.0 GiB  | 0x0054    | CPU2_DIMM_E1
 N/A    | DDR4                        | 16.0 GiB  | 0x0058    | CPU2_DIMM_F1
```

Display all DDR and Optane persistent memory installed in CPU Socket 0

```
# ipmctl show -topology -socket 0
 DimmID | MemoryType                  | Capacity    | PhysicalID| DeviceLocator
================================================================================
 0x0001 | Logical Non-Volatile Device | 252.438 GiB | 0x0026    | CPU1_DIMM_A2
 0x0011 | Logical Non-Volatile Device | 252.438 GiB | 0x0028    | CPU1_DIMM_B2
 0x0021 | Logical Non-Volatile Device | 252.438 GiB | 0x002a    | CPU1_DIMM_C2
 0x0101 | Logical Non-Volatile Device | 252.438 GiB | 0x002c    | CPU1_DIMM_D2
 0x0111 | Logical Non-Volatile Device | 252.438 GiB | 0x002e    | CPU1_DIMM_E2
 0x0121 | Logical Non-Volatile Device | 252.438 GiB | 0x0030    | CPU1_DIMM_F2
 N/A    | DDR4                        | 32.000 GiB  | 0x0025    | CPU1_DIMM_A1
 N/A    | DDR4                        | 32.000 GiB  | 0x0027    | CPU1_DIMM_B1
 N/A    | DDR4                        | 32.000 GiB  | 0x0029    | CPU1_DIMM_C1
 N/A    | DDR4                        | 32.000 GiB  | 0x002b    | CPU1_DIMM_D1
 N/A    | DDR4                        | 32.000 GiB  | 0x002d    | CPU1_DIMM_E1
 N/A    | DDR4                        | 32.000 GiB  | 0x002f    | CPU1_DIMM_F1
```

 Display information for Optane persistent memory modules 0x0001 and 0x101

```
# ipmctl show -topology -dimm 0x0001,0x0101
 DimmID | MemoryType                  | Capacity    | PhysicalID| DeviceLocator
================================================================================
 0x0001 | Logical Non-Volatile Device | 252.438 GiB | 0x0026    | CPU1_DIMM_A2
 0x0101 | Logical Non-Volatile Device | 252.438 GiB | 0x002c    | CPU1_DIMM_D2
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.pmem.io/ipmctl-user-guide/module-discovery/show-topology.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.