xref: /linux/Documentation/ABI/testing/sysfs-devices-edac (revision 71e2f4dd5a65bd8dbca0b77661e75eea471168f8)
1What:		/sys/devices/system/edac/mc/mc*/reset_counters
2Date:		January 2006
3Contact:	linux-edac@vger.kernel.org
4Description:	This write-only control file will zero all the statistical
5		counters for UE and CE errors on the given memory controller.
6		Zeroing the counters will also reset the timer indicating how
7		long since the last counter were reset. This is useful for
8		computing errors/time.  Since the counters are always reset
9		at driver initialization time, no module/kernel parameter
10		is available.
11
12What:		/sys/devices/system/edac/mc/mc*/seconds_since_reset
13Date:		January 2006
14Contact:	linux-edac@vger.kernel.org
15Description:	This attribute file displays how many seconds have elapsed
16		since the last counter reset. This can be used with the error
17		counters to measure error rates.
18
19What:		/sys/devices/system/edac/mc/mc*/mc_name
20Date:		January 2006
21Contact:	linux-edac@vger.kernel.org
22Description:	This attribute file displays the type of memory controller
23		that is being utilized.
24
25What:		/sys/devices/system/edac/mc/mc*/size_mb
26Date:		January 2006
27Contact:	linux-edac@vger.kernel.org
28Description:	This attribute file displays, in count of megabytes, of memory
29		that this memory controller manages.
30
31What:		/sys/devices/system/edac/mc/mc*/ue_count
32Date:		January 2006
33Contact:	linux-edac@vger.kernel.org
34Description:	This attribute file displays the total count of uncorrectable
35		errors that have occurred on this memory controller. If
36		panic_on_ue is set, this counter will not have a chance to
37		increment, since EDAC will panic the system
38
39What:		/sys/devices/system/edac/mc/mc*/ue_noinfo_count
40Date:		January 2006
41Contact:	linux-edac@vger.kernel.org
42Description:	This attribute file displays the number of UEs that have
43		occurred on this memory controller with no information as to
44		which DIMM slot is having errors.
45
46What:		/sys/devices/system/edac/mc/mc*/ce_count
47Date:		January 2006
48Contact:	linux-edac@vger.kernel.org
49Description:	This attribute file displays the total count of correctable
50		errors that have occurred on this memory controller. This
51		count is very important to examine. CEs provide early
52		indications that a DIMM is beginning to fail. This count
53		field should be monitored for non-zero values and report
54		such information to the system administrator.
55
56What:		/sys/devices/system/edac/mc/mc*/ce_noinfo_count
57Date:		January 2006
58Contact:	linux-edac@vger.kernel.org
59Description:	This attribute file displays the number of CEs that
60		have occurred on this memory controller wherewith no
61		information as to which DIMM slot is having errors. Memory is
62		handicapped, but operational, yet no information is available
63		to indicate which slot the failing memory is in. This count
64		field should be also be monitored for non-zero values.
65
66What:		/sys/devices/system/edac/mc/mc*/sdram_scrub_rate
67Date:		February 2007
68Contact:	linux-edac@vger.kernel.org
69Description:	Read/Write attribute file that controls memory scrubbing.
70		The scrubbing rate used by the memory controller is set by
71		writing a minimum bandwidth in bytes/sec to the attribute file.
72		The rate will be translated to an internal value that gives at
73		least the specified rate.
74		Reading the file will return the actual scrubbing rate employed.
75		If configuration fails or memory scrubbing is not implemented,
76		the value of the attribute file will be -1.
77
78What:		/sys/devices/system/edac/mc/mc*/max_location
79Date:		April 2012
80Contact:	Mauro Carvalho Chehab <mchehab+samsung@kernel.org>
81		linux-edac@vger.kernel.org
82Description:	This attribute file displays the information about the last
83		available memory slot in this memory controller. It is used by
84		userspace tools in order to display the memory filling layout.
85
86What:		/sys/devices/system/edac/mc/mc*/(dimm|rank)*/size
87Date:		April 2012
88Contact:	Mauro Carvalho Chehab <mchehab+samsung@kernel.org>
89		linux-edac@vger.kernel.org
90Description:	This attribute file will display the size of dimm or rank.
91		For dimm*/size, this is the size, in MB of the DIMM memory
92		stick. For rank*/size, this is the size, in MB for one rank
93		of the DIMM memory stick. On single rank memories (1R), this
94		is also the total size of the dimm. On dual rank (2R) memories,
95		this is half the size of the total DIMM memories.
96
97What:		/sys/devices/system/edac/mc/mc*/(dimm|rank)*/dimm_dev_type
98Date:		April 2012
99Contact:	Mauro Carvalho Chehab <mchehab+samsung@kernel.org>
100		linux-edac@vger.kernel.org
101Description:	This attribute file will display what type of DRAM device is
102		being utilized on this DIMM (x1, x2, x4, x8, ...).
103
104What:		/sys/devices/system/edac/mc/mc*/(dimm|rank)*/dimm_edac_mode
105Date:		April 2012
106Contact:	Mauro Carvalho Chehab <mchehab+samsung@kernel.org>
107		linux-edac@vger.kernel.org
108Description:	This attribute file will display what type of Error detection
109		and correction is being utilized. For example: S4ECD4ED would
110		mean a Chipkill with x4 DRAM.
111
112What:		/sys/devices/system/edac/mc/mc*/(dimm|rank)*/dimm_label
113Date:		April 2012
114Contact:	Mauro Carvalho Chehab <mchehab+samsung@kernel.org>
115		linux-edac@vger.kernel.org
116Description:	This control file allows this DIMM to have a label assigned
117		to it. With this label in the module, when errors occur
118		the output can provide the DIMM label in the system log.
119		This becomes vital for panic events to isolate the
120		cause of the UE event.
121		DIMM Labels must be assigned after booting, with information
122		that correctly identifies the physical slot with its
123		silk screen label. This information is currently very
124		motherboard specific and determination of this information
125		must occur in userland at this time.
126
127What:		/sys/devices/system/edac/mc/mc*/(dimm|rank)*/dimm_location
128Date:		April 2012
129Contact:	Mauro Carvalho Chehab <mchehab+samsung@kernel.org>
130		linux-edac@vger.kernel.org
131Description:	This attribute file will display the location (csrow/channel,
132		branch/channel/slot or channel/slot) of the dimm or rank.
133
134What:		/sys/devices/system/edac/mc/mc*/(dimm|rank)*/dimm_mem_type
135Date:		April 2012
136Contact:	Mauro Carvalho Chehab <mchehab+samsung@kernel.org>
137		linux-edac@vger.kernel.org
138Description:	This attribute file will display what type of memory is
139		currently on this csrow. Normally, either buffered or
140		unbuffered memory (for example, Unbuffered-DDR3).
141
142What:		/sys/devices/system/edac/mc/mc*/(dimm|rank)*/dimm_ce_count
143Date:		October 2016
144Contact:	linux-edac@vger.kernel.org
145Description:	This attribute file displays the total count of correctable
146		errors that have occurred on this DIMM. This count is very important
147		to examine. CEs provide early indications that a DIMM is beginning
148		to fail. This count field should be monitored for non-zero values
149		and report such information to the system administrator.
150
151What:		/sys/devices/system/edac/mc/mc*/(dimm|rank)*/dimm_ue_count
152Date:		October 2016
153Contact:	linux-edac@vger.kernel.org
154Description:	This attribute file displays the total count of uncorrectable
155		errors that have occurred on this DIMM. If panic_on_ue is set, this
156		counter will not have a chance to increment, since EDAC will panic the
157		system
158