2018-04-03 20:16:55 +03:00
/* SPDX-License-Identifier: GPL-2.0 */
Btrfs: Add zlib compression support
This is a large change for adding compression on reading and writing,
both for inline and regular extents. It does some fairly large
surgery to the writeback paths.
Compression is off by default and enabled by mount -o compress. Even
when the -o compress mount option is not used, it is possible to read
compressed extents off the disk.
If compression for a given set of pages fails to make them smaller, the
file is flagged to avoid future compression attempts later.
* While finding delalloc extents, the pages are locked before being sent down
to the delalloc handler. This allows the delalloc handler to do complex things
such as cleaning the pages, marking them writeback and starting IO on their
behalf.
* Inline extents are inserted at delalloc time now. This allows us to compress
the data before inserting the inline extent, and it allows us to insert
an inline extent that spans multiple pages.
* All of the in-memory extent representations (extent_map.c, ordered-data.c etc)
are changed to record both an in-memory size and an on disk size, as well
as a flag for compression.
From a disk format point of view, the extent pointers in the file are changed
to record the on disk size of a given extent and some encoding flags.
Space in the disk format is allocated for compression encoding, as well
as encryption and a generic 'other' field. Neither the encryption or the
'other' field are currently used.
In order to limit the amount of data read for a single random read in the
file, the size of a compressed extent is limited to 128k. This is a
software only limit, the disk format supports u64 sized compressed extents.
In order to limit the ram consumed while processing extents, the uncompressed
size of a compressed extent is limited to 256k. This is a software only limit
and will be subject to tuning later.
Checksumming is still done on compressed extents, and it is done on the
uncompressed version of the data. This way additional encodings can be
layered on without having to figure out which encoding to checksum.
Compression happens at delalloc time, which is basically singled threaded because
it is usually done by a single pdflush thread. This makes it tricky to
spread the compression load across all the cpus on the box. We'll have to
look at parallel pdflush walks of dirty inodes at a later time.
Decompression is hooked into readpages and it does spread across CPUs nicely.
Signed-off-by: Chris Mason <chris.mason@oracle.com>
2008-10-29 21:49:59 +03:00
/*
* Copyright ( C ) 2008 Oracle . All rights reserved .
*/
2018-04-03 20:16:55 +03:00
# ifndef BTRFS_COMPRESSION_H
# define BTRFS_COMPRESSION_H
Btrfs: Add zlib compression support
This is a large change for adding compression on reading and writing,
both for inline and regular extents. It does some fairly large
surgery to the writeback paths.
Compression is off by default and enabled by mount -o compress. Even
when the -o compress mount option is not used, it is possible to read
compressed extents off the disk.
If compression for a given set of pages fails to make them smaller, the
file is flagged to avoid future compression attempts later.
* While finding delalloc extents, the pages are locked before being sent down
to the delalloc handler. This allows the delalloc handler to do complex things
such as cleaning the pages, marking them writeback and starting IO on their
behalf.
* Inline extents are inserted at delalloc time now. This allows us to compress
the data before inserting the inline extent, and it allows us to insert
an inline extent that spans multiple pages.
* All of the in-memory extent representations (extent_map.c, ordered-data.c etc)
are changed to record both an in-memory size and an on disk size, as well
as a flag for compression.
From a disk format point of view, the extent pointers in the file are changed
to record the on disk size of a given extent and some encoding flags.
Space in the disk format is allocated for compression encoding, as well
as encryption and a generic 'other' field. Neither the encryption or the
'other' field are currently used.
In order to limit the amount of data read for a single random read in the
file, the size of a compressed extent is limited to 128k. This is a
software only limit, the disk format supports u64 sized compressed extents.
In order to limit the ram consumed while processing extents, the uncompressed
size of a compressed extent is limited to 256k. This is a software only limit
and will be subject to tuning later.
Checksumming is still done on compressed extents, and it is done on the
uncompressed version of the data. This way additional encodings can be
layered on without having to figure out which encoding to checksum.
Compression happens at delalloc time, which is basically singled threaded because
it is usually done by a single pdflush thread. This makes it tricky to
spread the compression load across all the cpus on the box. We'll have to
look at parallel pdflush walks of dirty inodes at a later time.
Decompression is hooked into readpages and it does spread across CPUs nicely.
Signed-off-by: Chris Mason <chris.mason@oracle.com>
2008-10-29 21:49:59 +03:00
2022-10-26 22:08:19 +03:00
# include <linux/blk_types.h>
2018-05-17 08:52:22 +03:00
# include <linux/sizes.h>
2020-06-03 08:55:16 +03:00
struct btrfs_inode ;
2017-02-14 21:30:39 +03:00
/*
* We want to make sure that amount of RAM required to uncompress an extent is
* reasonable , so we limit the total size in ram of a compressed extent to
* 128 k . This is a crucial number because it also controls how easily we can
* spread reads across cpus for decompression .
*
* We also want to make sure the amount of IO required to do a random read is
* reasonably small , so we limit the size of a compressed extent to 128 k .
*/
/* Maximum length of compressed data stored on disk */
# define BTRFS_MAX_COMPRESSED (SZ_128K)
2022-02-01 17:42:07 +03:00
static_assert ( ( BTRFS_MAX_COMPRESSED % PAGE_SIZE ) = = 0 ) ;
2017-02-14 21:30:39 +03:00
/* Maximum size of data before compression */
# define BTRFS_MAX_UNCOMPRESSED (SZ_128K)
2017-11-06 05:43:18 +03:00
# define BTRFS_ZLIB_DEFAULT_LEVEL 3
2017-05-26 10:44:59 +03:00
struct compressed_bio {
2019-10-14 15:38:33 +03:00
/* Number of compressed pages in the array */
unsigned int nr_pages ;
2017-05-26 10:44:59 +03:00
/* the pages with the compressed data on them */
struct page * * compressed_pages ;
/* inode that owns this data */
struct inode * inode ;
/* starting offset in the inode for our pages */
u64 start ;
2019-10-14 15:38:33 +03:00
/* Number of bytes in the inode we're working on */
unsigned int len ;
2017-05-26 10:44:59 +03:00
2019-10-14 15:38:33 +03:00
/* Number of bytes on disk */
unsigned int compressed_len ;
2017-05-26 10:44:59 +03:00
2019-10-14 15:38:33 +03:00
/* The compression algorithm for this bio */
u8 compress_type ;
2017-05-26 10:44:59 +03:00
2019-08-14 02:00:02 +03:00
/* Whether this is a write for writeback. */
bool writeback ;
2017-05-26 10:44:59 +03:00
/* IO errors */
2022-02-18 18:03:26 +03:00
blk_status_t status ;
2017-05-26 10:44:59 +03:00
2022-05-26 10:36:38 +03:00
union {
/* For reads, this is the bio we are copying the data into */
struct bio * orig_bio ;
struct work_struct write_end_work ;
} ;
2017-05-26 10:44:59 +03:00
} ;
2019-02-04 23:19:57 +03:00
static inline unsigned int btrfs_compress_type ( unsigned int type_level )
{
return ( type_level & 0xF ) ;
}
static inline unsigned int btrfs_compress_level ( unsigned int type_level )
{
return ( ( type_level & 0xF0 ) > > 4 ) ;
}
btrfs: make module init/exit match their sequence
[BACKGROUND]
In theory init_btrfs_fs() and exit_btrfs_fs() should match their
sequence, thus normally they should look like this:
init_btrfs_fs() | exit_btrfs_fs()
----------------------+------------------------
init_A(); |
init_B(); |
init_C(); |
| exit_C();
| exit_B();
| exit_A();
So is for the error path of init_btrfs_fs().
But it's not the case, some exit functions don't match their init
functions sequence in init_btrfs_fs().
Furthermore in init_btrfs_fs(), we need to have a new error label for
each new init function we added. This is not really expandable,
especially recently we may add several new functions to init_btrfs_fs().
[ENHANCEMENT]
The patch will introduce the following things to enhance the situation:
- struct init_sequence
Just a wrapper of init and exit function pointers.
The init function must use int type as return value, thus some init
functions need to be updated to return 0.
The exit function can be NULL, as there are some init sequence just
outputting a message.
- struct mod_init_seq[] array
This is a const array, recording all the initialization we need to do
in init_btrfs_fs(), and the order follows the old init_btrfs_fs().
- bool mod_init_result[] array
This is a bool array, recording if we have initialized one entry in
mod_init_seq[].
The reason to split mod_init_seq[] and mod_init_result[] is to avoid
section mismatch in reference.
All init function are in .init.text, but if mod_init_seq[] records
the @initialized member it can no longer be const, thus will be put
into .data section, and cause modpost warning.
For init_btrfs_fs() we just call all init functions in their order in
mod_init_seq[] array, and after each call, setting corresponding
mod_init_result[] to true.
For exit_btrfs_fs() and error handling path of init_btrfs_fs(), we just
iterate mod_init_seq[] in reverse order, and skip all uninitialized
entry.
With this patch, init_btrfs_fs()/exit_btrfs_fs() will be much easier to
expand and will always follow the strict order.
Signed-off-by: Qu Wenruo <wqu@suse.com>
Signed-off-by: David Sterba <dsterba@suse.com>
2022-10-12 12:22:35 +03:00
int __init btrfs_init_compress ( void ) ;
2018-02-19 19:24:18 +03:00
void __cold btrfs_exit_compress ( void ) ;
2010-12-17 09:21:50 +03:00
2017-09-15 18:36:57 +03:00
int btrfs_compress_pages ( unsigned int type_level , struct address_space * mapping ,
2017-02-14 21:04:07 +03:00
u64 start , struct page * * pages ,
2010-12-17 09:21:50 +03:00
unsigned long * out_pages ,
unsigned long * total_in ,
2017-02-14 21:45:05 +03:00
unsigned long * total_out ) ;
2022-11-07 19:30:21 +03:00
int btrfs_decompress ( int type , const u8 * data_in , struct page * dest_page ,
2010-12-17 09:21:50 +03:00
unsigned long start_byte , size_t srclen , size_t destlen ) ;
btrfs: rework btrfs_decompress_buf2page()
There are several bugs inside the function btrfs_decompress_buf2page()
- @start_byte doesn't take bvec.bv_offset into consideration
Thus it can't handle case where the target range is not page aligned.
- Too many helper variables
There are tons of helper variables, @buf_offset, @current_buf_start,
@start_byte, @prev_start_byte, @working_bytes, @bytes.
This hurts anyone who wants to read the function.
- No obvious main cursor for the iteartion
A new problem caused by previous problem.
- Comments for parameter list makes no sense
Like @buf_start is the offset to @buf, or offset inside the full
decompressed extent? (Spoiler alert, the later case)
And @total_out acts more like @buf_start + @size_of_buf.
The worst is @disk_start.
The real meaning of it is the file offset of the full decompressed
extent.
This patch will rework the whole function by:
- Add a proper comment with ASCII art to explain the parameter list
- Rework parameter list
The old @buf_start is renamed to @decompressed, to show how many bytes
are already decompressed inside the full decompressed extent.
The old @total_out is replaced by @buf_len, which is the decompressed
data size.
For old @disk_start and @bio, just pass @compressed_bio in.
- Use single main cursor
The main cursor will be @cur_file_offset, to show what's the current
file offset.
Other helper variables will be declared inside the main loop, and only
minimal amount of helper variables:
* offset_inside_decompressed_buf: The only real helper
* copy_start_file_offset: File offset we start memcpy
* bvec_file_offset: File offset of current bvec
Even with all these extensive comments, the final function is still
smaller than the original function, which is definitely a win.
Signed-off-by: Qu Wenruo <wqu@suse.com>
Signed-off-by: David Sterba <dsterba@suse.com>
2021-07-05 05:00:58 +03:00
int btrfs_decompress_buf2page ( const char * buf , u32 buf_len ,
struct compressed_bio * cb , u32 decompressed ) ;
2010-12-17 09:21:50 +03:00
2020-06-03 08:55:16 +03:00
blk_status_t btrfs_submit_compressed_write ( struct btrfs_inode * inode , u64 start ,
2021-05-29 12:48:35 +03:00
unsigned int len , u64 disk_start ,
unsigned int compressed_len ,
Btrfs: Add zlib compression support
This is a large change for adding compression on reading and writing,
both for inline and regular extents. It does some fairly large
surgery to the writeback paths.
Compression is off by default and enabled by mount -o compress. Even
when the -o compress mount option is not used, it is possible to read
compressed extents off the disk.
If compression for a given set of pages fails to make them smaller, the
file is flagged to avoid future compression attempts later.
* While finding delalloc extents, the pages are locked before being sent down
to the delalloc handler. This allows the delalloc handler to do complex things
such as cleaning the pages, marking them writeback and starting IO on their
behalf.
* Inline extents are inserted at delalloc time now. This allows us to compress
the data before inserting the inline extent, and it allows us to insert
an inline extent that spans multiple pages.
* All of the in-memory extent representations (extent_map.c, ordered-data.c etc)
are changed to record both an in-memory size and an on disk size, as well
as a flag for compression.
From a disk format point of view, the extent pointers in the file are changed
to record the on disk size of a given extent and some encoding flags.
Space in the disk format is allocated for compression encoding, as well
as encryption and a generic 'other' field. Neither the encryption or the
'other' field are currently used.
In order to limit the amount of data read for a single random read in the
file, the size of a compressed extent is limited to 128k. This is a
software only limit, the disk format supports u64 sized compressed extents.
In order to limit the ram consumed while processing extents, the uncompressed
size of a compressed extent is limited to 256k. This is a software only limit
and will be subject to tuning later.
Checksumming is still done on compressed extents, and it is done on the
uncompressed version of the data. This way additional encodings can be
layered on without having to figure out which encoding to checksum.
Compression happens at delalloc time, which is basically singled threaded because
it is usually done by a single pdflush thread. This makes it tricky to
spread the compression load across all the cpus on the box. We'll have to
look at parallel pdflush walks of dirty inodes at a later time.
Decompression is hooked into readpages and it does spread across CPUs nicely.
Signed-off-by: Chris Mason <chris.mason@oracle.com>
2008-10-29 21:49:59 +03:00
struct page * * compressed_pages ,
2021-05-29 12:48:35 +03:00
unsigned int nr_pages ,
2022-07-14 21:07:16 +03:00
blk_opf_t write_flags ,
2019-08-14 02:00:02 +03:00
struct cgroup_subsys_state * blkcg_css ,
bool writeback ) ;
2022-04-15 17:33:27 +03:00
void btrfs_submit_compressed_read ( struct inode * inode , struct bio * bio ,
2022-04-26 16:47:34 +03:00
int mirror_num ) ;
2016-03-10 12:26:59 +03:00
2019-02-04 23:20:05 +03:00
unsigned int btrfs_compress_str2level ( unsigned int type , const char * str ) ;
2017-09-15 18:36:57 +03:00
2016-03-10 12:26:59 +03:00
enum btrfs_compression_type {
BTRFS_COMPRESS_NONE = 0 ,
BTRFS_COMPRESS_ZLIB = 1 ,
BTRFS_COMPRESS_LZO = 2 ,
btrfs: Add zstd support
Add zstd compression and decompression support to BtrFS. zstd at its
fastest level compresses almost as well as zlib, while offering much
faster compression and decompression, approaching lzo speeds.
I benchmarked btrfs with zstd compression against no compression, lzo
compression, and zlib compression. I benchmarked two scenarios. Copying
a set of files to btrfs, and then reading the files. Copying a tarball
to btrfs, extracting it to btrfs, and then reading the extracted files.
After every operation, I call `sync` and include the sync time.
Between every pair of operations I unmount and remount the filesystem
to avoid caching. The benchmark files can be found in the upstream
zstd source repository under
`contrib/linux-kernel/{btrfs-benchmark.sh,btrfs-extract-benchmark.sh}`
[1] [2].
I ran the benchmarks on a Ubuntu 14.04 VM with 2 cores and 4 GiB of RAM.
The VM is running on a MacBook Pro with a 3.1 GHz Intel Core i7 processor,
16 GB of RAM, and a SSD.
The first compression benchmark is copying 10 copies of the unzipped
Silesia corpus [3] into a BtrFS filesystem mounted with
`-o compress-force=Method`. The decompression benchmark times how long
it takes to `tar` all 10 copies into `/dev/null`. The compression ratio is
measured by comparing the output of `df` and `du`. See the benchmark file
[1] for details. I benchmarked multiple zstd compression levels, although
the patch uses zstd level 1.
| Method | Ratio | Compression MB/s | Decompression speed |
|---------|-------|------------------|---------------------|
| None | 0.99 | 504 | 686 |
| lzo | 1.66 | 398 | 442 |
| zlib | 2.58 | 65 | 241 |
| zstd 1 | 2.57 | 260 | 383 |
| zstd 3 | 2.71 | 174 | 408 |
| zstd 6 | 2.87 | 70 | 398 |
| zstd 9 | 2.92 | 43 | 406 |
| zstd 12 | 2.93 | 21 | 408 |
| zstd 15 | 3.01 | 11 | 354 |
The next benchmark first copies `linux-4.11.6.tar` [4] to btrfs. Then it
measures the compression ratio, extracts the tar, and deletes the tar.
Then it measures the compression ratio again, and `tar`s the extracted
files into `/dev/null`. See the benchmark file [2] for details.
| Method | Tar Ratio | Extract Ratio | Copy (s) | Extract (s)| Read (s) |
|--------|-----------|---------------|----------|------------|----------|
| None | 0.97 | 0.78 | 0.981 | 5.501 | 8.807 |
| lzo | 2.06 | 1.38 | 1.631 | 8.458 | 8.585 |
| zlib | 3.40 | 1.86 | 7.750 | 21.544 | 11.744 |
| zstd 1 | 3.57 | 1.85 | 2.579 | 11.479 | 9.389 |
[1] https://github.com/facebook/zstd/blob/dev/contrib/linux-kernel/btrfs-benchmark.sh
[2] https://github.com/facebook/zstd/blob/dev/contrib/linux-kernel/btrfs-extract-benchmark.sh
[3] http://sun.aei.polsl.pl/~sdeor/index.php?page=silesia
[4] https://cdn.kernel.org/pub/linux/kernel/v4.x/linux-4.11.6.tar.xz
zstd source repository: https://github.com/facebook/zstd
Signed-off-by: Nick Terrell <terrelln@fb.com>
Signed-off-by: Chris Mason <clm@fb.com>
2017-08-10 05:39:02 +03:00
BTRFS_COMPRESS_ZSTD = 3 ,
2019-10-10 10:59:57 +03:00
BTRFS_NR_COMPRESS_TYPES = 4 ,
2016-03-10 12:26:59 +03:00
} ;
2019-02-04 23:20:03 +03:00
struct workspace_manager {
struct list_head idle_ws ;
spinlock_t ws_lock ;
/* Number of free workspaces */
int free_ws ;
/* Total number of allocated workspaces */
atomic_t total_ws ;
/* Waiters for a free workspace */
wait_queue_head_t ws_wait ;
} ;
2019-10-04 03:50:28 +03:00
struct list_head * btrfs_get_workspace ( int type , unsigned int level ) ;
2019-10-04 03:50:28 +03:00
void btrfs_put_workspace ( int type , struct list_head * ws ) ;
2019-02-04 23:20:03 +03:00
2010-12-17 09:21:50 +03:00
struct btrfs_compress_op {
2019-10-02 01:53:31 +03:00
struct workspace_manager * workspace_manager ;
2019-08-09 17:25:34 +03:00
/* Maximum level supported by the compression algorithm */
unsigned int max_level ;
unsigned int default_level ;
2010-12-17 09:21:50 +03:00
} ;
2019-02-04 23:19:59 +03:00
/* The heuristic workspaces are managed via the 0th workspace manager */
2019-10-10 10:59:57 +03:00
# define BTRFS_NR_WORKSPACE_MANAGERS BTRFS_NR_COMPRESS_TYPES
2019-02-04 23:19:59 +03:00
extern const struct btrfs_compress_op btrfs_heuristic_compress ;
2015-01-02 20:23:10 +03:00
extern const struct btrfs_compress_op btrfs_zlib_compress ;
extern const struct btrfs_compress_op btrfs_lzo_compress ;
btrfs: Add zstd support
Add zstd compression and decompression support to BtrFS. zstd at its
fastest level compresses almost as well as zlib, while offering much
faster compression and decompression, approaching lzo speeds.
I benchmarked btrfs with zstd compression against no compression, lzo
compression, and zlib compression. I benchmarked two scenarios. Copying
a set of files to btrfs, and then reading the files. Copying a tarball
to btrfs, extracting it to btrfs, and then reading the extracted files.
After every operation, I call `sync` and include the sync time.
Between every pair of operations I unmount and remount the filesystem
to avoid caching. The benchmark files can be found in the upstream
zstd source repository under
`contrib/linux-kernel/{btrfs-benchmark.sh,btrfs-extract-benchmark.sh}`
[1] [2].
I ran the benchmarks on a Ubuntu 14.04 VM with 2 cores and 4 GiB of RAM.
The VM is running on a MacBook Pro with a 3.1 GHz Intel Core i7 processor,
16 GB of RAM, and a SSD.
The first compression benchmark is copying 10 copies of the unzipped
Silesia corpus [3] into a BtrFS filesystem mounted with
`-o compress-force=Method`. The decompression benchmark times how long
it takes to `tar` all 10 copies into `/dev/null`. The compression ratio is
measured by comparing the output of `df` and `du`. See the benchmark file
[1] for details. I benchmarked multiple zstd compression levels, although
the patch uses zstd level 1.
| Method | Ratio | Compression MB/s | Decompression speed |
|---------|-------|------------------|---------------------|
| None | 0.99 | 504 | 686 |
| lzo | 1.66 | 398 | 442 |
| zlib | 2.58 | 65 | 241 |
| zstd 1 | 2.57 | 260 | 383 |
| zstd 3 | 2.71 | 174 | 408 |
| zstd 6 | 2.87 | 70 | 398 |
| zstd 9 | 2.92 | 43 | 406 |
| zstd 12 | 2.93 | 21 | 408 |
| zstd 15 | 3.01 | 11 | 354 |
The next benchmark first copies `linux-4.11.6.tar` [4] to btrfs. Then it
measures the compression ratio, extracts the tar, and deletes the tar.
Then it measures the compression ratio again, and `tar`s the extracted
files into `/dev/null`. See the benchmark file [2] for details.
| Method | Tar Ratio | Extract Ratio | Copy (s) | Extract (s)| Read (s) |
|--------|-----------|---------------|----------|------------|----------|
| None | 0.97 | 0.78 | 0.981 | 5.501 | 8.807 |
| lzo | 2.06 | 1.38 | 1.631 | 8.458 | 8.585 |
| zlib | 3.40 | 1.86 | 7.750 | 21.544 | 11.744 |
| zstd 1 | 3.57 | 1.85 | 2.579 | 11.479 | 9.389 |
[1] https://github.com/facebook/zstd/blob/dev/contrib/linux-kernel/btrfs-benchmark.sh
[2] https://github.com/facebook/zstd/blob/dev/contrib/linux-kernel/btrfs-extract-benchmark.sh
[3] http://sun.aei.polsl.pl/~sdeor/index.php?page=silesia
[4] https://cdn.kernel.org/pub/linux/kernel/v4.x/linux-4.11.6.tar.xz
zstd source repository: https://github.com/facebook/zstd
Signed-off-by: Nick Terrell <terrelln@fb.com>
Signed-off-by: Chris Mason <clm@fb.com>
2017-08-10 05:39:02 +03:00
extern const struct btrfs_compress_op btrfs_zstd_compress ;
2010-12-17 09:21:50 +03:00
2017-10-31 19:24:26 +03:00
const char * btrfs_compress_type2str ( enum btrfs_compression_type type ) ;
2019-06-06 13:07:15 +03:00
bool btrfs_compress_is_valid_type ( const char * str , size_t len ) ;
2017-10-31 19:24:26 +03:00
2017-07-17 16:52:58 +03:00
int btrfs_compress_heuristic ( struct inode * inode , u64 start , u64 end ) ;
2020-08-17 11:58:38 +03:00
int zlib_compress_pages ( struct list_head * ws , struct address_space * mapping ,
u64 start , struct page * * pages , unsigned long * out_pages ,
unsigned long * total_in , unsigned long * total_out ) ;
int zlib_decompress_bio ( struct list_head * ws , struct compressed_bio * cb ) ;
2022-11-07 19:30:21 +03:00
int zlib_decompress ( struct list_head * ws , const u8 * data_in ,
2020-08-17 11:58:38 +03:00
struct page * dest_page , unsigned long start_byte , size_t srclen ,
size_t destlen ) ;
struct list_head * zlib_alloc_workspace ( unsigned int level ) ;
void zlib_free_workspace ( struct list_head * ws ) ;
struct list_head * zlib_get_workspace ( unsigned int level ) ;
int lzo_compress_pages ( struct list_head * ws , struct address_space * mapping ,
u64 start , struct page * * pages , unsigned long * out_pages ,
unsigned long * total_in , unsigned long * total_out ) ;
int lzo_decompress_bio ( struct list_head * ws , struct compressed_bio * cb ) ;
2022-11-07 19:30:21 +03:00
int lzo_decompress ( struct list_head * ws , const u8 * data_in ,
2020-08-17 11:58:38 +03:00
struct page * dest_page , unsigned long start_byte , size_t srclen ,
size_t destlen ) ;
struct list_head * lzo_alloc_workspace ( unsigned int level ) ;
void lzo_free_workspace ( struct list_head * ws ) ;
int zstd_compress_pages ( struct list_head * ws , struct address_space * mapping ,
u64 start , struct page * * pages , unsigned long * out_pages ,
unsigned long * total_in , unsigned long * total_out ) ;
int zstd_decompress_bio ( struct list_head * ws , struct compressed_bio * cb ) ;
2022-11-07 19:30:21 +03:00
int zstd_decompress ( struct list_head * ws , const u8 * data_in ,
2020-08-17 11:58:38 +03:00
struct page * dest_page , unsigned long start_byte , size_t srclen ,
size_t destlen ) ;
void zstd_init_workspace_manager ( void ) ;
void zstd_cleanup_workspace_manager ( void ) ;
struct list_head * zstd_alloc_workspace ( unsigned int level ) ;
void zstd_free_workspace ( struct list_head * ws ) ;
struct list_head * zstd_get_workspace ( unsigned int level ) ;
void zstd_put_workspace ( struct list_head * ws ) ;
Btrfs: Add zlib compression support
This is a large change for adding compression on reading and writing,
both for inline and regular extents. It does some fairly large
surgery to the writeback paths.
Compression is off by default and enabled by mount -o compress. Even
when the -o compress mount option is not used, it is possible to read
compressed extents off the disk.
If compression for a given set of pages fails to make them smaller, the
file is flagged to avoid future compression attempts later.
* While finding delalloc extents, the pages are locked before being sent down
to the delalloc handler. This allows the delalloc handler to do complex things
such as cleaning the pages, marking them writeback and starting IO on their
behalf.
* Inline extents are inserted at delalloc time now. This allows us to compress
the data before inserting the inline extent, and it allows us to insert
an inline extent that spans multiple pages.
* All of the in-memory extent representations (extent_map.c, ordered-data.c etc)
are changed to record both an in-memory size and an on disk size, as well
as a flag for compression.
From a disk format point of view, the extent pointers in the file are changed
to record the on disk size of a given extent and some encoding flags.
Space in the disk format is allocated for compression encoding, as well
as encryption and a generic 'other' field. Neither the encryption or the
'other' field are currently used.
In order to limit the amount of data read for a single random read in the
file, the size of a compressed extent is limited to 128k. This is a
software only limit, the disk format supports u64 sized compressed extents.
In order to limit the ram consumed while processing extents, the uncompressed
size of a compressed extent is limited to 256k. This is a software only limit
and will be subject to tuning later.
Checksumming is still done on compressed extents, and it is done on the
uncompressed version of the data. This way additional encodings can be
layered on without having to figure out which encoding to checksum.
Compression happens at delalloc time, which is basically singled threaded because
it is usually done by a single pdflush thread. This makes it tricky to
spread the compression load across all the cpus on the box. We'll have to
look at parallel pdflush walks of dirty inodes at a later time.
Decompression is hooked into readpages and it does spread across CPUs nicely.
Signed-off-by: Chris Mason <chris.mason@oracle.com>
2008-10-29 21:49:59 +03:00
# endif