1NTFSCP(8) System Manager's Manual NTFSCP(8)
2
3
4
6 ntfscp - copy file to an NTFS volume.
7
9 ntfscp [options] device source_file destination
10
12 ntfscp will copy file to an NTFS volume. destination can be either file
13 or directory. In case if destination is directory specified by name
14 then source_file is copied into this directory, in case if destination
15 is directory and specified by inode number then unnamed data attribute
16 is created for this inode and source_file is copied into it (WARNING:
17 it's unusual to have unnamed data streams in the directories, think
18 twice before specifying directory by inode number).
19
21 Below is a summary of all the options that ntfscp accepts. Nearly all
22 options have two equivalent names. The short name is preceded by - and
23 the long name is preceded by --. Any single letter options, that don't
24 take an argument, can be combined into a single command, e.g. -fv is
25 equivalent to -f -v. Long named options can be abbreviated to any
26 unique prefix of their name.
27
28 -a, --attribute NUM
29 Write to this attribute.
30
31 -i, --inode
32 Treat destination as inode number.
33
34 -N, --attr-name NAME
35 Write to attribute with this name.
36
37 -n, --no-action
38 Use this option to make a test run before doing the real copy
39 operation. Volume will be opened read-only and no write will be
40 done.
41
42 -f, --force
43 This will override some sensible defaults, such as not working
44 with a mounted volume. Use this option with caution.
45
46 -h, --help
47 Show a list of options with a brief description of each one.
48
49 -q, --quiet
50 Suppress some debug/warning/error messages.
51
52 -V, --version
53 Show the version number, copyright and license ntfscp.
54
55 -v, --verbose
56 Display more debug/warning/error messages.
57
59 All data on NTFS is stored in streams, which can have names. A file can
60 have more than one data streams, but exactly one must have no name. The
61 size of a file is the size of its unnamed data stream. Usually when you
62 don't specify stream name you are access to unnamed data stream. If you
63 want access to named data stream you need to add ":stream_name" to the
64 filename. For example: by opening "some.mp3:artist" you will open
65 stream "artist" in "some.mp3". But windows usually prevent you from
66 accessing to named data streams, so you need to use some program like
67 FAR or utils from cygwin to access named data streams.
68
70 Copy new_boot.ini from /home/user as boot.ini to the root of an
71 /dev/hda1 NTFS volume:
72
73 ntfscp /dev/hda1 /home/user/new_boot.ini boot.ini
74
75 Copy myfile to C:\some\path\myfile:stream (assume that /dev/hda1 letter
76 in windows is C):
77
78 ntfscp -N stream /dev/hda1 myfile /some/path
79
80
82 There are no known problems with ntfscp. If you find a bug please send
83 an email describing the problem to the development team:
84 ntfs-3g-devel@lists.sf.net
85
87 ntfscp was written by Yura Pakhuchiy, with contributions from Anton Al‐
88 taparmakov and Hil Liao. It was ported to ntfs-3g by Erik Larsson.
89
91 With love to Marina Sapego.
92
94 <<<<<<< HEAD ntfscp is part of the ntfs-3g package and is available
95 from: ======= ntfscp is part of the ntfsprogs package and is available
96 from: >>>>>>> linux-ntfs/libntfs-3g_port-v2_0_0
97 http://www.tuxera.com/community/
98
99 The manual pages are available online at:
100 http://man.linux-ntfs.org/
101
103 ntfsprogs(8)
104
105
106
107ntfs-3g 2011.4.12 September 2007 NTFSCP(8)