123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872 |
- EDAC - Error Detection And Correction
- Written by Doug Thompson <dougthompson@xmission.com>
- 7 Dec 2005
- 17 Jul 2007 Updated
- (c) Mauro Carvalho Chehab <mchehab@redhat.com>
- 05 Aug 2009 Nehalem interface
- EDAC is maintained and written by:
- Doug Thompson, Dave Jiang, Dave Peterson et al,
- original author: Thayne Harbaugh,
- Contact:
- website: bluesmoke.sourceforge.net
- mailing list: bluesmoke-devel@lists.sourceforge.net
- "bluesmoke" was the name for this device driver when it was "out-of-tree"
- and maintained at sourceforge.net. When it was pushed into 2.6.16 for the
- first time, it was renamed to 'EDAC'.
- The bluesmoke project at sourceforge.net is now utilized as a 'staging area'
- for EDAC development, before it is sent upstream to kernel.org
- At the bluesmoke/EDAC project site is a series of quilt patches against
- recent kernels, stored in a SVN repository. For easier downloading, there
- is also a tarball snapshot available.
- ============================================================================
- EDAC PURPOSE
- The 'edac' kernel module goal is to detect and report errors that occur
- within the computer system running under linux.
- MEMORY
- In the initial release, memory Correctable Errors (CE) and Uncorrectable
- Errors (UE) are the primary errors being harvested. These types of errors
- are harvested by the 'edac_mc' class of device.
- Detecting CE events, then harvesting those events and reporting them,
- CAN be a predictor of future UE events. With CE events, the system can
- continue to operate, but with less safety. Preventive maintenance and
- proactive part replacement of memory DIMMs exhibiting CEs can reduce
- the likelihood of the dreaded UE events and system 'panics'.
- NON-MEMORY
- A new feature for EDAC, the edac_device class of device, was added in
- the 2.6.23 version of the kernel.
- This new device type allows for non-memory type of ECC hardware detectors
- to have their states harvested and presented to userspace via the sysfs
- interface.
- Some architectures have ECC detectors for L1, L2 and L3 caches, along with DMA
- engines, fabric switches, main data path switches, interconnections,
- and various other hardware data paths. If the hardware reports it, then
- a edac_device device probably can be constructed to harvest and present
- that to userspace.
- PCI BUS SCANNING
- In addition, PCI Bus Parity and SERR Errors are scanned for on PCI devices
- in order to determine if errors are occurring on data transfers.
- The presence of PCI Parity errors must be examined with a grain of salt.
- There are several add-in adapters that do NOT follow the PCI specification
- with regards to Parity generation and reporting. The specification says
- the vendor should tie the parity status bits to 0 if they do not intend
- to generate parity. Some vendors do not do this, and thus the parity bit
- can "float" giving false positives.
- In the kernel there is a PCI device attribute located in sysfs that is
- checked by the EDAC PCI scanning code. If that attribute is set,
- PCI parity/error scanning is skipped for that device. The attribute
- is:
- broken_parity_status
- as is located in /sys/devices/pci<XXX>/0000:XX:YY.Z directories for
- PCI devices.
- FUTURE HARDWARE SCANNING
- EDAC will have future error detectors that will be integrated with
- EDAC or added to it, in the following list:
- MCE Machine Check Exception
- MCA Machine Check Architecture
- NMI NMI notification of ECC errors
- MSRs Machine Specific Register error cases
- and other mechanisms.
- These errors are usually bus errors, ECC errors, thermal throttling
- and the like.
- ============================================================================
- EDAC VERSIONING
- EDAC is composed of a "core" module (edac_core.ko) and several Memory
- Controller (MC) driver modules. On a given system, the CORE
- is loaded and one MC driver will be loaded. Both the CORE and
- the MC driver (or edac_device driver) have individual versions that reflect
- current release level of their respective modules.
- Thus, to "report" on what version a system is running, one must report both
- the CORE's and the MC driver's versions.
- LOADING
- If 'edac' was statically linked with the kernel then no loading is
- necessary. If 'edac' was built as modules then simply modprobe the
- 'edac' pieces that you need. You should be able to modprobe
- hardware-specific modules and have the dependencies load the necessary core
- modules.
- Example:
- $> modprobe amd76x_edac
- loads both the amd76x_edac.ko memory controller module and the edac_mc.ko
- core module.
- ============================================================================
- EDAC sysfs INTERFACE
- EDAC presents a 'sysfs' interface for control, reporting and attribute
- reporting purposes.
- EDAC lives in the /sys/devices/system/edac directory.
- Within this directory there currently reside 2 'edac' components:
- mc memory controller(s) system
- pci PCI control and status system
- ============================================================================
- Memory Controller (mc) Model
- First a background on the memory controller's model abstracted in EDAC.
- Each 'mc' device controls a set of DIMM memory modules. These modules are
- laid out in a Chip-Select Row (csrowX) and Channel table (chX). There can
- be multiple csrows and multiple channels.
- Memory controllers allow for several csrows, with 8 csrows being a typical value.
- Yet, the actual number of csrows depends on the electrical "loading"
- of a given motherboard, memory controller and DIMM characteristics.
- Dual channels allows for 128 bit data transfers to the CPU from memory.
- Some newer chipsets allow for more than 2 channels, like Fully Buffered DIMMs
- (FB-DIMMs). The following example will assume 2 channels:
- Channel 0 Channel 1
- ===================================
- csrow0 | DIMM_A0 | DIMM_B0 |
- csrow1 | DIMM_A0 | DIMM_B0 |
- ===================================
- ===================================
- csrow2 | DIMM_A1 | DIMM_B1 |
- csrow3 | DIMM_A1 | DIMM_B1 |
- ===================================
- In the above example table there are 4 physical slots on the motherboard
- for memory DIMMs:
- DIMM_A0
- DIMM_B0
- DIMM_A1
- DIMM_B1
- Labels for these slots are usually silk screened on the motherboard. Slots
- labeled 'A' are channel 0 in this example. Slots labeled 'B'
- are channel 1. Notice that there are two csrows possible on a
- physical DIMM. These csrows are allocated their csrow assignment
- based on the slot into which the memory DIMM is placed. Thus, when 1 DIMM
- is placed in each Channel, the csrows cross both DIMMs.
- Memory DIMMs come single or dual "ranked". A rank is a populated csrow.
- Thus, 2 single ranked DIMMs, placed in slots DIMM_A0 and DIMM_B0 above
- will have 1 csrow, csrow0. csrow1 will be empty. On the other hand,
- when 2 dual ranked DIMMs are similarly placed, then both csrow0 and
- csrow1 will be populated. The pattern repeats itself for csrow2 and
- csrow3.
- The representation of the above is reflected in the directory tree
- in EDAC's sysfs interface. Starting in directory
- /sys/devices/system/edac/mc each memory controller will be represented
- by its own 'mcX' directory, where 'X' is the index of the MC.
- ..../edac/mc/
- |
- |->mc0
- |->mc1
- |->mc2
- ....
- Under each 'mcX' directory each 'csrowX' is again represented by a
- 'csrowX', where 'X' is the csrow index:
- .../mc/mc0/
- |
- |->csrow0
- |->csrow2
- |->csrow3
- ....
- Notice that there is no csrow1, which indicates that csrow0 is
- composed of a single ranked DIMMs. This should also apply in both
- Channels, in order to have dual-channel mode be operational. Since
- both csrow2 and csrow3 are populated, this indicates a dual ranked
- set of DIMMs for channels 0 and 1.
- Within each of the 'mcX' and 'csrowX' directories are several
- EDAC control and attribute files.
- ============================================================================
- 'mcX' DIRECTORIES
- In 'mcX' directories are EDAC control and attribute files for
- this 'X' instance of the memory controllers:
- Counter reset control file:
- 'reset_counters'
- This write-only control file will zero all the statistical counters
- for UE and CE errors. Zeroing the counters will also reset the timer
- indicating how long since the last counter zero. This is useful
- for computing errors/time. Since the counters are always reset at
- driver initialization time, no module/kernel parameter is available.
- RUN TIME: echo "anything" >/sys/devices/system/edac/mc/mc0/counter_reset
- This resets the counters on memory controller 0
- Seconds since last counter reset control file:
- 'seconds_since_reset'
- This attribute file displays how many seconds have elapsed since the
- last counter reset. This can be used with the error counters to
- measure error rates.
- Memory Controller name attribute file:
- 'mc_name'
- This attribute file displays the type of memory controller
- that is being utilized.
- Total memory managed by this memory controller attribute file:
- 'size_mb'
- This attribute file displays, in count of megabytes, of memory
- that this instance of memory controller manages.
- Total Uncorrectable Errors count attribute file:
- 'ue_count'
- This attribute file displays the total count of uncorrectable
- errors that have occurred on this memory controller. If panic_on_ue
- is set this counter will not have a chance to increment,
- since EDAC will panic the system.
- Total UE count that had no information attribute fileY:
- 'ue_noinfo_count'
- This attribute file displays the number of UEs that have occurred
- with no information as to which DIMM slot is having errors.
- Total Correctable Errors count attribute file:
- 'ce_count'
- This attribute file displays the total count of correctable
- errors that have occurred on this memory controller. This
- count is very important to examine. CEs provide early
- indications that a DIMM is beginning to fail. This count
- field should be monitored for non-zero values and report
- such information to the system administrator.
- Total Correctable Errors count attribute file:
- 'ce_noinfo_count'
- This attribute file displays the number of CEs that
- have occurred wherewith no information as to which DIMM slot
- is having errors. Memory is handicapped, but operational,
- yet no information is available to indicate which slot
- the failing memory is in. This count field should be also
- be monitored for non-zero values.
- Device Symlink:
- 'device'
- Symlink to the memory controller device.
- Sdram memory scrubbing rate:
- 'sdram_scrub_rate'
- Read/Write attribute file that controls memory scrubbing. The scrubbing
- rate is set by writing a minimum bandwidth in bytes/sec to the attribute
- file. The rate will be translated to an internal value that gives at
- least the specified rate.
- Reading the file will return the actual scrubbing rate employed.
- If configuration fails or memory scrubbing is not implemented, the value
- of the attribute file will be -1.
- ============================================================================
- 'csrowX' DIRECTORIES
- In the 'csrowX' directories are EDAC control and attribute files for
- this 'X' instance of csrow:
- Total Uncorrectable Errors count attribute file:
- 'ue_count'
- This attribute file displays the total count of uncorrectable
- errors that have occurred on this csrow. If panic_on_ue is set
- this counter will not have a chance to increment, since EDAC
- will panic the system.
- Total Correctable Errors count attribute file:
- 'ce_count'
- This attribute file displays the total count of correctable
- errors that have occurred on this csrow. This
- count is very important to examine. CEs provide early
- indications that a DIMM is beginning to fail. This count
- field should be monitored for non-zero values and report
- such information to the system administrator.
- Total memory managed by this csrow attribute file:
- 'size_mb'
- This attribute file displays, in count of megabytes, of memory
- that this csrow contains.
- Memory Type attribute file:
- 'mem_type'
- This attribute file will display what type of memory is currently
- on this csrow. Normally, either buffered or unbuffered memory.
- Examples:
- Registered-DDR
- Unbuffered-DDR
- EDAC Mode of operation attribute file:
- 'edac_mode'
- This attribute file will display what type of Error detection
- and correction is being utilized.
- Device type attribute file:
- 'dev_type'
- This attribute file will display what type of DRAM device is
- being utilized on this DIMM.
- Examples:
- x1
- x2
- x4
- x8
- Channel 0 CE Count attribute file:
- 'ch0_ce_count'
- This attribute file will display the count of CEs on this
- DIMM located in channel 0.
- Channel 0 UE Count attribute file:
- 'ch0_ue_count'
- This attribute file will display the count of UEs on this
- DIMM located in channel 0.
- Channel 0 DIMM Label control file:
- 'ch0_dimm_label'
- This control file allows this DIMM to have a label assigned
- to it. With this label in the module, when errors occur
- the output can provide the DIMM label in the system log.
- This becomes vital for panic events to isolate the
- cause of the UE event.
- DIMM Labels must be assigned after booting, with information
- that correctly identifies the physical slot with its
- silk screen label. This information is currently very
- motherboard specific and determination of this information
- must occur in userland at this time.
- Channel 1 CE Count attribute file:
- 'ch1_ce_count'
- This attribute file will display the count of CEs on this
- DIMM located in channel 1.
- Channel 1 UE Count attribute file:
- 'ch1_ue_count'
- This attribute file will display the count of UEs on this
- DIMM located in channel 0.
- Channel 1 DIMM Label control file:
- 'ch1_dimm_label'
- This control file allows this DIMM to have a label assigned
- to it. With this label in the module, when errors occur
- the output can provide the DIMM label in the system log.
- This becomes vital for panic events to isolate the
- cause of the UE event.
- DIMM Labels must be assigned after booting, with information
- that correctly identifies the physical slot with its
- silk screen label. This information is currently very
- motherboard specific and determination of this information
- must occur in userland at this time.
- ============================================================================
- SYSTEM LOGGING
- If logging for UEs and CEs are enabled then system logs will have
- error notices indicating errors that have been detected:
- EDAC MC0: CE page 0x283, offset 0xce0, grain 8, syndrome 0x6ec3, row 0,
- channel 1 "DIMM_B1": amd76x_edac
- EDAC MC0: CE page 0x1e5, offset 0xfb0, grain 8, syndrome 0xb741, row 0,
- channel 1 "DIMM_B1": amd76x_edac
- The structure of the message is:
- the memory controller (MC0)
- Error type (CE)
- memory page (0x283)
- offset in the page (0xce0)
- the byte granularity (grain 8)
- or resolution of the error
- the error syndrome (0xb741)
- memory row (row 0)
- memory channel (channel 1)
- DIMM label, if set prior (DIMM B1
- and then an optional, driver-specific message that may
- have additional information.
- Both UEs and CEs with no info will lack all but memory controller,
- error type, a notice of "no info" and then an optional,
- driver-specific error message.
- ============================================================================
- PCI Bus Parity Detection
- On Header Type 00 devices the primary status is looked at
- for any parity error regardless of whether Parity is enabled on the
- device. (The spec indicates parity is generated in some cases).
- On Header Type 01 bridges, the secondary status register is also
- looked at to see if parity occurred on the bus on the other side of
- the bridge.
- SYSFS CONFIGURATION
- Under /sys/devices/system/edac/pci are control and attribute files as follows:
- Enable/Disable PCI Parity checking control file:
- 'check_pci_parity'
- This control file enables or disables the PCI Bus Parity scanning
- operation. Writing a 1 to this file enables the scanning. Writing
- a 0 to this file disables the scanning.
- Enable:
- echo "1" >/sys/devices/system/edac/pci/check_pci_parity
- Disable:
- echo "0" >/sys/devices/system/edac/pci/check_pci_parity
- Parity Count:
- 'pci_parity_count'
- This attribute file will display the number of parity errors that
- have been detected.
- ============================================================================
- MODULE PARAMETERS
- Panic on UE control file:
- 'edac_mc_panic_on_ue'
- An uncorrectable error will cause a machine panic. This is usually
- desirable. It is a bad idea to continue when an uncorrectable error
- occurs - it is indeterminate what was uncorrected and the operating
- system context might be so mangled that continuing will lead to further
- corruption. If the kernel has MCE configured, then EDAC will never
- notice the UE.
- LOAD TIME: module/kernel parameter: edac_mc_panic_on_ue=[0|1]
- RUN TIME: echo "1" > /sys/module/edac_core/parameters/edac_mc_panic_on_ue
- Log UE control file:
- 'edac_mc_log_ue'
- Generate kernel messages describing uncorrectable errors. These errors
- are reported through the system message log system. UE statistics
- will be accumulated even when UE logging is disabled.
- LOAD TIME: module/kernel parameter: edac_mc_log_ue=[0|1]
- RUN TIME: echo "1" > /sys/module/edac_core/parameters/edac_mc_log_ue
- Log CE control file:
- 'edac_mc_log_ce'
- Generate kernel messages describing correctable errors. These
- errors are reported through the system message log system.
- CE statistics will be accumulated even when CE logging is disabled.
- LOAD TIME: module/kernel parameter: edac_mc_log_ce=[0|1]
- RUN TIME: echo "1" > /sys/module/edac_core/parameters/edac_mc_log_ce
- Polling period control file:
- 'edac_mc_poll_msec'
- The time period, in milliseconds, for polling for error information.
- Too small a value wastes resources. Too large a value might delay
- necessary handling of errors and might loose valuable information for
- locating the error. 1000 milliseconds (once each second) is the current
- default. Systems which require all the bandwidth they can get, may
- increase this.
- LOAD TIME: module/kernel parameter: edac_mc_poll_msec=[0|1]
- RUN TIME: echo "1000" > /sys/module/edac_core/parameters/edac_mc_poll_msec
- Panic on PCI PARITY Error:
- 'panic_on_pci_parity'
- This control files enables or disables panicking when a parity
- error has been detected.
- module/kernel parameter: edac_panic_on_pci_pe=[0|1]
- Enable:
- echo "1" > /sys/module/edac_core/parameters/edac_panic_on_pci_pe
- Disable:
- echo "0" > /sys/module/edac_core/parameters/edac_panic_on_pci_pe
- =======================================================================
- EDAC_DEVICE type of device
- In the header file, edac_core.h, there is a series of edac_device structures
- and APIs for the EDAC_DEVICE.
- User space access to an edac_device is through the sysfs interface.
- At the location /sys/devices/system/edac (sysfs) new edac_device devices will
- appear.
- There is a three level tree beneath the above 'edac' directory. For example,
- the 'test_device_edac' device (found at the bluesmoke.sourceforget.net website)
- installs itself as:
- /sys/devices/systm/edac/test-instance
- in this directory are various controls, a symlink and one or more 'instance'
- directorys.
- The standard default controls are:
- log_ce boolean to log CE events
- log_ue boolean to log UE events
- panic_on_ue boolean to 'panic' the system if an UE is encountered
- (default off, can be set true via startup script)
- poll_msec time period between POLL cycles for events
- The test_device_edac device adds at least one of its own custom control:
- test_bits which in the current test driver does nothing but
- show how it is installed. A ported driver can
- add one or more such controls and/or attributes
- for specific uses.
- One out-of-tree driver uses controls here to allow
- for ERROR INJECTION operations to hardware
- injection registers
- The symlink points to the 'struct dev' that is registered for this edac_device.
- INSTANCES
- One or more instance directories are present. For the 'test_device_edac' case:
- test-instance0
- In this directory there are two default counter attributes, which are totals of
- counter in deeper subdirectories.
- ce_count total of CE events of subdirectories
- ue_count total of UE events of subdirectories
- BLOCKS
- At the lowest directory level is the 'block' directory. There can be 0, 1
- or more blocks specified in each instance.
- test-block0
- In this directory the default attributes are:
- ce_count which is counter of CE events for this 'block'
- of hardware being monitored
- ue_count which is counter of UE events for this 'block'
- of hardware being monitored
- The 'test_device_edac' device adds 4 attributes and 1 control:
- test-block-bits-0 for every POLL cycle this counter
- is incremented
- test-block-bits-1 every 10 cycles, this counter is bumped once,
- and test-block-bits-0 is set to 0
- test-block-bits-2 every 100 cycles, this counter is bumped once,
- and test-block-bits-1 is set to 0
- test-block-bits-3 every 1000 cycles, this counter is bumped once,
- and test-block-bits-2 is set to 0
- reset-counters writing ANY thing to this control will
- reset all the above counters.
- Use of the 'test_device_edac' driver should any others to create their own
- unique drivers for their hardware systems.
- The 'test_device_edac' sample driver is located at the
- bluesmoke.sourceforge.net project site for EDAC.
- =======================================================================
- NEHALEM USAGE OF EDAC APIs
- This chapter documents some EXPERIMENTAL mappings for EDAC API to handle
- Nehalem EDAC driver. They will likely be changed on future versions
- of the driver.
- Due to the way Nehalem exports Memory Controller data, some adjustments
- were done at i7core_edac driver. This chapter will cover those differences
- 1) On Nehalem, there are one Memory Controller per Quick Patch Interconnect
- (QPI). At the driver, the term "socket" means one QPI. This is
- associated with a physical CPU socket.
- Each MC have 3 physical read channels, 3 physical write channels and
- 3 logic channels. The driver currenty sees it as just 3 channels.
- Each channel can have up to 3 DIMMs.
- The minimum known unity is DIMMs. There are no information about csrows.
- As EDAC API maps the minimum unity is csrows, the driver sequencially
- maps channel/dimm into different csrows.
- For example, supposing the following layout:
- Ch0 phy rd0, wr0 (0x063f4031): 2 ranks, UDIMMs
- dimm 0 1024 Mb offset: 0, bank: 8, rank: 1, row: 0x4000, col: 0x400
- dimm 1 1024 Mb offset: 4, bank: 8, rank: 1, row: 0x4000, col: 0x400
- Ch1 phy rd1, wr1 (0x063f4031): 2 ranks, UDIMMs
- dimm 0 1024 Mb offset: 0, bank: 8, rank: 1, row: 0x4000, col: 0x400
- Ch2 phy rd3, wr3 (0x063f4031): 2 ranks, UDIMMs
- dimm 0 1024 Mb offset: 0, bank: 8, rank: 1, row: 0x4000, col: 0x400
- The driver will map it as:
- csrow0: channel 0, dimm0
- csrow1: channel 0, dimm1
- csrow2: channel 1, dimm0
- csrow3: channel 2, dimm0
- exports one
- DIMM per csrow.
- Each QPI is exported as a different memory controller.
- 2) Nehalem MC has the hability to generate errors. The driver implements this
- functionality via some error injection nodes:
- For injecting a memory error, there are some sysfs nodes, under
- /sys/devices/system/edac/mc/mc?/:
- inject_addrmatch/*:
- Controls the error injection mask register. It is possible to specify
- several characteristics of the address to match an error code:
- dimm = the affected dimm. Numbers are relative to a channel;
- rank = the memory rank;
- channel = the channel that will generate an error;
- bank = the affected bank;
- page = the page address;
- column (or col) = the address column.
- each of the above values can be set to "any" to match any valid value.
- At driver init, all values are set to any.
- For example, to generate an error at rank 1 of dimm 2, for any channel,
- any bank, any page, any column:
- echo 2 >/sys/devices/system/edac/mc/mc0/inject_addrmatch/dimm
- echo 1 >/sys/devices/system/edac/mc/mc0/inject_addrmatch/rank
- To return to the default behaviour of matching any, you can do:
- echo any >/sys/devices/system/edac/mc/mc0/inject_addrmatch/dimm
- echo any >/sys/devices/system/edac/mc/mc0/inject_addrmatch/rank
- inject_eccmask:
- specifies what bits will have troubles,
- inject_section:
- specifies what ECC cache section will get the error:
- 3 for both
- 2 for the highest
- 1 for the lowest
- inject_type:
- specifies the type of error, being a combination of the following bits:
- bit 0 - repeat
- bit 1 - ecc
- bit 2 - parity
- inject_enable starts the error generation when something different
- than 0 is written.
- All inject vars can be read. root permission is needed for write.
- Datasheet states that the error will only be generated after a write on an
- address that matches inject_addrmatch. It seems, however, that reading will
- also produce an error.
- For example, the following code will generate an error for any write access
- at socket 0, on any DIMM/address on channel 2:
- echo 2 >/sys/devices/system/edac/mc/mc0/inject_addrmatch/channel
- echo 2 >/sys/devices/system/edac/mc/mc0/inject_type
- echo 64 >/sys/devices/system/edac/mc/mc0/inject_eccmask
- echo 3 >/sys/devices/system/edac/mc/mc0/inject_section
- echo 1 >/sys/devices/system/edac/mc/mc0/inject_enable
- dd if=/dev/mem of=/dev/null seek=16k bs=4k count=1 >& /dev/null
- For socket 1, it is needed to replace "mc0" by "mc1" at the above
- commands.
- The generated error message will look like:
- 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))
- 3) Nehalem specific Corrected Error memory counters
- Nehalem have some registers to count memory errors. The driver uses those
- registers to report Corrected Errors on devices with Registered Dimms.
- However, those counters don't work with Unregistered Dimms. As the chipset
- offers some counters that also work with UDIMMS (but with a worse level of
- granularity than the default ones), the driver exposes those registers for
- UDIMM memories.
- They can be read by looking at the contents of all_channel_counts/
- $ for i in /sys/devices/system/edac/mc/mc0/all_channel_counts/*; do echo $i; cat $i; done
- /sys/devices/system/edac/mc/mc0/all_channel_counts/udimm0
- 0
- /sys/devices/system/edac/mc/mc0/all_channel_counts/udimm1
- 0
- /sys/devices/system/edac/mc/mc0/all_channel_counts/udimm2
- 0
- What happens here is that errors on different csrows, but at the same
- dimm number will increment the same counter.
- So, in this memory mapping:
- csrow0: channel 0, dimm0
- csrow1: channel 0, dimm1
- csrow2: channel 1, dimm0
- csrow3: channel 2, dimm0
- The hardware will increment udimm0 for an error at the first dimm at either
- csrow0, csrow2 or csrow3;
- The hardware will increment udimm1 for an error at the second dimm at either
- csrow0, csrow2 or csrow3;
- The hardware will increment udimm2 for an error at the third dimm at either
- csrow0, csrow2 or csrow3;
- 4) Standard error counters
- The standard error counters are generated when an mcelog error is received
- by the driver. Since, with udimm, this is counted by software, it is
- possible that some errors could be lost. With rdimm's, they displays the
- contents of the registers
|