Man page - chirp(1)

Packages contains this manual

Package: coop-computing-tools
apt-get install coop-computing-tools

Manuals in package:

Documentations in package:

coop-computing-tools

Manual

chirp

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
ENVIRONMENT VARIABLES
EXIT STATUS
EXAMPLES
COPYRIGHT
SEE ALSO

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

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