# cxl-list(1)

## NAME 

cxl-list - List CXL capable memory devices, and their attributes in json.

## SYNOPSIS 

`cxl list [<options>]`

Walk the CXL capable device hierarchy in the system and list all device instances along with some of their major attributes.

## EXAMPLE&#x20;

`# cxl list --memdevs { "memdev":"mem0", "pmem_size":268435456, "ram_size":0, }`

## OPTIONS&#x20;

-m, --memdev= Specify a cxl memory device name to filter the listing. For example:

```
# cxl list --memdevs
{
 "memdev":"mem0",
 "pmem_size":268435456,
 "ram_size":0,
}
```

-M, --memdevs&#x20;

&#x20;   Include CXL memory devices in the listing

-i, --idle&#x20;

&#x20;   Include idle (not enabled / zero-sized) devices in the listing

-H, --health&#x20;

&#x20;   Include health information in the memdev listing. Example listing:

```
# cxl list -m mem0 -H
[
 {
   "memdev":"mem0",
   "pmem_size":268435456,
   "ram_size":268435456,
   "health":{
	 "maintenance_needed":true,
	 "performance_degraded":true,
	 "hw_replacement_needed":true,
	 "media_normal":false,
	 "media_not_ready":false,
	 "media_persistence_lost":false,
	 "media_data_lost":true,
	 "media_powerloss_persistence_loss":false,
	 "media_shutdown_persistence_loss":false,
	 "media_persistence_loss_imminent":false,
	 "media_powerloss_data_loss":false,
	 "media_shutdown_data_loss":false,
	 "media_data_loss_imminent":false,
	 "ext_life_used":"normal",
	 "ext_temperature":"critical",
	 "ext_corrected_volatile":"warning",
	 "ext_corrected_persistent":"normal",
	 "life_used_percent":15,
	 "temperature":25,
	 "dirty_shutdowns":10,
	 "volatile_errors":20,
	 "pmem_errors":30
   }
 }
]
```

-u, --human&#x20;

&#x20;   By default the command will output machine-friendly raw-integer data. Instead, with this flag, numbers representing storage size will be formatted as human readable strings with units, other fields are converted to hexadecimal strings.

-v, --verbose&#x20;

&#x20;   Emit more debug messages

## COPYRIGHT&#x20;

Copyright © 2016 - 2020, Intel Corporation. License GPLv2: GNU GPL version 2 <http://gnu.org/licenses/gpl.html>. This is free software: you are free to change and redistribute it. There is NO WARRANTY, to the extent permitted by law.

## SEE ALSO&#x20;

[ndctl-list(1)](https://docs.pmem.io/ndctl-user-guide/v72.0/ndctl-man-pages/ndctl-list)


---

# 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/ndctl-user-guide/v72.0/cxl-man-pages/cxl-list-1.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.