xref: /linux/Documentation/ABI/testing/sysfs-bus-papr-pmem (revision 2d02bf835e5731de632c8a13567905fa7c0da01c)
1b791abf3SVaibhav JainWhat:		/sys/bus/nd/devices/nmemX/papr/flags
2b791abf3SVaibhav JainDate:		Apr, 2020
3b791abf3SVaibhav JainKernelVersion:	v5.8
4b791abf3SVaibhav JainContact:	linuxppc-dev <linuxppc-dev@lists.ozlabs.org>, linux-nvdimm@lists.01.org,
5b791abf3SVaibhav JainDescription:
6b791abf3SVaibhav Jain		(RO) Report flags indicating various states of a
7b791abf3SVaibhav Jain		papr-pmem NVDIMM device. Each flag maps to a one or
8b791abf3SVaibhav Jain		more bits set in the dimm-health-bitmap retrieved in
9b791abf3SVaibhav Jain		response to H_SCM_HEALTH hcall. The details of the bit
10b791abf3SVaibhav Jain		flags returned in response to this hcall is available
11b791abf3SVaibhav Jain		at 'Documentation/powerpc/papr_hcalls.rst' . Below are
12b791abf3SVaibhav Jain		the flags reported in this sysfs file:
13b791abf3SVaibhav Jain
14b791abf3SVaibhav Jain		* "not_armed"	: Indicates that NVDIMM contents will not
15b791abf3SVaibhav Jain				  survive a power cycle.
16b791abf3SVaibhav Jain		* "flush_fail"	: Indicates that NVDIMM contents
17b791abf3SVaibhav Jain				  couldn't be flushed during last
18b791abf3SVaibhav Jain				  shut-down event.
19b791abf3SVaibhav Jain		* "restore_fail": Indicates that NVDIMM contents
20b791abf3SVaibhav Jain				  couldn't be restored during NVDIMM
21b791abf3SVaibhav Jain				  initialization.
22b791abf3SVaibhav Jain		* "encrypted"	: NVDIMM contents are encrypted.
23b791abf3SVaibhav Jain		* "smart_notify": There is health event for the NVDIMM.
24b791abf3SVaibhav Jain		* "scrubbed"	: Indicating that contents of the
25b791abf3SVaibhav Jain				  NVDIMM have been scrubbed.
26b791abf3SVaibhav Jain		* "locked"	: Indicating that NVDIMM contents cant
27b791abf3SVaibhav Jain				  be modified until next power cycle.
28*2d02bf83SVaibhav Jain
29*2d02bf83SVaibhav JainWhat:		/sys/bus/nd/devices/nmemX/papr/perf_stats
30*2d02bf83SVaibhav JainDate:		May, 2020
31*2d02bf83SVaibhav JainKernelVersion:	v5.9
32*2d02bf83SVaibhav JainContact:	linuxppc-dev <linuxppc-dev@lists.ozlabs.org>, linux-nvdimm@lists.01.org,
33*2d02bf83SVaibhav JainDescription:
34*2d02bf83SVaibhav Jain		(RO) Report various performance stats related to papr-scm NVDIMM
35*2d02bf83SVaibhav Jain		device.  Each stat is reported on a new line with each line
36*2d02bf83SVaibhav Jain		composed of a stat-identifier followed by it value. Below are
37*2d02bf83SVaibhav Jain		currently known dimm performance stats which are reported:
38*2d02bf83SVaibhav Jain
39*2d02bf83SVaibhav Jain		* "CtlResCt" : Controller Reset Count
40*2d02bf83SVaibhav Jain		* "CtlResTm" : Controller Reset Elapsed Time
41*2d02bf83SVaibhav Jain		* "PonSecs " : Power-on Seconds
42*2d02bf83SVaibhav Jain		* "MemLife " : Life Remaining
43*2d02bf83SVaibhav Jain		* "CritRscU" : Critical Resource Utilization
44*2d02bf83SVaibhav Jain		* "HostLCnt" : Host Load Count
45*2d02bf83SVaibhav Jain		* "HostSCnt" : Host Store Count
46*2d02bf83SVaibhav Jain		* "HostSDur" : Host Store Duration
47*2d02bf83SVaibhav Jain		* "HostLDur" : Host Load Duration
48*2d02bf83SVaibhav Jain		* "MedRCnt " : Media Read Count
49*2d02bf83SVaibhav Jain		* "MedWCnt " : Media Write Count
50*2d02bf83SVaibhav Jain		* "MedRDur " : Media Read Duration
51*2d02bf83SVaibhav Jain		* "MedWDur " : Media Write Duration
52*2d02bf83SVaibhav Jain		* "CchRHCnt" : Cache Read Hit Count
53*2d02bf83SVaibhav Jain		* "CchWHCnt" : Cache Write Hit Count
54*2d02bf83SVaibhav Jain		* "FastWCnt" : Fast Write Count