.TH "parrot_cp" 1 "" "CCTools 8.0.0 DEVELOPMENT" "Cooperative Computing Tools"

.SH NAME
.LP
\fBparrot_cp\fP - a replacement for \FCcp\FT that provides higher performance when dealing
with remote files via \FCparrot_run\FT.

.SH SYNOPSIS
.LP
\FC\fBparrot_cp [options] ... sources ... <dest>\fP\FT

.SH DESCRIPTION
.LP

\FCparrot_cp\FT is a drop-in replacement for the Unix \FCcp\FT command.
It provides better performance when copying files to or from remote storage
systems by taking advantage of whole-file transfer rather than copying files
block-by-block.

.SH OPTIONS
.LP

.LP
.TP
.B \ -f, --force
.
Forcibly remove target before copying.
.TP
.B \ -i, --interactive
.
Interactive mode: ask before overwriting.
.TP
.B \ -r
.
 Same as -R
.TP
.B \ -R, --recursive
.
Recursively copy directories.
.TP
.B \ -s, --symlinks
.
Make symbolic links instead of copying files.
.TP
.B \ -l, --hardlinks 
.
Make hard links instead of copying files.
.TP
.B \ -u, --update-only
.
Update mode: Copy only if source is newer than target.
.TP
.B \ -v, --version
.
Verbose mode: Show names of files copied.
.TP
.B \ -h, --help
.
Help: Show these options.


.SH EXIT STATUS
.LP
On success, returns zero.  On failure, returns non-zero.

.SH EXAMPLES
.LP

To use parrot_cp you can either call the code directly:

.fam C
.nf
.nh
.IP "" 8
% parrot_run tcsh
% parrot_cp /tmp/mydata /chirp/server.nd.edu/joe/data
% exit
.fi
.hy
.fam
.P

or alias calls to \FCcp\FT with calls to \FCparrot_cp\FT:

.fam C
.nf
.nh
.IP "" 8
% parrot_run bash
% alias cp parrot_cp
% cp -r /chirp/server.nd.edu/joe /tmp/joe
% exit
.fi
.hy
.fam
.P


.SH COPYRIGHT
.LP

The Cooperative Computing Tools are Copyright (C) 2005-2019 The University of Notre Dame.  This software is distributed under the GNU General Public License.  See the file COPYING for details.

.SH SEE ALSO
.LP


.IP \(bu 4
\fBCooperative Computing Tools Documentation\fP
.IP \(bu 4
\fBParrot User Manual\fP
.IP \(bu 4
\fBparrot_run(1)\fP \fBparrot_cp(1)\fP \fBparrot_getacl(1)\fP  \fBparrot_setacl(1)\fP  \fBparrot_mkalloc(1)\fP  \fBparrot_lsalloc(1)\fP  \fBparrot_locate(1)\fP  \fBparrot_timeout(1)\fP  \fBparrot_whoami(1)\fP  \fBparrot_mount(1)\fP  \fBparrot_md5(1)\fP  \fBparrot_package_create(1)\fP  \fBparrot_package_run(1)\fP  \fBchroot_package_run(1)\fP