File 0192-btrfs-progs-add-man-page-for-btrfs-convert.patch of Package btrfsprogs.openSUSE_12.1_Update
From 2c19dc5e7bd5fe9a2838ec852128f64a5be54c4c Mon Sep 17 00:00:00 2001 From: David Sterba <dsterba@suse.cz> Date: Mon, 26 Mar 2012 15:39:08 +0200 Subject: [PATCH 09/10] btrfs-progs: add man page for btrfs-convert Signed-off-by: David Sterba <dsterba@suse.cz> --- man/Makefile | 5 +++- man/btrfs-convert.8.in | 60 ++++++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 64 insertions(+), 1 deletions(-) create mode 100644 man/btrfs-convert.8.in diff --git a/man/Makefile b/man/Makefile index 4a90b75..f28eec7 100644 --- a/man/Makefile +++ b/man/Makefile @@ -7,7 +7,7 @@ mandir = $(prefix)/man man8dir = $(mandir)/man8 MANPAGES = mkfs.btrfs.8.gz btrfsctl.8.gz btrfsck.8.gz btrfs-image.8.gz \ - btrfs-show.8.gz btrfs.8.gz + btrfs-show.8.gz btrfs.8.gz btrfs-convert.8.gz all: $(MANPAGES) @@ -29,6 +29,9 @@ btrfs-image.8.gz: btrfs-image.8.in btrfs-show.8.gz: btrfs-show.8.in $(GZIP) -n -c btrfs-show.8.in > btrfs-show.8.gz +btrfs-convert.8.gz: btrfs-convert.8.in + $(GZIP) -n -c btrfs-convert.8.in > btrfs-convert.8.gz + clean : rm -f $(MANPAGES) diff --git a/man/btrfs-convert.8.in b/man/btrfs-convert.8.in new file mode 100644 index 0000000..4057419 --- /dev/null +++ b/man/btrfs-convert.8.in @@ -0,0 +1,60 @@ +.TH BTRFS-CONVERT 8 +.SH NAME +btrfs-convert \- convert ext2/ext3/ext4 filesystem image to btrfs in-place +.SH SYNOPSIS +.B btrfs-convert \fB[\-dinL]\fP \fB[\-r]\fP \fB[\-l\fP \fILABEL\fP\fB]\fP \fIdevice\fP +.SH DESCRIPTION +.B btrfs-convert +is used to convert a ext2/ext3/ext4 filesystem image to a btrfs one. This is +performed on an unmounted image. The conversion is done in-place and it's +possible to do a rollback to original fs. The original filesystem image is +accessible as a subvolume named \fIext2\_subvol\fP. + +The success of the operation depends on amount of free space in the original +filesystem, as btrfs uses this space to store it's own metadata and just adds +pointers to the data blocks. + +Duration of the operation depends on fragmentation and allocated space on the +orignal filesystem, it may take seveal hours for a terabyte-sized filesystem. + +If the operation does not finish succesfully, the image is recognized as the +original fileystem. + +.SH OPTIONS +.TP +\fB\-d\fP +Disable data checksumming. This may speed up the convert operation. +.TP +\fB\-i\fP +Do not convert ACLs. +.TP +\fB\-n\fP +Disable packing of small files. +.TP +\fB\-l\fR \fILABEL\fP +Set the label of btrfs filesystem to \fILABEL\fP. +.TP +\fB\-L\fP +Copy label from the original filesystem to btrfs. +.TP +\fB\-r\fP +Try rollback to the original filesystem. Beware that this may not always +succeed if the btrfs filesystem has been changed in a way that prevents this. + +.SH CAVEATS +The resulting filesystem will inherit the fragmentation and it's possible to +run whole filesystem defragmentation and then balance. + +The raid profile of both data and metada will be \fIsingle\fP, this is not the +same as default mkfs will create. Use balance with convert filter to change +raid profile you want. + +Security labels or quotas are not transferred to the new filesystem. + +Block sizes must be at least of btrfs supported size (currently 4KB on x86_64). + +.SH AVAILABILITY +.B btrfs-convert +is part of btrfs-progs. +.SH SEE ALSO +.BR mkfs.btrfs (8) -- 1.7.6.233.gd79bc
