1
2
3EDAC - Error Detection And Correction
4
5Written by Doug Thompson <dougthompson@xmission.com>
67 Dec 2005
717 Jul 2007	Updated
8
9(c) Mauro Carvalho Chehab <mchehab@redhat.com>
1005 Aug 2009	Nehalem interface
11
12EDAC is maintained and written by:
13
14	Doug Thompson, Dave Jiang, Dave Peterson et al,
15	original author: Thayne Harbaugh,
16
17Contact:
18	website:	bluesmoke.sourceforge.net
19	mailing list:	bluesmoke-devel@lists.sourceforge.net
20
21"bluesmoke" was the name for this device driver when it was "out-of-tree"
22and maintained at sourceforge.net.  When it was pushed into 2.6.16 for the
23first time, it was renamed to 'EDAC'.
24
25The bluesmoke project at sourceforge.net is now utilized as a 'staging area'
26for EDAC development, before it is sent upstream to kernel.org
27
28At the bluesmoke/EDAC project site is a series of quilt patches against
29recent kernels, stored in a SVN repository. For easier downloading, there
30is also a tarball snapshot available.
31
32============================================================================
33EDAC PURPOSE
34
35The 'edac' kernel module goal is to detect and report errors that occur
36within the computer system running under linux.
37
38MEMORY
39
40In the initial release, memory Correctable Errors (CE) and Uncorrectable
41Errors (UE) are the primary errors being harvested. These types of errors
42are harvested by the 'edac_mc' class of device.
43
44Detecting CE events, then harvesting those events and reporting them,
45CAN be a predictor of future UE events.  With CE events, the system can
46continue to operate, but with less safety. Preventive maintenance and
47proactive part replacement of memory DIMMs exhibiting CEs can reduce
48the likelihood of the dreaded UE events and system 'panics'.
49
50NON-MEMORY
51
52A new feature for EDAC, the edac_device class of device, was added in
53the 2.6.23 version of the kernel.
54
55This new device type allows for non-memory type of ECC hardware detectors
56to have their states harvested and presented to userspace via the sysfs
57interface.
58
59Some architectures have ECC detectors for L1, L2 and L3 caches, along with DMA
60engines, fabric switches, main data path switches, interconnections,
61and various other hardware data paths. If the hardware reports it, then
62a edac_device device probably can be constructed to harvest and present
63that to userspace.
64
65
66PCI BUS SCANNING
67
68In addition, PCI Bus Parity and SERR Errors are scanned for on PCI devices
69in order to determine if errors are occurring on data transfers.
70
71The presence of PCI Parity errors must be examined with a grain of salt.
72There are several add-in adapters that do NOT follow the PCI specification
73with regards to Parity generation and reporting. The specification says
74the vendor should tie the parity status bits to 0 if they do not intend
75to generate parity.  Some vendors do not do this, and thus the parity bit
76can "float" giving false positives.
77
78In the kernel there is a PCI device attribute located in sysfs that is
79checked by the EDAC PCI scanning code. If that attribute is set,
80PCI parity/error scanning is skipped for that device. The attribute
81is:
82
83	broken_parity_status
84
85as is located in /sys/devices/pci<XXX>/0000:XX:YY.Z directories for
86PCI devices.
87
88FUTURE HARDWARE SCANNING
89
90EDAC will have future error detectors that will be integrated with
91EDAC or added to it, in the following list:
92
93	MCE	Machine Check Exception
94	MCA	Machine Check Architecture
95	NMI	NMI notification of ECC errors
96	MSRs 	Machine Specific Register error cases
97	and other mechanisms.
98
99These errors are usually bus errors, ECC errors, thermal throttling
100and the like.
101
102
103============================================================================
104EDAC VERSIONING
105
106EDAC is composed of a "core" module (edac_core.ko) and several Memory
107Controller (MC) driver modules. On a given system, the CORE
108is loaded and one MC driver will be loaded. Both the CORE and
109the MC driver (or edac_device driver) have individual versions that reflect
110current release level of their respective modules.
111
112Thus, to "report" on what version a system is running, one must report both
113the CORE's and the MC driver's versions.
114
115
116LOADING
117
118If 'edac' was statically linked with the kernel then no loading is
119necessary.  If 'edac' was built as modules then simply modprobe the
120'edac' pieces that you need.  You should be able to modprobe
121hardware-specific modules and have the dependencies load the necessary core
122modules.
123
124Example:
125
126$> modprobe amd76x_edac
127
128loads both the amd76x_edac.ko memory controller module and the edac_mc.ko
129core module.
130
131
132============================================================================
133EDAC sysfs INTERFACE
134
135EDAC presents a 'sysfs' interface for control, reporting and attribute
136reporting purposes.
137
138EDAC lives in the /sys/devices/system/edac directory.
139
140Within this directory there currently reside 2 'edac' components:
141
142	mc	memory controller(s) system
143	pci	PCI control and status system
144
145
146============================================================================
147Memory Controller (mc) Model
148
149First a background on the memory controller's model abstracted in EDAC.
150Each 'mc' device controls a set of DIMM memory modules. These modules are
151laid out in a Chip-Select Row (csrowX) and Channel table (chX). There can
152be multiple csrows and multiple channels.
153
154Memory controllers allow for several csrows, with 8 csrows being a typical value.
155Yet, the actual number of csrows depends on the electrical "loading"
156of a given motherboard, memory controller and DIMM characteristics.
157
158Dual channels allows for 128 bit data transfers to the CPU from memory.
159Some newer chipsets allow for more than 2 channels, like Fully Buffered DIMMs
160(FB-DIMMs). The following example will assume 2 channels:
161
162
163		Channel 0	Channel 1
164	===================================
165	csrow0	| DIMM_A0	| DIMM_B0 |
166	csrow1	| DIMM_A0	| DIMM_B0 |
167	===================================
168
169	===================================
170	csrow2	| DIMM_A1	| DIMM_B1 |
171	csrow3	| DIMM_A1	| DIMM_B1 |
172	===================================
173
174In the above example table there are 4 physical slots on the motherboard
175for memory DIMMs:
176
177	DIMM_A0
178	DIMM_B0
179	DIMM_A1
180	DIMM_B1
181
182Labels for these slots are usually silk screened on the motherboard. Slots
183labeled 'A' are channel 0 in this example. Slots labeled 'B'
184are channel 1. Notice that there are two csrows possible on a
185physical DIMM. These csrows are allocated their csrow assignment
186based on the slot into which the memory DIMM is placed. Thus, when 1 DIMM
187is placed in each Channel, the csrows cross both DIMMs.
188
189Memory DIMMs come single or dual "ranked". A rank is a populated csrow.
190Thus, 2 single ranked DIMMs, placed in slots DIMM_A0 and DIMM_B0 above
191will have 1 csrow, csrow0. csrow1 will be empty. On the other hand,
192when 2 dual ranked DIMMs are similarly placed, then both csrow0 and
193csrow1 will be populated. The pattern repeats itself for csrow2 and
194csrow3.
195
196The representation of the above is reflected in the directory tree
197in EDAC's sysfs interface. Starting in directory
198/sys/devices/system/edac/mc each memory controller will be represented
199by its own 'mcX' directory, where 'X' is the index of the MC.
200
201
202	..../edac/mc/
203		   |
204		   |->mc0
205		   |->mc1
206		   |->mc2
207		   ....
208
209Under each 'mcX' directory each 'csrowX' is again represented by a
210'csrowX', where 'X' is the csrow index:
211
212
213	.../mc/mc0/
214		|
215		|->csrow0
216		|->csrow2
217		|->csrow3
218		....
219
220Notice that there is no csrow1, which indicates that csrow0 is
221composed of a single ranked DIMMs. This should also apply in both
222Channels, in order to have dual-channel mode be operational. Since
223both csrow2 and csrow3 are populated, this indicates a dual ranked
224set of DIMMs for channels 0 and 1.
225
226
227Within each of the 'mcX' and 'csrowX' directories are several
228EDAC control and attribute files.
229
230============================================================================
231'mcX' DIRECTORIES
232
233
234In 'mcX' directories are EDAC control and attribute files for
235this 'X' instance of the memory controllers:
236
237
238Counter reset control file:
239
240	'reset_counters'
241
242	This write-only control file will zero all the statistical counters
243	for UE and CE errors.  Zeroing the counters will also reset the timer
244	indicating how long since the last counter zero.  This is useful
245	for computing errors/time.  Since the counters are always reset at
246	driver initialization time, no module/kernel parameter is available.
247
248	RUN TIME: echo "anything" >/sys/devices/system/edac/mc/mc0/counter_reset
249
250		This resets the counters on memory controller 0
251
252
253Seconds since last counter reset control file:
254
255	'seconds_since_reset'
256
257	This attribute file displays how many seconds have elapsed since the
258	last counter reset. This can be used with the error counters to
259	measure error rates.
260
261
262
263Memory Controller name attribute file:
264
265	'mc_name'
266
267	This attribute file displays the type of memory controller
268	that is being utilized.
269
270
271Total memory managed by this memory controller attribute file:
272
273	'size_mb'
274
275	This attribute file displays, in count of megabytes, of memory
276	that this instance of memory controller manages.
277
278
279Total Uncorrectable Errors count attribute file:
280
281	'ue_count'
282
283	This attribute file displays the total count of uncorrectable
284	errors that have occurred on this memory controller. If panic_on_ue
285	is set this counter will not have a chance to increment,
286	since EDAC will panic the system.
287
288
289Total UE count that had no information attribute fileY:
290
291	'ue_noinfo_count'
292
293	This attribute file displays the number of UEs that have occurred
294	with no information as to which DIMM slot is having errors.
295
296
297Total Correctable Errors count attribute file:
298
299	'ce_count'
300
301	This attribute file displays the total count of correctable
302	errors that have occurred on this memory controller. This
303	count is very important to examine. CEs provide early
304	indications that a DIMM is beginning to fail. This count
305	field should be monitored for non-zero values and report
306	such information to the system administrator.
307
308
309Total Correctable Errors count attribute file:
310
311	'ce_noinfo_count'
312
313	This attribute file displays the number of CEs that
314	have occurred wherewith no information as to which DIMM slot
315	is having errors. Memory is handicapped, but operational,
316	yet no information is available to indicate which slot
317	the failing memory is in. This count field should be also
318	be monitored for non-zero values.
319
320Device Symlink:
321
322	'device'
323
324	Symlink to the memory controller device.
325
326Sdram memory scrubbing rate:
327
328	'sdram_scrub_rate'
329
330	Read/Write attribute file that controls memory scrubbing. The scrubbing
331	rate is set by writing a minimum bandwidth in bytes/sec to the attribute
332	file. The rate will be translated to an internal value that gives at
333	least the specified rate.
334
335	Reading the file will return the actual scrubbing rate employed.
336
337	If configuration fails or memory scrubbing is not implemented, the value
338	of the attribute file will be -1.
339
340
341
342============================================================================
343'csrowX' DIRECTORIES
344
345In the 'csrowX' directories are EDAC control and attribute files for
346this 'X' instance of csrow:
347
348
349Total Uncorrectable Errors count attribute file:
350
351	'ue_count'
352
353	This attribute file displays the total count of uncorrectable
354	errors that have occurred on this csrow. If panic_on_ue is set
355	this counter will not have a chance to increment, since EDAC
356	will panic the system.
357
358
359Total Correctable Errors count attribute file:
360
361	'ce_count'
362
363	This attribute file displays the total count of correctable
364	errors that have occurred on this csrow. This
365	count is very important to examine. CEs provide early
366	indications that a DIMM is beginning to fail. This count
367	field should be monitored for non-zero values and report
368	such information to the system administrator.
369
370
371Total memory managed by this csrow attribute file:
372
373	'size_mb'
374
375	This attribute file displays, in count of megabytes, of memory
376	that this csrow contains.
377
378
379Memory Type attribute file:
380
381	'mem_type'
382
383	This attribute file will display what type of memory is currently
384	on this csrow. Normally, either buffered or unbuffered memory.
385	Examples:
386		Registered-DDR
387		Unbuffered-DDR
388
389
390EDAC Mode of operation attribute file:
391
392	'edac_mode'
393
394	This attribute file will display what type of Error detection
395	and correction is being utilized.
396
397
398Device type attribute file:
399
400	'dev_type'
401
402	This attribute file will display what type of DRAM device is
403	being utilized on this DIMM.
404	Examples:
405		x1
406		x2
407		x4
408		x8
409
410
411Channel 0 CE Count attribute file:
412
413	'ch0_ce_count'
414
415	This attribute file will display the count of CEs on this
416	DIMM located in channel 0.
417
418
419Channel 0 UE Count attribute file:
420
421	'ch0_ue_count'
422
423	This attribute file will display the count of UEs on this
424	DIMM located in channel 0.
425
426
427Channel 0 DIMM Label control file:
428
429	'ch0_dimm_label'
430
431	This control file allows this DIMM to have a label assigned
432	to it. With this label in the module, when errors occur
433	the output can provide the DIMM label in the system log.
434	This becomes vital for panic events to isolate the
435	cause of the UE event.
436
437	DIMM Labels must be assigned after booting, with information
438	that correctly identifies the physical slot with its
439	silk screen label. This information is currently very
440	motherboard specific and determination of this information
441	must occur in userland at this time.
442
443
444Channel 1 CE Count attribute file:
445
446	'ch1_ce_count'
447
448	This attribute file will display the count of CEs on this
449	DIMM located in channel 1.
450
451
452Channel 1 UE Count attribute file:
453
454	'ch1_ue_count'
455
456	This attribute file will display the count of UEs on this
457	DIMM located in channel 0.
458
459
460Channel 1 DIMM Label control file:
461
462	'ch1_dimm_label'
463
464	This control file allows this DIMM to have a label assigned
465	to it. With this label in the module, when errors occur
466	the output can provide the DIMM label in the system log.
467	This becomes vital for panic events to isolate the
468	cause of the UE event.
469
470	DIMM Labels must be assigned after booting, with information
471	that correctly identifies the physical slot with its
472	silk screen label. This information is currently very
473	motherboard specific and determination of this information
474	must occur in userland at this time.
475
476============================================================================
477SYSTEM LOGGING
478
479If logging for UEs and CEs are enabled then system logs will have
480error notices indicating errors that have been detected:
481
482EDAC MC0: CE page 0x283, offset 0xce0, grain 8, syndrome 0x6ec3, row 0,
483channel 1 "DIMM_B1": amd76x_edac
484
485EDAC MC0: CE page 0x1e5, offset 0xfb0, grain 8, syndrome 0xb741, row 0,
486channel 1 "DIMM_B1": amd76x_edac
487
488
489The structure of the message is:
490	the memory controller			(MC0)
491	Error type				(CE)
492	memory page				(0x283)
493	offset in the page			(0xce0)
494	the byte granularity 			(grain 8)
495		or resolution of the error
496	the error syndrome			(0xb741)
497	memory row				(row 0)
498	memory channel				(channel 1)
499	DIMM label, if set prior		(DIMM B1
500	and then an optional, driver-specific message that may
501		have additional information.
502
503Both UEs and CEs with no info will lack all but memory controller,
504error type, a notice of "no info" and then an optional,
505driver-specific error message.
506
507
508============================================================================
509PCI Bus Parity Detection
510
511
512On Header Type 00 devices the primary status is looked at
513for any parity error regardless of whether Parity is enabled on the
514device.  (The spec indicates parity is generated in some cases).
515On Header Type 01 bridges, the secondary status register is also
516looked at to see if parity occurred on the bus on the other side of
517the bridge.
518
519
520SYSFS CONFIGURATION
521
522Under /sys/devices/system/edac/pci are control and attribute files as follows:
523
524
525Enable/Disable PCI Parity checking control file:
526
527	'check_pci_parity'
528
529
530	This control file enables or disables the PCI Bus Parity scanning
531	operation. Writing a 1 to this file enables the scanning. Writing
532	a 0 to this file disables the scanning.
533
534	Enable:
535	echo "1" >/sys/devices/system/edac/pci/check_pci_parity
536
537	Disable:
538	echo "0" >/sys/devices/system/edac/pci/check_pci_parity
539
540
541Parity Count:
542
543	'pci_parity_count'
544
545	This attribute file will display the number of parity errors that
546	have been detected.
547
548
549============================================================================
550MODULE PARAMETERS
551
552Panic on UE control file:
553
554	'edac_mc_panic_on_ue'
555
556	An uncorrectable error will cause a machine panic.  This is usually
557	desirable.  It is a bad idea to continue when an uncorrectable error
558	occurs - it is indeterminate what was uncorrected and the operating
559	system context might be so mangled that continuing will lead to further
560	corruption. If the kernel has MCE configured, then EDAC will never
561	notice the UE.
562
563	LOAD TIME: module/kernel parameter: edac_mc_panic_on_ue=[0|1]
564
565	RUN TIME:  echo "1" > /sys/module/edac_core/parameters/edac_mc_panic_on_ue
566
567
568Log UE control file:
569
570	'edac_mc_log_ue'
571
572	Generate kernel messages describing uncorrectable errors.  These errors
573	are reported through the system message log system.  UE statistics
574	will be accumulated even when UE logging is disabled.
575
576	LOAD TIME: module/kernel parameter: edac_mc_log_ue=[0|1]
577
578	RUN TIME: echo "1" > /sys/module/edac_core/parameters/edac_mc_log_ue
579
580
581Log CE control file:
582
583	'edac_mc_log_ce'
584
585	Generate kernel messages describing correctable errors.  These
586	errors are reported through the system message log system.
587	CE statistics will be accumulated even when CE logging is disabled.
588
589	LOAD TIME: module/kernel parameter: edac_mc_log_ce=[0|1]
590
591	RUN TIME: echo "1" > /sys/module/edac_core/parameters/edac_mc_log_ce
592
593
594Polling period control file:
595
596	'edac_mc_poll_msec'
597
598	The time period, in milliseconds, for polling for error information.
599	Too small a value wastes resources.  Too large a value might delay
600	necessary handling of errors and might loose valuable information for
601	locating the error.  1000 milliseconds (once each second) is the current
602	default. Systems which require all the bandwidth they can get, may
603	increase this.
604
605	LOAD TIME: module/kernel parameter: edac_mc_poll_msec=[0|1]
606
607	RUN TIME: echo "1000" > /sys/module/edac_core/parameters/edac_mc_poll_msec
608
609
610Panic on PCI PARITY Error:
611
612	'panic_on_pci_parity'
613
614
615	This control files enables or disables panicking when a parity
616	error has been detected.
617
618
619	module/kernel parameter: edac_panic_on_pci_pe=[0|1]
620
621	Enable:
622	echo "1" > /sys/module/edac_core/parameters/edac_panic_on_pci_pe
623
624	Disable:
625	echo "0" > /sys/module/edac_core/parameters/edac_panic_on_pci_pe
626
627
628
629=======================================================================
630
631
632EDAC_DEVICE type of device
633
634In the header file, edac_core.h, there is a series of edac_device structures
635and APIs for the EDAC_DEVICE.
636
637User space access to an edac_device is through the sysfs interface.
638
639At the location /sys/devices/system/edac (sysfs) new edac_device devices will
640appear.
641
642There is a three level tree beneath the above 'edac' directory. For example,
643the 'test_device_edac' device (found at the bluesmoke.sourceforget.net website)
644installs itself as:
645
646	/sys/devices/systm/edac/test-instance
647
648in this directory are various controls, a symlink and one or more 'instance'
649directorys.
650
651The standard default controls are:
652
653	log_ce		boolean to log CE events
654	log_ue		boolean to log UE events
655	panic_on_ue	boolean to 'panic' the system if an UE is encountered
656			(default off, can be set true via startup script)
657	poll_msec	time period between POLL cycles for events
658
659The test_device_edac device adds at least one of its own custom control:
660
661	test_bits	which in the current test driver does nothing but
662			show how it is installed. A ported driver can
663			add one or more such controls and/or attributes
664			for specific uses.
665			One out-of-tree driver uses controls here to allow
666			for ERROR INJECTION operations to hardware
667			injection registers
668
669The symlink points to the 'struct dev' that is registered for this edac_device.
670
671INSTANCES
672
673One or more instance directories are present. For the 'test_device_edac' case:
674
675	test-instance0
676
677
678In this directory there are two default counter attributes, which are totals of
679counter in deeper subdirectories.
680
681	ce_count	total of CE events of subdirectories
682	ue_count	total of UE events of subdirectories
683
684BLOCKS
685
686At the lowest directory level is the 'block' directory. There can be 0, 1
687or more blocks specified in each instance.
688
689	test-block0
690
691
692In this directory the default attributes are:
693
694	ce_count	which is counter of CE events for this 'block'
695			of hardware being monitored
696	ue_count	which is counter of UE events for this 'block'
697			of hardware being monitored
698
699
700The 'test_device_edac' device adds 4 attributes and 1 control:
701
702	test-block-bits-0	for every POLL cycle this counter
703				is incremented
704	test-block-bits-1	every 10 cycles, this counter is bumped once,
705				and test-block-bits-0 is set to 0
706	test-block-bits-2	every 100 cycles, this counter is bumped once,
707				and test-block-bits-1 is set to 0
708	test-block-bits-3	every 1000 cycles, this counter is bumped once,
709				and test-block-bits-2 is set to 0
710
711
712	reset-counters		writing ANY thing to this control will
713				reset all the above counters.
714
715
716Use of the 'test_device_edac' driver should any others to create their own
717unique drivers for their hardware systems.
718
719The 'test_device_edac' sample driver is located at the
720bluesmoke.sourceforge.net project site for EDAC.
721
722=======================================================================
723NEHALEM USAGE OF EDAC APIs
724
725This chapter documents some EXPERIMENTAL mappings for EDAC API to handle
726Nehalem EDAC driver. They will likely be changed on future versions
727of the driver.
728
729Due to the way Nehalem exports Memory Controller data, some adjustments
730were done at i7core_edac driver. This chapter will cover those differences
731
7321) On Nehalem, there are one Memory Controller per Quick Patch Interconnect
733   (QPI). At the driver, the term "socket" means one QPI. This is
734   associated with a physical CPU socket.
735
736   Each MC have 3 physical read channels, 3 physical write channels and
737   3 logic channels. The driver currenty sees it as just 3 channels.
738   Each channel can have up to 3 DIMMs.
739
740   The minimum known unity is DIMMs. There are no information about csrows.
741   As EDAC API maps the minimum unity is csrows, the driver sequencially
742   maps channel/dimm into different csrows.
743
744   For example, supposing the following layout:
745	Ch0 phy rd0, wr0 (0x063f4031): 2 ranks, UDIMMs
746	  dimm 0 1024 Mb offset: 0, bank: 8, rank: 1, row: 0x4000, col: 0x400
747	  dimm 1 1024 Mb offset: 4, bank: 8, rank: 1, row: 0x4000, col: 0x400
748        Ch1 phy rd1, wr1 (0x063f4031): 2 ranks, UDIMMs
749	  dimm 0 1024 Mb offset: 0, bank: 8, rank: 1, row: 0x4000, col: 0x400
750	Ch2 phy rd3, wr3 (0x063f4031): 2 ranks, UDIMMs
751	  dimm 0 1024 Mb offset: 0, bank: 8, rank: 1, row: 0x4000, col: 0x400
752   The driver will map it as:
753	csrow0: channel 0, dimm0
754	csrow1: channel 0, dimm1
755	csrow2: channel 1, dimm0
756	csrow3: channel 2, dimm0
757
758exports one
759   DIMM per csrow.
760
761   Each QPI is exported as a different memory controller.
762
7632) Nehalem MC has the hability to generate errors. The driver implements this
764   functionality via some error injection nodes:
765
766   For injecting a memory error, there are some sysfs nodes, under
767   /sys/devices/system/edac/mc/mc?/:
768
769   inject_addrmatch/*:
770      Controls the error injection mask register. It is possible to specify
771      several characteristics of the address to match an error code:
772         dimm = the affected dimm. Numbers are relative to a channel;
773         rank = the memory rank;
774         channel = the channel that will generate an error;
775         bank = the affected bank;
776         page = the page address;
777         column (or col) = the address column.
778      each of the above values can be set to "any" to match any valid value.
779
780      At driver init, all values are set to any.
781
782      For example, to generate an error at rank 1 of dimm 2, for any channel,
783      any bank, any page, any column:
784		echo 2 >/sys/devices/system/edac/mc/mc0/inject_addrmatch/dimm
785		echo 1 >/sys/devices/system/edac/mc/mc0/inject_addrmatch/rank
786
787	To return to the default behaviour of matching any, you can do:
788		echo any >/sys/devices/system/edac/mc/mc0/inject_addrmatch/dimm
789		echo any >/sys/devices/system/edac/mc/mc0/inject_addrmatch/rank
790
791   inject_eccmask:
792       specifies what bits will have troubles,
793
794   inject_section:
795       specifies what ECC cache section will get the error:
796		3 for both
797		2 for the highest
798		1 for the lowest
799
800   inject_type:
801       specifies the type of error, being a combination of the following bits:
802		bit 0 - repeat
803		bit 1 - ecc
804		bit 2 - parity
805
806       inject_enable starts the error generation when something different
807       than 0 is written.
808
809   All inject vars can be read. root permission is needed for write.
810
811   Datasheet states that the error will only be generated after a write on an
812   address that matches inject_addrmatch. It seems, however, that reading will
813   also produce an error.
814
815   For example, the following code will generate an error for any write access
816   at socket 0, on any DIMM/address on channel 2:
817
818   echo 2 >/sys/devices/system/edac/mc/mc0/inject_addrmatch/channel
819   echo 2 >/sys/devices/system/edac/mc/mc0/inject_type
820   echo 64 >/sys/devices/system/edac/mc/mc0/inject_eccmask
821   echo 3 >/sys/devices/system/edac/mc/mc0/inject_section
822   echo 1 >/sys/devices/system/edac/mc/mc0/inject_enable
823   dd if=/dev/mem of=/dev/null seek=16k bs=4k count=1 >& /dev/null
824
825   For socket 1, it is needed to replace "mc0" by "mc1" at the above
826   commands.
827
828   The generated error message will look like:
829
830   EDAC MC0: UE row 0, channel-a= 0 channel-b= 0 labels "-": NON_FATAL (addr = 0x0075b980, socket=0, Dimm=0, Channel=2, syndrome=0x00000040, count=1, Err=8c0000400001009f:4000080482 (read error: read ECC error))
831
8323) Nehalem specific Corrected Error memory counters
833
834   Nehalem have some registers to count memory errors. The driver uses those
835   registers to report Corrected Errors on devices with Registered Dimms.
836
837   However, those counters don't work with Unregistered Dimms. As the chipset
838   offers some counters that also work with UDIMMS (but with a worse level of
839   granularity than the default ones), the driver exposes those registers for
840   UDIMM memories.
841
842   They can be read by looking at the contents of all_channel_counts/
843
844   $ for i in /sys/devices/system/edac/mc/mc0/all_channel_counts/*; do echo $i; cat $i; done
845	/sys/devices/system/edac/mc/mc0/all_channel_counts/udimm0
846	0
847	/sys/devices/system/edac/mc/mc0/all_channel_counts/udimm1
848	0
849	/sys/devices/system/edac/mc/mc0/all_channel_counts/udimm2
850	0
851
852   What happens here is that errors on different csrows, but at the same
853   dimm number will increment the same counter.
854   So, in this memory mapping:
855	csrow0: channel 0, dimm0
856	csrow1: channel 0, dimm1
857	csrow2: channel 1, dimm0
858	csrow3: channel 2, dimm0
859   The hardware will increment udimm0 for an error at the first dimm at either
860	csrow0, csrow2  or csrow3;
861   The hardware will increment udimm1 for an error at the second dimm at either
862	csrow0, csrow2  or csrow3;
863   The hardware will increment udimm2 for an error at the third dimm at either
864	csrow0, csrow2  or csrow3;
865
8664) Standard error counters
867
868   The standard error counters are generated when an mcelog error is received
869   by the driver. Since, with udimm, this is counted by software, it is
870   possible that some errors could be lost. With rdimm's, they displays the
871   contents of the registers
872