IPMCTL User Guide
HomePMDKNDCTLBlog
Version 1.x
Version 1.x
  • IPMCTL User Guide
  • Installing IPMCTL
    • Installing IPMCTL packages on Linux
    • Building and Installing IPMCTL from Source on Linux
    • Installing IPMCTL on Microsoft Windows using the MSI Installer
    • Building and Installing IPMCTL on Microsoft Windows from Source
  • Basic Usage
  • Module Discovery
    • Show System Capabilities
    • Show Socket
    • Show Topology
    • Show Memory Resources
    • Show Device
  • Provisioning
    • Concepts
    • Create Memory Allocation Goal
    • Provision App Direct
    • Provision Memory Mode
    • Provision Mixed Mode
    • Show Memory Allocation Goal
    • Dump Memory Allocation Settings
    • Load Memory Allocation Goal
    • Delete Memory Allocation Goal
  • Security
    • Enable Device Security
    • Change Device Passphrase
    • Change Device Security
    • Erase Device Data
  • Instrumentation
    • Show Sensor
    • Change Sensor Settings
    • Show Device Performance
  • Debug
    • Run Diagnostic
    • Show Error Log
    • Dump Debug Log
    • Show ACPI Tables
    • Show Device Platform Configuration Data
    • Delete Device Platform Configuration Data
    • Inject Error
  • Support and Maintenance
    • Show Events
    • Version and Firmware
Powered by GitBook
On this page
  • DimmHandle
  • DimmUID

Was this helpful?

Module Discovery

Persistent memory modules are uniquely referenced by one of two IDs: DimmHandle or DimmUID. Either ID may be used for commands that utilize the -dimm flag to perform operations on a single module or set of modules. The default is to operate on all modules, which does not require the use of -dimm.

For example, each of the following are equivalent:

    $ ipmctl show -d DimmHandle,DimmUID -dimm 8089-a2-1748-00000001
    $ ipmctl show -d DimmHandle,DimmUID -dimm 0x0001
    $ ipmctl show -d DimmHandle,DimmUID -dimm 1

For simplicity, this document will primarily use DimmUID.

The -dimm option accepts a single DimmUID or a comma separated list of DimmUIDs to filter the results. For example, the following ipmctl show command displays the DimmHandle and DimmUID properties for two modules with IDs of 0x0001 and 0x1001:

    $ ipmctl show -d DimmHandle,DimmUID -dimm 0x0001,0x1001

    ---DimmID=0x0001---
     DimmHandle=0x0001
     DimmUID=8089-a2-1748-00000001
    ---DimmID=0x1001---
     DimmHandle=0x1001
     DimmUID=8089-a2-1748-00000002

DimmHandle

The DimmHandle is equivalent to the DimmUID and is formatted as 0xABCD, where A, B, C, and D are defined as follows:

  • A = Socket

  • B = Memory Controller

  • C = Channel

  • D = Slot

DimmUID

The DimmUID is a unique identifier specific to each physical module. The unique identifier of an Intel Optane DC persistent memory module is formatted as VVVV-ML-MMYYSNSNSNSN or VVVV-SNSNSNSN (if the manufacturing information is not available) where:

  • VVVV = VendorID

  • ML = Manufacturing Location

  • MMYY = Manufacturing Date

  • SNSNSNSN = Serial Number

PreviousBasic UsageNextShow System Capabilities

Last updated 5 years ago

Was this helpful?