xref: /linux/fs/btrfs/Kconfig (revision e53524cdcc02d089e757b668da031ba06ff665c3)
1# SPDX-License-Identifier: GPL-2.0
2
3config BTRFS_FS
4	tristate "Btrfs filesystem support"
5	select BLK_CGROUP_PUNT_BIO
6	select CRYPTO
7	select CRYPTO_CRC32C
8	select LIBCRC32C
9	select CRYPTO_XXHASH
10	select CRYPTO_SHA256
11	select CRYPTO_BLAKE2B
12	select ZLIB_INFLATE
13	select ZLIB_DEFLATE
14	select LZO_COMPRESS
15	select LZO_DECOMPRESS
16	select ZSTD_COMPRESS
17	select ZSTD_DECOMPRESS
18	select FS_IOMAP
19	select RAID6_PQ
20	select XOR_BLOCKS
21	depends on PAGE_SIZE_LESS_THAN_256KB
22
23	help
24	  Btrfs is a general purpose copy-on-write filesystem with extents,
25	  writable snapshotting, support for multiple devices and many more
26	  features focused on fault tolerance, repair and easy administration.
27
28	  The filesystem disk format is no longer unstable, and it's not
29	  expected to change unless there are strong reasons to do so. If there
30	  is a format change, file systems with a unchanged format will
31	  continue to be mountable and usable by newer kernels.
32
33	  For more information, please see the web pages at
34	  http://btrfs.wiki.kernel.org.
35
36	  To compile this file system support as a module, choose M here. The
37	  module will be called btrfs.
38
39	  If unsure, say N.
40
41config BTRFS_FS_POSIX_ACL
42	bool "Btrfs POSIX Access Control Lists"
43	depends on BTRFS_FS
44	select FS_POSIX_ACL
45	help
46	  POSIX Access Control Lists (ACLs) support permissions for users and
47	  groups beyond the owner/group/world scheme.
48
49	  If you don't know what Access Control Lists are, say N
50
51config BTRFS_FS_CHECK_INTEGRITY
52	bool "Btrfs with integrity check tool compiled in (DANGEROUS)"
53	depends on BTRFS_FS
54	help
55	  Adds code that examines all block write requests (including
56	  writes of the super block). The goal is to verify that the
57	  state of the filesystem on disk is always consistent, i.e.,
58	  after a power-loss or kernel panic event the filesystem is
59	  in a consistent state.
60
61	  If the integrity check tool is included and activated in
62	  the mount options, plenty of kernel memory is used, and
63	  plenty of additional CPU cycles are spent. Enabling this
64	  functionality is not intended for normal use.
65
66	  In most cases, unless you are a btrfs developer who needs
67	  to verify the integrity of (super)-block write requests
68	  during the run of a regression test, say N
69
70config BTRFS_FS_RUN_SANITY_TESTS
71	bool "Btrfs will run sanity tests upon loading"
72	depends on BTRFS_FS
73	help
74	  This will run some basic sanity tests on the free space cache
75	  code to make sure it is acting as it should.  These are mostly
76	  regression tests and are only really interesting to btrfs
77	  developers.
78
79	  If unsure, say N.
80
81config BTRFS_DEBUG
82	bool "Btrfs debugging support"
83	depends on BTRFS_FS
84	help
85	  Enable run-time debugging support for the btrfs filesystem. This may
86	  enable additional and expensive checks with negative impact on
87	  performance, or export extra information via sysfs.
88
89	  If unsure, say N.
90
91config BTRFS_ASSERT
92	bool "Btrfs assert support"
93	depends on BTRFS_FS
94	help
95	  Enable run-time assertion checking.  This will result in panics if
96	  any of the assertions trip.  This is meant for btrfs developers only.
97
98	  If unsure, say N.
99
100config BTRFS_FS_REF_VERIFY
101	bool "Btrfs with the ref verify tool compiled in"
102	depends on BTRFS_FS
103	default n
104	help
105	  Enable run-time extent reference verification instrumentation.  This
106	  is meant to be used by btrfs developers for tracking down extent
107	  reference problems or verifying they didn't break something.
108
109	  If unsure, say N.
110