---
name: "chirp_put"
section: "1"
platform: "linux"
package: "coop-computing-tools"
version: "1:7.14.5-1+b2"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/chirp_put"
---

# chirp\_put(1)

copy a single file from local machine to a Chirp server

## NAME

**chirp\_put** - copy a single file from local machine to a Chirp server

## SYNOPSIS

FCchirp\_put \[options\] *\<localfile\>* *\<hostname\[:port\]\>* *\<remotefile\>*FT

## DESCRIPTION

**chirp\_put** is a tool for copying a single file from local storage to a Chirp server.

**chirp\_put** is a quick and simple way to copy a single local file *\<localfile\>* to a remote file given *\<hostname\[:port\]\>* *\<path\>*

## OPTIONS

- **-a,--auth=*\<flag\>***

   Enable authentication mode: unix, hostname, address, ticket, kerberos, or globus.

- **-d,--debug=*\<flag\>***

  Enable debugging for this subsystem.

- **-b,--block-size=*\<size\>***

  Set transfer buffer size. (default is 65536 bytes).

- **-f,--follow**

  Follow input file like tail -f.

- **-i,--tickets=*\<files\>***

  Comma-delimited list of tickets to use for authentication.

- **-t,--timeout=*\<time\>***

  Timeout for failure. (default is 3600s)

- **-v,--version**

  Show program version.

- **-h,--help**

  Show help text.

## ENVIRONMENT VARIABLES

- •

  FCCHIRP\_CLIENT\_TICKETSFT Comma delimited list of tickets to authenticate with (same as FC-iFT).

## EXIT STATUS

On success, returns zero.  On failure, returns non-zero.

## EXAMPLES

To copy a single local file using **chirp\_put**:

```

```

-

  % chirp\_put /tmp/mydata.dat server1.somewhere.edu /mydata/mydata.dat

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

```

```

-

  % chirp\_put -t 36000 /tmp/mybigdata.dat server1.somewhere.edu /mydata/mybigdata.dat

## COPYRIGHT

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

## SEE ALSO

- •

  **Cooperative Computing Tools Documentation**

- •

  **Chirp User Manual**

- •

  **[chirp(1)](/chirp/1.md)**  **[chirp\_status(1)](/chirp_status/1.md)**  **[chirp\_fuse(1)](/chirp_fuse/1.md)**  **[chirp\_get(1)](/chirp_get/1.md)**  **[chirp\_put(1)](/chirp_put/1.md)**  **[chirp\_stream\_files(1)](/chirp_stream_files/1.md)**  **[chirp\_distribute(1)](/chirp_distribute/1.md)**  **[chirp\_benchmark(1)](/chirp_benchmark/1.md)**  **[chirp\_server(1)](/chirp_server/1.md)**