NDCTL-INJECT-SMART(1)

NAME
ndctl-inject-smart - perform smart threshold/injection operations on a DIMM

SYNOPSIS

ndctl inject-smart <dimm> [<options>]

DESCRIPTION

A generic DIMM device object, named /dev/nmemX, is registered for each memory device indicated in the ACPI NFIT table, or other platform NVDIMM resource discovery mechanism.

ndctl-inject-smart can be used to set smart thresholds, and inject smart attributes.

EXAMPLES

Set smart controller temperature and spares threshold for DIMM-0 to 32C, spares threshold to 8, and enable the spares alarm.

ndctl inject-smart --ctrl-temperature-threshold=32 --spares-threshold=8 --spares-alarm nmem0

Inject a media temperature value of 52 and fatal health status flag for DIMM-0

ndctl inject-smart --media-temperature=52 --health=fatal nmem0

OPTIONS

-b, --bus=
    A bus id number, or a provider string (e.g. "ACPI.NFIT"). Restrict the operation to the specified bus(es). The keyword all can be specified to indicate the lack of any restriction, however this is the same as not supplying a --bus option at all.

-m, --media-temperature=
    Inject <value> for the media temperature smart attribute.

-M, --media-temperature-threshold=
    Set <value> for the smart media temperature threshold.

--media-temperature-alarm=
    Enable or disable the smart media temperature alarm. Options are on or off.

--media-temperature-uninject
    Uninject any media temperature previously injected.

-c, --ctrl-temperature=
    Inject <value> for the controller temperature smart attribute.

-C, --ctrl-temperature-threshold=
    Set <value> for the smart controller temperature threshold.

--ctrl-temperature-alarm=
    Enable or disable the smart controller temperature alarm. Options are on or off.

--ctrl-temperature-uninject
    Uninject any controller temperature previously injected.

-s, --spares=
    Inject <value> for the spares smart attribute.

-S, --spares-threshold=
    Set <value> for the smart spares threshold.

--spares-alarm=
    Enable or disable the smart spares alarm. Options are on or off.

--spares-uninject
    Uninject any spare percentage previously injected.

-f, --fatal
    Set the flag to spoof fatal health status.

--fatal-uninject
    Uninject the fatal health status flag.

-U, --unsafe-shutdown
    Set the flag to spoof an unsafe shutdown on the next power down.

--unsafe-shutdown-uninject
    Uninject the unsafe shutdown flag.

-N, --uninject-all
    Uninject all possible smart fields/values irrespective of whether they have been previously injected or not.

-v, --verbose
    Emit debug messages for the error injection process

-u, --human
    Format numbers representing storage sizes, or offsets as human readable strings with units instead of the default machine-friendly raw-integer data. Convert other numeric fields into hexadecimal strings.

COPYRIGHT

Copyright (c) 2016 - 2019, Intel Corporation. License GPLv2: GNU GPL version 2 This is free software: you are free to change and redistribute it. There is NO WARRANTY, to the extent permitted by law.

SEE ALSO

ndctl-list(1),