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