€•‡H      Œsphinx.addnodes”Œdocument”“”)”}”(Œ	rawsource”Œ ”Œchildren”]”(Œtranslations”ŒLanguagesNode”“”)”}”(hhh]”(h Œpending_xref”“”)”}”(hhh]”Œdocutils.nodes”ŒText”“”ŒChinese (Simplified)”…””}”Œparent”hsbaŒ
attributes”}”(Œids”]”Œclasses”]”Œnames”]”Œdupnames”]”Œbackrefs”]”Œ	refdomain”Œstd”Œreftype”Œdoc”Œ	reftarget”Œ!/translations/zh_CN/edac/features”Œmodname”NŒ	classname”NŒrefexplicit”ˆuŒtagname”hhhubh)”}”(hhh]”hŒChinese (Traditional)”…””}”hh2sbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ!/translations/zh_TW/edac/features”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒItalian”…””}”hhFsbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ!/translations/it_IT/edac/features”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒJapanese”…””}”hhZsbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ!/translations/ja_JP/edac/features”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒKorean”…””}”hhnsbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ!/translations/ko_KR/edac/features”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒSpanish”…””}”hh‚sbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ!/translations/sp_SP/edac/features”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubeh}”(h]”h ]”h"]”h$]”h&]”Œcurrent_language”ŒEnglish”uh1h
hhŒ	_document”hŒsource”NŒline”NubhŒcomment”“”)”}”(hŒCSPDX-License-Identifier: GPL-2.0 OR GFDL-1.2-no-invariants-or-later”h]”hŒCSPDX-License-Identifier: GPL-2.0 OR GFDL-1.2-no-invariants-or-later”…””}”hh£sbah}”(h]”h ]”h"]”h$]”h&]”Œ	xml:space”Œpreserve”uh1h¡hhhžhhŸŒ;/var/lib/git/docbuild/linux/Documentation/edac/features.rst”h KubhŒsection”“”)”}”(hhh]”(hŒtitle”“”)”}”(hŒEDAC/RAS features”h]”hŒEDAC/RAS features”…””}”(hh»hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¹hh¶hžhhŸh³h KubhŒ	paragraph”“”)”}”(hŒ*Copyright (c) 2024-2025 HiSilicon Limited.”h]”hŒ*Copyright (c) 2024-2025 HiSilicon Limited.”…””}”(hhËhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h Khh¶hžhubhŒ
field_list”“”)”}”(hhh]”(hŒfield”“”)”}”(hhh]”(hŒ
field_name”“”)”}”(hŒAuthor”h]”hŒAuthor”…””}”(hhåhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hãhhàhŸh³h K ubhŒ
field_body”“”)”}”(hŒ"Shiju Jose <shiju.jose@huawei.com>”h]”hÊ)”}”(hh÷h]”(hŒShiju Jose <”…””}”(hhùhžhhŸNh NubhŒ	reference”“”)”}”(hŒshiju.jose@huawei.com”h]”hŒshiju.jose@huawei.com”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”Œmailto:shiju.jose@huawei.com”uh1j   hhùubhŒ>”…””}”(hhùhžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h K	hhõubah}”(h]”h ]”h"]”h$]”h&]”uh1hóhhàubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÞhŸh³h K	hhÛhžhubhß)”}”(hhh]”(hä)”}”(hŒLicense”h]”hŒLicense”…””}”(hj+  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hãhj(  hŸh³h K ubhô)”}”(hŒ•The GNU Free Documentation License, Version 1.2 without
Invariant Sections, Front-Cover Texts nor Back-Cover Texts.
(dual licensed under the GPL v2)
”h]”hÊ)”}”(hŒ”The GNU Free Documentation License, Version 1.2 without
Invariant Sections, Front-Cover Texts nor Back-Cover Texts.
(dual licensed under the GPL v2)”h]”hŒ”The GNU Free Documentation License, Version 1.2 without
Invariant Sections, Front-Cover Texts nor Back-Cover Texts.
(dual licensed under the GPL v2)”…””}”(hj=  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h K
hj9  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hóhj(  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÞhŸh³h K
hhÛhžhubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÙhh¶hžhhŸh³h K	ubhŒbullet_list”“”)”}”(hhh]”hŒ	list_item”“”)”}”(hŒWritten for: 6.15
”h]”hÊ)”}”(hŒWritten for: 6.15”h]”hŒWritten for: 6.15”…””}”(hjh  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h Khjd  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jb  hj_  hžhhŸh³h Nubah}”(h]”h ]”h"]”h$]”h&]”Œbullet”Œ-”uh1j]  hŸh³h Khh¶hžhubhµ)”}”(hhh]”(hº)”}”(hŒIntroduction”h]”hŒIntroduction”…””}”(hj‡  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¹hj„  hžhhŸh³h KubhÊ)”}”(hŒ3EDAC/RAS components plugging and high-level design:”h]”hŒ3EDAC/RAS components plugging and high-level design:”…””}”(hj•  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h Khj„  hžhubhŒenumerated_list”“”)”}”(hhh]”(jc  )”}”(hŒScrub control
”h]”hÊ)”}”(hŒScrub control”h]”hŒScrub control”…””}”(hj¬  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h Khj¨  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jb  hj¥  hžhhŸh³h Nubjc  )”}”(hŒ Error Check Scrub (ECS) control
”h]”hÊ)”}”(hŒError Check Scrub (ECS) control”h]”hŒError Check Scrub (ECS) control”…””}”(hjÄ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h KhjÀ  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jb  hj¥  hžhhŸh³h Nubjc  )”}”(hŒACPI RAS2 features
”h]”hÊ)”}”(hŒACPI RAS2 features”h]”hŒACPI RAS2 features”…””}”(hjÜ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h KhjØ  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jb  hj¥  hžhhŸh³h Nubjc  )”}”(hŒ"Post Package Repair (PPR) control
”h]”hÊ)”}”(hŒ!Post Package Repair (PPR) control”h]”hŒ!Post Package Repair (PPR) control”…””}”(hjô  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h Khjð  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jb  hj¥  hžhhŸh³h Nubjc  )”}”(hŒMemory Sparing Repair control
”h]”hÊ)”}”(hŒMemory Sparing Repair control”h]”hŒMemory Sparing Repair control”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h Khj  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jb  hj¥  hžhhŸh³h Nubeh}”(h]”h ]”h"]”h$]”h&]”Œenumtype”Œarabic”Œprefix”hŒsuffix”Œ.”uh1j£  hj„  hžhhŸh³h KubhÊ)”}”(hŒ;High level design is illustrated in the following diagram::”h]”hŒ:High level design is illustrated in the following diagram:”…””}”(hj+  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h Khj„  hžhubhŒliteral_block”“”)”}”(hXt       +-----------------------------------------------+
     |   Userspace - Rasdaemon                       |
     | +-------------+                               |
     | | RAS CXL mem |     +---------------+         |
     | |error handler|---->|               |         |
     | +-------------+     | RAS dynamic   |         |
     | +-------------+     | scrub, memory |         |
     | | RAS memory  |---->| repair control|         |
     | |error handler|     +----|----------+         |
     | +-------------+          |                    |
     +--------------------------|--------------------+
                                |
                                |
