summaryrefslogtreecommitdiff
path: root/Documentation/btrfs-convert.txt
diff options
context:
space:
mode:
authorQu Wenruo <quwenruo@cn.fujitsu.com>2015-04-03 15:23:13 +0800
committerDavid Sterba <dsterba@suse.cz>2015-04-07 17:44:05 +0200
commit96563f961c6a7fede89dc85cdeaec2158bbc66e8 (patch)
treed90507df306107f4b7e7d1e39b00cffcc7c74845 /Documentation/btrfs-convert.txt
parent45678c3048a1d74b99303763cea0729fe5df798b (diff)
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>
Diffstat (limited to 'Documentation/btrfs-convert.txt')
-rw-r--r--Documentation/btrfs-convert.txt9
1 files changed, 9 insertions, 0 deletions
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::