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 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 directo-
       ries, 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.

       -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 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:somepathmyfile: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 Altaparmakov 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:
       http://www.tuxera.com/community/

SEE ALSO

       ntfsprogs(8)

ntfs-3g 2017.3.23						  September 2007							 NTFSCP(8)