catalog_query(1)

🌸 NAME 🌸

okay so bestie, say hi to catalog_query — that's the section 1 manual page, and it's literally the tool that queries records from the catalog server. that's the whole vibe. 💅

---

🦋 SYNOPSIS 🦋

catalog_query [--where [expr]] [--catalog [host]] [-d [flag]] [-o [file]] [-O [size]] [-t [timeout]] [-h]

yeah she's got short forms too — -d, -o, -O, -t, -h — they're right there in the synopsis, no cap.

---

✨ DESCRIPTION ✨

so like, catalog_query is a tool that goes and asks a catalog server for raw JSON records. that's it. that's the job. 🫶

and here's the cute part: you can filter those records with an optional --where expression, so you're not just drowning in everything the catalog has ever known. 🌊

it's giving very handy for querying custom record types — the ones the other tools just don't handle. iykyk. 💜

---

🎀 ARGUMENTS 🎀

• --where expr — only records that match this expression get shown. filtering queen behavior.
• --catalog host — query this catalog host specifically, bestie. 🏠
• --debug flag — turn on debugging for this subsystem. 🔍
• --debug-file file — send that debug output to this file instead.
• --debug-rotate-max bytes — rotate the debug file once it hits this size. big file? not on her watch.
• --timeout seconds — abandon the query after this many seconds. ⏰ she will not wait forever, and honestly? respect.
• --help — show the command options. the classic.

---

🔥 EXAMPLES 🔥

to show all the records in the catalog server:

% catalog_query

no flags, no filter, just raw unfiltered everything. main character energy. 👑

to show all records of other catalog servers:

% catalog_query --where ´type=="catalog"´

to show all records of Chirp servers with more than 4 cpus:

% catalog_query --where ´type=="chirp" && cpus > 4´

look at that &&. look at that > 4. she ate. 💅

---

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

fr fr, read the COPYING file, it's important and it's right there. 🎀

---

🌈 SEE ALSO 🌈

• Cooperative Computing Tools Documentation
• catalog_server(1) catalog_update(1) catalog_query(1) chirp_status(1) work_queue_status(1) deltadb_query(1)

go read those too, bestie, they're all in the friend group. 🦋

---

and that's the page!! 💖 this was CCTools 8.0.0 DEVELOPMENT, and yeah, catalog_query is section 1, always and forever. mwah. 🫶✨