aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorGao Xiang <hsiangkao@linux.alibaba.com>2023-09-21 00:41:28 +0800
committerGao Xiang <hsiangkao@linux.alibaba.com>2023-09-21 00:47:23 +0800
commitcf3b15d8beb5aff3e88625696d1627a74c2adb94 (patch)
tree05195e1eae2b39a1e9b52b2942992b8d860170c0
parent4fe36e57f20649f07fbd9e94dcb5f53a68a3f985 (diff)
downloaderofs-utils-cf3b15d8beb5aff3e88625696d1627a74c2adb94.tar.gz
erofs-utils: manpages: update new options of mkfs.erofs
-b block-size -E ^xattr-name-filter --gzip --tar=[fi] --xattr-prefix=X Signed-off-by: Gao Xiang <hsiangkao@linux.alibaba.com> Link: https://lore.kernel.org/r/20230920164128.1637554-1-hsiangkao@linux.alibaba.com
-rw-r--r--man/mkfs.erofs.123
1 files changed, 23 insertions, 0 deletions
diff --git a/man/mkfs.erofs.1 b/man/mkfs.erofs.1
index 1cfde28..00ac2ac 100644
--- a/man/mkfs.erofs.1
+++ b/man/mkfs.erofs.1
@@ -26,6 +26,11 @@ compression level (1 to 12 for LZ4HC, 0 to 9 for LZMA and 100 to 109 for LZMA
extreme compression) separated by a comma. Alternative algorithms could be
specified and separated by colons.
.TP
+.BI "\-b " block-size
+Set the fundamental block size of the filesystem in bytes. In other words,
+specify the smallest amount of data that can be accessed at a time. The
+default is the system page size. It cannot be less than 512 bytes.
+.TP
.BI "\-C " max-pcluster-size
Specify the maximum size of compress physical cluster in bytes.
This may cause the big pcluster feature to be enabled (Linux v5.13+).
@@ -79,6 +84,9 @@ for compatibility with Linux pre-v5.4.
.BI noinline_data
Don't inline regular files to enable FSDAX for these files (Linux v5.15+).
.TP
+.B ^xattr-name-filter
+Turn off/on xattr name filter to optimize negative xattr lookups (Linux v6.6+).
+.TP
.BI ztailpacking
Pack the tail part (pcluster) of compressed files into its metadata to save
more space and the tail part I/O. (Linux v5.17+)
@@ -152,6 +160,9 @@ When this option is used together with
the final file gids are
set to \fIGID\fR + \fIGID-OFFSET\fR.
.TP
+.B \-\-gzip
+Filter tarball streams through gzip.
+.TP
.B \-\-help
Display help string and exit.
.TP
@@ -169,12 +180,24 @@ Use extended inodes instead of compact inodes if the file modification time
would overflow compact inodes. This is the default. Overrides
.BR --ignore-mtime .
.TP
+.B "\-\-tar=f"
+Generate a full EROFS image from a tarball.
+.TP
+.B "\-\-tar=i"
+Generate an meta-only EROFS image from a tarball.
+.TP
.BI "\-\-uid-offset=" UIDOFFSET
Add \fIUIDOFFSET\fR to all file UIDs.
When this option is used together with
.BR --force-uid ,
the final file uids are
set to \fIUID\fR + \fIUIDOFFSET\fR.
+.TP
+.BI "\-\-xattr-prefix=" PREFIX
+Specify a customized extended attribute namespace prefix for space saving,
+e.g. "trusted.overlay.". You may give multiple
+.B --xattr-prefix
+options (Linux v6.4+).
.SH AUTHOR
This version of \fBmkfs.erofs\fR is written by Li Guifu <blucerlee@gmail.com>,
Miao Xie <miaoxie@huawei.com> and Gao Xiang <xiang@kernel.org> with