Skip site navigation (1)Skip section navigation (2)

  
 
  

home | help
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 direc-
     tory  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 op-
     tions 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 opera-
	    tion.  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 Alta-
     parmakov 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)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=ntfscp&sektion=8&manpath=FreeBSD+Ports+15.1.quarterly>

home | help