dump.f2fs(8)

dump.f2fs8

Retrieve directory and file entries from an f2fs-formated image

Usage

dump.f2fs [-i inode number] [-I inode number] [-n NAT range] [-M Block map] [-s SIT range] [-a SSA range] [-b block address] [-d debugging-level] device

Overview

dump.f2fs is used to retrieve f2fs metadata (usually in a disk partition). device is the special file corresponding to the device (e.g. /dev/sdXX).

Currently, it can retrieve 1) a file or folder given its inode number (folders are dumped recursively), 2) NAT entries into a file, 3) SIT entries into a file, 4) SSA entries into a file, 5) reverse information from the given block address.

The exit code returned by dump.f2fs is 0 on success and -1 on failure.

Options

-i inode number

Specify an inode number to dump out.

-r

Dump out from the root inode.

-f

Do not prompt before dumping

-y

Alias for -f

-o path

Dump inodes to the given path -P Preserve mode/owner/group for dumped inode

-L

Preserves symlinks. Otherwise symlinks are dumped as regular files.

-I inode number

Specify an inode number and scan full disk to dump out, include history inode block

-n NAT range

Specify a range presented by nids to dump NAT entries.

-M Block map

Show all the allocated block addresses given inode number.

-s SIT range

Specify a range presented by segment numbers to dump SIT entries.

-a SSA range

Specify a range presented by segment numbers to dump SSA entries.

-b block address

Specify a block address to retrieve its metadata information.

-d debug-level

Specify the level of debugging options. The default number is 0, which shows basic debugging messages.

-N

Answer "No" for all questsions.

Initial checking code was written by Byoung Geun Kim <[email protected]>.

Releases

6 releases since Debian 9 (Stretch); the text changed 4 times.

  1. 9–10
  2. 11
  3. 12
  4. 13
  5. Arch

-L since Arch Linux 2026-11-01; -N since Arch Linux 2026-11-01; -f since Arch Linux 2026-11-01; -r since Arch Linux 2026-11-01; -y since Arch Linux 2026-11-01.

Author

Availability

dump.f2fs is available from git://git.kernel.org/pub/scm/linux/kernel/git/jaegeuk/f2fs-tools.git.

From f2fs-tools 1.17.0-1 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.