NTFSCP(8)               (September 2007)                NTFSCP(8)

     NAME
          ntfscp - copy file to an NTFS volume.

     SYNOPSIS
          ntfscp [options] device source_file destination

     DESCRIPTION
          ntfscp will copy file to an NTFS volume. destination can be
          either file or directory. In case if destination is
          directory specified by name then source_file is copied into
          this directory, in case if destination is directory and
          specified by inode number then unnamed data attribute is
          created for this inode and source_file is copied into it
          (WARNING: it's unusual to have unnamed data streams in the
          directories, think twice before specifying directory by
          inode number).

     OPTIONS
          Below is a summary of all the options that ntfscp accepts.
          Nearly all options have two equivalent names.  The short
          name is preceded by - and the long name is preceded by --.
          Any single letter options, that don't take an argument, can
          be combined into a single command, e.g.  -fv is equivalent
          to -f -v.  Long named options can be abbreviated to any
          unique prefix of their name.

          -a, --attribute NUM
               Write to this attribute.

          -i, --inode
               Treat destination as inode number.

          -m, --min-fragments
               Minimize fragmentation when allocating space to the
               attribute. This is mostly useful when creating big
               files.

          -N, --attr-name NAME
               Write to attribute with this name.

          -n, --no-action
               Use this option to make a test run before doing the
               real copy operation.  Volume will be opened read-only
               and no write will be done.

          -f, --force
               This will override some sensible defaults, such as not
               working with a mounted volume.  Use this option with
               caution.

     Page 1                  ntfs-3g 2021.8.22       (printed 5/25/22)

     NTFSCP(8)               (September 2007)                NTFSCP(8)

          -h, --help
               Show a list of options with a brief description of each
               one.

          -q, --quiet
               Suppress some debug/warning/error messages.

          -t, --timestamp
               Copy the modification time of source_file to destina-
               tion. This is not compatible with --attr-name and
               --attribute.

          -V, --version
               Show the version number, copyright and license ntfscp.

          -v, --verbose
               Display more debug/warning/error messages.

     DATA STREAMS
          All data on NTFS is stored in streams, which can have names.
          A file can have more than one data streams, but exactly one
          must have no name. The size of a file is the size of its
          unnamed data stream. Usually when you don't specify stream
          name you are access to unnamed data stream. If you want
          access to named data stream you need to add ":stream_name"
          to the filename. For example: by opening "some.mp3:artist"
          you will open stream "artist" in "some.mp3". But windows
          usually prevent you from accessing to named data streams, so
          you need to use some program like FAR or utils from cygwin
          to access named data streams.

     EXAMPLES
          Copy new_boot.ini from /home/user as boot.ini to the root of
          an /dev/hda1 NTFS volume:

               ntfscp /dev/hda1 /home/user/new_boot.ini boot.ini

          Copy myfile to C:\some\path\myfile:stream (assume that
          /dev/hda1 letter in windows is C):

               ntfscp -N stream /dev/hda1 myfile /some/path

     BUGS
          There are no known problems with ntfscp. If you find a bug
          please send an email describing the problem to the develop-
          ment team:
          ntfs-3g-devel@lists.sf.net

     AUTHORS
          ntfscp was written by Yura Pakhuchiy, with contributions
          from Anton Altaparmakov and Hil Liao.  It was ported to

     Page 2                  ntfs-3g 2021.8.22       (printed 5/25/22)

     NTFSCP(8)               (September 2007)                NTFSCP(8)

          ntfs-3g by Erik Larsson.

     DEDICATION
          With love to Marina Sapego.

     AVAILABILITY
          ntfscp is part of the ntfs-3g package and is available from:
          http://www.tuxera.com/community/

     SEE ALSO
          ntfsprogs(8)

     Page 3                  ntfs-3g 2021.8.22       (printed 5/25/22)