erofs-utils: manpages: update new options of mkfs.erofs
authorGao Xiang <hsiangkao@linux.alibaba.com>
Wed, 20 Sep 2023 16:41:28 +0000 (00:41 +0800)
committerGao Xiang <hsiangkao@linux.alibaba.com>
Wed, 20 Sep 2023 16:47:23 +0000 (00:47 +0800)
 -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
man/mkfs.erofs.1

index 1cfde28c171f2a3778d5669fbf90a1f38b022e95..00ac2ac9c03bfd4041d8f54906297f25ab9119e2 100644 (file)
@@ -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