+-------------------------------|------------------------------+
|     Kernel EDAC extension for | controlling RAS Features     |
|+------------------------------|----------------------------+ |
|| EDAC Core          Sysfs EDAC| Bus                        | |
||   +--------------------------|---------------------------+| |
||   |/sys/bus/edac/devices/<dev>/scrubX/ |   | EDAC device || |
||   |/sys/bus/edac/devices/<dev>/ecsX/   |<->| EDAC MC     || |
||   |/sys/bus/edac/devices/<dev>/repairX |   | EDAC sysfs  || |
||   +---------------------------|--------------------------+| |
||                           EDAC|Bus                        | |
||                               |                           | |
||   +----------+ Get feature    |      Get feature          | |
||   |          | desc +---------|------+ desc +----------+  | |
||   |EDAC scrub|<-----| EDAC device    |      |          |  | |
||   +----------+      | driver- RAS    |----->| EDAC mem |  | |
||   +----------+      | feature control|      | repair   |  | |
||   |          |<-----|                |      +----------+  | |
||   |EDAC ECS  |      +---------|------+                    | |
||   +----------+    Register RAS|features                   | |
||         ______________________|_____________              | |
|+---------|---------------|------------------|--------------+ |
|  +-------|----+  +-------|-------+     +----|----------+     |
|  |            |  | CXL mem driver|     | Client driver |     |
|  | ACPI RAS2  |  | scrub, ECS,   |     | memory repair |     |
|  | driver     |  | sparing, PPR  |     | features      |     |
|  +-----|------+  +-------|-------+     +------|--------+     |
|        |                 |                    |              |
+--------|-----------------|--------------------|--------------+
         |                 |                    |
