Manual: ntfscp

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 di‐
       rectory 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.

       -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  --at‐
	      tribute.

       -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  devel‐
       opment 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:
       https://github.com/tuxera/ntfs-3g

SEE ALSO
       ntfsprogs(8)

ntfs-3g 2022.10.3				       September 2007						   NTFSCP(8)