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

NAME

6       ndctl-read-labels - read out the label area on a dimm or set of dimms
7

SYNOPSIS

9       ndctl read-labels <nmem0> [<nmem1>..<nmemN>] [<options>]
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. This command dumps the raw binary data in a dimm’s label
16       area to stdout or a file. In the multi-dimm case the data is
17       concatenated.
18

OPTIONS

20       <memory device(s)>
21           One or more nmemX device names. The keyword all can be specified to
22           operate on every dimm in the system, optionally filtered by bus id
23           (see
24                  --bus= option).
25
26       -s, --size=
27           Limit the operation to the given number of bytes. A size of 0
28           indicates to operate over the entire label capacity.
29
30       -O, --offset=
31           Begin the operation at the given offset into the label area.
32
33       -b, --bus=
34           Limit operation to memory devices (dimms) that are on the given
35           bus. Where bus can be a provider name or a bus id number.
36
37       -v
38           Turn on verbose debug messages in the library (if ndctl was built
39           with logging and debug enabled).
40
41       -I, --index
42           Limit the span of the label operation to just the index-block area.
43           This is useful to determine if the dimm label area is initialized.
44           Note that this option and --size/--offset are mutually exclusive.
45
46       -o, --output
47           output file
48
49       -j, --json
50           parse the label data into json assuming the NVDIMM Namespace
51           Specification format.
52
53       -u, --human
54           enable json output and convert number formats to human readable
55           strings, for example show the size in terms of "KB", "MB", "GB",
56           etc instead of a signed 64-bit numbers per the JSON interchange
57           format (implies --json).
58

60       Copyright (c) 2016 - 2019, Intel Corporation. License GPLv2: GNU GPL
61       version 2 <http://gnu.org/licenses/gpl.html>. This  is  free  software:
62       you  are  free  to change and redistribute it. There is NO WARRANTY, to
63       the extent permitted by law.
64

SEE ALSO

66       UEFI NVDIMM Label Protocol <http://www.uefi.org/sites/default/files/
67       resources/UEFI_Spec_2_7.pdf>
68
69
70
71ndctl                             2019-10-28              NDCTL-READ-LABELS(1)
Impressum