chirp_status(1)

✨ NAME ✨

chirp_status — bestie, this is the lil' tool that gets you the current status of one or more Chirp server(s) 💅

(it lives in the Cooperative Computing Tools family, section 1 of the manual, iykyk 🫶)

---

🌸 SYNOPSIS 🌸

chirp_status [options] <nane> <value>

(no babe I did not typo that, that's literally what it says, we respect the source ✨)

---

🦋 DESCRIPTION 🦋

okay so chirp_status is a tool for checking status of Chirp server(s). that's the whole vibe. it's giving "hey server, u up?" 💖

it can look up Chirp server(s) using type, name, port, owner and version. so many ways to find ur fave.

by default, chirp_status lists type, name, port, owner, version, total and available storage of Chirp server(s). the standard serve, no cap.

but when you hit it with the long form option (-l), it lists additional information such as average load, available memory, operating system, up time, etc... ✨ the full main character reveal, honestly.

---

👑 OPTIONS 👑

• --where <expr> — only show servers matching this expression. ur lil' filter, ur lil' vibe check 🎀
• -c, --catalog=<host> — query the catalog on this host. like, ask this specific place instead 🌸
• -A, --server-space=<size> — only show servers with this space available. (example: -A 100MB). bestie only wants servers with room for her stuff 💅
• --server-project <name> — only servers with this project name. very "show me ur people" energy 🫶
• -t, --timeout=<time> — timeout. how long we wait before we're like ok bye 😭
• -s, --brief — short output. the tl;dr version, no paragraphs 💜
• -l, --verbose — long output. the director's cut, the extended edition 🌈
• -T, --totals — totals output. aggregate slay, everything added up 👑
• -v, --version — show program version. which era of the software are we in ⭐
• -d, --debug=<flag> — enable debugging for this subsystem. turn the lil' cameras on 🔥
• -o, --debug-file=<file> — write debugging output to this file. by default, debugging is sent to stderr (":stderr"). you may specify logs to be sent to stdout (":stdout") instead. 💖
• -O, --debug-rotate-max=<bytes> — rotate file once it reaches this size. when it gets too big it just... moves on, iconic 💀
• -h, --help — show help text. ur girl when u need her 🙈

---

🌈 ENVIRONMENT VARIABLES 🌈

• CHIRP_CLIENT_TICKETS — comma delimited list of tickets to authenticate with (same as -i). ur lil' wristband collection so the servers know u belong 🎟️✨

---

🍓 EXIT STATUS 🍓

• On success, returns zero. 💖
• On failure, returns non-zero. 😭 (we do NOT love that for us)

---

💜 EXAMPLES 💜

to show status of all available Chirp servers using chirp_status:

% chirp_status

to show status of a particular Chirp server:

% chirp_status --where 'name=="server1.somewhere.edu"'

to show status of Chirp servers which belong to a particular owner:

% chirp_status --where 'owner=="fred"'

to show all details in JSON format:

% chirp_status --long

to show aggregate status of all Chirp servers using chirp_status:

% chirp_status -T

---

🎀 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 lil' license, bestie, it's the law fr fr 🫶)

---

💅 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, u ate 💅✨

okay so this was CCTools 8.0.0 DEVELOPMENT energy, chirp_status(1), and that's the sign-off — go check ur servers, queen 👑💖