From f5db48e053307af1f27d3fe4cc29a3c38d3fdd14 Mon Sep 17 00:00:00 2001 From: David Sterba Date: Tue, 20 Feb 2024 10:51:44 +0100 Subject: [PATCH] btrfs-progs: docs: clarify potential problems with convert Add a note summarizing the problems. [ci skip] Issue: #257 Signed-off-by: David Sterba --- Documentation/ch-convert-intro.rst | 7 +++++++ 1 file changed, 7 insertions(+) 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