---
name: "chirp_get"
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_get"
---

# chirp\_get(1)

get a single file from a Chirp server to local machine

## NAME

**chirp\_get** - get a single file from a Chirp server to local machine

## SYNOPSIS

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

## DESCRIPTION

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

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

**chirp\_get** also can stream data which can be useful in a shell pipeline.

## OPTIONS

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

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

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

  Enable debugging for this subsystem.

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

  Timeout for failure. (default is 3600s)

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

  Comma-delimited list of tickets to use for authentication.

- **-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 remote file using **chirp\_get**:

```

```

-

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

To get, while at the same time, untar a single remote archive file using **chirp\_get**:

```

```

-

  % chirp\_get myhost.somewhere.edu /mydata/archive.tar.gz - \| tar xvzf

## 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)**