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

Gao Xiang hsiangkao at linux.alibaba.com
Fri Jan 24 13:47:11 AEDT 2025


Add `-E fragdedupe` and revise some descriptions.

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

diff --git a/man/mkfs.erofs.1 b/man/mkfs.erofs.1
index 0093839..698ed5b 100644
--- a/man/mkfs.erofs.1
+++ b/man/mkfs.erofs.1
@@ -45,9 +45,10 @@ warning messages.
 Limit how many xattrs will be inlined. The default is 2.
 Disables storing xattrs if < 0.
 .TP
-.BI "\-E " extended-option \fR[\fP, ... \fR]\fP
+.BI "\-E " [^]extended-option \fR[\fP, ... \fR]\fP
 Set extended options for the filesystem. Extended options are comma separated,
-and may take an extra argument using the equals ('=') sign.
+and may take an extra argument using the equals ('=') sign.  To disable a
+feature, usually prefix the extended option name with a caret ('^') character.
 The following extended options are supported:
 .RS 1.2i
 .TP
@@ -74,20 +75,36 @@ Force generation of inode chunk format as a 4-byte block address array.
 .BI force-chunk-indexes
 Forcely generate inode chunk format as an 8-byte chunk index (with device ID).
 .TP
+.BI [^]fragdedupe\fR[\fP= <inode|full> \fR]\fP
+Set the mode for fragment data deduplication.  It's effective only when
+\fI-E(all)-fragments\fR is used together.  If a caret ('^') character is set,
+fragment data deduplication is disabled.
+.RS 1.2i
+.TP
+.I inode
+Deduplicate fragment data only when the inode data is identical.  This option
+will result in faster image generation with the current codebase
+.TP
+.I full
+Always deduplicate fragment data if possible
+.RE
+.TP
 .BI fragments\fR[\fP= size \fR]\fP
 Pack the tail part (pcluster) of compressed files, or entire files, into a
 special inode for smaller image sizes, and it may take an argument as the
 pcluster size of the packed inode in bytes. (Linux v6.1+)
 .TP
+.BI ^inline_data
+Don't inline regular files.  It's typically useful to enable FSDAX (Linux 5.15+)
+for those images, however, there could be other use cases too.
+.TP
 .BI legacy-compress
 Disable "inplace decompression" and "compacted indexes",
 for compatibility with Linux pre-v5.4.
 .TP
-.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+).
+.B xattr-name-filter
+Enable a name filter for extended attributes to optimize negative lookups.
+(Linux v6.6+).
 .TP
 .BI ztailpacking
 Pack the tail part (pcluster) of compressed files into its metadata to save
@@ -97,7 +114,7 @@ more space and the tail part I/O. (Linux v5.17+)
 .BI "\-L " volume-label
 Set the volume label for the filesystem to
 .IR volume-label .
-The maximum length of the volume label is 16 bytes.
+The maximum length of the volume label is 15 bytes.
 .TP
 .BI "\-T " #
 Specify a UNIX timestamp for image creation time for reproducible builds.
-- 
2.43.5



More information about the Linux-erofs mailing list