[PATCH 4/4] zswap: Update document with sharing of duplicate pages feature

From: Srividya Desireddy
Date: Wed Aug 17 2016 - 06:31:29 EST


From: Srividya Desireddy <srividya.dr@xxxxxxxxxxx>
Date: Wed, 17 Aug 2016 14:34:41 +0530
Subject: [PATCH 4/4] zswap: Update document with sharing of duplicate pages
feature

Updated zswap document with details on the sharing of duplicate swap pages
feature. The usage of zswap.same_page_sharing module parameter is
explained.

Signed-off-by: Srividya Desireddy <srividya.dr@xxxxxxxxxxx>
---
Documentation/vm/zswap.txt | 18 ++++++++++++++++++
1 file changed, 18 insertions(+)

diff --git a/Documentation/vm/zswap.txt b/Documentation/vm/zswap.txt
index 89fff7d..cf11807 100644
--- a/Documentation/vm/zswap.txt
+++ b/Documentation/vm/zswap.txt
@@ -98,5 +98,23 @@ request is made for a page in an old zpool, it is uncompressed using its
original compressor. Once all pages are removed from an old zpool, the zpool
and its compressor are freed.

+Some of the pages swapped to zswap have same content as that of pages already
+stored in zswap. These pages are compressed and stored in the zpool memory.
+Same page sharing feature enables the duplicate pages to share same compressed
+zpool memory. This helps in reducing the zpool memory allocated by zswap to
+store compressed pages.
+
+Same page sharing feature is disabled by default and can be enabled at boot
+time by setting the "same_page_sharing" attribute to 1 at boot time. ie:
+zswap.same_page_sharing=1. It can also be enabled and disabled at runtime
+using the sysfs "same_page_sharing" attribute, e.g.
+
+echo 1 > /sys/module/zswap/parameters/same_page_sharing
+
+When zswap same page sharing is disabled at runtime it will stop sharing the
+new duplicate pages that are being swapped out. However, the existing duplicate
+pages will keep sharing the compressed memory pool until they are swapped in or
+invalidated.
+
A debugfs interface is provided for various statistic about pool size, number
of pages stored, and various counters for the reasons pages are rejected.
--
1.7.9.5