Documentation/ABI/testing/sysfs-edac-memory-repair

Source file repositories/reference/linux-study-clean/Documentation/ABI/testing/sysfs-edac-memory-repair

File Facts

System
Linux kernel
Corpus path
Documentation/ABI/testing/sysfs-edac-memory-repair
Extension
[no extension]
Size
8222 bytes
Lines
207
Domain
Support Tooling And Documentation
Bucket
Documentation
Inferred role
Support Tooling And Documentation: Documentation
Status
atlas-only

Why This File Exists

Repository support layer: documentation, build tooling, samples, user-space helper tools, generated initramfs support, licenses, and validation utilities.

Dependency Surface

Detected Declarations

Annotated Snippet

What:		/sys/bus/edac/devices/<dev-name>/mem_repairX
Date:		March 2025
KernelVersion:	6.15
Contact:	linux-edac@vger.kernel.org
Description:
		The sysfs EDAC bus devices /<dev-name>/mem_repairX subdirectory
		pertains to the memory media repair features control, such as
		PPR (Post Package Repair), memory sparing etc, where <dev-name>
		directory corresponds to a device registered with the EDAC
		device driver for the memory repair features.

		Post Package Repair is a maintenance operation requests the memory
		device to perform a repair operation on its media. It is a memory
		self-healing feature that fixes a failing memory location by
		replacing it with a spare row in a DRAM device. For example, a
		CXL memory device with DRAM components that support PPR features may
		implement PPR maintenance operations. DRAM components may support
		two types of PPR functions: hard PPR, for a permanent row repair, and
		soft PPR, for a temporary row repair. Soft PPR may be much faster
		than hard PPR, but the repair is lost with a power cycle.

		The sysfs attributes nodes for a repair feature are only
		present if the parent driver has implemented the corresponding
		attr callback function and provided the necessary operations
		to the EDAC device driver during registration.

		In some states of system configuration (e.g. before address
		decoders have been configured), memory devices (e.g. CXL)
		may not have an active mapping in the main host address
		physical address map. As such, the memory to repair must be
		identified by a device specific physical addressing scheme
		using a device physical address(DPA). The DPA and other control
		attributes to use will be presented in related error records.

What:		/sys/bus/edac/devices/<dev-name>/mem_repairX/repair_type
Date:		March 2025
KernelVersion:	6.15
Contact:	linux-edac@vger.kernel.org
Description:
		(RO) Memory repair type. For eg. post package repair,
		memory sparing etc. Valid values are:

		- ppr - Post package repair.

		- cacheline-sparing

		- row-sparing

		- bank-sparing

		- rank-sparing

		- All other values are reserved.

What:		/sys/bus/edac/devices/<dev-name>/mem_repairX/persist_mode
Date:		March 2025
KernelVersion:	6.15
Contact:	linux-edac@vger.kernel.org
Description:
		(RW) Get/Set the current persist repair mode set for a
		repair function. Persist repair modes supported in the
		device, based on a memory repair function, either is temporary,
		which is lost with a power cycle or permanent. Valid values are:

		- 0 - Soft memory repair (temporary repair).

		- 1 - Hard memory repair (permanent repair).

		- All other values are reserved.

Annotation

Implementation Notes