'\" t
.\"     Title: daxctl-offline-memory
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.12
.\"      Date: 2022-04-08
.\"    Manual: daxctl Manual
.\"    Source: daxctl
.\"  Language: English
.\"
.TH "DAXCTL\-OFFLINE\-MEMORY" "1" "2022-04-08" "daxctl" "daxctl 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"
daxctl\-offline\-memory \- Offline the memory for a device that is in system\-ram mode
.SH "SYNOPSIS"
.sp
.sp
.nf
\fIdaxctl offline\-memory\fP <dax0.0> [<dax1.0>...<daxY.Z>] [<options>]
.fi
.br
.SH "EXAMPLES"
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Reconfigure dax0.0 to system\-ram mode
.RE
.sp
.if n .RS 4
.nf
.fam C
# daxctl reconfigure\-device \-\-mode=system\-ram \-\-human dax0.0
{
  "chardev":"dax0.0",
  "size":"7.87 GiB (8.45 GB)",
  "target_node":2,
  "mode":"system\-ram"
}
.fam
.fi
.if n .RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Offline the memory
.RE
.sp
.if n .RS 4
.nf
.fam C
# daxctl offline\-memory dax0.0
dax0.0: 62 sections offlined
offlined memory for 1 device
.fam
.fi
.if n .RE
.SH "DESCRIPTION"
.sp
Offline the memory sections associated with a device that has been converted
to the system\-ram mode. If one or more blocks are already offline, attempt to
offline the remaining blocks. If all blocks were already offline, print a
message and return success without actually doing anything.
.sp
This is complementary to the \fIdaxctl\-online\-memory\fP command, and may be used
when it is wished to offline the memory sections, but not convert the device
back to \fIdevdax\fP mode.
.SH "OPTIONS"
.sp
\-r, \-\-region=
.RS 4
Restrict the operation to devices belonging to the specified region(s).
A device\-dax region is a contiguous range of memory that hosts one or
more /dev/daxX.Y devices, where X is the region id and Y is the device
instance id.
.RE
.sp
\-u, \-\-human
.RS 4
By default the command will output machine\-friendly raw\-integer
data. Instead, with this flag, numbers representing storage size
will be formatted as human readable strings with units, other
fields are converted to hexadecimal strings.
.RE
.sp
\-v, \-\-verbose
.RS 4
Emit more debug messages
.RE
.SH "COPYRIGHT"
.sp
Copyright \(co 2016 \- 2020, Intel Corporation. License GPLv2: GNU GPL
version 2 \c
.URL "http://gnu.org/licenses/gpl.html" "" "."
This is free software:
you are free to change and redistribute it.  There is NO WARRANTY, to
the extent permitted by law.
.SH "SEE ALSO"
.sp
daxctl\-reconfigure\-device(1),daxctl\-online\-memory[1]