Go to main content

man pages section 8: System Administration Commands

Exit Print View

Updated: Thursday, June 13, 2019
 
 

ntfscp(8)

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 Synopsis) 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(7) for descriptions of the following attributes:

ATTRIBUTE TYPE
ATTRIBUTE VALUE
Availability
system/file-system/ntfsprogs
Interface Stability
Uncommitted

See Also

attributes(7), ntfsprogs(8), ntfsresize(8), parted(8)

Authors

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