NDCTL-CHECK-LABELS(1) ndctl Manual NDCTL-CHECK-LABELS(1)

# [NAME](#NAME)

ndctl-check-labels - determine if the given dimms have a valid namespace index block

# [SYNOPSIS](#SYNOPSIS)

```
ndctl check-labels <nmem0> [<nmem1>..<nmemN>] [<options>]
```

# [DESCRIPTION](#DESCRIPTION)

The namespace label area is a small persistent partition of capacity available on some NVDIMM devices. The label area is used to provision one, or more, namespaces from regions. In addition to checking if a label area has a valid index block, running this command in verbose mode reports the reason the index block is deemed invalid.

# [OPTIONS](#OPTIONS)

&lt;memory device(s)&gt;

A *nmemX* device name, or a dimm id number. Restrict the operation to the specified dimm(s). The keyword *all* can be specified to indicate the lack of any restriction, however this is the same as not supplying a --dimm option at all.

-s, --size=

Limit the operation to the given number of bytes. A size of 0 indicates to operate over the entire label capacity.

-O, --offset=

Begin the operation at the given offset into the label area.

-b, --bus=

A bus id number, or a provider string (e.g. "ACPI.NFIT"). Restrict the operation to the specified bus(es). The keyword *all* can be specified to indicate the lack of any restriction, however this is the same as not supplying a --bus option at all.

-v

Turn on verbose debug messages in the library (if ndctl was built with logging and debug enabled).

# [COPYRIGHT](#COPYRIGHT)

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

# [SEE ALSO](#SEE_ALSO)

*UEFI NVDIMM Label Protocol* &lt;http://www.uefi.org/sites/default/files/resources/UEFI\_Spec\_2\_7.pdf&gt;

2026-08-31 ndctl

---

Document: ndctl-check-labels(1) from ndctl 85-r2 (Chainguard OS)
Source: https://github.com/pmem/ndctl