NAME

       ipmctl-show-sensor - Shows sensor data for one or more DCPMMs

SYNOPSIS

       ipmctl show [OPTIONS] -sensor [SENSORS] [TARGETS]

DESCRIPTION

       Shows sensor data for one or more DCPMMs. This data includes DCPMM health, temperatures, percentage
       remaining, up-time and more.

OPTIONS

       -a, -all
           Shows all attributes.

           Note

           The all and display options are exclusive and may not be used together.

       -d (attributes), -display (attributes)
           Filters the returned attributes by explicitly specifying a comma-separated list of any of the
           attributes defined in the Return Data section.

           Note

           The all and display options are exclusive and may not be used together.

       -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.

           Note

           The -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".

SENSORS

       Health
           (Default) The current DCPMM health as reported in the SMART log

       MediaTemperature
           (Default) The current DCPMM media temperature in Celsius

       ControllerTemperature
           (Default) The current DCPMM controller temperature in Celsius

       PercentageRemaining
           (Default) Remaining DCPMM’s life as a percentage value of factory expected life span

       LatchedDirtyShutdownCount
           (Default) The number of shutdowns without notification over the lifetime of the DCPMM

       UnlatchedDirtyShutdownCount
           (Default) The number of shutdowns without notification over the lifetime of the DCPMM. This counter
           is the same as LatchedDirtyShutdownCount except it will always be incremented on a dirty shutdown,
           even if Latch System Shutdown Status was not enabled

       PowerOnTime
           (Default) The total power-on time over the lifetime of the DCPMM

       UpTime
           (Default) The total power-on time since the last power cycle of the DCPMM

       PowerCycles
           (Default) The number of power cycles over the lifetime of the DCPMM

       FwErrorCount
           (Default) The total number of firmware error log entries

TARGETS

       -dimm [DimmIDs]
           Restricts output to the sensors on specific DCPMMs by supplying the DIMM target and one or more
           comma-separated DCPMM identifiers. The default is to display sensors for all manageable DCPMMs.

EXAMPLES

       Gets all sensor information for all DCPMMs.

       ipmctl show -sensor

       Shows the media temperature sensor for the specified DCPMM.

       ipmctl show -sensor MediaTemperature -dimm 0x0001

LIMITATIONS

       In order to successfully execute this command:

       •   The caller must have the appropriate privileges.

       •   The specified DCPMM(s) must be manageable by the host software.

RETURN DATA

       This command displays a table with a row for each sensor on each DCPMM. Applying a specific DCPMM or
       sensor type target limits the number of rows. Applying options can be used to expand or restrict the
       output.

       DimmID
           (Default) The DCPMM identifier

       Type
           (Default) The sensor type. Refer to the sensor table above.

       CurrentValue
           (Default) The current reading followed by the units of measurement (e.g., 57 °C or 25%)

       AlarmThreshold
           The threshold value at which an alarm for the respective sensor will be triggered.

       ThrottlingStopThreshold
           The threshold value at which firmware will stop throttling to reduce overall thermals and keep the
           DIMM within safe operating temperatures.

       ThrottlingStartThreshold
           The threshold value at which firmware will start throttling to reduce overall thermals and keep the
           DIMM within safe operating temperatures.

       ShutdownThreshold
           The threshold value at which device shutdown will occur.

           Note

           Supported thresholds for a given sensor are listed as a part of the return data when using the -all
           or -display flag. Only the alarm threshold is settable.

       AlarmEnabled
           Current state of the alarm threshold, where applicable. One of:

           •   0: Disabled

           •   1: Enabled

           •   N/A

       MaxTemperature
           The highest temperature reported in degrees Celsius for a given media or controller sensor. This
           value is persistent through Power Loss and is read-only.

ipmctl                                             2020-02-10                              IPMCTL-SHOW-SENSOR(1)