0001 What: /sys/bus/nd/devices/nmemX/papr/flags
0002 Date: Apr, 2020
0003 KernelVersion: v5.8
0004 Contact: linuxppc-dev <linuxppc-dev@lists.ozlabs.org>, nvdimm@lists.linux.dev,
0005 Description:
0006 (RO) Report flags indicating various states of a
0007 papr-pmem NVDIMM device. Each flag maps to a one or
0008 more bits set in the dimm-health-bitmap retrieved in
0009 response to H_SCM_HEALTH hcall. The details of the bit
0010 flags returned in response to this hcall is available
0011 at 'Documentation/powerpc/papr_hcalls.rst' . Below are
0012 the flags reported in this sysfs file:
0013
0014 * "not_armed"
0015 Indicates that NVDIMM contents will not
0016 survive a power cycle.
0017 * "flush_fail"
0018 Indicates that NVDIMM contents
0019 couldn't be flushed during last
0020 shut-down event.
0021 * "restore_fail"
0022 Indicates that NVDIMM contents
0023 couldn't be restored during NVDIMM
0024 initialization.
0025 * "encrypted"
0026 NVDIMM contents are encrypted.
0027 * "smart_notify"
0028 There is health event for the NVDIMM.
0029 * "scrubbed"
0030 Indicating that contents of the
0031 NVDIMM have been scrubbed.
0032 * "locked"
0033 Indicating that NVDIMM contents cant
0034 be modified until next power cycle.
0035
0036 What: /sys/bus/nd/devices/nmemX/papr/perf_stats
0037 Date: May, 2020
0038 KernelVersion: v5.9
0039 Contact: linuxppc-dev <linuxppc-dev@lists.ozlabs.org>, nvdimm@lists.linux.dev,
0040 Description:
0041 (RO) Report various performance stats related to papr-scm NVDIMM
0042 device. This attribute is only available for NVDIMM devices
0043 that support reporting NVDIMM performance stats. Each stat is
0044 reported on a new line with each line composed of a
0045 stat-identifier followed by it value. Below are currently known
0046 dimm performance stats which are reported:
0047
0048 * "CtlResCt" : Controller Reset Count
0049 * "CtlResTm" : Controller Reset Elapsed Time
0050 * "PonSecs " : Power-on Seconds
0051 * "MemLife " : Life Remaining
0052 * "CritRscU" : Critical Resource Utilization
0053 * "HostLCnt" : Host Load Count
0054 * "HostSCnt" : Host Store Count
0055 * "HostSDur" : Host Store Duration
0056 * "HostLDur" : Host Load Duration
0057 * "MedRCnt " : Media Read Count
0058 * "MedWCnt " : Media Write Count
0059 * "MedRDur " : Media Read Duration
0060 * "MedWDur " : Media Write Duration
0061 * "CchRHCnt" : Cache Read Hit Count
0062 * "CchWHCnt" : Cache Write Hit Count
0063 * "FastWCnt" : Fast Write Count
0064
0065 What: /sys/bus/nd/devices/nmemX/papr/health_bitmap_inject
0066 Date: Jan, 2022
0067 KernelVersion: v5.17
0068 Contact: linuxppc-dev <linuxppc-dev@lists.ozlabs.org>, nvdimm@lists.linux.dev,
0069 Description:
0070 (RO) Reports the health bitmap inject bitmap that is applied to
0071 bitmap received from PowerVM via the H_SCM_HEALTH. This is used
0072 to forcibly set specific bits returned from Hcall. These is then
0073 used to simulate various health or shutdown states for an nvdimm
0074 and are set by user-space tools like ndctl by issuing a PAPR DSM.
0075
