'\" t
.\"     Title: daxctl-online-memory
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.10
.\"      Date: 2020-12-22
.\"    Manual: daxctl Manual
.\"    Source: daxctl
.\"  Language: English
.\"
.TH "DAXCTL\-ONLINE\-MEMORY" "1" "2020-12-22" "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\-online\-memory \- Online the memory for a device that is in system\-ram mode
.SH "SYNOPSIS"
.sp
.sp
.nf
\fIdaxctl online\-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, don\(cqt online the memory
.RE
.sp
.if n .RS 4
.nf
# daxctl reconfigure\-device \-\-mode=system\-ram \-\-no\-online \-\-human dax0.0
{
  "chardev":"dax0.0",
  "size":"7.87 GiB (8.45 GB)",
  "target_node":2,
  "mode":"system\-ram"
}
.fi
.if n .RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Online the memory separately
.RE
.sp
.if n .RS 4
.nf
# daxctl online\-memory dax0.0
dax0.0: 62 new sections onlined
onlined memory for 1 device
.fi
.if n .RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Onlining memory when some sections were already online
.RE
.sp
.if n .RS 4
.nf
# daxctl online\-memory dax0.0
dax0.0: 1 section already online
dax0.0: 61 new sections onlined
onlined memory for 1 device
.fi
.if n .RE
.SH "DESCRIPTION"
.sp
Online the memory sections associated with a device that has been converted
to the system\-ram mode. If one or more blocks are already online, print a
message about them, and attempt to online the remaining blocks.
.sp
This is complementary to the \fIdaxctl\-reconfigure\-device\fP command, when used with
the \fI\-\-no\-online\fP option to skip onlining memory sections immediately after the
reconfigure. In these scenarios, the memory can be onlined at a later time using
\fIdaxctl\-online\-memory\fP.
.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
\-\-no\-movable
.RS 4
\fI\-\-movable\fP is the default. This can be overridden to online new
memory such that it is not \fImovable\fP. This allows any allocation
to potentially be served from this memory. This may preclude subsequent
removal. With the \fI\-\-movable\fP behavior (which is default), kernel
allocations will not consider this memory, and it will be reserved
for application use.
.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\-offline\-memory[1]