---
name: "chirp"
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"
---

# chirp(1)

command line tool providing explicit control of a Chirp server.

## NAME

**chirp** - command line tool providing explicit control of a Chirp server.

## SYNOPSIS

FCchirp \[options\] \[hostname\] \[command\]FT

## DESCRIPTION

**chirp** is a tool to connect and manage a Chirp server in a similar way to an FTP client.  **chirp** allows connecting to a Chirp server, copying files, and managing directories, auditing node etc...

Here are some important  **chirp** commands:

- •

  **open** *\<host\>* Connect to a Chirp server.

- •

  **close** Close connection to current Chirp server.

- •

  **get** *\<remotefile\>* \[localfile\] Copy a remote file to local storage.

- •

  **put** *\<localfile\>* \[remotefile\] Copy a local file to Chirp server.

- •

  **thirdput** *\<file\>* *\<3rdhost\>* *\<3rdfile\>* Copy a remote file to another Chirp server.

- •

  **getacl** *\<remotepath\>* Get acl of a remote file/directory.

- •

  **setacl** *\<remotepath\>* *\<user\>* *\<rwldax\>* Set acl for a remote file/directory.

- •

  **ls** \[-la\] \[remotepath\] List contents of a remote directory.

- •

  **mv** *\<oldname\>* *\<newname\>* Change name of a remote file.

- •

  **rm** *\<file\>* Delete a remote file.

- •

  **audit**	\[-r\] Audit current Chirp server.

- •

  **exit** Close connection and exit **Chirp**.

  **chirp** also manages Chirp tickets for authentication purpose.

- •

  **ticket\_create** \[-o\[utput\] *\<ticket filename\>*\] \[-s\[ubject\] *\<subject/user\>*\] \[-d\[uration\] *\<duration\>*\] \[-b\[its\] *\<bits\>*\] \[\[*\<directory\>* *\<acl\>*\] ...\] Creat a ticket

- •

  **ticket\_create** \[-o\[utput\] *\<ticket filename\>*\] \[-s\[ubject\] *\<subject/user\>*\] \[-d\[uration\] *\<duration\>*\] \[-b\[its\] *\<bits\>*\] \[\[*\<directory\>* *\<acl\>*\] ...\] Creat a ticket

- •

  **ticket\_register** *\<name\>* \[*\<subject\>*\] *\<duration\>* Manually register a ticket with multiple Chirp severs.

- •

  **ticket\_delete** *\<name\>* Remove a ticket.

- •

  **ticket\_list** *\<name\>* List registered tickets on a Chirp server.

- •

  **ticket\_get** *\<name\>* Check status of a ticket.

- •

  **ticket\_modify** *\<name\>* *\<directory\>* *\<aclmask\>* Modify a ticket.

## OPTIONS

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

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

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

  Enable debugging for this subsystem.

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

  Comma-delimited list of tickets to use for authentication.

- **-l,--verbose**

  Long transfer information.

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

  Set remote operation timeout.

- **-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 connect to a Chirp server using **chirp**:

```

```

-

  % chirp server1.somewhere.edu chirp\> (enter more commands here)

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

```

```

-

  % chirp server1.somewhere.edu put /tmp/mydata.dat /mydata/mydata.dat

To get a single remote file using **chirp**:

```

```

-

  % chirp server1.somewhere.edu get /mydata/mydata.dat /tmp/mydata.dat

To create a ticket using:

```

```

-

  % chirp server1.somewhere.edu get ticket\_create -output myticket.ticket -subject unix:user -bits 1024 -duration 86400 / rl /foo rwl

To register a ticket with other Chirp servers:

```

```

-

  % chirp server2.somewhere.edu ticket\_register myticket.ticket unix:user 86400

To delete a ticket:

```

```

-

  % chirp server1.somewhere.edu ticket\_delete myticket.ticket

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