xref: /linux/fs/erofs/Kconfig (revision 1c4b5ecb7ea190fa3e9f9d6891e6c90b60e04f24)
1# SPDX-License-Identifier: GPL-2.0-only
2
3config EROFS_FS
4	tristate "EROFS filesystem support"
5	depends on BLOCK
6	select FS_IOMAP
7	select LIBCRC32C
8	help
9	  EROFS (Enhanced Read-Only File System) is a lightweight read-only
10	  file system with modern designs (e.g. no buffer heads, inline
11	  xattrs/data, chunk-based deduplication, multiple devices, etc.) for
12	  scenarios which need high-performance read-only solutions, e.g.
13	  smartphones with Android OS, LiveCDs and high-density hosts with
14	  numerous containers;
15
16	  It also provides fixed-sized output compression support in order to
17	  improve storage density as well as keep relatively higher compression
18	  ratios and implements in-place decompression to reuse the file page
19	  for compressed data temporarily with proper strategies, which is
20	  quite useful to ensure guaranteed end-to-end runtime decompression
21	  performance under extremely memory pressure without extra cost.
22
23	  See the documentation at <file:Documentation/filesystems/erofs.rst>
24	  for more details.
25
26	  If unsure, say N.
27
28config EROFS_FS_DEBUG
29	bool "EROFS debugging feature"
30	depends on EROFS_FS
31	help
32	  Print debugging messages and enable more BUG_ONs which check
33	  filesystem consistency and find potential issues aggressively,
34	  which can be used for Android eng build, for example.
35
36	  For daily use, say N.
37
38config EROFS_FS_XATTR
39	bool "EROFS extended attributes"
40	depends on EROFS_FS
41	default y
42	help
43	  Extended attributes are name:value pairs associated with inodes by
44	  the kernel or by users (see the attr(5) manual page, or visit
45	  <http://acl.bestbits.at/> for details).
46
47	  If unsure, say N.
48
49config EROFS_FS_POSIX_ACL
50	bool "EROFS Access Control Lists"
51	depends on EROFS_FS_XATTR
52	select FS_POSIX_ACL
53	default y
54	help
55	  Posix Access Control Lists (ACLs) support permissions for users and
56	  groups beyond the owner/group/world scheme.
57
58	  To learn more about Access Control Lists, visit the POSIX ACLs for
59	  Linux website <http://acl.bestbits.at/>.
60
61	  If you don't know what Access Control Lists are, say N.
62
63config EROFS_FS_SECURITY
64	bool "EROFS Security Labels"
65	depends on EROFS_FS_XATTR
66	default y
67	help
68	  Security labels provide an access control facility to support Linux
69	  Security Models (LSMs) accepted by AppArmor, SELinux, Smack and TOMOYO
70	  Linux. This option enables an extended attribute handler for file
71	  security labels in the erofs filesystem, so that it requires enabling
72	  the extended attribute support in advance.
73
74	  If you are not using a security module, say N.
75
76config EROFS_FS_ZIP
77	bool "EROFS Data Compression Support"
78	depends on EROFS_FS
79	select LZ4_DECOMPRESS
80	default y
81	help
82	  Enable fixed-sized output compression for EROFS.
83
84	  If you don't want to enable compression feature, say N.
85
86config EROFS_FS_ZIP_LZMA
87	bool "EROFS LZMA compressed data support"
88	depends on EROFS_FS_ZIP
89	select XZ_DEC
90	select XZ_DEC_MICROLZMA
91	help
92	  Saying Y here includes support for reading EROFS file systems
93	  containing LZMA compressed data, specifically called microLZMA. it
94	  gives better compression ratios than the LZ4 algorithm, at the
95	  expense of more CPU overhead.
96
97	  LZMA support is an experimental feature for now and so most file
98	  systems will be readable without selecting this option.
99
100	  If unsure, say N.
101