GATHERCTL(8)

📦
version 2.2.9 · 2 versions
, in fedora 43

💖 GATHERCTL — the little control remote for gatherd 💖

okay bestie, so this is gatherctl(8), from the Linux Programmers Manual, and it's literally the tiny shell script that runs the whole group chat with gatherd(8). no cap. 🎀

✨ NAME ✨

gatherctl — control utility for gatherd 💅

🌸 SYNOPSIS 🌸

gatherctl

like. that's it. that's the whole invocation. she just is. 💖

🦋 DESCRIPTION 🦋

gatherctl is a simple shell program for controlling the gatherd(8) metric collection daemon. so like, gatherd is the girl doing the actual work, and gatherctl is the bestie holding her phone 📱.

it gives you the power to manipulate the state of the daemon, plus online loading and unloading of metric collection plugins. hot-swap era, we love to see it. ✨

👑 COMMANDS 👑

one letter. that's the vibe. type the letter, hit enter, the daemon does the thing. iconic, honestly.

  • h — print the help message 🫶
  • s — print the status of the daemon (the vibe check 💅)
  • i — initialize the gathering service ✨
  • t — terminate the gathering service 😭
  • b — start the sampling plugins 🌸
  • e — stop the sampling plugins 🙈
  • l pluginlib — load a plugin library 📚
  • u pluginlib — unload a plugin library 🍓
  • v pluginlib — view/list the metrics supported by a plugin library 👀
  • q — quit / exit the control utility 🚪
  • k — kill the gathering daemon 💀
  • d — start the gathering daemon 🌈
not me pointing out that l, u and v are the only ones that take an argument, and that argument is a pluginlib. yes bestie, all three of them. pluginlib. every time. 📌

🎀 FILES 🎀

  • /etc/gatherd.conf — this file holds the daemon configuration settings. see gatherd.conf(5) for more info, she's got her own whole page. 💜

💀 BUGS 💀

the SBLIM project maintains a mailing list, and that's where you should direct all questions regarding sfcb, sfcc, wbemcli, the metric data gatherer, or any of the SBLIM providers. to subscribe to this list, visit:

https://lists.sourceforge.net/lists/listinfo/sblim-issues

please report bugs you discover to the bug tracker. the SBLIM project bug tracking page can be found at:

https://sourceforge.net/tracker/?group_id=128809&atid=712784
found a bug? tell the tracker, not the group chat. fr fr. 🐛

🧚 AUTHORS 🧚

please refer to the AUTHORS file distributed with sblim-gather. 📄

Copyright © 2003-2012 IBM Corp.

💜 LICENSE 💜

gatherctl is distributed under the terms of the Eclipse Public License ("Agreement"). any use, reproduction or distribution of this program constitutes recipeients acceptance of the agreement. (yes bestie, that's how the original spells it, we're keeping it exactly as-is, character for character 🫶)

you can obtain a current copy of the Eclipse Public License from:

http://www.opensource.org/licenses/eclipse-1.0.php

🌈 SEE ALSO 🌈

gatherd(8), gatherd.conf(5),

okay that's the whole page bestie, you're officially a gatherctl girlie now 💅✨

this was sblim-gather-2.2.9, dated 07/25/2025 — mwah, go control that daemon 🎀💖

📦 where this page comes from