1NTFS2BTRFS(8)                System Administration               NTFS2BTRFS(8)
2
3
4

NAME

6       ntfs2btrfs - convert ntfs filesystem to btrfs filesystem
7

SYNOPSIS

9       ntfs2btrfs [options] device
10

DESCRIPTION

12       This  is  a  tool  which  does  in-place conversion of Microsoft's NTFS
13       filesystem to the open-source filesystem Btrfs, much  as  btrfs-convert
14       does for ext2.
15

OPTIONS

17       -c <ALGO>, --compress=<ALGO>
18           Uses  the  specified  algorithm  to  recompress files that are com‐
19           pressed on the NTFS volume; valid choices are zstd, lzo,  zlib,  or
20           none.   If you don't specify any value, zstd will be used, assuming
21           it's been compiled in. Note that this will be ignored if  you  also
22           select --no-datasum (see below).
23
24       -h <ALGO>, --hash=<ALGO>
25           Uses  the  specified  checksumming  algorithm;  valid  choices  are
26           crc32c, xxhash, sha256, and blake2. The first of these will be used
27           by default, and should be fine for most purposes.
28
29       -r, --rollback
30           Tries to restore the original NTFS filesystem. See ROLLBACK below.
31
32       -d, --no-datasum
33           Skips  calculating  checksums  for existing data. Don't choose this
34           unless you're sure it's what you want.
35

ROLLBACK

37       The original filesystem image is saved as image/ntfs.img as  a  reflink
38       copy.  You  can  restore this at any time by using the rollback option,
39       provided that you've not moved the data by doing  a  balance.  Bear  in
40       mind  that this restores the volume to how it was when you did the con‐
41       version, meaning that any changes you've made since will be lost.
42
43       If you decide to keep the conversion, you can remove the image  subvol‐
44       ume at any point to free up space.
45

XATTRS

47       Various  bits  of  NTFS-specific  data are stored as Btrfs xattrs, in a
48       manner    that     the     Windows     btrfs     driver     understands
49       (https://github.com/maharmstone/btrfs).  Some should also be understood
50       by tools such as Wine and Samba, but YMMV.
51
52       • The NTFS attribute value is stored as a hex string at user.DOSATTRIB.
53
54       • The reparse points on directories are stored  at  user.reparse.  NTFS
55         symlinks  should be converted into POSIX symlinks. The data for other
56         reparse points will be stored as the contents of the files.
57
58       • The NT security descriptor is stored as security.NTACL.
59
60       • Alternate data streams on files are stored  in  the  user  namespace,
61         e.g. :Zone.Identifier becomes user.Zone.Identifier.
62

SEE ALSO

64       btrfs(8), mkfs.btrfs(8).
65

AUTHOR

67       Written by Mark Harmstone (mark@harmstone.com).
68
69

WEB

71       https://github.com/maharmstone/ntfs2btrfs
72
73
74
75ntfs2btrfs 20220812               August 2022                    NTFS2BTRFS(8)
Impressum