DUMP.EROFS(1)

✨ DUMP.EROFS ✨

okay bestie, gather round, because dump.erofs is one of those little tools that's lowkey iconic once you know what it does. it's a General Commands Manual girlie, and it lives in the erofs-utils family 💖

🌸 NAME 🌸

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

like. it dumps. it tells you things. it's giving detective energy 🔍✨

---

🎀 SYNOPSIS 🎀

dump.erofs [OPTIONS] IMAGE

that's it, that's the whole vibe. one IMAGE, and whatever OPTIONS your heart desires 🫶

---

💅 DESCRIPTION 💅

so here's the tea: 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.

five things!! it's a whole menu, not a single dish, and honestly? we stan a multitasker 👑

---

🌈 OPTIONS 🌈

• --device=path — specify an extra device to be used together. and yes bestie, you may give multiple --device options, as long as you put them in the correct order. order matters, no cap 🙈
• --ls — list directory contents. NID or path required, so don't come in here empty-handed 💀
• --cat — write file content to standard output. NID or path required. yes it's the cat you're thinking of, it's literally that 🐱
• --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. short and sweet, we love a clean exit ✨
• -h, --help — display help string and exit.
• -s — show superblock information. this is the default if no options are specified, so if you just run it bare, this is the one that shows up. main character energy, honestly 👑
• -S — show image statistics, including file type/size distribution, number of (un)compressed files, compression ratio, etc. the full glow-up report 📊

---

💜 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>

shoutout to the devs, fr fr 🫶

---

🦋 AVAILABILITY 🦋

dump.erofs is part of the erofs-utils package and is available from

git://git.kernel.org/pub/scm/linux/kernel/git/xiang/erofs-utils.git.

go get it, bestie 🧚

---

⭐ SEE ALSO ⭐

• mkfs.erofs(1)
• fsck.erofs(1)

the whole friend group. make the filesystem, check the filesystem, dump the filesystem — it's giving found family 🌸

---

and that's a wrap!! this page comes to you from the General Commands Manual section, and it's still rocking that same DUMP.EROFS(1) energy at the bottom of the page as it does at the top. periodt 💅💖✨