---
name: "chirp_distribute"
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_distribute"
---

# chirp\_distribute(1)

copy a directory from one Chirp server to one or more Chirp server(s).

## NAME

**chirp\_distribute** - copy a directory from one Chirp server to one or more Chirp server(s).

## SYNOPSIS

FCchirp\_distribute \[options\] *\<sourcehost\>* *\<sourcepath\>* *\<host1\>* *\<host2\>* *\<host3\>* ...FT

## DESCRIPTION

**chirp\_distribute** is a tool for coping commonly used data across Chirp servers. Data is originated from a Chirp server *\<sourcehost\>* *\<sourcepath\>* and is copied to a given list of Chirp server(s) *\<host1\>* *\<host2\>* *\<host3\>*, etc ...

**chirp\_distribute** is a quick and simple way for replicating a directory from a Chirp server to many Chirp Servers by creating a spanning tree and then transferring data concurrently from host to host using third party transfer. It is faster than manually copying data using **parrot cp**, **chirp\_put** or **chirp\_third\_put**

**chirp\_distribute** also can clean up replicated data using -X option.

## OPTIONS

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

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

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

  Enable debugging for this subsystem.

- **-D,--info-transfer**

  Show detailed location, time, and performance of each transfer.

- **-F,--failures-file=*\<file\>***

  Write matrix of failures to this file.

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

  Comma-delimited list of tickets to use for authentication.

- **-N,--copies-max=*\<num\>***

  Stop after this number of successful copies.

- **-p,--jobs=*\<num\>***

  Maximum number of processes to run at once (default=100)

- **-R,--randomize-hosts**

  Randomize order of target hosts given on command line.

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

  Timeout for for each copy. (default is 3600s)

- **-T,--timeout-all=*\<time\>***

  Overall timeout for entire distribution. (default is 3600).

- **-v,--verbose**

  Show program version.

- **-X,--delete-target**

  Delete data from all of the target hosts.

- **-Y,--info-success**

  Show confirmation of successful placements.

- **-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 directory from server1 to server2, server3, server4 using **chirp\_distribute**:

```

```

-

  chirp\_distribute server1.somewhere.edu /mydata server2.somewhere.edu server3.somewhere.edu server4.somewhere.edu

To replicate a directory from server1 to  all available Chirp server(s) in Chirp catalog using **chirp\_distribute** and **chirp\_status**:

```

```

-

  chirp\_distribute server1.somewhere.edu /mydata \`chirp\_status -s\`

To replicate a directory from server1 to  all available Chirp server(s) in Chirp catalog using **chirp\_distribute** and **chirp\_status**. However stop when reach 100 copies with -N option:

```

```

-

  chirp\_distribute -N 100 server1.somewhere.edu /mydata \`chirp\_status -s\`

To clean up replicated data using **chirp\_distribute** using -X option:

```

```

-

  chirp\_distribute -X server1.somewhere.edu /mydata \`chirp\_status -s\`

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