ntfscp(8)

1NTFSCP(8)                   System Manager's Manual                  NTFSCP(8)
2
3
4

NAME

6       ntfscp - overwrite file on an NTFS volume.
7

SYNOPSIS

9       ntfscp [options] device source_file destination
10

DESCRIPTION

12       ntfscp  will  overwrite file on an NTFS volume. At present ntfscp can't
13       create new files.  destination can be either file or directory. In case
14       if  destination  is  directory  specified  by  name then source_file is
15       copied into this directory, in case if  destination  is  directory  and
16       specified  by  inode  number then unnamed data attribute is created for
17       this inode and source_file is copied into it (WARNING: it's unusual  to
18       have unnamed data streams in the directories, think twice before speci‐
19       fying directory by inode number).
20

OPTIONS

22       Below is a summary of all the options that ntfscp accepts.  Nearly  all
23       options have two equivalent names.  The short name is preceded by - and
24       the long name is preceded by --.  Any single letter options, that don't
25       take  an  argument, can be combined into a single command, e.g.  -fv is
26       equivalent to -f -v.  Long named options  can  be  abbreviated  to  any
27       unique prefix of their name.
28
29       -a, --attribute NUM
30              Write to this attribute.
31
32       -i, --inode
33              Treat destination as inode number.
34
35       -N, --attr-name NAME
36              Write to attribute with this name.
37
38       -n, --no-action
39              Use  this  option  to make a test run before doing the real copy
40              operation.  Volume will be opened read-only and no write will be
41              done.
42
43       -f, --force
44              This  will  override some sensible defaults, such as not working
45              with a mounted volume.  Use this option with caution.
46
47       -h, --help
48              Show a list of options with a brief description of each one.
49
50       -q, --quiet
51              Suppress some debug/warning/error messages.
52
53       -V, --version
54              Show the version number, copyright and license ntfscp.
55
56       -v, --verbose
57              Display more debug/warning/error messages.
58

DATA STREAMS

60       All data on NTFS is stored in streams, which can have names. A file can
61       have more than one data streams, but exactly one must have no name. The
62       size of a file is the size of its unnamed data stream. Usually when you
63       don't specify stream name you are access to unnamed data stream. If you
64       want access to named data stream you need to add ":stream_name" to  the
65       filename.  For  example:  by  opening  "some.mp3:artist"  you will open
66       stream "artist" in "some.mp3". But windows  usually  prevent  you  from
67       accessing  to  named data streams, so you need to use some program like
68       FAR or utils from cygwin to access named data streams.
69

EXAMPLES

71       Copy new_boot.ini from  /home/user  as  boot.ini  to  the  root  of  an
72       /dev/hda1 NTFS volume:
73
74              ntfscp /dev/hda1 /home/user/new_boot.ini boot.ini
75
76       Copy myfile to C:\some\path\myfile:stream (assume that /dev/hda1 letter
77       in windows is C):
78
79              ntfscp -N stream /dev/hda1 myfile /some/path
80
81

BUGS

83       There are no known problems with ntfscp.  If you find a bug please send
84       an email describing the problem to the development team:
85       linux-ntfs-dev@lists.sourceforge.net
86

AUTHORS

88       ntfscp was written by Yura Pakhuchiy, with contributions from Anton Al‐
89       taparmakov.
90

DEDICATION

92       With love to Marina Sapego.
93

AVAILABILITY

95       ntfscp is part of the ntfsprogs package and is available from:
96       http://www.linux-ntfs.org/content/view/19/37
97
98       The manual pages are available online at:
99       http://man.linux-ntfs.org/
100