Provided by: ntfs2btrfs_20240115-1_amd64 bug

NAME

       ntfs2btrfs - convert ntfs filesystem to btrfs filesystem

SYNOPSIS

       ntfs2btrfs [options] device

DESCRIPTION

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

OPTIONS

       -c <ALGO>, --compress=<ALGO>
           Uses the specified algorithm to recompress files that  are  compressed  on  the  NTFS  volume;  valid
           choices  are  zstd,  lzo, zlib, or none.  If you don't specify any value, zstd will be used, assuming
           it's been compiled in. Note that this will be ignored if you also select --no-datasum (see below).

       -h <ALGO>, --hash=<ALGO>
           Uses the specified checksumming algorithm; valid choices are crc32c, xxhash, sha256, and blake2.  The
           first of these will be used by default, and should be fine for most purposes.

       -r, --rollback
           Tries to restore the original NTFS filesystem. See ROLLBACK below.

       -d, --no-datasum
           Skips  calculating  checksums  for  existing data. Don't choose this unless you're sure it's what you
           want.

ROLLBACK

       The original filesystem image is saved as image/ntfs.img as a reflink copy. You can restore this  at  any
       time  by  using  the rollback option, provided that you've not moved the data by doing a balance. Bear in
       mind that this restores the volume to how it was when you did the conversion, meaning  that  any  changes
       you've made since will be lost.

       If you decide to keep the conversion, you can remove the image subvolume at any point to free up space.

XATTRS

       Various  bits of NTFS-specific data are stored as Btrfs xattrs, in a manner that the Windows btrfs driver
       understands (https://github.com/maharmstone/btrfs). Some should also be understood by tools such as  Wine
       and Samba, but YMMV.

       • The NTFS attribute value is stored as a hex string at user.DOSATTRIB.

       • The  reparse  points  on directories are stored at user.reparse. NTFS symlinks should be converted into
         POSIX symlinks. The data for other reparse points will be stored as the contents of the files.

       • The NT security descriptor is stored as security.NTACL.

       • Alternate data streams on files are  stored  in  the  user  namespace,  e.g.  :Zone.Identifier  becomes
         user.Zone.Identifier.

SEE ALSO

       btrfs(8), mkfs.btrfs(8).

AUTHOR

       Written by Mark Harmstone (mark@harmstone.com).

WEB

       https://github.com/maharmstone/ntfs2btrfs