ntfscp - copy file to an NTFS volume.
ntfscp [options] device source_file destination
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).
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 com-
mand, 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.
Treat destination as inode number.
-N, --attr-name NAME
Write to attribute with this name.
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.
This will override some sensible defaults, such as not working with a mounted vol-
ume. Use this option with caution.
Show a list of options with a brief description of each one.
Suppress some debug/warning/error messages.
Show the version number, copyright and license ntfscp.
Display more debug/warning/error messages.
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.
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
There are no known problems with ntfscp. If you find a bug please send an email describing
the problem to the development team:
ntfscp was written by Yura Pakhuchiy, with contributions from Anton Altaparmakov and Hil
Liao. It was ported to ntfs-3g by Erik Larsson.
With love to Marina Sapego.
ntfscp is part of the ntfs-3g package and is available from:
ntfs-3g 2011.4.12AR.4 September 2007 NTFSCP(8)