NDCTL User Guide
HomePMDKNDCTLBlog
v72.0
v72.0
  • NDCTL User Guide
  • Installing NDCTL, DAXCTL, and CXL-CLI Utilities
    • Installing NDCTL and DAXCTL Packages on Linux
    • Installing the CXL-CLI Package on Linux
    • Installing NDCTL, DAXCTL, and CXL-CLI from Source on Linux
  • Quick Start
  • Concepts
    • NVDIMM Devices
    • PMEM and BLK Modes
    • Regions
      • Regions, Atomic Sectors, and DAX
    • Label Storage Area (LSA)
    • Namespaces
  • Managing NVDIMMs
  • Managing Regions
  • Managing Label Storage Areas (LSA)
  • Managing Namespaces
  • Managing NVDIMM Security
  • NDCTL Man Pages
    • ndctl(1)
    • ndctl-activate-firmware(1)
    • ndctl−check−labels(1)
    • ndctl−check−namespace(1)
    • ndctl−clear−errors(1)
    • ndctl−create−namespace(1)
    • ndctl−destroy−namespace(1)
    • ndctl−disable−dimm(1)
    • ndctl−disable−namespace(1)
    • ndctl−disable−region(1)
    • ndctl−enable−dimm(1)
    • ndctl-enable−namespace(1)
    • ndctl−enable−region(1)
    • ndctl−freeze−security(1)
    • ndctl−init−labels(1)
    • ndctl−inject−error(1)
    • ndctl−inject−smart(1)
    • ndct-list(1)
    • ndctl−load−keys(1)
    • ndctl−monitor(1)
    • ndctl-read-infoblock(1)
    • ndctl−read−labels(1)
    • ndctl−remove−passphrase(1)
    • ndctl−sanitize−dimm(1)
    • ndctl−setup−passphrase(1)
    • ndctl−start−scrub(1)
    • ndctl-update-firmware(1)
    • ndctl-update-passphrase(1)
    • ndctl−wait−overwrite(1)
    • ndctl−wait−scrub(1)
    • ndctl-write-infoblock(1)
    • ndctl−write−labels(1)
    • ndctl−zero−labels(1)
  • DAXCTL Man Pages
    • daxctl(1)
    • daxctl-create-device (1)
    • daxctl-destroy-device (1)
    • daxctl-disable-device (1)
    • daxctl-enable-device (1)
    • daxctl-list(1)
    • daxctl−migrate−device−model(1)
    • daxctl−offline−memory(1)
    • daxctl−online−memory(1)
    • daxctl−reconfigure−device(1)
  • CXL Man Pages
    • cxl(1)
    • cxl-list(1)
    • cxl-read-labels(1)
    • cxl-write-labels(1)
    • cxl-zero-labels(1)
  • Troubleshooting
  • Glossary
  • Reference Material
Powered by GitBook
On this page
  • NAME
  • SYNOPSIS
  • DESCRIPTION
  • OPTIONS
  • SEE ALSO

Was this helpful?

  1. NDCTL Man Pages

ndctl−write−labels(1)

Previousndctl-write-infoblock(1)Nextndctl−zero−labels(1)

Last updated 3 years ago

Was this helpful?

NAME

ndctl−write−labels − write data to the label area on a dimm

SYNOPSIS

ndctl write−labels <nmem> [-i <filename>]

DESCRIPTION

The namespace label area is a small persistent partition of capacity available on some NVDIMM devices. The label area is used to resolve aliasing between pmem and blk capacity by delineating namespace boundaries. Read data from the input filename, or stdin, and write it to the given device. Note that the device must not be active in any region, otherwise the kernel will not allow write access to the device’s label data area.

OPTIONS

One or more nmemX device names. The keyword all can be specified to operate on every dimm in the system, optionally filtered by bus id (see −−bus= option).

−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=

Limit operation to memory devices (dimms) that are on the given bus. Where bus can be a provider name or a bus id number.

−v

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

−i, −−input

input file

SEE ALSO

UEFI NVDIMM Label Protocol

http://www.uefi.org/sites/default/files/resources/UEFI_Spec_2_7.pdf
NAME
SYNOPSIS
DESCRIPTION
OPTIONS
SEE ALSO