[PATCH] erofs-utils: manpages: update new options of mkfs.erofs

Gao Xiang hsiangkao at linux.alibaba.com
Thu Sep 21 02:41:28 AEST 2023


 -b block-size
 -E ^xattr-name-filter
 --gzip
 --tar=[fi]
 --xattr-prefix=X

Signed-off-by: Gao Xiang <hsiangkao at linux.alibaba.com>
---
 man/mkfs.erofs.1 | 23 +++++++++++++++++++++++
 1 file changed, 23 insertions(+)

diff --git a/man/mkfs.erofs.1 b/man/mkfs.erofs.1
index 1cfde28..5dd718d 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 at gmail.com>,
 Miao Xie <miaoxie at huawei.com> and Gao Xiang <xiang at kernel.org> with
-- 
2.39.3



More information about the Linux-erofs mailing list