Linux-EROFS Archive on
 help / color / Atom feed
From: Gao Xiang via Linux-erofs <>
To: Li Guifu <>,
Cc: Miao Xie <>
Subject: [PATCH v2] erofs-utils: add manual for mkfs.erofs
Date: Mon,  4 Nov 2019 15:28:17 +0800
Message-ID: <> (raw)
In-Reply-To: <>

This patch adds mkfs.erofs manpage, which is a requirement of
a debian binary package (See Debian Policy Manual section 12.1 [1].)

Signed-off-by: Gao Xiang <>
changes since v1:
 - remove redundant whitespace in the previous version;
 - adjust long lines.      |  2 +-     |  1 +
 man/  |  5 ++++
 man/mkfs.erofs.1 | 68 ++++++++++++++++++++++++++++++++++++++++++++++++
 4 files changed, 75 insertions(+), 1 deletion(-)
 create mode 100644 man/
 create mode 100644 man/mkfs.erofs.1

diff --git a/ b/
index d94ab73..1d20577 100644
--- a/
+++ b/
@@ -3,4 +3,4 @@
-SUBDIRS=lib mkfs
+SUBDIRS = man lib mkfs
diff --git a/ b/
index 4f88678..a93767f 100644
--- a/
+++ b/
@@ -173,6 +173,7 @@ AM_CONDITIONAL([ENABLE_LZ4], [test "x${have_lz4}" = "xyes"])
 AM_CONDITIONAL([ENABLE_LZ4HC], [test "x${have_lz4hc}" = "xyes"])
+		 man/Makefile
diff --git a/man/ b/man/
new file mode 100644
index 0000000..dcdbb35
--- /dev/null
+++ b/man/
@@ -0,0 +1,5 @@
+# SPDX-License-Identifier: GPL-2.0+
+dist_man_MANS = mkfs.erofs.1
diff --git a/man/mkfs.erofs.1 b/man/mkfs.erofs.1
new file mode 100644
index 0000000..d6bf828
--- /dev/null
+++ b/man/mkfs.erofs.1
@@ -0,0 +1,68 @@
+.\" Copyright (c) 2019 Gao Xiang <>
+mkfs.erofs \- tool to create an EROFS filesystem
+\fBmkfs.erofs\fR [\fIOPTIONS\fR] \fIDESTINATION\fR \fISOURCE\fR
+EROFS is a new enhanced lightweight linux read-only filesystem with modern
+designs (eg. no buffer head, reduced metadata, inline xattrs/data, etc.) for
+scenarios which need high-performance read-only requirements, e.g. Android OS
+for smartphones and LIVECDs.
+It also provides fixed-sized output compression support, which improves storage
+density, keeps relatively higher compression ratios, which is more useful to
+achieve high performance for embedded devices with limited memory since it has
+unnoticable memory overhead and page cache thrashing.
+mkfs.erofs is used to create such EROFS filesystem \fIDESTINATION\fR image file
+from \fISOURCE\fR directory.
+.BI "\-z " compression-algorithm " [" ",#" "]"
+Set an algorithm for file compression, which can be set with an optional
+compression level separated by a comma.
+.BI "\-d " #
+Specify the level of debugging messages. The default is 0.
+.BI "\-x " #
+Specify the upper limit of an xattr which is still inlined. The default is 2.
+Disable storing xattrs if < 0.
+.BI "\-E " extended-option " [,...]"
+Set extended options for the filesystem. Extended options are comma separated,
+and may take an argument using the equals ('=') sign.
+The following extended options are supported:
+.RS 1.2i
+.BI legacy-compress
+Disable "decompression in-place" and "compacted indexes" support, which is used
+when generating EROFS images for kernel version < 5.3.
+.BI force-inode-compact
+Forcely generate compact inodes (32-byte inodes) to output.
+.BI force-inode-extended
+Forcely generate extended inodes (64-byte inodes) to output.
+.BI "\-T " #
+Set all files to the given UNIX timestamp. Reproducible builds requires setting
+all to a specific one.
+.B \-\-help
+Display this help and exit.
+This version of \fBmkfs.erofs\fR is written by Li Guifu <>,
+Miao Xie <> and Gao Xiang <> with
+continuously improvements from others.
+This manual page was written by Gao Xiang <>.
+\fBmkfs.erofs\fR is part of erofs-utils package and is available from
+.BR mkfs (8).

  reply index

Thread overview: 3+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
     [not found] <>
2019-11-03 15:30 ` [PATCH] " Gao Xiang via Linux-erofs
2019-11-04  7:28   ` Gao Xiang via Linux-erofs [this message]
2019-11-04 16:40     ` [PATCH v2] " Li Guifu

Reply instructions:

You may reply publically to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \ \ \ \ \ \

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link

Linux-EROFS Archive on

Archives are clonable:
	git clone --mirror linux-erofs/git/0.git

	# If you have public-inbox 1.1+ installed, you may
	# initialize and index your mirror using the following commands:
	public-inbox-init -V2 linux-erofs linux-erofs/ \
	public-inbox-index linux-erofs

Example config snippet for mirrors

Newsgroup available over NNTP:

AGPL code for this site: git clone