catalog_update(1)

💖 catalog_update(1) — the send-an-update-to-the-catalog-server girlie 💖

okay so bestie, you know how the catalog server is out here collecting gossip about every host in the cluster? yeah. this is the tiny little hand-held megaphone you use to slide into its DMs yourself. it lives in the Cooperative Computing Tools manual, and no cap, it's short but it serves. 🫶

---

✨ NAME ✨

catalog_update — send update to catalog server

that's it. that's the whole name section. she's lowkey humble. 💅

---

🌈 SYNOPSIS 🌈

catalog_update [options] [name=value] ..

---

🦋 DESCRIPTION 🦋

so the catalog_update tool lets you manually yeet an update to a catalog server via a short UDP packet. that's the vibe. one little packet, one big glow-up for the catalog. ✨

---

🎀 OPTIONS 🎀

• -c, --catalog=<host> — send the update to this catalog host. this is your target. your main character server. 👑
• -f, --file=<json-file> — send extra JSON attributes that live in this file. more fields, more lore. 📄
• -d, --debug=<flags> — turn on debug flags.
• -o, --debug-file=<file> — send that debug output to this file instead of wherever it was going.
• -v <version> — show software version. version check, periodt. ⭐
• -h <help> — show all options. when in doubt, ask for help, it's giving self-care. 🙈

---

the catalog_update tool sends a custom message to the catalog server in the form of a JSON object with various properties describing the host. by default, the catalog_update tool includes the following fields in the update:

• type — this describes the node type (default is "node").
• version — this is the version of CCTools.
• cpu — this is CPU architecture of the machine.
• opsys — this is operating system of the machine.
• opsysversion — this is operating system version of the machine.
• load1 — this is 1-minute load of the machine.
• load5 — this is 5-minute load of the machine.
• load15 — this is 15-minute load of the machine.
• memory_total — this is total amount of memory on the machine
• memory_avail — this is amount of available memory on the machine
• cpus — this is number of detected CPUs on the machine.
• uptime — this how long the machine has been running.
• owner — this is user who sent the update.

okay so about the field name — it is intended to give a human-readable name to a service or application which accepts incoming connections at port. that's the tea, fr fr. 🍓

---

🌸 ENVIRONMENT VARIABLES 🌸

• CATALOG_HOST — hostname of catalog server (same as -c). set it once, forget it, live your life. 💜

---

💀 EXIT STATUS 💀

• on success, returns zero. 🎉
• on failure, returns non-zero. 😭

---

🧚 EXAMPLES 🧚

the following example sends an update to the catalog server located at catalog.cse.nd.edu with three custom fields. watch her work:

% cat > test.json << EOF
{
    "type" : "node",
    "has_java" : true,
    "mode" : 3
}
EOF
% catalog_update -c catalog.cse.nd.edu -f test.json

look at that. iconic. ate. no crumbs. 🔥

---

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

yes bestie, read the license, it's not optional. respecting licenses is highkey the most main character energy there is. 💅

---

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

---

and that's the whole page, bestie!! 🎀 this was CCTools 8.0.0 DEVELOPMENT, mwah, go send some updates and slay. 🦋✨💖