c8h4/btrfs-progs
1
0
Fork 0
Code Issues Pull requests Actions Packages Projects Releases Wiki Activity

btrfs-progs: docs: change wording about required fsck

Browse source 
Make running the 'fsck' more explicit and add the commands with
recommended options.

Issue: #348
Signed-off-by: David Sterba <dsterba@suse.com>
This commit is contained in:
David Sterba 2021-03-10 16:32:24 +01:00
parent 5d80df6065
commit cbadf0f1ae
1 changed files with 16 additions and 2 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

18
Documentation/btrfs-convert.asciidoc
View file

@ -43,8 +43,22 @@ have a supported data block size (ie. the same that would be valid for
'mkfs.btrfs'). This is typically the system page size (4KiB on x86_64
machines).
NOTE: The source filesystem should be clean, you are encouraged to run the
'fsck' tool if you're not sure.
**BEFORE YOU START**
The source filesystem must be clean, eg. no journal to replay or no repairs
needed. The respective 'fsck' utility must be run on the source filesytem prior
to conversion. Please refer to the manual pages in case you encounter problems.
For ext2/3/4:
# e2fsck -fvy /dev/sdx
For reiserfs:
# reiserfsck -fy /dev/sdx
Skipping that step could lead to incorrect results on the target filesystem,
but it may work.
**REMOVE THE ORIGINAL FILESYSTEM METADATA**