Man page or keyword search:   man All Sections 1 - General Commands 2 - System Calls 3 - Subroutines, Functions 4 - Special Files 5 - File Formats 6 - Games and Screensavers 7 - Macros and Conventions 8 - Maintenence Commands 9 - Kernel Interface New Commands Server 4.4BSD AIX Alpinelinux Archlinux Aros BSDOS BSDi Bifrost CentOS Cygwin Darwin Debian DigitalUNIX DragonFly ElementaryOS Fedora FreeBSD Gentoo GhostBSD HP-UX Haiku Hurd IRIX Inferno JazzOS Kali Knoppix LinuxMint MacOSX Mageia Mandriva Manjaro Minix MirBSD NeXTSTEP NetBSD OPENSTEP OSF1 OpenBSD OpenDarwin OpenIndiana OpenMandriva OpenServer OpenSuSE OpenVMS Oracle PC-BSD Peanut Pidora Plan9 QNX Raspbian RedHat Scientific Slackware SmartOS Solaris SuSE SunOS Syllable Tru64 UNIXv7 Ubuntu Ultrix UnixWare Xenix YellowDog aLinux   18016 pages apropos Keyword Search (all sections) Output format html ascii pdf view pdf save postscript

BTRFS-IMAGE(8)			 Btrfs Manual			BTRFS-IMAGE(8)

NAME
       btrfs-image - create/restore an image of the filesystem

SYNOPSIS
       btrfs-image [options] <source> <target>

DESCRIPTION
       btrfs-image is used to create an image of a btrfs filesystem. All data
       will be zeroed, but metadata and the like is preserved.

       Mainly used for debug purpose.

OPTIONS
       -r
	   Restore metadump image. By default, this fixes super’s chunk tree,
	   by using 1 stripe pointing to primary device, so that file system
	   can be restored by running tree log reply if possible. To restore
	   without changing number of stripes in chunk tree check -o option.

       -c <value>
	   Compression level (0 ~ 9).

       -t <value>
	   Number of threads (1 ~ 32) to be used to process the image dump or
	   restore.

       -o
	   Use the old restore method, this does not fixup the chunk tree so
	   the restored file system will not be able to be mounted.

       -s
	   Sanitize the file names when generating the image. One -s means
	   just generate random garbage, which means that the directory
	   indexes won’t match up since the hashes won’t match with the
	   garbage filenames. Using -ss will calculate a collision for the
	   filename so that the hashes match, and if it can’t calculate a
	   collision then it will just generate garbage. The collision
	   calculator is very time and CPU intensive so only use it if you are
	   having problems with your file system tree and need to have it
	   mostly working.

       -w
	   Walk all the trees manually and copy any blocks that are
	   referenced. Use this option if your extent tree is corrupted to
	   make sure that all of the metadata is captured.

EXIT STATUS
       btrfs-image will return 0 if no error happened. If any problems
       happened, 1 will be returned.

AUTHOR
       Written by Shilong Wang and Wenruo Qu.

COPYRIGHT
       Copyright © 2013 FUJITSU LIMITED.

       License GPLv2: GNU GPL version 2 http://gnu.org/licenses/gpl.html.

       This is free software: you are free to change and redistribute it.
       There is NO WARRANTY, to the extent permitted by law.

SEE ALSO
       mkfs.btrfs(8)

Btrfs v3.14.2			  05/30/2014			BTRFS-IMAGE(8)

Vote for polarhome