GNU Linux-libre 4.4.294-gnu1
[releases.git] / Documentation / ABI / testing / sysfs-devices-edac
1 What:           /sys/devices/system/edac/mc/mc*/reset_counters
2 Date:           January 2006
3 Contact:        linux-edac@vger.kernel.org
4 Description:    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
12 What:           /sys/devices/system/edac/mc/mc*/seconds_since_reset
13 Date:           January 2006
14 Contact:        linux-edac@vger.kernel.org
15 Description:    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
19 What:           /sys/devices/system/edac/mc/mc*/mc_name
20 Date:           January 2006
21 Contact:        linux-edac@vger.kernel.org
22 Description:    This attribute file displays the type of memory controller
23                 that is being utilized.
24
25 What:           /sys/devices/system/edac/mc/mc*/size_mb
26 Date:           January 2006
27 Contact:        linux-edac@vger.kernel.org
28 Description:    This attribute file displays, in count of megabytes, of memory
29                 that this memory controller manages.
30
31 What:           /sys/devices/system/edac/mc/mc*/ue_count
32 Date:           January 2006
33 Contact:        linux-edac@vger.kernel.org
34 Description:    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
39 What:           /sys/devices/system/edac/mc/mc*/ue_noinfo_count
40 Date:           January 2006
41 Contact:        linux-edac@vger.kernel.org
42 Description:    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
46 What:           /sys/devices/system/edac/mc/mc*/ce_count
47 Date:           January 2006
48 Contact:        linux-edac@vger.kernel.org
49 Description:    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
56 What:           /sys/devices/system/edac/mc/mc*/ce_noinfo_count
57 Date:           January 2006
58 Contact:        linux-edac@vger.kernel.org
59 Description:    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
66 What:           /sys/devices/system/edac/mc/mc*/sdram_scrub_rate
67 Date:           February 2007
68 Contact:        linux-edac@vger.kernel.org
69 Description:    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
78 What:           /sys/devices/system/edac/mc/mc*/max_location
79 Date:           April 2012
80 Contact:        Mauro Carvalho Chehab <m.chehab@samsung.com>
81                 linux-edac@vger.kernel.org
82 Description:    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
86 What:           /sys/devices/system/edac/mc/mc*/(dimm|rank)*/size
87 Date:           April 2012
88 Contact:        Mauro Carvalho Chehab <m.chehab@samsung.com>
89                 linux-edac@vger.kernel.org
90 Description:    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
97 What:           /sys/devices/system/edac/mc/mc*/(dimm|rank)*/dimm_dev_type
98 Date:           April 2012
99 Contact:        Mauro Carvalho Chehab <m.chehab@samsung.com>
100                 linux-edac@vger.kernel.org
101 Description:    This attribute file will display what type of DRAM device is
102                 being utilized on this DIMM (x1, x2, x4, x8, ...).
103
104 What:           /sys/devices/system/edac/mc/mc*/(dimm|rank)*/dimm_edac_mode
105 Date:           April 2012
106 Contact:        Mauro Carvalho Chehab <m.chehab@samsung.com>
107                 linux-edac@vger.kernel.org
108 Description:    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
112 What:           /sys/devices/system/edac/mc/mc*/(dimm|rank)*/dimm_label
113 Date:           April 2012
114 Contact:        Mauro Carvalho Chehab <m.chehab@samsung.com>
115                 linux-edac@vger.kernel.org
116 Description:    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
127 What:           /sys/devices/system/edac/mc/mc*/(dimm|rank)*/dimm_location
128 Date:           April 2012
129 Contact:        Mauro Carvalho Chehab <m.chehab@samsung.com>
130                 linux-edac@vger.kernel.org
131 Description:    This attribute file will display the location (csrow/channel,
132                 branch/channel/slot or channel/slot) of the dimm or rank.
133
134 What:           /sys/devices/system/edac/mc/mc*/(dimm|rank)*/dimm_mem_type
135 Date:           April 2012
136 Contact:        Mauro Carvalho Chehab <m.chehab@samsung.com>
137                 linux-edac@vger.kernel.org
138 Description:    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).