# Show Memory Resources

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

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

## **Example**

Show persistent memory module resource allocation.

```
$ ipmctl show -memoryresources

Capacity=1517.0 GiB
MemoryCapacity=0.0 GiB
AppDirectCapacity=1512.0 GiB
UnconfiguredCapacity=0.0 GiB
InaccessibleCapacity=5.0 GiB
ReservedCapacity=0.0 GiB
```

## **Return Data**

* `MemoryCapacity`: Total usable system persistent memory for Memory Mode.
* `AppDirectCapacity`: Total usable system persistent memory for App Direct mode.
* `UnconfiguredCapacity`: Total system persistent memory capacity that is unusable because it has not been configured.
* `ReservedCapacity`: Total system persistent memory 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 (SPA) space.
* `InaccessibleCapacity`: Total system persistent memory capacity that is inaccessible due any of:
  * Platform configuration prevents accessing this capacity. e.g. MemoryCapacity is configured but MemoryMode is not enabled by platform FW (current operating 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.
  * Intel Optane DC persistent memory is configured but SKU prevents usage. e.g. AppDirectCapacity but  SKU is MemoryMode only.


---

# 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/v1.x/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.
