1 # SPDX-License-Identifier: GPL-2.0-only 1 # SPDX-License-Identifier: GPL-2.0-only 2 2 3 config EROFS_FS 3 config EROFS_FS 4 tristate "EROFS filesystem support" 4 tristate "EROFS filesystem support" 5 depends on BLOCK 5 depends on BLOCK 6 select FS_IOMAP << 7 select LIBCRC32C << 8 help 6 help 9 EROFS (Enhanced Read-Only File Syste !! 7 EROFS (Enhanced Read-Only File System) is a lightweight 10 file system with modern designs (e.g !! 8 read-only file system with modern designs (eg. page-sized 11 xattrs/data, chunk-based deduplicati !! 9 blocks, inline xattrs/data, etc.) for scenarios which need 12 scenarios which need high-performanc !! 10 high-performance read-only requirements, e.g. Android OS 13 smartphones with Android OS, LiveCDs !! 11 for mobile phones and LIVECDs. 14 numerous containers; !! 12 15 !! 13 It also provides fixed-sized output compression support, 16 It also provides fixed-sized output !! 14 which improves storage density, keeps relatively higher 17 improve storage density as well as k !! 15 compression ratios, which is more useful to achieve high 18 ratios and implements in-place decom !! 16 performance for embedded devices with limited memory. 19 for compressed data temporarily with << 20 quite useful to ensure guaranteed en << 21 performance under extremely memory p << 22 << 23 See the documentation at <file:Docum << 24 and the web pages at <https://erofs. << 25 17 26 If unsure, say N. 18 If unsure, say N. 27 19 28 config EROFS_FS_DEBUG 20 config EROFS_FS_DEBUG 29 bool "EROFS debugging feature" 21 bool "EROFS debugging feature" 30 depends on EROFS_FS 22 depends on EROFS_FS 31 help 23 help 32 Print debugging messages and enable 24 Print debugging messages and enable more BUG_ONs which check 33 filesystem consistency and find pote 25 filesystem consistency and find potential issues aggressively, 34 which can be used for Android eng bu 26 which can be used for Android eng build, for example. 35 27 36 For daily use, say N. 28 For daily use, say N. 37 29 38 config EROFS_FS_XATTR 30 config EROFS_FS_XATTR 39 bool "EROFS extended attributes" 31 bool "EROFS extended attributes" 40 depends on EROFS_FS 32 depends on EROFS_FS 41 select XXHASH << 42 default y 33 default y 43 help 34 help 44 Extended attributes are name:value p 35 Extended attributes are name:value pairs associated with inodes by 45 the kernel or by users (see the attr 36 the kernel or by users (see the attr(5) manual page, or visit 46 <http://acl.bestbits.at/> for detail 37 <http://acl.bestbits.at/> for details). 47 38 48 If unsure, say N. 39 If unsure, say N. 49 40 50 config EROFS_FS_POSIX_ACL 41 config EROFS_FS_POSIX_ACL 51 bool "EROFS Access Control Lists" 42 bool "EROFS Access Control Lists" 52 depends on EROFS_FS_XATTR 43 depends on EROFS_FS_XATTR 53 select FS_POSIX_ACL 44 select FS_POSIX_ACL 54 default y 45 default y 55 help 46 help 56 Posix Access Control Lists (ACLs) su 47 Posix Access Control Lists (ACLs) support permissions for users and 57 groups beyond the owner/group/world 48 groups beyond the owner/group/world scheme. 58 49 59 To learn more about Access Control L 50 To learn more about Access Control Lists, visit the POSIX ACLs for 60 Linux website <http://acl.bestbits.a 51 Linux website <http://acl.bestbits.at/>. 61 52 62 If you don't know what Access Contro 53 If you don't know what Access Control Lists are, say N. 63 54 64 config EROFS_FS_SECURITY 55 config EROFS_FS_SECURITY 65 bool "EROFS Security Labels" 56 bool "EROFS Security Labels" 66 depends on EROFS_FS_XATTR 57 depends on EROFS_FS_XATTR 67 default y 58 default y 68 help 59 help 69 Security labels provide an access co 60 Security labels provide an access control facility to support Linux 70 Security Models (LSMs) accepted by A 61 Security Models (LSMs) accepted by AppArmor, SELinux, Smack and TOMOYO 71 Linux. This option enables an extend 62 Linux. This option enables an extended attribute handler for file 72 security labels in the erofs filesys 63 security labels in the erofs filesystem, so that it requires enabling 73 the extended attribute support in ad 64 the extended attribute support in advance. 74 65 75 If you are not using a security modu 66 If you are not using a security module, say N. 76 67 77 config EROFS_FS_BACKED_BY_FILE << 78 bool "File-backed EROFS filesystem sup << 79 depends on EROFS_FS << 80 default y << 81 help << 82 This allows EROFS to use filesystem << 83 the intercession of loopback block d << 84 particularly useful for container im << 85 other sandboxes, where loop devices << 86 be used to simplify error-prone life << 87 virtual block devices. << 88 << 89 Note that this feature, along with o << 90 hooks, will eventually replace "EROF << 91 << 92 If you don't want to enable this fea << 93 << 94 config EROFS_FS_ZIP 68 config EROFS_FS_ZIP 95 bool "EROFS Data Compression Support" 69 bool "EROFS Data Compression Support" 96 depends on EROFS_FS 70 depends on EROFS_FS 97 select LZ4_DECOMPRESS 71 select LZ4_DECOMPRESS 98 default y 72 default y 99 help 73 help 100 Enable fixed-sized output compressio 74 Enable fixed-sized output compression for EROFS. 101 75 102 If you don't want to enable compress 76 If you don't want to enable compression feature, say N. 103 77 104 config EROFS_FS_ZIP_LZMA !! 78 config EROFS_FS_CLUSTER_PAGE_LIMIT 105 bool "EROFS LZMA compressed data suppo !! 79 int "EROFS Cluster Pages Hard Limit" 106 depends on EROFS_FS_ZIP << 107 select XZ_DEC << 108 select XZ_DEC_MICROLZMA << 109 help << 110 Saying Y here includes support for r << 111 containing LZMA compressed data, spe << 112 gives better compression ratios than << 113 expense of more CPU overhead. << 114 << 115 If unsure, say N. << 116 << 117 config EROFS_FS_ZIP_DEFLATE << 118 bool "EROFS DEFLATE compressed data su << 119 depends on EROFS_FS_ZIP << 120 select ZLIB_INFLATE << 121 help << 122 Saying Y here includes support for r << 123 containing DEFLATE compressed data. << 124 ratios than the default LZ4 format, << 125 overhead. << 126 << 127 DEFLATE support is an experimental f << 128 file systems will be readable withou << 129 << 130 If unsure, say N. << 131 << 132 config EROFS_FS_ZIP_ZSTD << 133 bool "EROFS Zstandard compressed data << 134 depends on EROFS_FS_ZIP 80 depends on EROFS_FS_ZIP 135 select ZSTD_DECOMPRESS !! 81 range 1 256 >> 82 default "1" 136 help 83 help 137 Saying Y here includes support for r !! 84 Indicates maximum # of pages of a compressed 138 containing Zstandard compressed data !! 85 physical cluster. 139 ratios than the default LZ4 format, << 140 overhead. << 141 86 142 Zstandard support is an experimental !! 87 For example, if files in a image were compressed 143 file systems will be readable withou !! 88 into 8k-unit, hard limit should not be configured >> 89 less than 2. Otherwise, the image will be refused >> 90 to mount on this kernel. 144 91 145 If unsure, say N. << 146 << 147 config EROFS_FS_ONDEMAND << 148 bool "EROFS fscache-based on-demand re << 149 depends on EROFS_FS << 150 select NETFS_SUPPORT << 151 select FSCACHE << 152 select CACHEFILES << 153 select CACHEFILES_ONDEMAND << 154 help << 155 This permits EROFS to use fscache-ba << 156 read support. << 157 << 158 It is now deprecated and scheduled t << 159 after fanotify pre-content hooks are << 160 << 161 If unsure, say N. << 162 << 163 config EROFS_FS_PCPU_KTHREAD << 164 bool "EROFS per-cpu decompression kthr << 165 depends on EROFS_FS_ZIP << 166 help << 167 Saying Y here enables per-CPU kthrea << 168 async decompression for low latencie << 169 << 170 If unsure, say N. << 171 << 172 config EROFS_FS_PCPU_KTHREAD_HIPRI << 173 bool "EROFS high priority per-CPU kthr << 174 depends on EROFS_FS_ZIP && EROFS_FS_PC << 175 default y << 176 help << 177 This permits EROFS to configure per- << 178 at higher priority. << 179 << 180 If unsure, say N. <<
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.