xref: /openbmc/linux/fs/erofs/Kconfig (revision dfeab2e9)
147e4937aSGao Xiang# SPDX-License-Identifier: GPL-2.0-only
247e4937aSGao Xiang
347e4937aSGao Xiangconfig EROFS_FS
447e4937aSGao Xiang	tristate "EROFS filesystem support"
547e4937aSGao Xiang	depends on BLOCK
6a08e67a0SHuang Jianan	select FS_IOMAP
7b858a484SPratik Shinde	select LIBCRC32C
847e4937aSGao Xiang	help
9*dfeab2e9SGao Xiang	  EROFS (Enhanced Read-Only File System) is a lightweight read-only
10*dfeab2e9SGao Xiang	  file system with modern designs (e.g. no buffer heads, inline
11*dfeab2e9SGao Xiang	  xattrs/data, chunk-based deduplication, multiple devices, etc.) for
12*dfeab2e9SGao Xiang	  scenarios which need high-performance read-only solutions, e.g.
13*dfeab2e9SGao Xiang	  smartphones with Android OS, LiveCDs and high-density hosts with
14*dfeab2e9SGao Xiang	  numerous containers;
1547e4937aSGao Xiang
16*dfeab2e9SGao Xiang	  It also provides fixed-sized output compression support in order to
17*dfeab2e9SGao Xiang	  improve storage density as well as keep relatively higher compression
18*dfeab2e9SGao Xiang	  ratios and implements in-place decompression to reuse the file page
19*dfeab2e9SGao Xiang	  for compressed data temporarily with proper strategies, which is
20*dfeab2e9SGao Xiang	  quite useful to ensure guaranteed end-to-end runtime decompression
21*dfeab2e9SGao Xiang	  performance under extremely memory pressure without extra cost.
22*dfeab2e9SGao Xiang
23*dfeab2e9SGao Xiang	  See the documentation at <file:Documentation/filesystems/erofs.rst>
24*dfeab2e9SGao Xiang	  for more details.
2547e4937aSGao Xiang
2647e4937aSGao Xiang	  If unsure, say N.
2747e4937aSGao Xiang
2847e4937aSGao Xiangconfig EROFS_FS_DEBUG
2947e4937aSGao Xiang	bool "EROFS debugging feature"
3047e4937aSGao Xiang	depends on EROFS_FS
3147e4937aSGao Xiang	help
3247e4937aSGao Xiang	  Print debugging messages and enable more BUG_ONs which check
3347e4937aSGao Xiang	  filesystem consistency and find potential issues aggressively,
3447e4937aSGao Xiang	  which can be used for Android eng build, for example.
3547e4937aSGao Xiang
3647e4937aSGao Xiang	  For daily use, say N.
3747e4937aSGao Xiang
3847e4937aSGao Xiangconfig EROFS_FS_XATTR
3947e4937aSGao Xiang	bool "EROFS extended attributes"
4047e4937aSGao Xiang	depends on EROFS_FS
4147e4937aSGao Xiang	default y
4247e4937aSGao Xiang	help
4347e4937aSGao Xiang	  Extended attributes are name:value pairs associated with inodes by
4447e4937aSGao Xiang	  the kernel or by users (see the attr(5) manual page, or visit
4547e4937aSGao Xiang	  <http://acl.bestbits.at/> for details).
4647e4937aSGao Xiang
4747e4937aSGao Xiang	  If unsure, say N.
4847e4937aSGao Xiang
4947e4937aSGao Xiangconfig EROFS_FS_POSIX_ACL
5047e4937aSGao Xiang	bool "EROFS Access Control Lists"
5147e4937aSGao Xiang	depends on EROFS_FS_XATTR
5247e4937aSGao Xiang	select FS_POSIX_ACL
5347e4937aSGao Xiang	default y
5447e4937aSGao Xiang	help
5547e4937aSGao Xiang	  Posix Access Control Lists (ACLs) support permissions for users and
5647e4937aSGao Xiang	  groups beyond the owner/group/world scheme.
5747e4937aSGao Xiang
5847e4937aSGao Xiang	  To learn more about Access Control Lists, visit the POSIX ACLs for
5947e4937aSGao Xiang	  Linux website <http://acl.bestbits.at/>.
6047e4937aSGao Xiang
6147e4937aSGao Xiang	  If you don't know what Access Control Lists are, say N.
6247e4937aSGao Xiang
6347e4937aSGao Xiangconfig EROFS_FS_SECURITY
6447e4937aSGao Xiang	bool "EROFS Security Labels"
6547e4937aSGao Xiang	depends on EROFS_FS_XATTR
6647e4937aSGao Xiang	default y
6747e4937aSGao Xiang	help
6847e4937aSGao Xiang	  Security labels provide an access control facility to support Linux
6947e4937aSGao Xiang	  Security Models (LSMs) accepted by AppArmor, SELinux, Smack and TOMOYO
7047e4937aSGao Xiang	  Linux. This option enables an extended attribute handler for file
7147e4937aSGao Xiang	  security labels in the erofs filesystem, so that it requires enabling
7247e4937aSGao Xiang	  the extended attribute support in advance.
7347e4937aSGao Xiang
7447e4937aSGao Xiang	  If you are not using a security module, say N.
7547e4937aSGao Xiang
7647e4937aSGao Xiangconfig EROFS_FS_ZIP
7747e4937aSGao Xiang	bool "EROFS Data Compression Support"
7847e4937aSGao Xiang	depends on EROFS_FS
7947e4937aSGao Xiang	select LZ4_DECOMPRESS
8047e4937aSGao Xiang	default y
8147e4937aSGao Xiang	help
8247e4937aSGao Xiang	  Enable fixed-sized output compression for EROFS.
8347e4937aSGao Xiang
8447e4937aSGao Xiang	  If you don't want to enable compression feature, say N.
85