ipmctl-set-preferences - Man Page
Modifies one or more user preferences
Synopsis
ipmctl set [OPTIONS] -preferences [PROPERTIES]
Description
Modifies one or more user preferences in the PMem module software.
Options
- -h, ā-help
Displays help for the command.
- -ddrt
Used to specify DDRT as the desired transport protocol for the current invocation of ipmctl.
- -smbus
Used to specify SMBUS as the desired transport protocol for the current invocation of ipmctl.
NoteThe -ddrt and -smbus options are mutually exclusive and may not be used together.
- -o (text|nvmxml), -output (text|nvmxml)
Changes the output format. One of: "text" (default) or "nvmxml".
Properties
- CLI_DEFAULT_DIMM_ID
The default display of PMem module identifiers. One of:
- "UID": Use the DimmUID attribute as defined in the section [Show Dimm].
- "HANDLE": Use the DimmHandle attribute as defined in section [Show Dimm]. This is the default
- CLI_DEFAULT_SIZE
The default display of capacities in the CLI. One of:
- "AUTO": Automatically choose the best format for each capacity in binary multiples of bytes (i.e., B, MiB, GiB or TiB). This is the default.
- "AUTO_10": Automatically choose the best format for each capacity in decimal multiples of bytes (i.e., B, MB, GB or TB).
- "B": Displays all capacities in bytes.
- "MB": Displays all capacities in megabytes.
- "MiB": Displays all capacities in mebibytes.
- "GB": Displays all capacities in gigabytes.
- "GiB": Displays all capacities in gibibytes.
- "TB": Displays all capacities in terabytes.
- "TiB": Displays all capacities in tebibytes.
- APPDIRECT_SETTINGS
The interleave settings to use when creating App Direct capacity in the format: (IMCSize_ChannelSize). Must be one of the BIOS supported App Direct settings returned by the command [Show System Capabilities].
NoteByOne is not a valid setting for this preference. The default is "RECOMMENDED" which uses the BIOS recommended App Direct settings.
Note
The same interleave settings are used for all the App Direct capacity in the system. Therefore, if any App Direct capacity already exists, this preference cannot be changed.
- DBG_LOG_LEVEL
Whether debug logging is enabled in the PMem module host software. These logs pertain to the operation of the command-line tool only and do not reflect any logging functionality of the PMem module. One of:
- "0": Logging is disabled. This is the default.
- "1": Log Errors.
- "2": Log Warnings, Errors.
- "3": Log Informational, Warnings, Errors.
- "4": Log Verbose, Informational, Warnings, Errors.
Examples
Use DimmUID as the default PMem module identifier and display all capacities in bytes.
ipmctl set -preferences CLI_DEFAULT_DIMM_ID=UID CLI_DEFAULT_SIZE=B
Return Data
Returns the status of the operation.
Sample Output
Set (Property)=(Value): Success|Error (Code)-(Description)