NAME

cp − copy files and directory subtrees

SYNOPSIS

cp file1 new_file
cp file1 [ file2 ...  ] dest_directory
cp −r directory1[directory2...] dest_directory

DESCRIPTION

Cp copies:

• file1 to new or existing new_file,

• file1 to existing dest_directory,

• file1, file2, ... to existing dest_directory,

• directory subtree directory1, to new or existing dest_directory. or

• multiple directory subtrees directory1, directory2, ... to new or existing dest_directory.

Under no circumstance can file1 and new_file be the same (be cautious when using shell metacharacters).  When destination is a directory, one or more files are copied into that directory.  If two or more files are copied, the destination must be a directory.  When copying a single file to a new file, if new_file exists, its contents are destroyed. 

If the access permissions of the destination dest_directory or existing destination file new_file forbid writing, cp aborts and produces an error message “cannot create file”.

To copy one or more directory subtrees to another directory, the −r option is required.  The −r option is ignored if used when copying a file to another file or files to a directory. 

If new_file is a link to an existing file with other links, cp overwrites the existing file and retains all links.  If copying a file to an existing file, cp does not change existing file access permission bits, owner, or group. 

When copying files to a directory or to a new file that does not already exist, cp creates a new file with the same file miscellaneous bits as file1, except that the sticky bit is not set unless you are superuser (see chmod(2)). The owner and group of the new file or files are those of the user. The last modification time of new_file (and last access time, if new_file did not exist) and the last access time of the source file1 are set to the time the copy was made. 

Options

−r Cause cp to copy the subtree rooted at each source directory to dest_directory. If dest_directory exists, it must be a directory, in which case cp creates a directory within dest_directory with the same name as file1 and copies the subtree rooted at file1 to dest_directory/file1. An error occurs if dest_directory/file1 already exists.  If dest_directory does not exist, cp creates it and copies the subtree rooted at file1 to dest_directory. Note that cp −r cannot merge subtrees. 

Only normal files and directories are copied; character special devices, block special devices, network special files, named pipes, symbolic links, and sockets are not copied, and a warning is printed stating that the file was skipped.  dest_directory should not reside within directory1, nor should directory1 have a cyclic directory structure, since in both cases cp attempts to copy an infinite amount of data. 

Access Control Lists (ACLs)

If new_file is a new file, or if a new file is created in dest_directory, it inherits the access control list of the original file1, file2, etc., altered to reflect any difference in ownership between the two files (see acl(5)).

EXAMPLES

The following command moves the directory sourcedir and its contents to a new location (targetdir) in the file system. Since cp creates the new directory, the destination directory targetdir should not already exist. 

cp -r sourcedir targetdir && rm -rf sourcedir

The −r option copies the subtree (files) in the directory sourcedir to the directory targetdir. The double ampersand (&&) causes a conditional action.  If the operation on the left side of the && is successful, the right side is executed (and removes the old directory).  If the operation on the left of the && is not successful, the old directory is not removed. 

This example is equivalent to:

mv sourcedir targetdir

To copy all files and directory subtrees in the current directory to existing targetdir, use:

cp -r ∗ targetdir

To copy all files and directory subtrees in sourcedir to targetdir, use:

cp -r sourcedir/∗ targetdir

Note that directory pathnames can precede both sourcedir and targetdir.

DEPENDENCIES

RFA and NFS
Access control lists of networked files are summarized (as returned in st_mode by stat(2)), but not copied to the new file. When using mv or ln on such files, a + is not printed after the mode value when asking for permission to overwrite a file. 

AUTHOR

Cp was developed by AT&T, the University of California, Berkeley and HP. 

SEE ALSO

cpio(1), ln(1), mv(1), rm(1), link(1M), lstat(2), readlink(2), stat(2), symlink(2), symlink(4), acl(5). 

EXTERNAL INFLUENCES

Environment Variables

LC_CTYPE determines the interpretation of text as single and/or multi-byte characters. 

LANG and LC_CTYPE determine the local language equivalent of y (for yes/no queries). 

LANG determines the language in which messages are displayed. 

If LC_CTYPE is not specified in the environment or is set to the empty string, the value of LANG is used as a default for each unspecified or empty variable.  If LANG is not specified or is set to the empty string, a default of "C" (see lang(5)) is used instead of LANG.  If any internationalization variable contains an invalid setting, cp behaves as if all internationalization variables are set to "C".  See environ(5).

International Code Set Support

Single- and multi-byte character code sets are supported. 

STANDARDS CONFORMANCE

cp: SVID2, XPG2, XPG3

Hewlett-Packard Company  —  HP-UX Release 7.0: Sept 1989