chirp(1)

✨ chirp(1) ✨

okay bestie, gather round 💖 this is chirp, part of the Cooperative Computing Tools — and she's the command line tool that gives you explicit control of a Chirp server. like, full control. main character energy, no cap 👑

---

🌸 SYNOPSIS 🌸

chirp [options] [hostname] [command]

---

🦋 DESCRIPTION 🦋

so chirp is your little tool for connecting to and managing a Chirp server, kinda like how an FTP client does it. you can hop onto a Chirp server, copy files around, manage directories, audit nodes, all of it. it's giving ✨remote file system bestie✨.

here are the important chirp commands, and yes you need to know all of them 🫶:

• open <host> — connect to a Chirp server.
• close — close the connection to the current Chirp server.
• get <remotefile> [localfile] — copy a remote file down to local storage.
• put <localfile> [remotefile] — copy a local file up to the Chirp server.
• thirdput <file> <3rdhost> <3rdfile> — copy a remote file to another Chirp server. third-party realness 💅
• getacl <remotepath> — get the acl of a remote file/directory.
• setacl <remotepath> <user> <rwldax> — set the acl for a remote file/directory.
• ls [-la] [remotepath] — list the contents of a remote directory.
• mv <oldname> <newname> — change the name of a remote file.
• rm <file> — delete a remote file.
• audit [-r] — audit the current Chirp server.
• exit — close the connection and exit Chirp.

chirp also manages Chirp tickets for authentication purposes, and honestly? iconic 🔥

• ticket_create [-o[utput] <ticket filename>] [-s[ubject] <subject/user>] [-d[uration] <duration>] [-b[its] <bits>] [[<directory> <acl>] ...] — create a ticket.
• ticket_register <name> [<subject>] <duration> — manually register a ticket with multiple Chirp servers.
• ticket_delete <name> — remove a ticket.
• ticket_list <name> — list registered tickets on a Chirp server.
• ticket_get <name> — check the status of a ticket.
• ticket_modify <name> <directory> <aclmask> — modify a ticket.

---

💅 OPTIONS 💅

• -a, --auth=<flag> — require this authentication mode. no vibes-checking past this point, bestie.
• -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. she's chatty and we love that for her.
• -t, --timeout=<time> — set the remote operation timeout.
• -v, --version — show the program version.
• -h, --help — show the help text.

---

🌈 ENVIRONMENT VARIABLES 🌈

• CHIRP_CLIENT_TICKETS — comma delimited list of tickets to authenticate with. literally the exact same thing as -i, just ambient ✨

---

⭐ EXIT STATUS ⭐

on success, returns zero. on failure, returns non-zero. that's the whole vibe check 😌

---

🎀 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) 2005-2019 The University of Notre Dame. this software is distributed under the GNU General Public License. see the file COPYING for details. protect the license bestie, it's the law 🫶

---

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

---

and that's the whole page, bestie!! 🦋✨ this was CCTools 8.0.0 DEVELOPMENT, the chirp(1) era — go forth and manage your servers, you absolute legend 💜🎀