NAME

cp − copy files

SYNOPSIS

cp [ −i ] [ −r ] file1 file2

cp [ −i ] [ −r ] file ... directory

DESCRIPTION

File1 is copied onto file2. The mode and owner of file2 are preserved if it already existed; the mode of the source file is used otherwise. 

In the second form, one or more files are copied into the directory with their original file-names. 

Cp refuses to copy a file onto itself. 

OPTIONS

−i Interactive: prompt the user with the name of the file whenever the copy would overwrite an old file.  Answering with ’y’ means that cp should go ahead and copy the file.  Any other answer will prevent cp from overwriting the file. 

−r Recursive:  if any of the source files are directories, cp copies each subtree rooted at that name; in this case the destination must be a directory. 

EXAMPLES

To make a backup copy of goodies:

% cp goodies old.goodies

To copy an entire directory hierarchy:

% cp −r /usr/wendy/src  /usr/wendy/backup

However, BEWARE of a recursive copy like this one:

% cp −r /usr/wendy/src  /usr/wendy/src/backup

which keeps copying files until it fills the entire file system. 

SEE ALSO

cat(1), pr(1), mv(1), rcp(1C)

BUGS

There should be an option to copy timestamps to the new files — for instance, when copying a whole hierarchy from one file system to another file system, or when making a backup copy. 

Sun Release 1.1  —  Last change: 16 February 1984