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.

       --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).

                                                                                                   MKFS.EROFS(1)