[PATCH v4] erofs: DEFLATE compression support
Gao Xiang
hsiangkao at linux.alibaba.com
Sun Jul 30 23:49:27 AEST 2023
On 2023/7/30 20:53, Chao Yu wrote:
> On 2023/7/16 17:19, Gao Xiang wrote:
>> 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 v3:
>> - fix 'insz' mis-calculation, which leads to failure on 4k pclusters.
>>
>> fs/erofs/Kconfig | 15 ++
>> fs/erofs/Makefile | 1 +
>> fs/erofs/compress.h | 2 +
>> fs/erofs/decompressor.c | 6 +
>> fs/erofs/decompressor_deflate.c | 250 ++++++++++++++++++++++++++++++++
>> fs/erofs/erofs_fs.h | 7 +
>> fs/erofs/internal.h | 20 +++
>> fs/erofs/super.c | 10 ++
>> fs/erofs/zmap.c | 5 +-
>> 9 files changed, 314 insertions(+), 2 deletions(-)
>> create mode 100644 fs/erofs/decompressor_deflate.c
>>
>> diff --git a/fs/erofs/Kconfig b/fs/erofs/Kconfig
>> index f259d92c9720..56a99ba8ce22 100644
>> --- a/fs/erofs/Kconfig
>> +++ b/fs/erofs/Kconfig
>> @@ -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)
>> diff --git a/fs/erofs/Makefile b/fs/erofs/Makefile
>> index a3a98fc3e481..994d0b9deddf 100644
>> --- a/fs/erofs/Makefile
>> +++ b/fs/erofs/Makefile
>> @@ -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
>> diff --git a/fs/erofs/compress.h b/fs/erofs/compress.h
>> index b1b846504027..349c3316ae6b 100644
>> --- a/fs/erofs/compress.h
>> +++ b/fs/erofs/compress.h
>> @@ -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
>> diff --git a/fs/erofs/decompressor.c b/fs/erofs/decompressor.c
>> index cfad1eac7fd9..332ec5f74002 100644
>> --- a/fs/erofs/decompressor.c
>> +++ b/fs/erofs/decompressor.c
>> @@ -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
>> };
>> diff --git a/fs/erofs/decompressor_deflate.c b/fs/erofs/decompressor_deflate.c
>> new file mode 100644
>> index 000000000000..c34e29b15465
>> --- /dev/null
>> +++ b/fs/erofs/decompressor_deflate.c
>> @@ -0,0 +1,250 @@
>> +// SPDX-License-Identifier: GPL-2.0-or-later
>> +#include <linux/module.h>
>> +#include <linux/zlib.h>
>> +#include "compress.h"
>> +
>> +struct z_erofs_deflate {
>> + struct z_erofs_deflate *next;
>> + struct z_stream_s z;
>> + u8 bounce[PAGE_SIZE];
>> +};
>> +
>> +static DEFINE_SPINLOCK(z_erofs_deflate_lock);
>> +static unsigned int z_erofs_deflate_nstrms, z_erofs_deflate_avail_strms;
>> +static struct z_erofs_deflate *z_erofs_deflate_head;
>> +static DECLARE_WAIT_QUEUE_HEAD(z_erofs_deflate_wq);
>> +
>> +module_param_named(deflate_streams, z_erofs_deflate_nstrms, uint, 0444);
>> +
>> +void z_erofs_deflate_exit(void)
>> +{
>> + /* there should be no running fs instance */
>> + while (z_erofs_deflate_avail_strms) {
>> + struct z_erofs_deflate *strm;
>> +
>> + spin_lock(&z_erofs_deflate_lock);
>> + strm = z_erofs_deflate_head;
>> + if (!strm) {
>> + spin_unlock(&z_erofs_deflate_lock);
>> + DBG_BUGON(1);
>> + return;
>> + }
>> + z_erofs_deflate_head = NULL;
>> + spin_unlock(&z_erofs_deflate_lock);
>> +
>> + while (strm) {
>> + struct z_erofs_deflate *n = strm->next;
>> +
>> + vfree(strm->z.workspace);
>> + kfree(strm);
>> + --z_erofs_deflate_avail_strms;
>> + strm = n;
>> + }
>> + }
>> +}
>> +
>> +int __init z_erofs_deflate_init(void)
>> +{
>> + /* by default, use # of possible CPUs instead */
>> + if (!z_erofs_deflate_nstrms)
>> + z_erofs_deflate_nstrms = num_possible_cpus();
>> +
>> + for (; z_erofs_deflate_avail_strms < z_erofs_deflate_nstrms;
>> + ++z_erofs_deflate_avail_strms) {
>> + struct z_erofs_deflate *strm;
>> +
>> + strm = kzalloc(sizeof(*strm), GFP_KERNEL);
>> + if (!strm)
>> + goto out_failed;
>> +
>> + /* XXX: in-kernel zlib cannot shrink windowbits currently */
>> + strm->z.workspace = vmalloc(zlib_inflate_workspacesize());
>> + if (!strm->z.workspace)
>
> kfree(strm)?
z_erofs_deflate_exit() below will handle this.
Thanks,
Gao Xiang
>
> Thanks,
>
>> + goto out_failed;
>> +
>> + spin_lock(&z_erofs_deflate_lock);
>> + strm->next = z_erofs_deflate_head;
>> + z_erofs_deflate_head = strm;
>> + spin_unlock(&z_erofs_deflate_lock);
>> + }
>> + return 0;
>> +
>> +out_failed:
>> + pr_err("failed to allocate zlib workspace\n");
>> + z_erofs_deflate_exit();
>> + return -ENOMEM;
>> +}
>> +
More information about the Linux-erofs
mailing list