NTFSCP(8) System Manager's Manual 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 di-
rectory 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 be-
fore 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 op-
eration. 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.
-t, --timestamp
Copy the modification time of source_file to destination. 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 development team:
ntfs-3g-devel@lists.sf.net
AUTHORS
ntfscp was written by Yura Pakhuchiy, with contributions from Anton Al-
taparmakov and Hil Liao. It was ported to ntfs-3g by Erik Larsson.
DEDICATION
With love to Marina Sapego.
AVAILABILITY
ntfscp is part of the ntfs-3g package and is available from:
https://github.com/tuxera/ntfs-3g
SEE ALSO
ntfsprogs(8)
ntfs-3g 2022.10.3 September 2007 NTFSCP(8)
Generated by dwww version 1.16 on Sat Oct 3 06:49:39 CEST 2026.