+--------|-----------------|--------------------|--------------+
|    +---|-----------------|--------------------|-------+      |
|    |                                                  |      |
|    |            Platform HW and Firmware              |      |
|    +--------------------------------------------------+      |
+--------------------------------------------------------------+”h]”hXt       +-----------------------------------------------+
     |   Userspace - Rasdaemon                       |
     | +-------------+                               |
     | | RAS CXL mem |     +---------------+         |
     | |error handler|---->|               |         |
     | +-------------+     | RAS dynamic   |         |
     | +-------------+     | scrub, memory |         |
     | | RAS memory  |---->| repair control|         |
     | |error handler|     +----|----------+         |
     | +-------------+          |                    |
     +--------------------------|--------------------+
                                |
                                |
+-------------------------------|------------------------------+
|     Kernel EDAC extension for | controlling RAS Features     |
|+------------------------------|----------------------------+ |
|| EDAC Core          Sysfs EDAC| Bus                        | |
||   +--------------------------|---------------------------+| |
||   |/sys/bus/edac/devices/<dev>/scrubX/ |   | EDAC device || |
||   |/sys/bus/edac/devices/<dev>/ecsX/   |<->| EDAC MC     || |
||   |/sys/bus/edac/devices/<dev>/repairX |   | EDAC sysfs  || |
||   +---------------------------|--------------------------+| |
||                           EDAC|Bus                        | |
||                               |                           | |
||   +----------+ Get feature    |      Get feature          | |
||   |          | desc +---------|------+ desc +----------+  | |
||   |EDAC scrub|<-----| EDAC device    |      |          |  | |
||   +----------+      | driver- RAS    |----->| EDAC mem |  | |
||   +----------+      | feature control|      | repair   |  | |
||   |          |<-----|                |      +----------+  | |
||   |EDAC ECS  |      +---------|------+                    | |
||   +----------+    Register RAS|features                   | |
||         ______________________|_____________              | |
|+---------|---------------|------------------|--------------+ |
|  +-------|----+  +-------|-------+     +----|----------+     |
|  |            |  | CXL mem driver|     | Client driver |     |
|  | ACPI RAS2  |  | scrub, ECS,   |     | memory repair |     |
|  | driver     |  | sparing, PPR  |     | features      |     |
|  +-----|------+  +-------|-------+     +------|--------+     |
|        |                 |                    |              |
+--------|-----------------|--------------------|--------------+
         |                 |                    |
