CUSSH(1)

📦 version 5.12.0.348.g93f9bdcb, in opensuse-leap 16.0

💅 CUSSH(1) — the collectd UNIX socket shell, bestie

ok so picture this: it's the Collectd UNIX Socket Shell manual page, and I'm about to make it make sense. this is cussh (say it with me: cussh ✨), and it's your new little bestie for talking to collectd. let's go 🫶

✨ NAME ✨

cussh — collectd UNIX socket shell. that's it, that's the whole vibe 🎀

🌸 SYNOPSIS 🌸

cussh [<path>]

yes it's literally that short. one optional path, no cap 💅

🦋 DESCRIPTION 🦋

okay so here's the tea ☕ — collectd's unixsock plugin lets outside programs get at the values collectd has collected or received, and lets them submit their own values. iconic behavior, honestly 👑

and cussh? it's a little interactive frontend for that plugin. that's it. that's the whole job. tiny, cute, does exactly one thing and does it well 💖

🎀 OPTIONS 🎀

  • <path> — the path to the UNIX socket that collectd's unixsock plugin gives you. the default is /var/run/collectd-unixsock if you don't feel like typing it. lowkey convenient, highkey slay 🌈

👑 COMMANDS 👑

here's where it gets good. the commands are:

  • HELP
  • PUTVAL Identifier Valuelist
  • GETVAL Identifier
  • GETTHRESHOLD Identifier
  • FLUSH [timeout=$timeout] [plugin=$plugin[ ...]]
  • LISTVAL
  • PUTNOTIF [[severity=$severity] [message=$message] [ ...]]

these commands follow the exact same syntax as described in collectd-unixsock(5). so like, no improvising, no freestyling the syntax, bestie — go read that page, iykyk 😭

🧚 SEE ALSO 🧚

💜 AUTHOR 💜

written by Sebastian Harl <sh@tokkee.org>. periodt 💅

collectd has been written by Florian Forster and others — shoutout to the whole crew, they ate 🔥

Copyright (C) 2007 Sebastian Harl.

this program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; only version 2 of the License is applicable. that's the whole license clause, bestie, i'm not paraphrasing legal text, absolutely not 🙈

fr fr, go read collectd-unixsock(5) before you start typing commands, because that's where the actual syntax lives and i'm not about to be responsible for your malformed PUTVAL, no ma'am 💀

okay that's the whole page, we're done here — this was perl v5.42.0, dated 2024-12-18, and honestly? she's a whole main character 🌸🦋✨ bye bestie, go collect some values 💖

📦 where this page comes from