PM: hibernate: Add support for LZ4 compression for hibernation
authorNikhil V <quic_nprakash@quicinc.com>
Mon, 22 Jan 2024 13:15:27 +0000 (18:45 +0530)
committerRafael J. Wysocki <rafael.j.wysocki@intel.com>
Mon, 5 Feb 2024 13:30:35 +0000 (14:30 +0100)
Extend the support for LZ4 compression to be used with hibernation.
The main idea is that different compression algorithms
have different characteristics and hibernation may benefit when it uses
any of these algorithms: a default algorithm, having higher
compression rate but is slower(compression/decompression) and a
secondary algorithm, that is faster(compression/decompression) but has
lower compression rate.

LZ4 algorithm has better decompression speeds over LZO. This reduces
the hibernation image restore time.
As per test results:
                                    LZO             LZ4
Size before Compression(bytes)   682696704       682393600
Size after Compression(bytes)    146502402       155993547
Decompression Rate               335.02 MB/s     501.05 MB/s
Restore time                       4.4s             3.8s

LZO is the default compression algorithm used for hibernation. Enable
CONFIG_HIBERNATION_COMP_LZ4 to set the default compressor as LZ4.

Signed-off-by: Nikhil V <quic_nprakash@quicinc.com>
Signed-off-by: Rafael J. Wysocki <rafael.j.wysocki@intel.com>
kernel/power/Kconfig
kernel/power/hibernate.c
kernel/power/power.h

index d4167159bae8ac13c9e7f8fc0831bb7a63fa23ef..afce8130d8b92c71f1db895f4039e5a38bf3722b 100644 (file)
@@ -101,11 +101,16 @@ config HIBERNATION_COMP_LZO
        bool "lzo"
        depends on CRYPTO_LZO
 
+config HIBERNATION_COMP_LZ4
+       bool "lz4"
+       depends on CRYPTO_LZ4
+
 endchoice
 
 config HIBERNATION_DEF_COMP
        string
        default "lzo" if HIBERNATION_COMP_LZO
+       default "lz4" if HIBERNATION_COMP_LZ4
        help
          Default compressor to be used for hibernation.
 
index 76b7ff619c908832e58661700d9fd31701a044ff..219191d6d0e84e650bc354e95dca051d3fcd479a 100644 (file)
@@ -727,6 +727,9 @@ static int load_image_and_restore(void)
        return error;
 }
 
+#define COMPRESSION_ALGO_LZO "lzo"
+#define COMPRESSION_ALGO_LZ4 "lz4"
+
 /**
  * hibernate - Carry out system hibernation, including saving the image.
  */
@@ -786,11 +789,24 @@ int hibernate(void)
 
                if (hibernation_mode == HIBERNATION_PLATFORM)
                        flags |= SF_PLATFORM_MODE;
-               if (nocompress)
+               if (nocompress) {
                        flags |= SF_NOCOMPRESS_MODE;
-               else
+               } else {
                        flags |= SF_CRC32_MODE;
 
+                       /*
+                        * By default, LZO compression is enabled. Use SF_COMPRESSION_ALG_LZ4
+                        * to override this behaviour and use LZ4.
+                        *
+                        * Refer kernel/power/power.h for more details
+                        */
+
+                       if (!strcmp(hib_comp_algo, COMPRESSION_ALGO_LZ4))
+                               flags |= SF_COMPRESSION_ALG_LZ4;
+                       else
+                               flags |= SF_COMPRESSION_ALG_LZO;
+               }
+
                pm_pr_dbg("Writing hibernation image.\n");
                error = swsusp_write(flags);
                swsusp_free();
@@ -980,7 +996,10 @@ static int software_resume(void)
         * the algorithm support.
         */
        if (!(swsusp_header_flags & SF_NOCOMPRESS_MODE)) {
-               strscpy(hib_comp_algo, default_compressor, sizeof(hib_comp_algo));
+               if (swsusp_header_flags & SF_COMPRESSION_ALG_LZ4)
+                       strscpy(hib_comp_algo, COMPRESSION_ALGO_LZ4, sizeof(hib_comp_algo));
+               else
+                       strscpy(hib_comp_algo, default_compressor, sizeof(hib_comp_algo));
                if (crypto_has_comp(hib_comp_algo, 0, 0) != 1) {
                        pr_err("%s compression is not available\n", hib_comp_algo);
                        error = -EOPNOTSUPP;
index 5efa2c987057c52affc03934481e04b296fd83a1..518349272848fa404e1bccd85cd3f700f399ab09 100644 (file)
@@ -167,11 +167,25 @@ extern int swsusp_swap_in_use(void);
  * Flags that can be passed from the hibernatig hernel to the "boot" kernel in
  * the image header.
  */
+#define SF_COMPRESSION_ALG_LZO 0 /* dummy, details given  below */
 #define SF_PLATFORM_MODE       1
 #define SF_NOCOMPRESS_MODE     2
 #define SF_CRC32_MODE          4
 #define SF_HW_SIG              8
 
+/*
+ * Bit to indicate the compression algorithm to be used(for LZ4). The same
+ * could be checked while saving/loading image to/from disk to use the
+ * corresponding algorithms.
+ *
+ * By default, LZO compression is enabled if SF_CRC32_MODE is set. Use
+ * SF_COMPRESSION_ALG_LZ4 to override this behaviour and use LZ4.
+ *
+ * SF_CRC32_MODE, SF_COMPRESSION_ALG_LZO(dummy) -> Compression, LZO
+ * SF_CRC32_MODE, SF_COMPRESSION_ALG_LZ4 -> Compression, LZ4
+ */
+#define SF_COMPRESSION_ALG_LZ4 16
+
 /* kernel/power/hibernate.c */
 int swsusp_check(bool exclusive);
 extern void swsusp_free(void);