xref: /linux/Documentation/ABI/testing/sysfs-kernel-mm-ksm (revision 906fd46a65383cd639e5eec72a047efc33045d86)
1What:		/sys/kernel/mm/ksm
2Date:		September 2009
3KernelVersion:	2.6.32
4Contact:	Linux memory management mailing list <linux-mm@kvack.org>
5Description:	Interface for Kernel Samepage Merging (KSM)
6
7What:		/sys/kernel/mm/ksm/full_scans
8What:		/sys/kernel/mm/ksm/pages_shared
9What:		/sys/kernel/mm/ksm/pages_sharing
10What:		/sys/kernel/mm/ksm/pages_to_scan
11What:		/sys/kernel/mm/ksm/pages_unshared
12What:		/sys/kernel/mm/ksm/pages_volatile
13What:		/sys/kernel/mm/ksm/run
14What:		/sys/kernel/mm/ksm/sleep_millisecs
15Date:		September 2009
16Contact:	Linux memory management mailing list <linux-mm@kvack.org>
17Description:	Kernel Samepage Merging daemon sysfs interface
18
19		full_scans: how many times all mergeable areas have been
20		scanned.
21
22		pages_shared: how many shared pages are being used.
23
24		pages_sharing: how many more sites are sharing them i.e. how
25		much saved.
26
27		pages_to_scan: how many present pages to scan before ksmd goes
28		to sleep.
29
30		pages_unshared: how many pages unique but repeatedly checked
31		for merging.
32
33		pages_volatile: how many pages changing too fast to be placed
34		in a tree.
35
36		run: write 0 to disable ksm, read 0 while ksm is disabled.
37
38			- write 1 to run ksm, read 1 while ksm is running.
39			- write 2 to disable ksm and unmerge all its pages.
40
41		sleep_millisecs: how many milliseconds ksm should sleep between
42		scans.
43
44		See Documentation/mm/ksm.rst for more information.
45
46What:		/sys/kernel/mm/ksm/merge_across_nodes
47Date:		January 2013
48KernelVersion:	3.9
49Contact:	Linux memory management mailing list <linux-mm@kvack.org>
50Description:	Control merging pages across different NUMA nodes.
51
52		When it is set to 0 only pages from the same node are merged,
53		otherwise pages from all nodes can be merged together (default).
54
55What:		/sys/kernel/mm/ksm/general_profit
56Date:		April 2023
57KernelVersion:  6.4
58Contact:	Linux memory management mailing list <linux-mm@kvack.org>
59Description:	Measure how effective KSM is.
60		general_profit: how effective is KSM. The formula for the
61		calculation is in Documentation/admin-guide/mm/ksm.rst.
62