---
name: "dump.erofs"
section: "1"
platform: "linux"
package: "erofs-utils"
version: "1.9.4-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/dump.erofs"
---

# dump.erofs(1)

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

## NAME

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

## SYNOPSIS

**dump.erofs** \[*OPTIONS*\] *IMAGE*

## DESCRIPTION

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

## AUTHOR

Initial code was written by Wang Qi \<mpiglet@outlook.com\>, Guo Xuenan \<guoxuenan@huawei.com\>.

This manual page was written by Guo Xuenan \<guoxuenan@huawei.com\>

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

## SEE ALSO

**[mkfs.erofs(1)](/mkfs.erofs/1.md),** **[fsck.erofs(1)](/fsck.erofs/1.md)**