diff options
author | David Sterba <dsterba@suse.com> | 2024-02-20 10:51:44 +0100 |
---|---|---|
committer | David Sterba <dsterba@suse.com> | 2024-02-20 10:52:08 +0100 |
commit | f5db48e053307af1f27d3fe4cc29a3c38d3fdd14 (patch) | |
tree | 9793ae5cc827afcccf03a7a5c7cde02d83a2588e | |
parent | 93cdc1c2fc8df31a7943d2199282893eece4df53 (diff) | |
download | btrfs-progs-f5db48e053307af1f27d3fe4cc29a3c38d3fdd14.tar.gz |
btrfs-progs: docs: clarify potential problems with convert
Add a note summarizing the problems.
[ci skip]
Issue: #257
Signed-off-by: David Sterba <dsterba@suse.com>
-rw-r--r-- | Documentation/ch-convert-intro.rst | 7 |
1 files changed, 7 insertions, 0 deletions
diff --git a/Documentation/ch-convert-intro.rst b/Documentation/ch-convert-intro.rst index 58521692..e9a7054e 100644 --- a/Documentation/ch-convert-intro.rst +++ b/Documentation/ch-convert-intro.rst @@ -33,6 +33,13 @@ have a supported data block size (i.e. the same that would be valid for :command:`mkfs.btrfs`). This is typically the system page size (4KiB on x86_64 machines). +.. note:: + + Always consider if a mkfs and file copy would not be a better option than + the in-place conversion given what was said above. The conversion depends on + 3rd party libraries and the other filesystems could still evolve and add new + features. Not all combinations are covered or tested. + **BEFORE YOU START** The source filesystem must be clean, e.g. no journal to replay or no repairs |