cp(C)

Syntax

cp [ -fip ] source_file1 source_file2 ... target

cp -R [ -fip ] source_file1 source_file2 ... target

cp -r [ -fip ] source_file1 source_file2 ... target

Description

In the first form, when source_file and target_file are not directories, the contents of source_file are copied to target_file.

In the second form, where target is a directory, cp copies each named source file to a destination of the same name within the directory target.

The third and fourth forms are described with the options below.

cp recognizes the following options:

-f

If the destination file exists but is not writeable, it is unlinked before copying is performed. Any hard links to the file are lost. (This option forces cp to overwrite existing files.)

-i

Before attempting to copy to an existing file, cp prompts for confirmation. The copy operation is not performed unless the user types an affirmative.

-p

When copying, cp tries to transfer the following characteristics from each source file to the corresponding destination file:

• Time of last modification and access

• User and group ID

• File permission bits

-r

Copies file hierarchies recursively.

-R

Copies file hierarchies recursively. Also permits copying of device nodes and named pipes. (The copy of a device node or pipe is assigned the file permissions of the source file, subject to the user's UMASK setting, unless the -p option is applied).

Examples

To copy all the files in directory mydir to backupdir, overwriting any files which exist there and have the same name:

cp -f mydir/*  backupdir

To copy all the files in mydir and all its subdirectories to backupdir:

cp -R mydir backupdir

To copy input from the terminal /dev/tty to inputfile until the user types <Ctrl>d:

cp -r /dev/tty inputfile

Limitations

See also

Standards conformance

ISO/IEC DIS 99452:1992, Information technology Portable Operating System Interface (POSIX) Part 2: Shell and Utilities (IEEE Std 1003.21992);
AT&T SVID Issue 2;
X/Open CAE Specification, Commands and Utilities, Issue 4, 1992.

Notices