Orange Pi5 kernel

^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   1) For all of the nmem device attributes under ``nfit/*``, see the 'NVDIMM Firmware
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   2) Interface Table (NFIT)' section in the ACPI specification
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   3) (http://www.uefi.org/specifications) for more details.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   4) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   5) What:		/sys/bus/nd/devices/nmemX/nfit/serial
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   6) Date:		Jun, 2015
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   7) KernelVersion:	v4.2
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   8) Contact:	linux-nvdimm@lists.01.org
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   9) Description:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  10) 		(RO) Serial number of the NVDIMM (non-volatile dual in-line
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  11) 		memory module), assigned by the module vendor.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  12) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  13) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  14) What:		/sys/bus/nd/devices/nmemX/nfit/handle
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  15) Date:		Apr, 2015
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  16) KernelVersion:	v4.2
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  17) Contact:	linux-nvdimm@lists.01.org
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  18) Description:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  19) 		(RO) The address (given by the _ADR object) of the device on its
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  20) 		parent bus of the NVDIMM device containing the NVDIMM region.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  21) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  22) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  23) What:		/sys/bus/nd/devices/nmemX/nfit/device
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  24) Date:		Apr, 2015
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  25) KernelVersion:	v4.1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  26) Contact:	linux-nvdimm@lists.01.org
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  27) Description:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  28) 		(RO) Device id for the NVDIMM, assigned by the module vendor.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  29) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  30) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  31) What:		/sys/bus/nd/devices/nmemX/nfit/rev_id
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  32) Date:		Jun, 2015
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  33) KernelVersion:	v4.2
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  34) Contact:	linux-nvdimm@lists.01.org
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  35) Description:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  36) 		(RO) Revision of the NVDIMM, assigned by the module vendor.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  37) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  38) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  39) What:		/sys/bus/nd/devices/nmemX/nfit/phys_id
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  40) Date:		Apr, 2015
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  41) KernelVersion:	v4.2
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  42) Contact:	linux-nvdimm@lists.01.org
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  43) Description:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  44) 		(RO) Handle (i.e., instance number) for the SMBIOS (system
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  45) 		management BIOS) Memory Device structure describing the NVDIMM
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  46) 		containing the NVDIMM region.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  47) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  48) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  49) What:		/sys/bus/nd/devices/nmemX/nfit/flags
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  50) Date:		Jun, 2015
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  51) KernelVersion:	v4.2
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  52) Contact:	linux-nvdimm@lists.01.org
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  53) Description:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  54) 		(RO) The flags in the NFIT memory device sub-structure indicate
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  55) 		the state of the data on the nvdimm relative to its energy
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  56) 		source or last "flush to persistence".
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  57) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  58) 		The attribute is a translation of the 'NVDIMM State Flags' field
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  59) 		in section 5.2.25.3 'NVDIMM Region Mapping' Structure of the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  60) 		ACPI specification 6.2.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  61) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  62) 		The health states are "save_fail", "restore_fail", "flush_fail",
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  63) 		"not_armed", "smart_event", "map_fail" and "smart_notify".
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  64) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  65) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  66) What:		/sys/bus/nd/devices/nmemX/nfit/format
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  67) What:		/sys/bus/nd/devices/nmemX/nfit/format1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  68) What:		/sys/bus/nd/devices/nmemX/nfit/formats
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  69) Date:		Apr, 2016
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  70) KernelVersion:	v4.7
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  71) Contact:	linux-nvdimm@lists.01.org
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  72) Description:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  73) 		(RO) The interface codes indicate support for persistent memory
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  74) 		mapped directly into system physical address space and / or a
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  75) 		block aperture access mechanism to the NVDIMM media.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  76) 		The 'formats' attribute displays the number of supported
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  77) 		interfaces.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  78) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  79) 		This layout is compatible with existing libndctl binaries that
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  80) 		only expect one code per-dimm as they will ignore
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  81) 		nmemX/nfit/formats and nmemX/nfit/formatN.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  82) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  83) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  84) What:		/sys/bus/nd/devices/nmemX/nfit/vendor
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  85) Date:		Apr, 2016
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  86) KernelVersion:	v4.7
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  87) Contact:	linux-nvdimm@lists.01.org
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  88) Description:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  89) 		(RO) Vendor id of the NVDIMM.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  90) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  91) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  92) What:		/sys/bus/nd/devices/nmemX/nfit/dsm_mask
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  93) Date:		May, 2016
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  94) KernelVersion:	v4.7
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  95) Contact:	linux-nvdimm@lists.01.org
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  96) Description:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  97) 		(RO) The bitmask indicates the supported device specific control
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  98) 		functions relative to the NVDIMM command family supported by the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  99) 		device
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 100) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 101) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 102) What:		/sys/bus/nd/devices/nmemX/nfit/family
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 103) Date:		Apr, 2016
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 104) KernelVersion:	v4.7
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 105) Contact:	linux-nvdimm@lists.01.org
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 106) Description:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 107) 		(RO) Displays the NVDIMM family command sets. Values
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 108) 		0, 1, 2 and 3 correspond to NVDIMM_FAMILY_INTEL,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 109) 		NVDIMM_FAMILY_HPE1, NVDIMM_FAMILY_HPE2 and NVDIMM_FAMILY_MSFT
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 110) 		respectively.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 111) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 112) 		See the specifications for these command families here:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 113) 		http://pmem.io/documents/NVDIMM_DSM_Interface-V1.6.pdf
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 114) 		https://github.com/HewlettPackard/hpe-nvm/blob/master/Documentation/
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 115) 		https://msdn.microsoft.com/library/windows/hardware/mt604741"
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 116) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 117) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 118) What:		/sys/bus/nd/devices/nmemX/nfit/id
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 119) Date:		Apr, 2016
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 120) KernelVersion:	v4.7
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 121) Contact:	linux-nvdimm@lists.01.org
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 122) Description:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 123) 		(RO) ACPI specification 6.2 section 5.2.25.9, defines an
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 124) 		identifier for an NVDIMM, which refelects the id attribute.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 125) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 126) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 127) What:		/sys/bus/nd/devices/nmemX/nfit/subsystem_vendor
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 128) Date:		Apr, 2016
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 129) KernelVersion:	v4.7
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 130) Contact:	linux-nvdimm@lists.01.org
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 131) Description:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 132) 		(RO) Sub-system vendor id of the NVDIMM non-volatile memory
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 133) 		subsystem controller.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 134) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 135) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 136) What:		/sys/bus/nd/devices/nmemX/nfit/subsystem_rev_id
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 137) Date:		Apr, 2016
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 138) KernelVersion:	v4.7
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 139) Contact:	linux-nvdimm@lists.01.org
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 140) Description:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 141) 		(RO) Sub-system revision id of the NVDIMM non-volatile memory subsystem
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 142) 		controller, assigned by the non-volatile memory subsystem
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 143) 		controller vendor.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 144) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 145) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 146) What:		/sys/bus/nd/devices/nmemX/nfit/subsystem_device
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 147) Date:		Apr, 2016
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 148) KernelVersion:	v4.7
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 149) Contact:	linux-nvdimm@lists.01.org
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 150) Description:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 151) 		(RO) Sub-system device id for the NVDIMM non-volatile memory
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 152) 		subsystem controller, assigned by the non-volatile memory
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 153) 		subsystem controller vendor.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 154) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 155) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 156) What:		/sys/bus/nd/devices/ndbusX/nfit/revision
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 157) Date:		Jun, 2015
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 158) KernelVersion:	v4.2
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 159) Contact:	linux-nvdimm@lists.01.org
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 160) Description:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 161) 		(RO) ACPI NFIT table revision number.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 162) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 163) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 164) What:		/sys/bus/nd/devices/ndbusX/nfit/scrub
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 165) Date:		Sep, 2016
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 166) KernelVersion:	v4.9
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 167) Contact:	linux-nvdimm@lists.01.org
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 168) Description:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 169) 		(RW) This shows the number of full Address Range Scrubs (ARS)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 170) 		that have been completed since driver load time. Userspace can
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 171) 		wait on this using select/poll etc. A '+' at the end indicates
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 172) 		an ARS is in progress
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 173) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 174) 		Writing a value of 1 triggers an ARS scan.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 175) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 176) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 177) What:		/sys/bus/nd/devices/ndbusX/nfit/hw_error_scrub
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 178) Date:		Sep, 2016
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 179) KernelVersion:	v4.9
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 180) Contact:	linux-nvdimm@lists.01.org
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 181) Description:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 182) 		(RW) Provides a way to toggle the behavior between just adding
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 183) 		the address (cache line) where the MCE happened to the poison
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 184) 		list and doing a full scrub. The former (selective insertion of
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 185) 		the address) is done unconditionally.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 186) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 187) 		This attribute can have the following values written to it:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 188) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 189) 		'0': Switch to the default mode where an exception will only
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 190) 		insert the address of the memory error into the poison and
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 191) 		badblocks lists.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 192) 		'1': Enable a full scrub to happen if an exception for a memory
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 193) 		error is received.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 194) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 195) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 196) What:		/sys/bus/nd/devices/ndbusX/nfit/dsm_mask
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 197) Date:		Jun, 2017
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 198) KernelVersion:	v4.13
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 199) Contact:	linux-nvdimm@lists.01.org
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 200) Description:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 201) 		(RO) The bitmask indicates the supported bus specific control
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 202) 		functions. See the section named 'NVDIMM Root Device _DSMs' in
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 203) 		the ACPI specification.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 204) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 205) What:		/sys/bus/nd/devices/ndbusX/nfit/firmware_activate_noidle
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 206) Date:		Apr, 2020
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 207) KernelVersion:	v5.8
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 208) Contact:	linux-nvdimm@lists.01.org
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 209) Description:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 210) 		(RW) The Intel platform implementation of firmware activate
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 211) 		support exposes an option let the platform force idle devices in
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 212) 		the system over the activation event, or trust that the OS will
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 213) 		do it. The safe default is to let the platform force idle
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 214) 		devices since the kernel is already in a suspend state, and on
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 215) 		the chance that a driver does not properly quiesce bus-mastering
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 216) 		after a suspend callback the platform will handle it.  However,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 217) 		the activation might abort if, for example, platform firmware
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 218) 		determines that the activation time exceeds the max PCI-E
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 219) 		completion timeout. Since the platform does not know whether the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 220) 		OS is running the activation from a suspend context it aborts,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 221) 		but if the system owner trusts driver suspend callback to be
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 222) 		sufficient then 'firmware_activation_noidle' can be
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 223) 		enabled to bypass the activation abort.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 224) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 225) What:		/sys/bus/nd/devices/regionX/nfit/range_index
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 226) Date:		Jun, 2015
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 227) KernelVersion:	v4.2
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 228) Contact:	linux-nvdimm@lists.01.org
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 229) Description:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 230) 		(RO) A unique number provided by the BIOS to identify an address
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 231) 		range. Used by NVDIMM Region Mapping Structure to uniquely refer
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 232) 		to this structure. Value of 0 is reserved and not used as an
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 233) 		index.