Skip to contentSkip to conversation

ksm: add zero_pages_sharing documentation

PATCH Superseded [email protected] 2 participants 2 messages Feb 10, 2023 – Mar 7, 2023

Subsystems (4)

v6 of 10 Superseded Latest is v10 →

lore
Share & tools
lore
#0 lore raw

PATCH v6 5/6 ksm: add zero_pages_sharing documentation

From: xu xin <[email protected]>

When enabling use_zero_pages, pages_sharing cannot represent how much memory saved indeed. zero_pages_sharing + pages_sharing does. add the description of zero_pages_sharing.

Cc Xiaokai Ran <[email protected]>
Cc Yang Yang <[email protected]>
Cc Jiang Xuexin <[email protected]>
Cc Claudio Imbrenda <[email protected]>
Cc David Hildenbrand <[email protected]>
---
 Documentation/admin-guide/mm/ksm.rst | 7 +++++++
 1 file changed, 7 insertions(+)
Documentation/admin-guide/mm/ksm.rst +7 -0
index fb6ba2002a4b..f160f9487a90 100644
@@ -173,6 +173,13 @@ stable_node_chains
         the number of KSM pages that hit the ``max_page_sharing`` limit
 stable_node_dups
         number of duplicated KSM pages
+zero_pages_sharing
+        how many empty pages are sharing kernel zero page(s) instead of
+        with each other as it would happen normally. Only effective when
+        enabling ``use_zero_pages`` knob.
+
+When enabling ``use_zero_pages``, the sum of ``pages_sharing`` +
+``zero_pages_sharing`` represents how much really saved by KSM.
 
 A high ratio of ``pages_sharing`` to ``pages_shared`` indicates good
 sharing, but a high ratio of ``pages_unshared`` to ``pages_sharing``
Signature · 1 line
2.15.2
#1 lore raw
Quoted 21 lines · On Fri, 10 Feb 2023 09:20:42 +0800 (CST) <[email protected]> wrote:

From: xu xin <[email protected]>

When enabling use_zero_pages, pages_sharing cannot represent how much memory saved indeed. zero_pages_sharing + pages_sharing does. add the description of zero_pages_sharing.

Cc Xiaokai Ran <[email protected]>
Cc Yang Yang <[email protected]>
Cc Jiang Xuexin <[email protected]>
Cc Claudio Imbrenda <[email protected]>
Cc David Hildenbrand <[email protected]>
---
 Documentation/admin-guide/mm/ksm.rst | 7 +++++++
 1 file changed, 7 insertions(+)
Documentation/admin-guide/mm/ksm.rst +0 -0
index fb6ba2002a4b..f160f9487a90 100644

Documentation/admin-guide/mm/ksm.rst stable_node_chains · line 177

Quoted 5 lines
Documentation/admin-guide/mm/ksm.rst +2 -0
@@ -173,6 +173,13 @@ stable_node_chains
         the number of KSM pages that hit the ``max_page_sharing`` limit
 stable_node_dups
         number of duplicated KSM pages
+zero_pages_sharing
+        how many empty pages are sharing kernel zero page(s) instead of

how many empty pages are sharing the kernel zero page(s) instead of other user pages as it would happen normally. Only meaningful when ``use_zero_pages`` is enabled.

Documentation/admin-guide/mm/ksm.rst stable_node_chains · line 181

Quoted 4 lines
Documentation/admin-guide/mm/ksm.rst +4 -0
+        with each other as it would happen normally. Only effective when
+        enabling ``use_zero_pages`` knob.
+
+When enabling ``use_zero_pages``, the sum of ``pages_sharing`` +

When ``use_zero_pages`` is enabled, the sum of ``pages_sharing`` +

Documentation/admin-guide/mm/ksm.rst stable_node_chains · line 182

Quoted 1 line
Documentation/admin-guide/mm/ksm.rst +1 -0
+``zero_pages_sharing`` represents how much really saved by KSM.

``zero_pages_sharing`` represents the actual number of pages saved by KSM.

Quoted 3 lines
Documentation/admin-guide/mm/ksm.rst +0 -0
 A high ratio of ``pages_sharing`` to ``pages_shared`` indicates good
 sharing, but a high ratio of ``pages_unshared`` to ``pages_sharing``