erofs: DEFLATE compression support
PATCH v5 1/1 erofs: DEFLATE compression support
Add DEFLATE compression as the 3rd supported algorithm.
DEFLATE is a popular generic-purpose compression algorithm for quite long time (many advanced formats like gzip, zlib, zip, png are all based on that) as Apple documentation written "If you require interoperability with non-Apple devices, use COMPRESSION_ZLIB. [1]".
Due to its popularity, there are several hardware on-market DEFLATE accelerators, such as (s390) DFLTCC, (Intel) IAA/QAT, (HiSilicon) ZIP accelerator, etc. In addition, there are also several high-performence IP cores and even open-source FPGA approches available for DEFLATE. Therefore, it's useful to support DEFLATE compression in order to find a way to utilize these accelerators for asynchronous I/Os and get benefits from these later.
Besides, it's a good choice to trade off between compression ratios and performance compared to LZ4 and LZMA. The DEFLATE core format is simple as well as easy to understand, therefore the code size of its decompressor is small even for the bootloader use cases. The runtime memory consumption is quite limited too (e.g. 32K + ~7K for each zlib stream). As usual, EROFS ourperforms similar approaches too.
Alternatively, DEFLATE could still be used for some specific files since EROFS supports multiple compression algorithms in one image.
[1] https://developer.apple.com/documentation/compression/compression_algorithm
---
changes since v4:
- add a missing kfree(strm) in z_erofs_deflate_init() pointed out by Chao;
fs/erofs/Kconfig | 15 ++ fs/erofs/Makefile | 1 + fs/erofs/compress.h | 2 + fs/erofs/decompressor.c | 6 + fs/erofs/decompressor_deflate.c | 252 ++++++++++++++++++++++++++++++++ fs/erofs/erofs_fs.h | 7 + fs/erofs/internal.h | 20 +++ fs/erofs/super.c | 10 ++ fs/erofs/zmap.c | 5 +- 9 files changed, 316 insertions(+), 2 deletions(-) create mode 100644 fs/erofs/decompressor_deflate.c
fs/erofs/Kconfig +15 -0
@@ -99,6 +99,21 @@ config EROFS_FS_ZIP_LZMA If unsure, say N. +config EROFS_FS_ZIP_DEFLATE + bool "EROFS DEFLATE compressed data support" + depends on EROFS_FS_ZIP + select ZLIB_INFLATE + help + Saying Y here includes support for reading EROFS file systems + containing DEFLATE compressed data. It gives better compression + ratios than the default LZ4 format, while it costs more CPU + overhead. + + DEFLATE support is an experimental feature for now and so most + file systems will be readable without selecting this option. + + If unsure, say N. + config EROFS_FS_ONDEMAND bool "EROFS fscache-based on-demand read support" depends on CACHEFILES_ONDEMAND && (EROFS_FS=m && FSCACHE || EROFS_FS=y && FSCACHE=y)
fs/erofs/Makefile +1 -0
@@ -5,4 +5,5 @@ erofs-objs := super.o inode.o data.o namei.o dir.o utils.o sysfs.o erofs-$(CONFIG_EROFS_FS_XATTR) += xattr.o erofs-$(CONFIG_EROFS_FS_ZIP) += decompressor.o zmap.o zdata.o pcpubuf.o erofs-$(CONFIG_EROFS_FS_ZIP_LZMA) += decompressor_lzma.o +erofs-$(CONFIG_EROFS_FS_ZIP_DEFLATE) += decompressor_deflate.o erofs-$(CONFIG_EROFS_FS_ONDEMAND) += fscache.o
fs/erofs/compress.h +2 -0
@@ -94,4 +94,6 @@ extern const struct z_erofs_decompressor erofs_decompressors[];/* prototypes for specific algorithms */ int z_erofs_lzma_decompress (struct z_erofs_decompress_req *rq,struct page **pagepool); +int z_erofs_deflate_decompress (struct z_erofs_decompress_req *rq, +struct page **pagepool);#endif
fs/erofs/decompressor.c +6 -0
@@ -379,4 +379,10 @@ const struct z_erofs_decompressor erofs_decompressors[] = { .name = "lzma" },#endif +#ifdef CONFIG_EROFS_FS_ZIP_DEFLATE + [Z_EROFS_COMPRESSION_DEFLATE] = { + .decompress = z_erofs_deflate_decompress, + .name ="deflate" + }, +#endif };
fs/erofs/decompressor_deflate.c new file +252 -0
252 lines not on this page · raw message
fs/erofs/erofs_fs.h +7 -0
@@ -289,6 +289,7 @@ struct erofs_dirent {enum {Z_EROFS_COMPRESSION_LZ4 =0 ,Z_EROFS_COMPRESSION_LZMA =1 , +Z_EROFS_COMPRESSION_DEFLATE =2 ,Z_EROFS_COMPRESSION_MAX };#define Z_EROFS_ALL_COMPR_ALGS ((1 << Z_EROFS_COMPRESSION_MAX) - 1)
@@ -309,6 +310,12 @@ struct z_erofs_lzma_cfgs {#define Z_EROFS_LZMA_MAX_DICT_SIZE (8 * Z_EROFS_PCLUSTER_MAX_SIZE) +/* 6 bytes (+ length field = 8 bytes) */ +struct z_erofs_deflate_cfgs { +u8 windowbits;/* 8..15 for DEFLATE */ +u8 reserved[5 ]; +} __packed; +/* * bit 0 : COMPACTED_2B indexes (0 - off; 1 - on) * e.g. for 4k logical cluster size, 4B if compacted 2B is off;
fs/erofs/internal.h +20 -0
@@ -519,6 +519,26 @@ static inline int z_erofs_load_lzma_config(struct super_block *sb, }#endif /* !CONFIG_EROFS_FS_ZIP_LZMA */ +#ifdef CONFIG_EROFS_FS_ZIP_DEFLATE +int __init z_erofs_deflate_init (void ); +void z_erofs_deflate_exit (void ); +int z_erofs_load_deflate_config (struct super_block *sb, +struct erofs_super_block *dsb, +struct z_erofs_deflate_cfgs *dfl,int size); +#else +static inline int z_erofs_deflate_init (void ) {return 0 ; } +static inline int z_erofs_deflate_exit (void ) {return 0 ; } +static inline int z_erofs_load_deflate_config (struct super_block *sb, +struct erofs_super_block *dsb, +struct z_erofs_deflate_cfgs *dfl,int size) { +if (dfl) { +erofs_err (sb,"deflate algorithm isn't enabled" ); +return -EINVAL ; + } +return 0 ; +} +#endif /* !CONFIG_EROFS_FS_ZIP_DEFLATE */ +#ifdef CONFIG_EROFS_FS_ONDEMAND int erofs_fscache_register_fs (struct super_block *sb);void erofs_fscache_unregister_fs (struct super_block *sb);
fs/erofs/super.c +10 -0
@@ -201,6 +201,9 @@ static int erofs_load_compr_cfgs(struct super_block *sb,case Z_EROFS_COMPRESSION_LZMA : ret =z_erofs_load_lzma_config (sb, dsb, data, size);break ; +case Z_EROFS_COMPRESSION_DEFLATE : + ret =z_erofs_load_deflate_config (sb, dsb, data, size); +break ;default :DBG_BUGON (1 ); ret = -EFAULT ;
@@ -966,6 +969,10 @@ static int __init erofs_module_init(void)if (err) goto lzma_err; + err =z_erofs_deflate_init (); +if (err) + goto deflate_err; +erofs_pcpubuf_init (); err =z_erofs_init_zip_subsystem ();if (err)
@@ -986,6 +993,8 @@ static int __init erofs_module_init(void) sysfs_err:z_erofs_exit_zip_subsystem (); zip_err: +z_erofs_deflate_exit (); +deflate_err:z_erofs_lzma_exit (); lzma_err:erofs_exit_shrinker ();
@@ -1003,6 +1012,7 @@ static void __exit erofs_module_exit(void)erofs_exit_sysfs ();z_erofs_exit_zip_subsystem (); +z_erofs_deflate_exit ();z_erofs_lzma_exit ();erofs_exit_shrinker ();kmem_cache_destroy (erofs_inode_cachep);
fs/erofs/zmap.c +3 -2
@@ -561,8 +561,9 @@ static int z_erofs_do_map_blocks(struct inode *inode,if ((flags &EROFS_GET_BLOCKS_FIEMAP ) || ((flags &EROFS_GET_BLOCKS_READMORE ) && - map->m_algorithmformat ==Z_EROFS_COMPRESSION_LZMA && - map->m_llen >=i_blocksize (inode))) { + (map->m_algorithmformat ==Z_EROFS_COMPRESSION_LZMA || + map->m_algorithmformat ==Z_EROFS_COMPRESSION_DEFLATE ) && + map->m_llen >=i_blocksize (inode))) { err =z_erofs_get_extent_decompressedlen (&m);if (!err) map->m_flags |=EROFS_MAP_FULL_MAPPED ;
Signature · 1 line
2.24.4
Quoted 22 lines · Gao Xiang
Add DEFLATE compression as the 3rd supported algorithm.
DEFLATE is a popular generic-purpose compression algorithm for quite long time (many advanced formats like gzip, zlib, zip, png are all based on that) as Apple documentation written "If you require interoperability with non-Apple devices, use
COMPRESSION_ZLIB. [1]".Due to its popularity, there are several hardware on-market DEFLATE accelerators, such as (s390) DFLTCC, (Intel) IAA/QAT, (HiSilicon) ZIP accelerator, etc. In addition, there are also several high-performence IP cores and even open-source FPGA approches available for DEFLATE. Therefore, it's useful to support DEFLATE compression in order to find a way to utilize these accelerators for asynchronous I/Os and get benefits from these later.
Besides, it's a good choice to trade off between compression ratios and performance compared to LZ4 and LZMA. The DEFLATE core format is simple as well as easy to understand, therefore the code size of its decompressor is small even for the bootloader use cases. The runtime memory consumption is quite limited too (e.g. 32K + ~7K for each zlib stream). As usual, EROFS ourperforms similar approaches too.
Quoted 5 lines
Alternatively, DEFLATE could still be used for some specific files since EROFS supports multiple compression algorithms in one image.
[1] https://developer.apple.com/documentation/compression/compression_algorithm
Signed-off-by Gao Xiang <[email protected]>
Thanks,
PATCH v6 1/1 erofs: DEFLATE compression support
In reply to Gao XiangAdd DEFLATE compression as the 3rd supported algorithm.
DEFLATE is a popular generic-purpose compression algorithm for quite long time (many advanced formats like gzip, zlib, zip, png are all based on that) as Apple documentation written "If you require interoperability with non-Apple devices, use COMPRESSION_ZLIB. [1]".
Due to its popularity, there are several hardware on-market DEFLATE accelerators, such as (s390) DFLTCC, (Intel) IAA/QAT, (HiSilicon) ZIP accelerator, etc. In addition, there are also several high-performence IP cores and even open-source FPGA approches available for DEFLATE. Therefore, it's useful to support DEFLATE compression in order to find a way to utilize these accelerators for asynchronous I/Os and get benefits from these later.
Besides, it's a good choice to trade off between compression ratios and performance compared to LZ4 and LZMA. The DEFLATE core format is simple as well as easy to understand, therefore the code size of its decompressor is small even for the bootloader use cases. The runtime memory consumption is quite limited too (e.g. 32K + ~7K for each zlib stream). As usual, EROFS ourperforms similar approaches too.
Alternatively, DEFLATE could still be used for some specific files since EROFS supports multiple compression algorithms in one image.
[1] https://developer.apple.com/documentation/compression/compression_algorithm
---
changes since v5:
- fix data corruption due to use a static buffer to drop unused decompressed data. since the sliding window of current zlib could reuse next_out instead of internal buffer, such usage is incorrect;
- pass erofs stress test now.
fs/erofs/Kconfig | 15 ++ fs/erofs/Makefile | 1 + fs/erofs/compress.h | 2 + fs/erofs/decompressor.c | 6 + fs/erofs/decompressor_deflate.c | 244 ++++++++++++++++++++++++++++++++ fs/erofs/erofs_fs.h | 7 + fs/erofs/internal.h | 20 +++ fs/erofs/super.c | 10 ++ fs/erofs/zmap.c | 5 +- 9 files changed, 308 insertions(+), 2 deletions(-) create mode 100644 fs/erofs/decompressor_deflate.c
fs/erofs/Kconfig +15 -0
@@ -99,6 +99,21 @@ config EROFS_FS_ZIP_LZMA If unsure, say N. +config EROFS_FS_ZIP_DEFLATE + bool "EROFS DEFLATE compressed data support" + depends on EROFS_FS_ZIP + select ZLIB_INFLATE + help + Saying Y here includes support for reading EROFS file systems + containing DEFLATE compressed data. It gives better compression + ratios than the default LZ4 format, while it costs more CPU + overhead. + + DEFLATE support is an experimental feature for now and so most + file systems will be readable without selecting this option. + + If unsure, say N. + config EROFS_FS_ONDEMAND bool "EROFS fscache-based on-demand read support" depends on CACHEFILES_ONDEMAND && (EROFS_FS=m && FSCACHE || EROFS_FS=y && FSCACHE=y)
fs/erofs/Makefile +1 -0
@@ -5,4 +5,5 @@ erofs-objs := super.o inode.o data.o namei.o dir.o utils.o sysfs.o erofs-$(CONFIG_EROFS_FS_XATTR) += xattr.o erofs-$(CONFIG_EROFS_FS_ZIP) += decompressor.o zmap.o zdata.o pcpubuf.o erofs-$(CONFIG_EROFS_FS_ZIP_LZMA) += decompressor_lzma.o +erofs-$(CONFIG_EROFS_FS_ZIP_DEFLATE) += decompressor_deflate.o erofs-$(CONFIG_EROFS_FS_ONDEMAND) += fscache.o
fs/erofs/compress.h +2 -0
@@ -94,4 +94,6 @@ extern const struct z_erofs_decompressor erofs_decompressors[];/* prototypes for specific algorithms */ int z_erofs_lzma_decompress (struct z_erofs_decompress_req *rq,struct page **pagepool); +int z_erofs_deflate_decompress (struct z_erofs_decompress_req *rq, +struct page **pagepool);#endif
fs/erofs/decompressor.c +6 -0
@@ -379,4 +379,10 @@ const struct z_erofs_decompressor erofs_decompressors[] = { .name = "lzma" },#endif +#ifdef CONFIG_EROFS_FS_ZIP_DEFLATE + [Z_EROFS_COMPRESSION_DEFLATE] = { + .decompress = z_erofs_deflate_decompress, + .name ="deflate" + }, +#endif };
fs/erofs/decompressor_deflate.c new file +244 -0
244 lines not on this page · raw message
fs/erofs/erofs_fs.h +7 -0
@@ -289,6 +289,7 @@ struct erofs_dirent {enum {Z_EROFS_COMPRESSION_LZ4 =0 ,Z_EROFS_COMPRESSION_LZMA =1 , +Z_EROFS_COMPRESSION_DEFLATE =2 ,Z_EROFS_COMPRESSION_MAX };#define Z_EROFS_ALL_COMPR_ALGS ((1 << Z_EROFS_COMPRESSION_MAX) - 1)
@@ -309,6 +310,12 @@ struct z_erofs_lzma_cfgs {#define Z_EROFS_LZMA_MAX_DICT_SIZE (8 * Z_EROFS_PCLUSTER_MAX_SIZE) +/* 6 bytes (+ length field = 8 bytes) */ +struct z_erofs_deflate_cfgs { +u8 windowbits;/* 8..15 for DEFLATE */ +u8 reserved[5 ]; +} __packed; +/* * bit 0 : COMPACTED_2B indexes (0 - off; 1 - on) * e.g. for 4k logical cluster size, 4B if compacted 2B is off;
fs/erofs/internal.h +20 -0
@@ -519,6 +519,26 @@ static inline int z_erofs_load_lzma_config(struct super_block *sb, }#endif /* !CONFIG_EROFS_FS_ZIP_LZMA */ +#ifdef CONFIG_EROFS_FS_ZIP_DEFLATE +int __init z_erofs_deflate_init (void ); +void z_erofs_deflate_exit (void ); +int z_erofs_load_deflate_config (struct super_block *sb, +struct erofs_super_block *dsb, +struct z_erofs_deflate_cfgs *dfl,int size); +#else +static inline int z_erofs_deflate_init (void ) {return 0 ; } +static inline int z_erofs_deflate_exit (void ) {return 0 ; } +static inline int z_erofs_load_deflate_config (struct super_block *sb, +struct erofs_super_block *dsb, +struct z_erofs_deflate_cfgs *dfl,int size) { +if (dfl) { +erofs_err (sb,"deflate algorithm isn't enabled" ); +return -EINVAL ; + } +return 0 ; +} +#endif /* !CONFIG_EROFS_FS_ZIP_DEFLATE */ +#ifdef CONFIG_EROFS_FS_ONDEMAND int erofs_fscache_register_fs (struct super_block *sb);void erofs_fscache_unregister_fs (struct super_block *sb);
fs/erofs/super.c +10 -0
@@ -201,6 +201,9 @@ static int erofs_load_compr_cfgs(struct super_block *sb,case Z_EROFS_COMPRESSION_LZMA : ret =z_erofs_load_lzma_config (sb, dsb, data, size);break ; +case Z_EROFS_COMPRESSION_DEFLATE : + ret =z_erofs_load_deflate_config (sb, dsb, data, size); +break ;default :DBG_BUGON (1 ); ret = -EFAULT ;
@@ -964,6 +967,10 @@ static int __init erofs_module_init(void)if (err) goto lzma_err; + err =z_erofs_deflate_init (); +if (err) + goto deflate_err; +erofs_pcpubuf_init (); err =z_erofs_init_zip_subsystem ();if (err)
@@ -984,6 +991,8 @@ static int __init erofs_module_init(void) sysfs_err:z_erofs_exit_zip_subsystem (); zip_err: +z_erofs_deflate_exit (); +deflate_err:z_erofs_lzma_exit (); lzma_err:erofs_exit_shrinker ();
@@ -1001,6 +1010,7 @@ static void __exit erofs_module_exit(void)erofs_exit_sysfs ();z_erofs_exit_zip_subsystem (); +z_erofs_deflate_exit ();z_erofs_lzma_exit ();erofs_exit_shrinker ();kmem_cache_destroy (erofs_inode_cachep);
fs/erofs/zmap.c +3 -2
@@ -561,8 +561,9 @@ static int z_erofs_do_map_blocks(struct inode *inode,if ((flags &EROFS_GET_BLOCKS_FIEMAP ) || ((flags &EROFS_GET_BLOCKS_READMORE ) && - map->m_algorithmformat ==Z_EROFS_COMPRESSION_LZMA && - map->m_llen >=i_blocksize (inode))) { + (map->m_algorithmformat ==Z_EROFS_COMPRESSION_LZMA || + map->m_algorithmformat ==Z_EROFS_COMPRESSION_DEFLATE ) && + map->m_llen >=i_blocksize (inode))) { err =z_erofs_get_extent_decompressedlen (&m);if (!err) map->m_flags |=EROFS_MAP_FULL_MAPPED ;
Signature · 1 line
2.24.4