From 96563f961c6a7fede89dc85cdeaec2158bbc66e8 Mon Sep 17 00:00:00 2001 From: Qu Wenruo Date: Fri, 3 Apr 2015 15:23:13 +0800 Subject: [PATCH] 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 Reported-by: Tsutomu Itoh Signed-off-by: Qu Wenruo Signed-off-by: David Sterba --- Documentation/btrfs-convert.txt | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/Documentation/btrfs-convert.txt b/Documentation/btrfs-convert.txt index 8b3f05b4..09510fa6 100644 --- a/Documentation/btrfs-convert.txt +++ b/Documentation/btrfs-convert.txt @@ -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::