phpman > man > ntfscp(8)

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 un‐
       named 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 file‐
       name. 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 AT lists.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 2021.8.22                          September 2007                                  NTFSCP(8)