2018-04-04 01:23:33 +08:00
|
|
|
# SPDX-License-Identifier: GPL-2.0
|
|
|
|
|
|
2009-01-22 15:27:30 +08:00
|
|
|
config BTRFS_FS
|
2013-03-19 19:50:59 +08:00
|
|
|
tristate "Btrfs filesystem support"
|
2023-03-27 08:49:53 +08:00
|
|
|
select BLK_CGROUP_PUNT_BIO
|
2019-06-03 22:58:57 +08:00
|
|
|
select CRYPTO
|
|
|
|
|
select CRYPTO_CRC32C
|
2019-07-02 22:39:03 +08:00
|
|
|
select LIBCRC32C
|
2019-10-07 17:11:01 +08:00
|
|
|
select CRYPTO_XXHASH
|
2019-10-07 17:11:02 +08:00
|
|
|
select CRYPTO_SHA256
|
2019-11-28 20:02:32 +08:00
|
|
|
select CRYPTO_BLAKE2B
|
2009-01-22 15:27:30 +08:00
|
|
|
select ZLIB_INFLATE
|
|
|
|
|
select ZLIB_DEFLATE
|
2010-10-25 15:12:26 +08:00
|
|
|
select LZO_COMPRESS
|
|
|
|
|
select LZO_DECOMPRESS
|
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 10:39:02 +08:00
|
|
|
select ZSTD_COMPRESS
|
|
|
|
|
select ZSTD_DECOMPRESS
|
2020-08-18 00:18:21 +08:00
|
|
|
select FS_IOMAP
|
2013-01-30 07:40:14 +08:00
|
|
|
select RAID6_PQ
|
2013-02-05 22:38:53 +08:00
|
|
|
select XOR_BLOCKS
|
2022-01-20 10:10:25 +08:00
|
|
|
depends on PAGE_SIZE_LESS_THAN_256KB
|
2013-01-30 07:40:14 +08:00
|
|
|
|
2009-01-22 15:27:30 +08:00
|
|
|
help
|
2013-11-20 21:32:34 +08:00
|
|
|
Btrfs is a general purpose copy-on-write filesystem with extents,
|
|
|
|
|
writable snapshotting, support for multiple devices and many more
|
|
|
|
|
features focused on fault tolerance, repair and easy administration.
|
2009-01-22 15:27:30 +08:00
|
|
|
|
2013-11-20 21:32:34 +08:00
|
|
|
The filesystem disk format is no longer unstable, and it's not
|
|
|
|
|
expected to change unless there are strong reasons to do so. If there
|
|
|
|
|
is a format change, file systems with a unchanged format will
|
|
|
|
|
continue to be mountable and usable by newer kernels.
|
|
|
|
|
|
|
|
|
|
For more information, please see the web pages at
|
2023-08-23 05:47:47 +08:00
|
|
|
https://btrfs.readthedocs.io
|
2009-01-22 15:27:30 +08:00
|
|
|
|
|
|
|
|
To compile this file system support as a module, choose M here. The
|
|
|
|
|
module will be called btrfs.
|
|
|
|
|
|
|
|
|
|
If unsure, say N.
|
2009-02-04 22:28:28 +08:00
|
|
|
|
|
|
|
|
config BTRFS_FS_POSIX_ACL
|
|
|
|
|
bool "Btrfs POSIX Access Control Lists"
|
|
|
|
|
depends on BTRFS_FS
|
|
|
|
|
select FS_POSIX_ACL
|
|
|
|
|
help
|
|
|
|
|
POSIX Access Control Lists (ACLs) support permissions for users and
|
|
|
|
|
groups beyond the owner/group/world scheme.
|
|
|
|
|
|
|
|
|
|
If you don't know what Access Control Lists are, say N
|
2011-11-02 00:06:04 +08:00
|
|
|
|
|
|
|
|
config BTRFS_FS_CHECK_INTEGRITY
|
2023-06-26 17:55:25 +08:00
|
|
|
bool "Btrfs with integrity check tool compiled in (DEPRECATED)"
|
2011-11-02 00:06:04 +08:00
|
|
|
depends on BTRFS_FS
|
|
|
|
|
help
|
2023-06-26 17:55:25 +08:00
|
|
|
This feature has been deprecated and will be removed in 6.7.
|
|
|
|
|
|
2011-11-02 00:06:04 +08:00
|
|
|
Adds code that examines all block write requests (including
|
|
|
|
|
writes of the super block). The goal is to verify that the
|
|
|
|
|
state of the filesystem on disk is always consistent, i.e.,
|
|
|
|
|
after a power-loss or kernel panic event the filesystem is
|
|
|
|
|
in a consistent state.
|
|
|
|
|
|
|
|
|
|
If the integrity check tool is included and activated in
|
|
|
|
|
the mount options, plenty of kernel memory is used, and
|
|
|
|
|
plenty of additional CPU cycles are spent. Enabling this
|
|
|
|
|
functionality is not intended for normal use.
|
|
|
|
|
|
|
|
|
|
In most cases, unless you are a btrfs developer who needs
|
|
|
|
|
to verify the integrity of (super)-block write requests
|
|
|
|
|
during the run of a regression test, say N
|
2013-03-15 21:47:08 +08:00
|
|
|
|
|
|
|
|
config BTRFS_FS_RUN_SANITY_TESTS
|
|
|
|
|
bool "Btrfs will run sanity tests upon loading"
|
|
|
|
|
depends on BTRFS_FS
|
|
|
|
|
help
|
|
|
|
|
This will run some basic sanity tests on the free space cache
|
|
|
|
|
code to make sure it is acting as it should. These are mostly
|
2013-08-14 17:59:45 +08:00
|
|
|
regression tests and are only really interesting to btrfs
|
|
|
|
|
developers.
|
2013-03-15 21:47:08 +08:00
|
|
|
|
|
|
|
|
If unsure, say N.
|
|
|
|
|
|
2013-04-23 00:12:31 +08:00
|
|
|
config BTRFS_DEBUG
|
|
|
|
|
bool "Btrfs debugging support"
|
|
|
|
|
depends on BTRFS_FS
|
|
|
|
|
help
|
|
|
|
|
Enable run-time debugging support for the btrfs filesystem. This may
|
|
|
|
|
enable additional and expensive checks with negative impact on
|
|
|
|
|
performance, or export extra information via sysfs.
|
|
|
|
|
|
|
|
|
|
If unsure, say N.
|
2013-08-27 04:53:15 +08:00
|
|
|
|
|
|
|
|
config BTRFS_ASSERT
|
|
|
|
|
bool "Btrfs assert support"
|
|
|
|
|
depends on BTRFS_FS
|
|
|
|
|
help
|
|
|
|
|
Enable run-time assertion checking. This will result in panics if
|
|
|
|
|
any of the assertions trip. This is meant for btrfs developers only.
|
|
|
|
|
|
|
|
|
|
If unsure, say N.
|
2017-09-30 03:43:50 +08:00
|
|
|
|
|
|
|
|
config BTRFS_FS_REF_VERIFY
|
|
|
|
|
bool "Btrfs with the ref verify tool compiled in"
|
|
|
|
|
depends on BTRFS_FS
|
|
|
|
|
default n
|
|
|
|
|
help
|
|
|
|
|
Enable run-time extent reference verification instrumentation. This
|
|
|
|
|
is meant to be used by btrfs developers for tracking down extent
|
|
|
|
|
reference problems or verifying they didn't break something.
|
|
|
|
|
|
|
|
|
|
If unsure, say N.
|