NDCTL User Guide

Introduction

ndctl is a utility for managing the Linux LIBNVDIMM Kernel subsystem. It is designed to work with various non-volatile memory devices (NVDIMMs) from different vendors. The LIBNVDIMM subsystem defines a kernel device model and control message interface for platform NVDIMM resources like those defined by the ACPI v6.0 NFIT (NVDIMM Firmware Interface Table). The latest ACPI and UEFI specifications can be found at uefi.org. Operations supported by ndctl include:

• Provisioning capacity (namespaces)

• Enumerating Devices

• Enabling and Disabling NVDIMMs, Regions, and Namespaces

• Managing NVDIMM Labels

What's new in v67

This release incorporates functionality up to the 5.4 kernel, and adds a number of bug fixes, and improvements.

Highlights include small changes for PowerPC compatibility, improvements to the dax.sh unit test to detect failures in mapping huge pages, support for the 'security frozen' attribute, user experience improvements for the daxctl-reconfigure-device command, including an option to specify movable vs. non-movable state for onlining memory, and an option to allow create-namespaces to create a maximal configuration until it exhausts all available region capacity.

Commands:

• create-namespace: add --continue option

• daxctl-reconfigure-device: add --no-movable option

• daxctl-reconfigure-device: display movable state in listings

• daxctl-reconfigure-device: detect races in memory onlining

• ndctl-freeze-security: support for 'security frozen' attribute

APIs:

• ndctl_dimm_security_is_frozen

• daxctl_memory_is_movable

• daxctl_memory_online_no_movable