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 <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] ] [[<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>
    Require this authentication mode.
    -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 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
    

    COPYRIGHT

    The Cooperative Computing Tools are Copyright (C) 2003-2004 Douglas Thain and Copyright (C) 2005-2011 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)
  • chirp_server_hdfs(1)

  • CCTools 4.1.4rc5 released on 04/10/2014