1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
|
btrfs-convert(8)
================
SYNOPSIS
--------
**btrfs-convert** [options] <device>
DESCRIPTION
-----------
.. include:: ch-convert-intro.rst
OPTIONS
-------
--csum <type>, --checksum <type>
Specify the checksum algorithm. Default is *crc32c*. Valid values are *crc32c*,
*xxhash*, *sha256* or *blake2*. To mount such filesystem kernel must support the
checksums as well.
-d|--no-datasum
disable data checksum calculations and set the NODATASUM file flag, this can speed
up the conversion
-i|--no-xattr
ignore xattrs and ACLs of files
-n|--no-inline
disable inlining of small files to metadata blocks, this will decrease the metadata
consumption and may help to convert a filesystem with low free space
-N|--nodesize <SIZE>
set filesystem nodesize, the tree block size in which btrfs stores its metadata.
The default value is 16KiB (16384) or the page size, whichever is bigger.
Must be a multiple of the sectorsize, but not larger than 65536. See
:doc:`mkfs.btrfs` for more details.
-r|--rollback
rollback to the original ext2/3/4 filesystem if possible
-l|--label <LABEL>
set filesystem label during conversion
-L|--copy-label
use label from the converted filesystem
-O|--features <feature1>[,<feature2>...]
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 *^*.
Description of the features is in section
:ref:`FILESYSTEM FEATURES<man-mkfs-filesystem-features>` of
:doc:`mkfs.btrfs`.
To see all available features that btrfs-convert supports run:
.. code-block:: bash
btrfs-convert -O list-all
-p|--progress
show progress of conversion (a heartbeat indicator and number of inodes
processed), on by default
--no-progress
disable progress and show only the main phases of conversion
--uuid <SPEC>
set the FSID of the new filesystem based on 'SPEC':
* *new* - (default) generate UUID for the FSID of btrfs
* *copy* - copy UUID from the source filesystem
* *UUID* - a conforming UUID value, the 36 byte string representation
--version
Print the :command:`btrfs-convert` version, builtin features and exit.
EXIT STATUS
-----------
**btrfs-convert** will return 0 if no error happened.
If any problems happened, 1 will be returned.
SEE ALSO
--------
:doc:`mkfs.btrfs`
|
