summaryrefslogtreecommitdiff
path: root/Documentation/ABI/testing/sysfs-edac-scrub
blob: c43be90deab4a9b9b8c78b0b5dea8ed8e87cf6c6 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
What:		/sys/bus/edac/devices/<dev-name>/scrubX
Date:		March 2025
KernelVersion:	6.15
Contact:	linux-edac@vger.kernel.org
Description:
		The sysfs EDAC bus devices /<dev-name>/scrubX subdirectory
		belongs to an instance of memory scrub control feature,
		where <dev-name> directory corresponds to a device/memory
		region registered with the EDAC device driver for the
		scrub control feature.

		The sysfs scrub attr nodes 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.

What:		/sys/bus/edac/devices/<dev-name>/scrubX/addr
Date:		March 2025
KernelVersion:	6.15
Contact:	linux-edac@vger.kernel.org
Description:
		(RW) The base address of the memory region to be scrubbed
		for on-demand scrubbing. Setting address starts scrubbing.
		The size must be set before that.

		The readback addr value is non-zero if the requested
		on-demand scrubbing is in progress, zero otherwise.

What:		/sys/bus/edac/devices/<dev-name>/scrubX/size
Date:		March 2025
KernelVersion:	6.15
Contact:	linux-edac@vger.kernel.org
Description:
		(RW) The size of the memory region to be scrubbed
		(on-demand scrubbing).

What:		/sys/bus/edac/devices/<dev-name>/scrubX/enable_background
Date:		March 2025
KernelVersion:	6.15
Contact:	linux-edac@vger.kernel.org
Description:
		(RW) Start/Stop background (patrol) scrubbing if supported.

What:		/sys/bus/edac/devices/<dev-name>/scrubX/min_cycle_duration
Date:		March 2025
KernelVersion:	6.15
Contact:	linux-edac@vger.kernel.org
Description:
		(RO) Supported minimum scrub cycle duration in seconds
		by the memory scrubber.

What:		/sys/bus/edac/devices/<dev-name>/scrubX/max_cycle_duration
Date:		March 2025
KernelVersion:	6.15
Contact:	linux-edac@vger.kernel.org
Description:
		(RO) Supported maximum scrub cycle duration in seconds
		by the memory scrubber.

What:		/sys/bus/edac/devices/<dev-name>/scrubX/current_cycle_duration
Date:		March 2025
KernelVersion:	6.15
Contact:	linux-edac@vger.kernel.org
Description:
		(RW) The current scrub cycle duration in seconds and must be
		within the supported range by the memory scrubber.

		Scrub has an overhead when running and that may want to be
		reduced by taking longer to do it.