+--------|-----------------|--------------------|--------------+
|    +---|-----------------|--------------------|-------+      |
|    |                                                  |      |
|    |            Platform HW and Firmware              |      |
|    +--------------------------------------------------+      |
+--------------------------------------------------------------+”…””}”hj;  sbah}”(h]”h ]”h"]”h$]”h&]”h±h²uh1j9  hŸh³h K!hj„  hžhubj¤  )”}”(hhh]”(jc  )”}”(hŒ}EDAC Features components - Create feature-specific descriptors. For
example: scrub, ECS, memory repair in the above diagram.
”h]”hÊ)”}”(hŒ|EDAC Features components - Create feature-specific descriptors. For
example: scrub, ECS, memory repair in the above diagram.”h]”hŒ|EDAC Features components - Create feature-specific descriptors. For
example: scrub, ECS, memory repair in the above diagram.”…””}”(hjP  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h KShjL  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jb  hjI  hžhhŸh³h Nubjc  )”}”(hX  EDAC device driver for controlling RAS Features - Get feature's attribute
descriptors from EDAC RAS feature component and registers device's RAS
features with EDAC bus and expose the features control attributes via
sysfs. For example, /sys/bus/edac/devices/<dev-name>/<feature>X/
”h]”hÊ)”}”(hX  EDAC device driver for controlling RAS Features - Get feature's attribute
descriptors from EDAC RAS feature component and registers device's RAS
features with EDAC bus and expose the features control attributes via
sysfs. For example, /sys/bus/edac/devices/<dev-name>/<feature>X/”h]”hX  EDAC device driver for controlling RAS Features - Get featureâ€™s attribute
descriptors from EDAC RAS feature component and registers deviceâ€™s RAS
features with EDAC bus and expose the features control attributes via
sysfs. For example, /sys/bus/edac/devices/<dev-name>/<feature>X/”…””}”(hjh  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h KVhjd  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jb  hjI  hžhhŸh³h Nubjc  )”}”(hŒÖRAS dynamic feature controller - Userspace sample modules in rasdaemon for
dynamic scrub/repair control to issue scrubbing/repair when excess number
of corrected memory errors are reported in a short span of time.
”h]”hÊ)”}”(hŒÕRAS dynamic feature controller - Userspace sample modules in rasdaemon for
dynamic scrub/repair control to issue scrubbing/repair when excess number
of corrected memory errors are reported in a short span of time.”h]”hŒÕRAS dynamic feature controller - Userspace sample modules in rasdaemon for
dynamic scrub/repair control to issue scrubbing/repair when excess number
of corrected memory errors are reported in a short span of time.”…””}”(hj€  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h K[hj|  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jb  hjI  hžhhŸh³h Nubeh}”(h]”h ]”h"]”h$]”h&]”j&  j'  j(  hj)  j*  uh1j£  hj„  hžhhŸh³h KSubeh}”(h]”Œintroduction”ah ]”h"]”Œintroduction”ah$]”h&]”uh1h´hh¶hžhhŸh³h Kubhµ)”}”(hhh]”(hº)”}”(hŒRAS features”h]”hŒRAS features”…””}”(hj¥  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¹hj¢  hžhhŸh³h K`ubj¤  )”}”(hhh]”jc  )”}”(hŒMemory Scrub
”h]”hÊ)”}”(hŒMemory Scrub”h]”hŒMemory Scrub”…””}”(hjº  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h Kahj¶  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jb  hj³  hžhhŸh³h Nubah}”(h]”h ]”h"]”h$]”h&]”j&  j'  j(  hj)  j*  uh1j£  hj¢  hžhhŸh³h KaubhÊ)”}”(hŒGMemory scrub features are documented in `Documentation/edac/scrub.rst`.”h]”(hŒ(Memory scrub features are documented in ”…””}”(hjÔ  hžhhŸNh NubhŒtitle_reference”“”)”}”(hŒ`Documentation/edac/scrub.rst`”h]”hŒDocumentation/edac/scrub.rst”…””}”(hjÞ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÜ  hjÔ  ubhŒ.”…””}”(hjÔ  hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h Kchj¢  hžhubj¤  )”}”(hhh]”jc  )”}”(hŒMemory Repair
”h]”hÊ)”}”(hŒMemory Repair”h]”hŒMemory Repair”…””}”(hjý  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h Kehjù  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jb  hjö  hžhhŸh³h Nubah}”(h]”h ]”h"]”h$]”h&]”j&  j'  j(  hj)  j*  Œstart”Kuh1j£  hj¢  hžhhŸh³h KeubhÊ)”}”(hŒPMemory repair features are documented in `Documentation/edac/memory_repair.rst`.”h]”(hŒ)Memory repair features are documented in ”…””}”(hj  hžhhŸNh NubjÝ  )”}”(hŒ&`Documentation/edac/memory_repair.rst`”h]”hŒ$Documentation/edac/memory_repair.rst”…””}”(hj   hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÜ  hj  ubhŒ.”…””}”(hj  hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h Kghj¢  hžhubeh}”(h]”Œras-features”ah ]”h"]”Œras features”ah$]”h&]”uh1h´hh¶hžhhŸh³h K`ubeh}”(h]”Œedac-ras-features”ah ]”h"]”Œedac/ras features”ah$]”h&]”uh1h´hhhžhhŸh³h Kubeh}”(h]”h ]”h"]”h$]”h&]”Œsource”h³uh1hŒcurrent_source”NŒcurrent_line”NŒsettings”Œdocutils.frontend”ŒValues”“”)”}”(h¹NŒ	generator”NŒ	datestamp”NŒsource_link”NŒ
source_url”NŒtoc_backlinks”Œentry”Œfootnote_backlinks”KŒsectnum_xform”KŒstrip_comments”NŒstrip_elements_with_classes”NŒstrip_classes”NŒreport_level”KŒ
halt_level”KŒexit_status_level”KŒdebug”NŒwarning_stream”NŒ	traceback”ˆŒinput_encoding”Œ	utf-8-sig”Œinput_encoding_error_handler”Œstrict”Œoutput_encoding”Œutf-8”Œoutput_encoding_error_handler”jk  Œerror_encoding”Œutf-8”Œerror_encoding_error_handler”Œbackslashreplace”Œlanguage_code”Œen”Œrecord_dependencies”NŒconfig”NŒ	id_prefix”hŒauto_id_prefix”Œid”Œdump_settings”NŒdump_internals”NŒdump_transforms”NŒdump_pseudo_xml”NŒexpose_internals”NŒstrict_visitor”NŒ_disable_config”NŒ_source”h³Œ_destination”NŒ_config_files”]”Œ7/var/lib/git/docbuild/linux/Documentation/docutils.conf”aŒfile_insertion_enabled”ˆŒraw_enabled”KŒline_length_limit”M'Œpep_references”NŒpep_base_url”Œhttps://peps.python.org/”Œpep_file_url_template”Œpep-%04d”Œrfc_references”NŒrfc_base_url”Œ&https://datatracker.ietf.org/doc/html/”Œ	tab_width”KŒtrim_footnote_reference_space”‰Œsyntax_highlight”Œlong”Œsmart_quotes”ˆŒsmartquotes_locales”]”Œcharacter_level_inline_markup”‰Œdoctitle_xform”‰Œdocinfo_xform”KŒsectsubtitle_xform”‰Œimage_loading”Œlink”Œembed_stylesheet”‰Œcloak_email_addresses”ˆŒsection_self_link”‰Œenv”NubŒreporter”NŒindirect_targets”]”Œsubstitution_defs”}”Œsubstitution_names”}”Œrefnames”}”Œrefids”}”Œnameids”}”(jE  jB  jŸ  jœ  j=  j:  uŒ	nametypes”}”(jE  ‰jŸ  ‰j=  ‰uh}”(jB  h¶jœ  j„  j:  j¢  uŒfootnote_refs”}”Œcitation_refs”}”Œautofootnotes”]”Œautofootnote_refs”]”Œsymbol_footnotes”]”Œsymbol_footnote_refs”]”Œ	footnotes”]”Œ	citations”]”Œautofootnote_start”KŒsymbol_footnote_start”K Œ
id_counter”Œcollections”ŒCounter”“”}”…”R”Œparse_messages”]”hŒsystem_message”“”)”}”(hhh]”hÊ)”}”(hŒ:Enumerated list start value not ordinal-1: "2" (ordinal 2)”h]”hŒ>Enumerated list start value not ordinal-1: â€œ2â€ (ordinal 2)”…””}”(hjÒ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhjÏ  ubah}”(h]”h ]”h"]”h$]”h&]”Œlevel”KŒtype”ŒINFO”Œsource”h³Œline”Kuh1jÍ  hj¢  hžhhŸh³h KeubaŒtransform_messages”]”Œtransformer”NŒinclude_log”]”Œ
decoration”Nhžhub.