Section: Maintenance Commands (8)
Updated: September 2007Index
Return to Main Contents
ntfscp - copy file to an NTFS volume.
] device source_file destination
will copy file to an NTFS volume. destination
can be either
file or directory. In case if destination
is directory specified by name
is copied into this directory, in case if
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
accepts. Nearly all options have two equivalent names. The short name is
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.
is equivalent to
Long named options can be abbreviated to any unique prefix of their name.
- -a, --attribute NUM
Write to this attribute.
- -i, --inode
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.
- -h, --help
Show a list of options with a brief description of each one.
- -q, --quiet
Suppress some debug/warning/error messages.
- -V, --version
Show the version number, copyright and license
- -v, --verbose
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
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:
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.
is part of the
package and is available from:
- DATA STREAMS
- SEE ALSO