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