MKFS.EROFS

Section: User Commands (1)
Page Index
 

NAME

mkfs.erofs - tool to create an EROFS filesystem  

SYNOPSIS

mkfs.erofs [OPTIONS] DESTINATION SOURCE  

DESCRIPTION

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 DESTINATION image file from SOURCE directory.  

OPTIONS

-z compression-algorithm [,#]
Set an algorithm for file compression, which can be set with an optional compression level separated by a comma.
-d #
Specify the level of debugging messages. The default is 0.
-x #
Specify the upper limit of an xattr which is still inlined. The default is 2. Disable storing xattrs if < 0.
-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:
legacy-compress
Disable "decompression in-place" and "compacted indexes" support, which is used when generating EROFS images for kernel version < 5.3.
force-inode-compact
Forcely generate compact inodes (32-byte inodes) to output.
force-inode-extended
Forcely generate extended inodes (64-byte inodes) to output.
-T #
Set all files to the given UNIX timestamp. Reproducible builds requires setting all to a specific one.
--exclude-path=path
Ignore file that matches the exact literal path. You may give multiple `--exclude-path' options.
--exclude-regex=regex
Ignore files that match the given regular expression. You may give multiple `--exclude-regex` options.
--help
Display this help and exit.
 

AUTHOR

This version of mkfs.erofs is written by Li Guifu <blucerlee@gmail.com>, Miao Xie <miaoxie@huawei.com> and Gao Xiang <xiang@kernel.org> with continuously improvements from others.

This manual page was written by Gao Xiang <xiang@kernel.org>.  

AVAILABILITY

mkfs.erofs is part of erofs-utils package and is available from git://git.kernel.org/pub/scm/linux/kernel/git/xiang/erofs-utils.git.  

SEE ALSO

mkfs(8).


 

Index

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
AUTHOR
AVAILABILITY
SEE ALSO