mirror of
https://github.com/kdave/btrfs-progs
synced 2025-05-08 02:48:03 +00:00
d6f7e3da0d
Previously btrfs-image would set a METADUMP flag and would make one big system chunk to cover the entire file system in the super in order to get around the unpleasant business of having to adjust the chunk tree. This meant that you could use the progs stuff on a restored file system, which is great for testing btrfsck and other such things. But we want to be able to run the tree log replay on a file system that is not able to run the tree log replay. So in order to do this we need to fixup the super's chunk array and the chunk tree itself. This is pretty easy since we restore using the logical offsets of the metadata, so we just have to set the chunk items to have 1 stripe and have the stripes point at the primary device and then use the logical offset of the chunk as the physical offset. With this patch I can restore a file system image that had a tree log and mount the file system and have the log be replayed successfully. This patch also gives you the -o option in case you want the old restore way, in the case where we want to make sure the system chunks as they were given to us are correct. Thanks, Signed-off-by: Josef Bacik <jbacik@fusionio.com>
39 lines
1.2 KiB
Groff
39 lines
1.2 KiB
Groff
.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.
|
|
.TP
|
|
\fB\-o\fP
|
|
use the old restore method, this does not fixup the chunk tree so the restored
|
|
file system will not be able to be mounted.
|
|
.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), mkfs.btrfs (8)
|