btrfs-progs: Doc: Add warning and note on btrfs-convert.

Although btrfs-convert can rollback converted btrfs, it still has some
limitation to ensure rollback.

Add a warning on the limitations.

Also add a note for users who decides to go on with btrfs and don't need
the rollback ability.

Reported-by: Vytautas D <vytdau@gmail.com>
Reported-by: Tsutomu Itoh <t-itoh@jp.fujitsu.com>
Signed-off-by: Qu Wenruo <quwenruo@cn.fujitsu.com>
Signed-off-by: David Sterba <dsterba@suse.cz>
This commit is contained in:
Qu Wenruo 2015-04-03 15:23:13 +08:00 committed by David Sterba
parent 45678c3048
commit 96563f961c
1 changed files with 9 additions and 0 deletions

View File

@ -15,6 +15,15 @@ DESCRIPTION
and the original filesystem image is accessible as from separate subvolume
named 'ext2_saved' as file image.
WARNING: If one hopes to rollback to ext2/3/4, they should not execute
*btrfs balance* command on converted btrfs, since it will change the extent
layout and make *btrfs-convert* unable to rollback.
NOTE: If one is satisfied with converted btrfs, and not longer wants to
rollback to ext2/3/4, it is highly recommended to remove 'ext2_saved' subvolume
and execute *btrfs filesystem defragment* and *btrfs balance* command on the
converted btrfs.
OPTIONS
-------
-d|--no-datasum::