chirp(1)

NAME

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

SYNOPSIS

*chirp [options] [hostname] [command]*

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 Connect to a Chirp server.
  • close Close connection to current Chirp server.
  • get [localfile] Copy a remote file to local storage.
  • put [remotefile] Copy a local file to Chirp server.
  • thirdput <3rdhost> <3rdfile> Copy a remote file to another Chirp server.
  • getacl Get acl of a remote file/directory.
  • setacl Set acl for a remote file/directory.
  • ls [-la] [remotepath] List contents of a remote directory.
  • mv Change name of a remote file.
  • rm 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] ] [-s[ubject] ] [-d[uration] ] [-b[its] ] [[ ] ...] Creat a ticket
  • ticket_register [] Manually register a ticket with multiple Chirp severs.
  • ticket_delete Remove a ticket.
  • ticket_list List registered tickets on a Chirp server.
  • ticket_get Check status of a ticket.
  • ticket_modify Modify a ticket.

OPTIONS

  • -a --auth Require this authentication mode.
  • -d --debug Enable debugging for this subsystem.
  • -i --tickets Comma-delimited list of tickets to use for authentication.
  • -l, --verbose Long transfer information.
  • -t --timeout Set remote operation timeout.
  • -v, --version Show program version.
  • -h, --help Show help text.

ENVIRONMENT VARIABLES

  • *CHIRP_CLIENT_TICKETS Comma delimited list of tickets to authenticate with (same as -i*).

EXIT STATUS

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

EXAMPLES

To conenct 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

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.

SEE ALSO

CCTools 8.0.0 DEVELOPMENT released on