# Show Memory Resources

Show the total Intel Optane persistent memory resource allocation across the host server.

```
ipmctl show [OPTIONS] -memoryresources
```

## **Examples**

### AppDirect

The following shows persistent memory module resource allocation from a system configured in 100% AppDirect mode:

```
$ ipmctl show -memoryresources
 MemoryType   | DDR         | PMemModule   | Total
==========================================================
 Volatile     | 381.500 GiB | 0.000 GiB    | 381.500 GiB
 AppDirect    | -           | 3024.000 GiB | 3024.000 GiB
 Cache        | 0.000 GiB   | -            | 0.000 GiB
 Inaccessible | 2.500 GiB   | 5.452 GiB    | 7.952 GiB
 Physical     | 384.000 GiB | 3029.452 GiB | 3413.452 GiB
```

### Human Readable Output

Show persistent memory module resource allocation with human-readable output (MiB and TiB).

```
# ipmctl show -units MiB -memoryresources
 MemoryType   | DDR            | PMemModule      | Total
===================================================================
 Volatile     | 390656.000 MiB | 0.000 MiB       | 390656.000 MiB
 AppDirect    | -              | 3096576.000 MiB | 3096576.000 MiB
 Cache        | 0.000 MiB      | -               | 0.000 MiB
 Inaccessible | 2560.000 MiB   | 5583.000 MiB    | 8143.000 MiB
 Physical     | 393216.000 MiB | 3102159.000 MiB | 3495375.000 MiB

 
 # ipmctl show -units TiB -memoryresources
 MemoryType   | DDR       | PMemModule | Total
===================================================
 Volatile     | 0.373 TiB | 0.000 TiB  | 0.373 TiB
 AppDirect    | -         | 2.953 TiB  | 2.953 TiB
 Cache        | 0.000 TiB | -          | 0.000 TiB
 Inaccessible | 0.002 TiB | 0.005 TiB  | 0.008 TiB
 Physical     | 0.375 TiB | 2.958 TiB  | 3.333 TiB
```

## **Return Data**

* `Volatile DDR Capacity`: Total DDR capacity that is used as volatile memory.
* `Volatile PMem module Capacity`: Total PMem module capacity that is used as volatile memory.
* `Total Volatile Capacity`: Total DDR and PMem module capacity that is used as volatile memory.
* `AppDirect PMem module Capacity`: Total PMem module capacity used as persistent memory.
* `Total AppDirect Capacity`: Total DDR and PMem module capacity used as persistent memory.
* `Cache DDR Capacity`: Total DDR capacity used as a cache for PMem modules.
* `Total Cache Capacity`: Total DDR capacity used as a cache for PMem modules.
* `Inaccessible DDR Capacity`: Total DDR capacity that is inaccessible.
* `InaccessibleCapacity`: Total system persistent memory capacity that is inaccessible due to any of:
  * Platform configuration prevents accessing this capacity. For example, MemoryCapacity is configured but MemoryMode is not enabled by platform FW (current Memory Mode is 1LM).
  * Capacity is inaccessible because it is not mapped into the System Physical Address space (SPA). This is usually due to platform firmware memory alignment requirements.
  * Persistent capacity that is reserved. This capacity is the persistent memory partition capacity (rounded down for alignment) less any App Direct capacity. Reserved capacity typically results from a Memory Allocation Goal request that specified the Reserved property. This capacity is not mapped to System Physical Address space (SPA).
  * Capacity that is unusable because it has not been configured.
  * PMem module configured capacity but SKU prevents usage. For example, AppDirectCapacity but PMem module SKU is MemoryMode only.
* `Total Inaccessible Capacity`: Total capacity of DDR and PMem module that is inaccessible.
* `Physical DDR Capacity`: Total physical DDR capacity populated on the platform.
* `Physical PMem module Capacity`: Total physical PMem module capacity populated on the platform.
* `Total Physical Capacity`: Total physical capacity populated on the platform.


---

# 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-memory-resources.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.