ntfscp.1m revision c10c16dec587a0662068f6e2991c29ed3a9db943
te
Portions Copyright (c) 2009, Sun Microsystems, Inc. All Rights Reserved
Copyright (c) 2002-2006 Szabolcs Szakacsits
Copyright (c) 2002-2005 Anton Altaparmakov
Copyright (c) 2002-2003 Richard Russon
Copyright (c) 2007 Yura Pakhuchiy
This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation ; either version 2 of the License, or (at your option) any later version. This program is distributed
in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program
(in the main directory of the Linux-NTFS distribution in the file COPYING); if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 11-1307 USA
ntfscp 1M "28 May 2009" "SunOS 5.11" "System Administration Commands"
NAME
ntfscp - copy file to an NTFS volume
SYNOPSIS

ntfscp [options] device source_file destination
DESCRIPTION

The ntfscp utility copies files to an NTFS volume. destination (see Synopis) can be either a file or a directory. If destination is a directory specified by name, source_file is copied into this directory. If destination is a directory specified by inode number, an unnamed data attribute is created for this inode and source_file is copied into it. Consider possible negative consequence before specifying a directory by inode number: it is unusual to have an unnamed data stream in a directory.

"Data Streams"

All data on NTFS is stored in streams, which can have names. A file can have more than one data stream, but exactly one must have no name. The size of a file is the size of its unnamed data stream. Usually, when you do not specify a stream name, you are seeking access to the unnamed data stream. If you want access to a 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. In an operating system, such as Windows, that prevents you from accessing named data streams, you need to use some program like FAR or utilities from cygwin to access those streams.

OPTIONS

Supported options are listed below. Most options have both single-letter and full-name forms. Multiple single-letter options that do not take an argument can be combined. For example, -fv is the equivalent of -f -v. A full-name option can be abbreviated to a unique prefix of its name.

-a, --attribute num

Write to attribute designated by num.

-f, --force

Overrides 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.

-i, --inode

Treat destination (see Synopsis) as inode number.

-N, --attr-name name

Write to attribute with this name.

-n, --no-action

Use this option to make a test run before doing the actual copy operation. Volume will be opened read-only and no write will be done.

-q, --quiet

Suppress some debug, warning, and error messages.

-V, --version

Show the version number, copyright, and license information.

-v, --verbose

Display more debug, warning, and error messages.

EXAMPLES

Example 1 Copying from Home to Root Directory

The following command copies new_boot.ini from /home/user as boot.ini to the root of an /dev/dsk/c0d0p1 NTFS volume.

# ntfscp /dev/dsk/c0d0p1 /home/user/new_boot.ini boot.ini

Example 2 Copying a Stream

The following command copies myfile to C:\some\path\myfile:stream (assume that /dev/dsk/c0d0p1 drive designator is C).

# ntfscp -N stream /dev/dsk/c0d0p1 myfile /some/path
ATTRIBUTES

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPEATTRIBUTE VALUE
Interface StabilityUncommitted
SEE ALSO

ntfsresize(1M), ntfsprogs(1M), parted(1M), attributes(5)

http://wiki.linux-ntfs.org

AUTHORS

ntfscp was written by Yura Pakhuchiy, with contributions from Anton Altaparmakov and Hil Liao.