dump.erofs(1)

dump.erofs1

Retrieve directory and file entries, show specific file or overall disk statistics information from an erofs-formatted image.

Usage

dump.erofs [OPTIONS] IMAGE

Overview

dump.erofs is used to retrieve erofs metadata and data from IMAGE and demonstrate
1) overall disk statistics,
2) superblock information,
3) file information of the given inode NID,
4) file extent information of the given inode NID,
5) file content for the given inode NID.

Options

--device=path

Specify an extra device to be used together. You may give multiple --device options in the correct order.

--ls

List directory contents. NID or path required.

--cat

Write file content to standard output. NID or path required.

--nid=NID

Specify an inode NID in order to print its file information.

--path=path

Specify an inode path in order to print its file information.

-e

Show the file extent information. NID or path required.

-V, --version

Print the version number and exit.

-h, --help

Display help string and exit.

-s

Show superblock information. This is the default if no options are specified.

-S

Show image statistics, including file type/size distribution, number of (un)compressed files, compression ratio, etc.

Releases

3 releases since Debian 12 (Bookworm); the text changed 1 time.

  1. 12
  2. 13–Arch

--cat since Debian 13 (Trixie); --help since Debian 13 (Trixie); --version since Debian 13 (Trixie); -h since Debian 13 (Trixie).

Author

Initial code was written by Wang Qi <[email protected]>, Guo Xuenan <[email protected]>.

This manual page was written by Guo Xuenan <[email protected]>

Availability

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

From erofs-utils 1.9.4-1 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.