cp(1)                                                       cp(1)



     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; otherwise, the mode of the
          source file is used (all bits set in the current umask value
          are cleared).

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

          cp refuses to copy a file onto itself.

          If the -i flag option is specified, cp will prompt the user
          with the name of the file whenever the copy will cause an
          old file to be overwritten.  An answer of y will cause cp to
          continue.  Any other answer will prevent it from overwriting
          the file.

          If the -r flag option is specified and any of the source
          files are directories, cp copies each subtree rooted at that
          name; in this case, the destination must be a directory.

     FILES
          /bin/cp

     SEE ALSO
          cat(1), pr(1), mv(1), rcp(1N).

     WARNINGS
          cp does not copy the description of special files, but at-
          tempts to copy the contents of the special file.  This often
          occurs when using the -r flag option for a recursive copy.
          For example, cp will hang when trying to copy a named pipe
          or tty device.  When a disk node is being copied, the con-
          tents of the disk partition will be copied.  To copy the
          description of the special files, use cpio(1).












     April, 1990                                                     1