99af5e5bda9f14304bcb0b5d6b8612d39a1ec756
[linux-2.6-block.git] / fs / xfs / Kconfig
1 config XFS_FS
2         tristate "XFS filesystem support"
3         depends on BLOCK
4         select EXPORTFS
5         select LIBCRC32C
6         select FS_IOMAP
7         help
8           XFS is a high performance journaling filesystem which originated
9           on the SGI IRIX platform.  It is completely multi-threaded, can
10           support large files and large filesystems, extended attributes,
11           variable block sizes, is extent based, and makes extensive use of
12           Btrees (directories, extents, free space) to aid both performance
13           and scalability.
14
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
19           To compile this file system support as a module, choose M here: the
20           module will be called xfs.  Be aware, however, that if the file
21           system of your root partition is compiled as a module, you'll need
22           to use an initial ramdisk (initrd) to boot.
23
24 config XFS_QUOTA
25         bool "XFS Quota support"
26         depends on XFS_FS
27         select QUOTACTL
28         help
29           If you say Y here, you will be able to set limits for disk usage on
30           a per user and/or a per group basis under XFS.  XFS considers quota
31           information as filesystem metadata and uses journaling to provide a
32           higher level guarantee of consistency.  The on-disk data format for
33           quota is also compatible with the IRIX version of XFS, allowing a
34           filesystem to be migrated between Linux and IRIX without any need
35           for conversion.
36
37           If unsure, say N.  More comprehensive documentation can be found in
38           README.quota in the xfsprogs package.  XFS quota can be used either
39           with or without the generic quota support enabled (CONFIG_QUOTA) -
40           they are completely independent subsystems.
41
42 config XFS_POSIX_ACL
43         bool "XFS POSIX ACL support"
44         depends on XFS_FS
45         select FS_POSIX_ACL
46         help
47           POSIX Access Control Lists (ACLs) support permissions for users and
48           groups beyond the owner/group/world scheme.
49
50           If you don't know what Access Control Lists are, say N.
51
52 config XFS_RT
53         bool "XFS Realtime subvolume support"
54         depends on XFS_FS
55         help
56           If you say Y here you will be able to mount and use XFS filesystems
57           which contain a realtime subvolume.  The realtime subvolume is a
58           separate area of disk space where only file data is stored.  It was
59           originally designed to provide deterministic data rates suitable
60           for media streaming applications, but is also useful as a generic
61           mechanism for ensuring data and metadata/log I/Os are completely
62           separated.  Regular file I/Os are isolated to a separate device
63           from all other requests, and this can be done quite transparently
64           to applications via the inherit-realtime directory inode flag.
65
66           See the xfs man page in section 5 for additional information.
67
68           If unsure, say N.
69
70 config XFS_ONLINE_SCRUB
71         bool "XFS online metadata check support"
72         default n
73         depends on XFS_FS
74         help
75           If you say Y here you will be able to check metadata on a
76           mounted XFS filesystem.  This feature is intended to reduce
77           filesystem downtime by supplementing xfs_repair.  The key
78           advantage here is to look for problems proactively so that
79           they can be dealt with in a controlled manner.
80
81           This feature is considered EXPERIMENTAL.  Use with caution!
82
83           See the xfs_scrub man page in section 8 for additional information.
84
85           If unsure, say N.
86
87 config XFS_ONLINE_REPAIR
88         bool "XFS online metadata repair support"
89         default n
90         depends on XFS_FS && XFS_ONLINE_SCRUB
91         help
92           If you say Y here you will be able to repair metadata on a
93           mounted XFS filesystem.  This feature is intended to reduce
94           filesystem downtime by fixing minor problems before they cause the
95           filesystem to go down.  However, it requires that the filesystem be
96           formatted with secondary metadata, such as reverse mappings and inode
97           parent pointers.
98
99           This feature is considered EXPERIMENTAL.  Use with caution!
100
101           See the xfs_scrub man page in section 8 for additional information.
102
103           If unsure, say N.
104
105 config XFS_WARN
106         bool "XFS Verbose Warnings"
107         depends on XFS_FS && !XFS_DEBUG
108         help
109           Say Y here to get an XFS build with many additional warnings.
110           It converts ASSERT checks to WARN, so will log any out-of-bounds
111           conditions that occur that would otherwise be missed. It is much
112           lighter weight than XFS_DEBUG and does not modify algorithms and will
113           not cause the kernel to panic on non-fatal errors.
114
115           However, similar to XFS_DEBUG, it is only advisable to use this if you
116           are debugging a particular problem.
117
118 config XFS_DEBUG
119         bool "XFS Debugging support"
120         depends on XFS_FS
121         help
122           Say Y here to get an XFS build with many debugging features,
123           including ASSERT checks, function wrappers around macros,
124           and extra sanity-checking functions in various code paths.
125
126           Note that the resulting code will be HUGE and SLOW, and probably
127           not useful unless you are debugging a particular problem.
128
129           Say N unless you are an XFS developer, or you play one on TV.
130
131 config XFS_ASSERT_FATAL
132         bool "XFS fatal asserts"
133         default y
134         depends on XFS_FS && XFS_DEBUG
135         help
136           Set the default DEBUG mode ASSERT failure behavior.
137
138           Say Y here to cause DEBUG mode ASSERT failures to result in fatal
139           errors that BUG() the kernel by default. If you say N, ASSERT failures
140           result in warnings.
141
142           This behavior can be modified at runtime via sysfs.