diff options
author | David Sterba <dsterba@suse.cz> | 2015-04-14 17:37:23 +0200 |
---|---|---|
committer | David Sterba <dsterba@suse.cz> | 2015-04-14 17:41:27 +0200 |
commit | 7ffccaf0c3b4d4979d7d74bab3d79d9541a6e665 (patch) | |
tree | 1d64b306503787588d0d79ab467b95f8c6a83c99 /Documentation/btrfs-convert.asciidoc | |
parent | 32ca2fa502c0a00a7dc40adbdae2e7b7765e6d63 (diff) |
btrfs-progs: Documentaion: rename to .asciidoc
A few minor benefits:
* editors set highliting according to the extensions
* web access to the git repository (github) renders the .asciidoc
files:
* we can link to them from the wiki
* the files are editable via browser and such editations can be
submitted for merge easily
Signed-off-by: David Sterba <dsterba@suse.cz>
Diffstat (limited to 'Documentation/btrfs-convert.asciidoc')
-rw-r--r-- | Documentation/btrfs-convert.asciidoc | 59 |
1 files changed, 59 insertions, 0 deletions
diff --git a/Documentation/btrfs-convert.asciidoc b/Documentation/btrfs-convert.asciidoc new file mode 100644 index 00000000..09510fa6 --- /dev/null +++ b/Documentation/btrfs-convert.asciidoc @@ -0,0 +1,59 @@ +btrfs-convert(8) +================ + +NAME +---- +btrfs-convert - convert from ext2/3/4 filesystem to btrfs or rollback + +SYNOPSIS +-------- +*btrfs-convert* [options] <device> + +DESCRIPTION +----------- +*btrfs-convert* is used to convert existed ext2/3/4 to btrfs filesystem, +and the original filesystem image is accessible as from separate subvolume +named 'ext2_saved' as file image. + +WARNING: If one hopes to rollback to ext2/3/4, they should not execute +*btrfs balance* command on converted btrfs, since it will change the extent +layout and make *btrfs-convert* unable to rollback. + +NOTE: If one is satisfied with converted btrfs, and not longer wants to +rollback to ext2/3/4, it is highly recommended to remove 'ext2_saved' subvolume +and execute *btrfs filesystem defragment* and *btrfs balance* command on the +converted btrfs. + +OPTIONS +------- +-d|--no-datasum:: +Disable data checksum calculations and set NODATASUM file flag. This can speed +up the conversion. +-i|--no-xattr:: +Ignore xattrs and ACLs. +-n|--no-inline:: +Disable inlining of small files to metadata blocks. +-N|--nodesize <SIZE>:: +Set filesystem nodesize, the tree block size in which btrfs stores data. +The default value is 16KB (16384) or the page size, whichever is bigger. +Must be a multiple of the sectorsize, but not larger than 65536. +-r|--rollback:: +Roll back to ext2fs. +-l|--label <LABEL>:: +set filesystem label during conversion. +-L|--copy-label:: +use label from the converted filesystem. +-p|--progress:: +Show progress of conversion, on by default. +--no-progress:: +Disable detailed progress and show only the main phases of conversion. + +EXIT STATUS +----------- +*btrfs-convert* will return 0 if no error happened. +If any problems happened, 1 will be returned. + +SEE ALSO +-------- +`mkfs.btrfs`(8) + |