Kconfig 8.9 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243
  1. # SPDX-License-Identifier: GPL-2.0-only
  2. config XFS_FS
  3. tristate "XFS filesystem support"
  4. depends on BLOCK
  5. select EXPORTFS
  6. select LIBCRC32C
  7. select FS_IOMAP
  8. help
  9. XFS is a high performance journaling filesystem which originated
  10. on the SGI IRIX platform. It is completely multi-threaded, can
  11. support large files and large filesystems, extended attributes,
  12. variable block sizes, is extent based, and makes extensive use of
  13. Btrees (directories, extents, free space) to aid both performance
  14. and scalability.
  15. Refer to the documentation at <http://oss.sgi.com/projects/xfs/>
  16. for complete details. This implementation is on-disk compatible
  17. with the IRIX version of XFS.
  18. To compile this file system support as a module, choose M here: the
  19. module will be called xfs. Be aware, however, that if the file
  20. system of your root partition is compiled as a module, you'll need
  21. to use an initial ramdisk (initrd) to boot.
  22. config XFS_SUPPORT_V4
  23. bool "Support deprecated V4 (crc=0) format"
  24. depends on XFS_FS
  25. default y
  26. help
  27. The V4 filesystem format lacks certain features that are supported
  28. by the V5 format, such as metadata checksumming, strengthened
  29. metadata verification, and the ability to store timestamps past the
  30. year 2038. Because of this, the V4 format is deprecated. All users
  31. should upgrade by backing up their files, reformatting, and restoring
  32. from the backup.
  33. Administrators and users can detect a V4 filesystem by running
  34. xfs_info against a filesystem mountpoint and checking for a string
  35. beginning with "crc=". If the string "crc=0" is found, the
  36. filesystem is a V4 filesystem. If no such string is found, please
  37. upgrade xfsprogs to the latest version and try again.
  38. This option will become default N in September 2025. Support for the
  39. V4 format will be removed entirely in September 2030. Distributors
  40. can say N here to withdraw support earlier.
  41. To continue supporting the old V4 format (crc=0), say Y.
  42. To close off an attack surface, say N.
  43. config XFS_SUPPORT_ASCII_CI
  44. bool "Support deprecated case-insensitive ascii (ascii-ci=1) format"
  45. depends on XFS_FS
  46. default y
  47. help
  48. The ASCII case insensitivity filesystem feature only works correctly
  49. on systems that have been coerced into using ISO 8859-1, and it does
  50. not work on extended attributes. The kernel has no visibility into
  51. the locale settings in userspace, so it corrupts UTF-8 names.
  52. Enabling this feature makes XFS vulnerable to mixed case sensitivity
  53. attacks. Because of this, the feature is deprecated. All users
  54. should upgrade by backing up their files, reformatting, and restoring
  55. from the backup.
  56. Administrators and users can detect such a filesystem by running
  57. xfs_info against a filesystem mountpoint and checking for a string
  58. beginning with "ascii-ci=". If the string "ascii-ci=1" is found, the
  59. filesystem is a case-insensitive filesystem. If no such string is
  60. found, please upgrade xfsprogs to the latest version and try again.
  61. This option will become default N in September 2025. Support for the
  62. feature will be removed entirely in September 2030. Distributors
  63. can say N here to withdraw support earlier.
  64. To continue supporting case-insensitivity (ascii-ci=1), say Y.
  65. To close off an attack surface, say N.
  66. config XFS_QUOTA
  67. bool "XFS Quota support"
  68. depends on XFS_FS
  69. select QUOTACTL
  70. help
  71. If you say Y here, you will be able to set limits for disk usage on
  72. a per user and/or a per group basis under XFS. XFS considers quota
  73. information as filesystem metadata and uses journaling to provide a
  74. higher level guarantee of consistency. The on-disk data format for
  75. quota is also compatible with the IRIX version of XFS, allowing a
  76. filesystem to be migrated between Linux and IRIX without any need
  77. for conversion.
  78. If unsure, say N. More comprehensive documentation can be found in
  79. README.quota in the xfsprogs package. XFS quota can be used either
  80. with or without the generic quota support enabled (CONFIG_QUOTA) -
  81. they are completely independent subsystems.
  82. config XFS_POSIX_ACL
  83. bool "XFS POSIX ACL support"
  84. depends on XFS_FS
  85. select FS_POSIX_ACL
  86. help
  87. POSIX Access Control Lists (ACLs) support permissions for users and
  88. groups beyond the owner/group/world scheme.
  89. If you don't know what Access Control Lists are, say N.
  90. config XFS_RT
  91. bool "XFS Realtime subvolume support"
  92. depends on XFS_FS
  93. help
  94. If you say Y here you will be able to mount and use XFS filesystems
  95. which contain a realtime subvolume. The realtime subvolume is a
  96. separate area of disk space where only file data is stored. It was
  97. originally designed to provide deterministic data rates suitable
  98. for media streaming applications, but is also useful as a generic
  99. mechanism for ensuring data and metadata/log I/Os are completely
  100. separated. Regular file I/Os are isolated to a separate device
  101. from all other requests, and this can be done quite transparently
  102. to applications via the inherit-realtime directory inode flag.
  103. See the xfs man page in section 5 for additional information.
  104. If unsure, say N.
  105. config XFS_DRAIN_INTENTS
  106. bool
  107. select JUMP_LABEL if HAVE_ARCH_JUMP_LABEL
  108. config XFS_LIVE_HOOKS
  109. bool
  110. select JUMP_LABEL if HAVE_ARCH_JUMP_LABEL
  111. config XFS_MEMORY_BUFS
  112. bool
  113. config XFS_BTREE_IN_MEM
  114. bool
  115. config XFS_ONLINE_SCRUB
  116. bool "XFS online metadata check support"
  117. default n
  118. depends on XFS_FS
  119. depends on TMPFS && SHMEM
  120. select XFS_LIVE_HOOKS
  121. select XFS_DRAIN_INTENTS
  122. select XFS_MEMORY_BUFS
  123. help
  124. If you say Y here you will be able to check metadata on a
  125. mounted XFS filesystem. This feature is intended to reduce
  126. filesystem downtime by supplementing xfs_repair. The key
  127. advantage here is to look for problems proactively so that
  128. they can be dealt with in a controlled manner.
  129. This feature is considered EXPERIMENTAL. Use with caution!
  130. See the xfs_scrub man page in section 8 for additional information.
  131. If unsure, say N.
  132. config XFS_ONLINE_SCRUB_STATS
  133. bool "XFS online metadata check usage data collection"
  134. default y
  135. depends on XFS_ONLINE_SCRUB
  136. select DEBUG_FS
  137. help
  138. If you say Y here, the kernel will gather usage data about
  139. the online metadata check subsystem. This includes the number
  140. of invocations, the outcomes, and the results of repairs, if any.
  141. This may slow down scrub slightly due to the use of high precision
  142. timers and the need to merge per-invocation information into the
  143. filesystem counters.
  144. Usage data are collected in /sys/kernel/debug/xfs/scrub.
  145. If unsure, say N.
  146. config XFS_ONLINE_REPAIR
  147. bool "XFS online metadata repair support"
  148. default n
  149. depends on XFS_FS && XFS_ONLINE_SCRUB
  150. select XFS_BTREE_IN_MEM
  151. help
  152. If you say Y here you will be able to repair metadata on a
  153. mounted XFS filesystem. This feature is intended to reduce
  154. filesystem downtime by fixing minor problems before they cause the
  155. filesystem to go down. However, it requires that the filesystem be
  156. formatted with secondary metadata, such as reverse mappings and inode
  157. parent pointers.
  158. This feature is considered EXPERIMENTAL. Use with caution!
  159. See the xfs_scrub man page in section 8 for additional information.
  160. If unsure, say N.
  161. config XFS_WARN
  162. bool "XFS Verbose Warnings"
  163. depends on XFS_FS && !XFS_DEBUG
  164. help
  165. Say Y here to get an XFS build with many additional warnings.
  166. It converts ASSERT checks to WARN, so will log any out-of-bounds
  167. conditions that occur that would otherwise be missed. It is much
  168. lighter weight than XFS_DEBUG and does not modify algorithms and will
  169. not cause the kernel to panic on non-fatal errors.
  170. However, similar to XFS_DEBUG, it is only advisable to use this if you
  171. are debugging a particular problem.
  172. config XFS_DEBUG
  173. bool "XFS Debugging support"
  174. depends on XFS_FS
  175. help
  176. Say Y here to get an XFS build with many debugging features,
  177. including ASSERT checks, function wrappers around macros,
  178. and extra sanity-checking functions in various code paths.
  179. Note that the resulting code will be HUGE and SLOW, and probably
  180. not useful unless you are debugging a particular problem.
  181. Say N unless you are an XFS developer, or you play one on TV.
  182. config XFS_DEBUG_EXPENSIVE
  183. bool "XFS expensive debugging checks"
  184. depends on XFS_FS && XFS_DEBUG
  185. help
  186. Say Y here to get an XFS build with expensive debugging checks
  187. enabled. These checks may affect performance significantly.
  188. Note that the resulting code will be HUGER and SLOWER, and probably
  189. not useful unless you are debugging a particular problem.
  190. Say N unless you are an XFS developer, or you play one on TV.
  191. config XFS_ASSERT_FATAL
  192. bool "XFS fatal asserts"
  193. default y
  194. depends on XFS_FS && XFS_DEBUG
  195. help
  196. Set the default DEBUG mode ASSERT failure behavior.
  197. Say Y here to cause DEBUG mode ASSERT failures to result in fatal
  198. errors that BUG() the kernel by default. If you say N, ASSERT failures
  199. result in warnings.
  200. This behavior can be modified at runtime via sysfs.