diff options
Diffstat (limited to 'upstream/archlinux/man8/btrfs-convert.8')
| -rw-r--r-- | upstream/archlinux/man8/btrfs-convert.8 | 52 |
1 files changed, 25 insertions, 27 deletions
diff --git a/upstream/archlinux/man8/btrfs-convert.8 b/upstream/archlinux/man8/btrfs-convert.8 index fded5087..09c56b98 100644 --- a/upstream/archlinux/man8/btrfs-convert.8 +++ b/upstream/archlinux/man8/btrfs-convert.8 @@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "BTRFS-CONVERT" "8" "Feb 14, 2024" "6.7.1" "BTRFS" +.TH "BTRFS-CONVERT" "8" "May 03, 2024" "6.8.1" "BTRFS" .SH NAME btrfs-convert \- convert from ext2/3/4 or reiserfs filesystem to btrfs in-place .SH SYNOPSIS @@ -46,7 +46,7 @@ ext2, ext3, ext4 \-\- original feature, always built in .IP \(bu 2 reiserfs \-\- since version 4.13, optionally built, requires libreiserfscore 3.6.27 .IP \(bu 2 -NTFS \-\- external tool \fI\%https://github.com/maharmstone/ntfs2btrfs\fP +NTFS \-\- external tool \X'tty: link https://github.com/maharmstone/ntfs2btrfs'\fI\%https://github.com/maharmstone/ntfs2btrfs\fP\X'tty: link' .UNINDENT .sp The list of supported source filesystem by a given binary is listed at the end @@ -76,6 +76,16 @@ have a supported data block size (i.e. the same that would be valid for \fBmkfs.btrfs\fP). This is typically the system page size (4KiB on x86_64 machines). .sp +\fBNOTE:\fP +.INDENT 0.0 +.INDENT 3.5 +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. +.UNINDENT +.UNINDENT +.sp \fBBEFORE YOU START\fP .sp The source filesystem must be clean, e.g. no journal to replay or no repairs @@ -86,11 +96,9 @@ For ext2/3/4: .INDENT 0.0 .INDENT 3.5 .sp -.nf -.ft C +.EX # e2fsck \-fvy /dev/sdx -.ft P -.fi +.EE .UNINDENT .UNINDENT .sp @@ -98,11 +106,9 @@ For reiserfs: .INDENT 0.0 .INDENT 3.5 .sp -.nf -.ft C +.EX # reiserfsck \-fy /dev/sdx -.ft P -.fi +.EE .UNINDENT .UNINDENT .sp @@ -116,11 +122,9 @@ metadata of the original filesystem will be removed: .INDENT 0.0 .INDENT 3.5 .sp -.nf -.ft C +.EX # btrfs subvolume delete /mnt/ext2_saved -.ft P -.fi +.EE .UNINDENT .UNINDENT .sp @@ -134,11 +138,9 @@ filesystem. This will attempt to make file extents more contiguous. .INDENT 0.0 .INDENT 3.5 .sp -.nf -.ft C +.EX # btrfs filesystem defrag \-v \-r \-f \-t 32M /mnt/btrfs -.ft P -.fi +.EE .UNINDENT .UNINDENT .sp @@ -160,11 +162,9 @@ Note that balance operation takes a lot of time, please see also .INDENT 0.0 .INDENT 3.5 .sp -.nf -.ft C +.EX # btrfs balance start \-m /mnt/btrfs -.ft P -.fi +.EE .UNINDENT .UNINDENT .SH OPTIONS @@ -207,18 +207,16 @@ use label from the converted filesystem A list of filesystem features enabled the at time of conversion. Not all features are supported by old kernels. To disable a feature, prefix it with \fI^\fP\&. Description of the features is in section -\fI\%FILESYSTEM FEATURES\fP of +\X'tty: link #man-mkfs-filesystem-features'\fI\%FILESYSTEM FEATURES\fP\X'tty: link' of \fI\%mkfs.btrfs(8)\fP\&. .sp To see all available features that btrfs\-convert supports run: .INDENT 7.0 .INDENT 3.5 .sp -.nf -.ft C +.EX btrfs\-convert \-O list\-all -.ft P -.fi +.EE .UNINDENT .UNINDENT .TP |