tjh.dev / kernel
Linux kernel mirror (for testing) git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel os linux
fork atom

ksm: add sysfs ABI Documentation

Add sysfs documentation for Kernel Samepage Merging (KSM) including new
merge_across_nodes knob.

Signed-off-by: Petr Holasek <pholasek@redhat.com>
Signed-off-by: Hugh Dickins <hughd@google.com>
Cc: Rik van Riel <riel@redhat.com>
Cc: Andrea Arcangeli <aarcange@redhat.com>
Cc: Izik Eidus <izik.eidus@ravellosystems.com>
Cc: Gerald Schaefer <gerald.schaefer@de.ibm.com>
Cc: KOSAKI Motohiro <kosaki.motohiro@gmail.com>
Signed-off-by: Andrew Morton <akpm@linux-foundation.org>
Signed-off-by: Linus Torvalds <torvalds@linux-foundation.org>

authored by

Petr Holasek and committed by
Linus Torvalds f00dc0ee 90bd6fd3

+52
+52
Documentation/ABI/testing/sysfs-kernel-mm-ksm
··· 1 + What: /sys/kernel/mm/ksm 2 + Date: September 2009 3 + KernelVersion: 2.6.32 4 + Contact: Linux memory management mailing list <linux-mm@kvack.org> 5 + Description: Interface for Kernel Samepage Merging (KSM) 6 + 7 + What: /sys/kernel/mm/ksm/full_scans 8 + What: /sys/kernel/mm/ksm/pages_shared 9 + What: /sys/kernel/mm/ksm/pages_sharing 10 + What: /sys/kernel/mm/ksm/pages_to_scan 11 + What: /sys/kernel/mm/ksm/pages_unshared 12 + What: /sys/kernel/mm/ksm/pages_volatile 13 + What: /sys/kernel/mm/ksm/run 14 + What: /sys/kernel/mm/ksm/sleep_millisecs 15 + Date: September 2009 16 + Contact: Linux memory management mailing list <linux-mm@kvack.org> 17 + Description: 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 + write 1 to run ksm, read 1 while ksm is running. 38 + write 2 to disable ksm and unmerge all its pages. 39 + 40 + sleep_millisecs: how many milliseconds ksm should sleep between 41 + scans. 42 + 43 + See Documentation/vm/ksm.txt for more information. 44 + 45 + What: /sys/kernel/mm/ksm/merge_across_nodes 46 + Date: January 2013 47 + KernelVersion: 3.9 48 + Contact: Linux memory management mailing list <linux-mm@kvack.org> 49 + Description: Control merging pages across different NUMA nodes. 50 + 51 + When it is set to 0 only pages from the same node are merged, 52 + otherwise pages from all nodes can be merged together (default).