ntfscp(8)

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

NAME

6       ntfscp - copy file to an NTFS volume.
7

SYNOPSIS

9       ntfscp [options] device source_file destination
10

DESCRIPTION

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

OPTIONS

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       -m, --min-fragments
35              Minimize fragmentation when allocating space to  the  attribute.
36              This is mostly useful when creating big files.
37
38       -N, --attr-name NAME
39              Write to attribute with this name.
40
41       -n, --no-action
42              Use  this  option  to make a test run before doing the real copy
43              operation.  Volume will be opened read-only and no write will be
44              done.
45
46       -f, --force
47              This  will  override some sensible defaults, such as not working
48              with a mounted volume.  Use this option with caution.
49
50       -h, --help
51              Show a list of options with a brief description of each one.
52
53       -q, --quiet
54              Suppress some debug/warning/error messages.
55
56       -V, --version
57              Show the version number, copyright and license ntfscp.
58
59       -v, --verbose
60              Display more debug/warning/error messages.
61

DATA STREAMS

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

EXAMPLES

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

BUGS

86       There are no known problems with ntfscp. If you find a bug please  send
87       an email describing the problem to the development team:
88       ntfs-3g-devel@lists.sf.net
89

AUTHORS

91       ntfscp was written by Yura Pakhuchiy, with contributions from Anton Al‐
92       taparmakov and Hil Liao.  It was ported to ntfs-3g by Erik Larsson.
93

DEDICATION

95       With love to Marina Sapego.
96

AVAILABILITY

98       ntfscp is part of the ntfs-3g package and is available from:
99       http://www.tuxera.com/community/
100