xref: /linux/Documentation/ABI/testing/sysfs-devices-edac (revision 2639c3ee298401881cc560c5e3987f8b222b9f7c)
18b6f04ceSMauro Carvalho ChehabWhat:		/sys/devices/system/edac/mc/mc*/reset_counters
28b6f04ceSMauro Carvalho ChehabDate:		January 2006
38b6f04ceSMauro Carvalho ChehabContact:	linux-edac@vger.kernel.org
48b6f04ceSMauro Carvalho ChehabDescription:	This write-only control file will zero all the statistical
58b6f04ceSMauro Carvalho Chehab		counters for UE and CE errors on the given memory controller.
68b6f04ceSMauro Carvalho Chehab		Zeroing the counters will also reset the timer indicating how
78b6f04ceSMauro Carvalho Chehab		long since the last counter were reset. This is useful for
88b6f04ceSMauro Carvalho Chehab		computing errors/time.  Since the counters are always reset
98b6f04ceSMauro Carvalho Chehab		at driver initialization time, no module/kernel parameter
108b6f04ceSMauro Carvalho Chehab		is available.
118b6f04ceSMauro Carvalho Chehab
128b6f04ceSMauro Carvalho ChehabWhat:		/sys/devices/system/edac/mc/mc*/seconds_since_reset
138b6f04ceSMauro Carvalho ChehabDate:		January 2006
148b6f04ceSMauro Carvalho ChehabContact:	linux-edac@vger.kernel.org
158b6f04ceSMauro Carvalho ChehabDescription:	This attribute file displays how many seconds have elapsed
168b6f04ceSMauro Carvalho Chehab		since the last counter reset. This can be used with the error
178b6f04ceSMauro Carvalho Chehab		counters to measure error rates.
188b6f04ceSMauro Carvalho Chehab
198b6f04ceSMauro Carvalho ChehabWhat:		/sys/devices/system/edac/mc/mc*/mc_name
208b6f04ceSMauro Carvalho ChehabDate:		January 2006
218b6f04ceSMauro Carvalho ChehabContact:	linux-edac@vger.kernel.org
228b6f04ceSMauro Carvalho ChehabDescription:	This attribute file displays the type of memory controller
238b6f04ceSMauro Carvalho Chehab		that is being utilized.
248b6f04ceSMauro Carvalho Chehab
258b6f04ceSMauro Carvalho ChehabWhat:		/sys/devices/system/edac/mc/mc*/size_mb
268b6f04ceSMauro Carvalho ChehabDate:		January 2006
278b6f04ceSMauro Carvalho ChehabContact:	linux-edac@vger.kernel.org
288b6f04ceSMauro Carvalho ChehabDescription:	This attribute file displays, in count of megabytes, of memory
298b6f04ceSMauro Carvalho Chehab		that this memory controller manages.
308b6f04ceSMauro Carvalho Chehab
318b6f04ceSMauro Carvalho ChehabWhat:		/sys/devices/system/edac/mc/mc*/ue_count
328b6f04ceSMauro Carvalho ChehabDate:		January 2006
338b6f04ceSMauro Carvalho ChehabContact:	linux-edac@vger.kernel.org
348b6f04ceSMauro Carvalho ChehabDescription:	This attribute file displays the total count of uncorrectable
358b6f04ceSMauro Carvalho Chehab		errors that have occurred on this memory controller. If
368b6f04ceSMauro Carvalho Chehab		panic_on_ue is set, this counter will not have a chance to
378b6f04ceSMauro Carvalho Chehab		increment, since EDAC will panic the system
388b6f04ceSMauro Carvalho Chehab
398b6f04ceSMauro Carvalho ChehabWhat:		/sys/devices/system/edac/mc/mc*/ue_noinfo_count
408b6f04ceSMauro Carvalho ChehabDate:		January 2006
418b6f04ceSMauro Carvalho ChehabContact:	linux-edac@vger.kernel.org
428b6f04ceSMauro Carvalho ChehabDescription:	This attribute file displays the number of UEs that have
438b6f04ceSMauro Carvalho Chehab		occurred on this memory controller with no information as to
448b6f04ceSMauro Carvalho Chehab		which DIMM slot is having errors.
458b6f04ceSMauro Carvalho Chehab
468b6f04ceSMauro Carvalho ChehabWhat:		/sys/devices/system/edac/mc/mc*/ce_count
478b6f04ceSMauro Carvalho ChehabDate:		January 2006
488b6f04ceSMauro Carvalho ChehabContact:	linux-edac@vger.kernel.org
498b6f04ceSMauro Carvalho ChehabDescription:	This attribute file displays the total count of correctable
508b6f04ceSMauro Carvalho Chehab		errors that have occurred on this memory controller. This
518b6f04ceSMauro Carvalho Chehab		count is very important to examine. CEs provide early
528b6f04ceSMauro Carvalho Chehab		indications that a DIMM is beginning to fail. This count
538b6f04ceSMauro Carvalho Chehab		field should be monitored for non-zero values and report
548b6f04ceSMauro Carvalho Chehab		such information to the system administrator.
558b6f04ceSMauro Carvalho Chehab
568b6f04ceSMauro Carvalho ChehabWhat:		/sys/devices/system/edac/mc/mc*/ce_noinfo_count
578b6f04ceSMauro Carvalho ChehabDate:		January 2006
588b6f04ceSMauro Carvalho ChehabContact:	linux-edac@vger.kernel.org
598b6f04ceSMauro Carvalho ChehabDescription:	This attribute file displays the number of CEs that
608b6f04ceSMauro Carvalho Chehab		have occurred on this memory controller wherewith no
618b6f04ceSMauro Carvalho Chehab		information as to which DIMM slot is having errors. Memory is
628b6f04ceSMauro Carvalho Chehab		handicapped, but operational, yet no information is available
638b6f04ceSMauro Carvalho Chehab		to indicate which slot the failing memory is in. This count
648b6f04ceSMauro Carvalho Chehab		field should be also be monitored for non-zero values.
658b6f04ceSMauro Carvalho Chehab
668b6f04ceSMauro Carvalho ChehabWhat:		/sys/devices/system/edac/mc/mc*/sdram_scrub_rate
678b6f04ceSMauro Carvalho ChehabDate:		February 2007
688b6f04ceSMauro Carvalho ChehabContact:	linux-edac@vger.kernel.org
698b6f04ceSMauro Carvalho ChehabDescription:	Read/Write attribute file that controls memory scrubbing.
708b6f04ceSMauro Carvalho Chehab		The scrubbing rate used by the memory controller is set by
718b6f04ceSMauro Carvalho Chehab		writing a minimum bandwidth in bytes/sec to the attribute file.
728b6f04ceSMauro Carvalho Chehab		The rate will be translated to an internal value that gives at
738b6f04ceSMauro Carvalho Chehab		least the specified rate.
748b6f04ceSMauro Carvalho Chehab		Reading the file will return the actual scrubbing rate employed.
758b6f04ceSMauro Carvalho Chehab		If configuration fails or memory scrubbing is not implemented,
768b6f04ceSMauro Carvalho Chehab		the value of the attribute file will be -1.
77*2639c3eeSMauro Carvalho Chehab
78*2639c3eeSMauro Carvalho ChehabWhat:		/sys/devices/system/edac/mc/mc*/max_location
79*2639c3eeSMauro Carvalho ChehabDate:		April 2012
80*2639c3eeSMauro Carvalho ChehabContact:	Mauro Carvalho Chehab <mchehab@redhat.com>
81*2639c3eeSMauro Carvalho Chehab		linux-edac@vger.kernel.org
82*2639c3eeSMauro Carvalho ChehabDescription:	This attribute file displays the information about the last
83*2639c3eeSMauro Carvalho Chehab		available memory slot in this memory controller. It is used by
84*2639c3eeSMauro Carvalho Chehab		userspace tools in order to display the memory filling layout.
85*2639c3eeSMauro Carvalho Chehab
86*2639c3eeSMauro Carvalho ChehabWhat:		/sys/devices/system/edac/mc/mc*/(dimm|rank)*/size
87*2639c3eeSMauro Carvalho ChehabDate:		April 2012
88*2639c3eeSMauro Carvalho ChehabContact:	Mauro Carvalho Chehab <mchehab@redhat.com>
89*2639c3eeSMauro Carvalho Chehab		linux-edac@vger.kernel.org
90*2639c3eeSMauro Carvalho ChehabDescription:	This attribute file will display the size of dimm or rank.
91*2639c3eeSMauro Carvalho Chehab		For dimm*/size, this is the size, in MB of the DIMM memory
92*2639c3eeSMauro Carvalho Chehab		stick. For rank*/size, this is the size, in MB for one rank
93*2639c3eeSMauro Carvalho Chehab		of the DIMM memory stick. On single rank memories (1R), this
94*2639c3eeSMauro Carvalho Chehab		is also the total size of the dimm. On dual rank (2R) memories,
95*2639c3eeSMauro Carvalho Chehab		this is half the size of the total DIMM memories.
96*2639c3eeSMauro Carvalho Chehab
97*2639c3eeSMauro Carvalho ChehabWhat:		/sys/devices/system/edac/mc/mc*/(dimm|rank)*/dimm_dev_type
98*2639c3eeSMauro Carvalho ChehabDate:		April 2012
99*2639c3eeSMauro Carvalho ChehabContact:	Mauro Carvalho Chehab <mchehab@redhat.com>
100*2639c3eeSMauro Carvalho Chehab		linux-edac@vger.kernel.org
101*2639c3eeSMauro Carvalho ChehabDescription:	This attribute file will display what type of DRAM device is
102*2639c3eeSMauro Carvalho Chehab		being utilized on this DIMM (x1, x2, x4, x8, ...).
103*2639c3eeSMauro Carvalho Chehab
104*2639c3eeSMauro Carvalho ChehabWhat:		/sys/devices/system/edac/mc/mc*/(dimm|rank)*/dimm_edac_mode
105*2639c3eeSMauro Carvalho ChehabDate:		April 2012
106*2639c3eeSMauro Carvalho ChehabContact:	Mauro Carvalho Chehab <mchehab@redhat.com>
107*2639c3eeSMauro Carvalho Chehab		linux-edac@vger.kernel.org
108*2639c3eeSMauro Carvalho ChehabDescription:	This attribute file will display what type of Error detection
109*2639c3eeSMauro Carvalho Chehab		and correction is being utilized. For example: S4ECD4ED would
110*2639c3eeSMauro Carvalho Chehab		mean a Chipkill with x4 DRAM.
111*2639c3eeSMauro Carvalho Chehab
112*2639c3eeSMauro Carvalho ChehabWhat:		/sys/devices/system/edac/mc/mc*/(dimm|rank)*/dimm_label
113*2639c3eeSMauro Carvalho ChehabDate:		April 2012
114*2639c3eeSMauro Carvalho ChehabContact:	Mauro Carvalho Chehab <mchehab@redhat.com>
115*2639c3eeSMauro Carvalho Chehab		linux-edac@vger.kernel.org
116*2639c3eeSMauro Carvalho ChehabDescription:	This control file allows this DIMM to have a label assigned
117*2639c3eeSMauro Carvalho Chehab		to it. With this label in the module, when errors occur
118*2639c3eeSMauro Carvalho Chehab		the output can provide the DIMM label in the system log.
119*2639c3eeSMauro Carvalho Chehab		This becomes vital for panic events to isolate the
120*2639c3eeSMauro Carvalho Chehab		cause of the UE event.
121*2639c3eeSMauro Carvalho Chehab		DIMM Labels must be assigned after booting, with information
122*2639c3eeSMauro Carvalho Chehab		that correctly identifies the physical slot with its
123*2639c3eeSMauro Carvalho Chehab		silk screen label. This information is currently very
124*2639c3eeSMauro Carvalho Chehab		motherboard specific and determination of this information
125*2639c3eeSMauro Carvalho Chehab		must occur in userland at this time.
126*2639c3eeSMauro Carvalho Chehab
127*2639c3eeSMauro Carvalho ChehabWhat:		/sys/devices/system/edac/mc/mc*/(dimm|rank)*/dimm_location
128*2639c3eeSMauro Carvalho ChehabDate:		April 2012
129*2639c3eeSMauro Carvalho ChehabContact:	Mauro Carvalho Chehab <mchehab@redhat.com>
130*2639c3eeSMauro Carvalho Chehab		linux-edac@vger.kernel.org
131*2639c3eeSMauro Carvalho ChehabDescription:	This attribute file will display the location (csrow/channel,
132*2639c3eeSMauro Carvalho Chehab		branch/channel/slot or channel/slot) of the dimm or rank.
133*2639c3eeSMauro Carvalho Chehab
134*2639c3eeSMauro Carvalho ChehabWhat:		/sys/devices/system/edac/mc/mc*/(dimm|rank)*/dimm_mem_type
135*2639c3eeSMauro Carvalho ChehabDate:		April 2012
136*2639c3eeSMauro Carvalho ChehabContact:	Mauro Carvalho Chehab <mchehab@redhat.com>
137*2639c3eeSMauro Carvalho Chehab		linux-edac@vger.kernel.org
138*2639c3eeSMauro Carvalho ChehabDescription:	This attribute file will display what type of memory is
139*2639c3eeSMauro Carvalho Chehab		currently on this csrow. Normally, either buffered or
140*2639c3eeSMauro Carvalho Chehab		unbuffered memory (for example, Unbuffered-DDR3).
141