blob: 7a348f85ab6f82c95f8c25ad032fb45c966768d0 [file] [log] [blame]
.TH BTRFS-IMAGE 8
.SH NAME
btrfs-image \- create/restore an image of the filesystem
.SH SYNOPSIS
.B btrfs-image
[options] \fIsource\fP \fItarget\fP
.SH DESCRIPTION
.B btrfs-image
is used to create an image of a btrfs filesystem. All data will be zeroed,
but metadata and the like is preserved.
.I source
is the special file corresponding to the device containing a btrfs filesystem.
(e.g \fI/dev/sdXX\fP).
.I target
is the image file that btrfs-image creates. When used with \fB-r\fP option,
\fBbtrfs-image\fP restores the image file from source into target.
.SH OPTIONS
.TP
\fB\-r\fP
restore metadump image.
.TP
\fB\-c\fR \fIvalue\fP
compression level (0 ~ 9).
.TP
\fB\-t\fR \fIvalue\fP
number of threads (1 ~ 32) to be used to process the image dump or restore.
.SH AVAILABILITY
.B btrfs-image
is part of btrfs-progs. Btrfs is currently under heavy development,
and not suitable for any uses other than benchmarking and review.
Please refer to the btrfs wiki
http://btrfs.wiki.kernel.org for further details.
.SH SEE ALSO
.BR btrfsck (8), btrfsctl (8), mkfs.btrfs (8)