xref: /linux/fs/xfs/Kconfig (revision 84d42ea6b6269aee7eb3d91a4425a08b8965fd4a)
11da177e4SLinus Torvaldsconfig XFS_FS
21da177e4SLinus Torvalds	tristate "XFS filesystem support"
39361401eSDavid Howells	depends on BLOCK
4d5cf09baSChristoph Hellwig	depends on (64BIT || LBDAF)
5d296d30aSChristoph Hellwig	select EXPORTFS
6bc02e869SChristoph Hellwig	select LIBCRC32C
768a9f5e7SChristoph Hellwig	select FS_IOMAP
81da177e4SLinus Torvalds	help
91da177e4SLinus Torvalds	  XFS is a high performance journaling filesystem which originated
101da177e4SLinus Torvalds	  on the SGI IRIX platform.  It is completely multi-threaded, can
111da177e4SLinus Torvalds	  support large files and large filesystems, extended attributes,
121da177e4SLinus Torvalds	  variable block sizes, is extent based, and makes extensive use of
131da177e4SLinus Torvalds	  Btrees (directories, extents, free space) to aid both performance
141da177e4SLinus Torvalds	  and scalability.
151da177e4SLinus Torvalds
161da177e4SLinus Torvalds	  Refer to the documentation at <http://oss.sgi.com/projects/xfs/>
171da177e4SLinus Torvalds	  for complete details.  This implementation is on-disk compatible
181da177e4SLinus Torvalds	  with the IRIX version of XFS.
191da177e4SLinus Torvalds
201da177e4SLinus Torvalds	  To compile this file system support as a module, choose M here: the
211da177e4SLinus Torvalds	  module will be called xfs.  Be aware, however, that if the file
221da177e4SLinus Torvalds	  system of your root partition is compiled as a module, you'll need
231da177e4SLinus Torvalds	  to use an initial ramdisk (initrd) to boot.
241da177e4SLinus Torvalds
251da177e4SLinus Torvaldsconfig XFS_QUOTA
26538524aeSNathan Scott	bool "XFS Quota support"
271da177e4SLinus Torvalds	depends on XFS_FS
2880f44b15SJan Kara	select QUOTACTL
291da177e4SLinus Torvalds	help
301da177e4SLinus Torvalds	  If you say Y here, you will be able to set limits for disk usage on
311da177e4SLinus Torvalds	  a per user and/or a per group basis under XFS.  XFS considers quota
321da177e4SLinus Torvalds	  information as filesystem metadata and uses journaling to provide a
331da177e4SLinus Torvalds	  higher level guarantee of consistency.  The on-disk data format for
341da177e4SLinus Torvalds	  quota is also compatible with the IRIX version of XFS, allowing a
351da177e4SLinus Torvalds	  filesystem to be migrated between Linux and IRIX without any need
361da177e4SLinus Torvalds	  for conversion.
371da177e4SLinus Torvalds
381da177e4SLinus Torvalds	  If unsure, say N.  More comprehensive documentation can be found in
391da177e4SLinus Torvalds	  README.quota in the xfsprogs package.  XFS quota can be used either
401da177e4SLinus Torvalds	  with or without the generic quota support enabled (CONFIG_QUOTA) -
411da177e4SLinus Torvalds	  they are completely independent subsystems.
421da177e4SLinus Torvalds
431da177e4SLinus Torvaldsconfig XFS_POSIX_ACL
4420ba0287SNathan Scott	bool "XFS POSIX ACL support"
451da177e4SLinus Torvalds	depends on XFS_FS
46ef14f0c1SChristoph Hellwig	select FS_POSIX_ACL
471da177e4SLinus Torvalds	help
481da177e4SLinus Torvalds	  POSIX Access Control Lists (ACLs) support permissions for users and
491da177e4SLinus Torvalds	  groups beyond the owner/group/world scheme.
501da177e4SLinus Torvalds
511da177e4SLinus Torvalds	  If you don't know what Access Control Lists are, say N.
521da177e4SLinus Torvalds
5320ba0287SNathan Scottconfig XFS_RT
54d7ede1aaSNathan Scott	bool "XFS Realtime subvolume support"
55d7ede1aaSNathan Scott	depends on XFS_FS
5620ba0287SNathan Scott	help
5720ba0287SNathan Scott	  If you say Y here you will be able to mount and use XFS filesystems
5820ba0287SNathan Scott	  which contain a realtime subvolume.  The realtime subvolume is a
59d7ede1aaSNathan Scott	  separate area of disk space where only file data is stored.  It was
60d7ede1aaSNathan Scott	  originally designed to provide deterministic data rates suitable
61d7ede1aaSNathan Scott	  for media streaming applications, but is also useful as a generic
62d7ede1aaSNathan Scott	  mechanism for ensuring data and metadata/log I/Os are completely
63d7ede1aaSNathan Scott	  separated.  Regular file I/Os are isolated to a separate device
64d7ede1aaSNathan Scott	  from all other requests, and this can be done quite transparently
65d7ede1aaSNathan Scott	  to applications via the inherit-realtime directory inode flag.
6620ba0287SNathan Scott
67d7ede1aaSNathan Scott	  See the xfs man page in section 5 for additional information.
6820ba0287SNathan Scott
6920ba0287SNathan Scott	  If unsure, say N.
707788fae6SChristoph Hellwig
7136fd6e86SDarrick J. Wongconfig XFS_ONLINE_SCRUB
7236fd6e86SDarrick J. Wong	bool "XFS online metadata check support"
7336fd6e86SDarrick J. Wong	default n
7436fd6e86SDarrick J. Wong	depends on XFS_FS
7536fd6e86SDarrick J. Wong	help
7636fd6e86SDarrick J. Wong	  If you say Y here you will be able to check metadata on a
7736fd6e86SDarrick J. Wong	  mounted XFS filesystem.  This feature is intended to reduce
7836fd6e86SDarrick J. Wong	  filesystem downtime by supplementing xfs_repair.  The key
7936fd6e86SDarrick J. Wong	  advantage here is to look for problems proactively so that
8036fd6e86SDarrick J. Wong	  they can be dealt with in a controlled manner.
8136fd6e86SDarrick J. Wong
8236fd6e86SDarrick J. Wong	  This feature is considered EXPERIMENTAL.  Use with caution!
8336fd6e86SDarrick J. Wong
8436fd6e86SDarrick J. Wong	  See the xfs_scrub man page in section 8 for additional information.
8536fd6e86SDarrick J. Wong
8636fd6e86SDarrick J. Wong	  If unsure, say N.
8736fd6e86SDarrick J. Wong
88*84d42ea6SDarrick J. Wongconfig XFS_ONLINE_REPAIR
89*84d42ea6SDarrick J. Wong	bool "XFS online metadata repair support"
90*84d42ea6SDarrick J. Wong	default n
91*84d42ea6SDarrick J. Wong	depends on XFS_FS && XFS_ONLINE_SCRUB
92*84d42ea6SDarrick J. Wong	help
93*84d42ea6SDarrick J. Wong	  If you say Y here you will be able to repair metadata on a
94*84d42ea6SDarrick J. Wong	  mounted XFS filesystem.  This feature is intended to reduce
95*84d42ea6SDarrick J. Wong	  filesystem downtime by fixing minor problems before they cause the
96*84d42ea6SDarrick J. Wong	  filesystem to go down.  However, it requires that the filesystem be
97*84d42ea6SDarrick J. Wong	  formatted with secondary metadata, such as reverse mappings and inode
98*84d42ea6SDarrick J. Wong	  parent pointers.
99*84d42ea6SDarrick J. Wong
100*84d42ea6SDarrick J. Wong	  This feature is considered EXPERIMENTAL.  Use with caution!
101*84d42ea6SDarrick J. Wong
102*84d42ea6SDarrick J. Wong	  See the xfs_scrub man page in section 8 for additional information.
103*84d42ea6SDarrick J. Wong
104*84d42ea6SDarrick J. Wong	  If unsure, say N.
105*84d42ea6SDarrick J. Wong
106742ae1e3SDave Chinnerconfig XFS_WARN
107742ae1e3SDave Chinner	bool "XFS Verbose Warnings"
108742ae1e3SDave Chinner	depends on XFS_FS && !XFS_DEBUG
109742ae1e3SDave Chinner	help
110742ae1e3SDave Chinner	  Say Y here to get an XFS build with many additional warnings.
111742ae1e3SDave Chinner	  It converts ASSERT checks to WARN, so will log any out-of-bounds
112742ae1e3SDave Chinner	  conditions that occur that would otherwise be missed. It is much
113742ae1e3SDave Chinner	  lighter weight than XFS_DEBUG and does not modify algorithms and will
114742ae1e3SDave Chinner	  not cause the kernel to panic on non-fatal errors.
115742ae1e3SDave Chinner
116742ae1e3SDave Chinner	  However, similar to XFS_DEBUG, it is only advisable to use this if you
117742ae1e3SDave Chinner	  are debugging a particular problem.
118742ae1e3SDave Chinner
1197788fae6SChristoph Hellwigconfig XFS_DEBUG
120d9777b8dSKees Cook	bool "XFS Debugging support"
121d9777b8dSKees Cook	depends on XFS_FS
1227788fae6SChristoph Hellwig	help
1237788fae6SChristoph Hellwig	  Say Y here to get an XFS build with many debugging features,
1247788fae6SChristoph Hellwig	  including ASSERT checks, function wrappers around macros,
1257788fae6SChristoph Hellwig	  and extra sanity-checking functions in various code paths.
1267788fae6SChristoph Hellwig
1277788fae6SChristoph Hellwig	  Note that the resulting code will be HUGE and SLOW, and probably
1287788fae6SChristoph Hellwig	  not useful unless you are debugging a particular problem.
1297788fae6SChristoph Hellwig
1307788fae6SChristoph Hellwig	  Say N unless you are an XFS developer, or you play one on TV.
1311040960eSBrian Foster
1321040960eSBrian Fosterconfig XFS_ASSERT_FATAL
1331040960eSBrian Foster	bool "XFS fatal asserts"
1341040960eSBrian Foster	default y
1351040960eSBrian Foster	depends on XFS_FS && XFS_DEBUG
1361040960eSBrian Foster	help
1371040960eSBrian Foster	  Set the default DEBUG mode ASSERT failure behavior.
1381040960eSBrian Foster
1391040960eSBrian Foster	  Say Y here to cause DEBUG mode ASSERT failures to result in fatal
1401040960eSBrian Foster	  errors that BUG() the kernel by default. If you say N, ASSERT failures
1411040960eSBrian Foster	  result in warnings.
1421040960eSBrian Foster
1431040960eSBrian Foster	  This behavior can be modified at runtime via sysfs.
144