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