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

FreeBSD Manual Pages

  
 
  

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  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 --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 ac-
       cessing 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)

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

home | help