'\" t
.\"     Title: cxl-write-labels
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.23
.\"      Date: 2025-01-23
.\"    Manual: cxl Manual
.\"    Source: cxl
.\"  Language: English
.\"
.TH "CXL\-WRITE\-LABELS" "1" "2025-01-23" "cxl" "cxl Manual"
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.ss \n[.ss] 0
.nh
.ad l
.de URL
\fI\\$2\fP <\\$1>\\$3
..
.als MTO URL
.if \n[.g] \{\
.  mso www.tmac
.  am URL
.    ad l
.  .
.  am MTO
.    ad l
.  .
.  LINKSTYLE blue R < >
.\}
.SH "NAME"
cxl-write-labels \- write data to the label area on a memdev
.SH "SYNOPSIS"
.sp
.nf
\fIcxl write\-labels <mem> [\-i <filename>]\fP
.fi
.br
.SH "DESCRIPTION"
.sp
The region label area is a small persistent partition of capacity
available on some CXL memory devices. The label area is used to
and configure or determine the set of memory devices participating
in different interleave sets.
Read data from the input filename, or stdin, and write it to the given
<mem> device. Note that the device must not be active in any region, or
actively registered with the nvdimm subsystem. If it is, the kernel will
not allow write access to the device\(cqs label data area.
.SH "OPTIONS"
.sp
<memory device(s)>
.RS 4
A \fImemX\fP device name, or a memdev id number. Restrict the operation to
the specified memdev(s). The keyword \fIall\fP can be specified to indicate
the lack of any restriction.
.RE
.sp
\-S, \-\-serial
.RS 4
Rather an a memdev id number, interpret the <memdev> argument(s)
as a list of serial numbers.
.RE
.sp
\-s, \-\-size=
.RS 4
Limit the operation to the given number of bytes. A size of 0
indicates to operate over the entire label capacity.
.RE
.sp
\-O, \-\-offset=
.RS 4
Begin the operation at the given offset into the label area.
.RE
.sp
\-v
.RS 4
Turn on verbose debug messages in the library (if libcxl was built with
logging and debug enabled).
.RE
.sp
\-i, \-\-input
.RS 4
input file
.RE
.SH "SEE ALSO"
.sp
cxl\-read\-labels(1),
cxl\-zero\-labels(1),
CXL\-2.0 9.13.2