1NDCTL-WRITE-LABELS(1)            ndctl Manual            NDCTL-WRITE-LABELS(1)
2
3
4

NAME

6       ndctl-write-labels - write data to the label area on a dimm
7

SYNOPSIS

9       ndctl write-labels <nmem> [-i <filename>]
10

DESCRIPTION

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

OPTIONS

21       <memory device(s)>
22           A nmemX device name, or a dimm id number. Restrict the operation to
23           the specified dimm(s). The keyword all can be specified to indicate
24           the lack of any restriction, however this is the same as not
25           supplying a --dimm option at all.
26
27       -s, --size=
28           Limit the operation to the given number of bytes. A size of 0
29           indicates to operate over the entire label capacity.
30
31       -O, --offset=
32           Begin the operation at the given offset into the label area.
33
34       -b, --bus=
35           A bus id number, or a provider string (e.g. "ACPI.NFIT"). Restrict
36           the operation to the specified bus(es). The keyword all can be
37           specified to indicate the lack of any restriction, however this is
38           the same as not supplying a --bus option at all.
39
40       -v
41           Turn on verbose debug messages in the library (if ndctl was built
42           with logging and debug enabled).
43
44       -i, --input
45           input file
46

SEE ALSO

48       UEFI NVDIMM Label Protocol[1]
49

NOTES

51        1. UEFI NVDIMM Label Protocol
52           http://www.uefi.org/sites/default/files/resources/UEFI_Spec_2_7.pdf
53
54
55
56ndctl 71.1                        07/22/2021             NDCTL-WRITE-LABELS(1)
Impressum