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

       •   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 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_status(1)       chirp_fuse(1)      chirp_get(1)      chirp_put(1)
           chirp_stream_files(1)  chirp_distribute(1)  chirp_benchmark(1)  chirp_server(1)