'\" t
.\"     Title: ipmctl-dump-goal
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.18
.\"      Date: 2023-06-12
.\"    Manual: ipmctl
.\"    Source: ipmctl
.\"  Language: English
.\"
.TH "IPMCTL\-DUMP\-GOAL" "1" "2023-06-12" "ipmctl" "ipmctl"
.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"
ipmctl-dump-goal \- Stores the current configured memory allocation settings to a file
.SH "SYNOPSIS"
.sp
.if n .RS 4
.nf
.fam C
ipmctl dump [OPTIONS] \-destination (path) \-system \-config
.fam
.fi
.if n .RE
.SH "DESCRIPTION"
.sp
Store the currently configured memory allocation settings for all PMem modules in the
system to a file in order to replicate the configuration elsewhere. Apply the
stored memory allocation settings using the command Section
[Load Memory Allocation Goal].
.SH "OPTIONS"
.sp
\-h, \-help
.RS 4
Displays help for the command.
.RE
.sp
\-ddrt
.RS 4
Used to specify DDRT as the desired transport protocol for the current invocation of ipmctl.
.RE
.sp
\-smbus
.RS 4
Used to specify SMBUS as the desired transport protocol for the current invocation of ipmctl.
.RE
.if n .sp
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
.B Note
.ps -1
.br
.sp
The \-ddrt and \-smbus options are mutually exclusive and may not be used together.
.sp .5v
.RE
.sp
\-lpmb
.RS 4
Used to specify large transport payload size for the current invocation of ipmctl.
.RE
.sp
\-spmb
.RS 4
Used to specify small transport payload size for the current invocation of ipmctl.
.RE
.if n .sp
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
.B Note
.ps -1
.br
.sp
The \-lpmb and \-spmb options are mutually exclusive and may not be used together.
.sp .5v
.RE
.sp
\-o (text|nvmxml), \-output (text|nvmxml)
.RS 4
Changes the output format. One of: "text" (default) or "nvmxml".
.RE
.SH "EXAMPLES"
.sp
Stores the memory allocation settings from all the PMem modules into the file "config.txt".
.sp
.if n .RS 4
.nf
.fam C
ipmctl dump \-destination config.txt \-system \-config
.fam
.fi
.if n .RE
.SH "LIMITATIONS"
.sp
In order to successfully execute this command:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
The caller must have the appropriate privileges.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Only memory allocation settings for manageable PMem modules that have been
successfully applied by the BIOS are stored in the file. Unconfigured PMem modules are
not included, nor are memory allocation goals that have not been applied.
.RE
.SH "RETURN DATA"
.sp
The CLI will indicate the overall status of the operation when complete. If a
failure occurs when dumping the memory allocation from multiple PMem modules, the
process will stop and the output file will be removed.
.sp
The output file is formatted as an ASCII file with one row per PMem module containing
the following comma separated values.
.sp
SocketID
.RS 4
Identifier for the socket the PMem module is associated with.
.RE
.sp
DimmHandle
.RS 4
PMem module device handle.
.RE
.sp
Capacity
.RS 4
Total capacity of the PMem module in GiB.
.RE
.sp
MemorySize
.RS 4
Capacity of the PMem module allocated as Memory Mode in GiB.
.RE
.sp
AppDirect1Size
.RS 4
Capacity of the PMem module allocated for the first App
Direct interleave set in GiB.
.RE
.sp
AppDirect1Format
.RS 4
Bit mask representing the interleave format of the first
App Direct interleave set.
.RE
.sp
AppDirect1Index
.RS 4
Unique index of the first App Direct interleave set.
.RE
.sp
AppDirect2Size
.RS 4
Capacity of the PMem module allocated for the second App
Direct interleave set in GiB.
.RE
.sp
AppDirect2Format
.RS 4
Bit mask representing the interleave format of the second
App Direct interleave set.
.RE
.sp
AppDirect2Index
.RS 4
Unique index of the second App Direct interleave set.
.RE
.SH "SAMPLE OUTPUT"
.sp
.if n .RS 4
.nf
.fam C
Successfully dumped system configuration to file: config.csv
.fam
.fi
.if n .RE
.sp
config.csv contents:
.sp
.if n .RS 4
.nf
.fam C
#SocketID,DimmHandle,Capacity,MemorySize,AppDirect1Size,AppDirect
1Format,AppDirect1Index,AppDirect2Size,AppDirect2Format,AppDirect2Index
1,4385,64,64,0,0,0,0,0,0
1,4401,64,64,0,0,0,0,0,0
1,4417,64,64,0,0,0,0,0,0
1,4433,64,64,0,0,0,0,0,0
1,4449,64,64,0,0,0,0,0,0
.fam
.fi
.if n .RE