.TH "chirp_put" 1 "" "CCTools 7.1.2 FINAL" "Cooperative Computing Tools"

.SH NAME
.LP
\fBchirp_put\fP - copy a single file from local machine to a Chirp server

.SH SYNOPSIS
.LP
\FC\fBchirp_put [options] <localfile> <hostname[:port]> <remotefile>\fP\FT

.SH DESCRIPTION
.LP

\fBchirp_put\fP is a tool for copying a single file from local storage to a Chirp server.
.PP
\fBchirp_put\fP is a quick and simple way to copy a single local file <localfile> to a remote file given <hostname[:port]> <path>

.SH OPTIONS
.LP

.LP
.TP
\fB-a\fP, \fB-\-auth\fP=\fI<flag>\fP
.
Require this authentication mode.
.TP
\fB-d\fP, \fB-\-debug\fP=\fI<flag>\fP
.
Enable debugging for this subsystem.
.TP
\fB-b\fP, \fB-\-block-size\fP=\fI<size>\fP
.
Set transfer buffer size. (default is 65536 bytes).
.TP
.B \ -f, --follow
.
Follow input file like tail -f.
.TP
\fB-i\fP, \fB-\-tickets\fP=\fI<files>\fP
.
Comma-delimited list of tickets to use for authentication.
.TP
\fB-t\fP, \fB-\-timeout\fP=\fI<time>\fP
.
Timeout for failure. (default is 3600s)
.TP
.B \ -v, --version
.
Show program version.
.TP
.B \ -h, --help
.
Show help text.


.SH ENVIRONMENT VARIABLES
.LP


.IP \(bu 4
\FC\fBCHIRP_CLIENT_TICKETS\fP\FT Comma delimited list of tickets to authenticate with (same as \FC-i\FT).


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

.SH EXAMPLES
.LP

To copy a single local file using \fBchirp_put\fP:

.fam C
.nf
.nh
.IP "" 8
% chirp_put /tmp/mydata.dat server1.somewhere.edu /mydata/mydata.dat
.fi
.hy
.fam
.P

When copying big data files that take longer than 3600s to copy, using \fBchirp_put\fP with option -t time to make sure \fBchirp_put\fP have enough time to finish:

.fam C
.nf
.nh
.IP "" 8
% chirp_put -t 36000 /tmp/mybigdata.dat server1.somewhere.edu /mydata/mybigdata.dat
.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
\fBChirp User Manual\fP
.IP \(bu 4
\fBchirp(1)\fP  \fBchirp_status(1)\fP  \fBchirp_fuse(1)\fP  \fBchirp_get(1)\fP  \fBchirp_put(1)\fP  \fBchirp_stream_files(1)\fP  \fBchirp_distribute(1)\fP  \fBchirp_benchmark(1)\fP  \fBchirp_server(1)\fP