bluechictl(1)

📦
version 1.3.0 · 2 versions
, in fedora 43, fedora 44

🌸 bluechictl — NAME 🌸

okay so bestie, meet bluechictl 💖 — a simple command line tool that lets you talk to the public D-Bus API of bluechi. That's it, that's the whole vibe. She's lowkey the group chat moderator for your whole fleet and she does NOT miss. ✨

✨ SYNOPSIS ✨

bluechictl [options] command

🦋 DESCRIPTION 🦋

So here's the tea: this is a simple command line tool</> that uses the public D-Bus API provided by Eclipse BlueChi™ to manage services on all the connected bluechi-agents, and to pull information back from them. Like, manage everything from one lil terminal, no cap. 👑

bluechictl [OPTIONS]

🎀 OPTIONS 🎀

  • --help, -h — prints the usage statement and then dips out. exit stage left, periodt. 🫶
  • --version, -v — prints the current bluechictl version. know your icon's era. 💅

🧚 Commands 🧚

💫 bluechictl [start|stop|freeze|thaw|restart|reload] [agent] [unit]

Runs one of the listed lifecycle operations on the given systemd unit, for the bluechi-agent. pick your fighter: start, stop, freeze, thaw, restart or reload. all iconic, all valid. ✨

💀 bluechictl [kill] [agent] [unit]

Kills the processes of — i.e. sends a signal to — the specified unit on the chosen node. yeah she said what she said 😭

Options:

  • --kill-whom — enum that defines which processes of the unit get killed. Has to be one of [all, main, control]. Default: all
  • --signal — the signal that gets sent to kill the processes of the unit. Default: 15 (SIGTERM)

🌈 bluechictl [enable] [agent] [unit1,...]

Enables the list of systemd unit files for the bluechi-agent. glow up time, bestie. 💖

Options:

  • --force, -f — override existing symlinks. bold. powerful. no fear.
  • --runtime — enable unit files temporarily, just until the next reboot. a short fling, not a commitment. 🦋
  • --no-reload — don't reload the daemon after enabling the unit files. she's tired, leave her be.

🙈 bluechictl [disable] [agent] [unit1,...]

Disables the list of systemd unit files for the bluechi-agent. it's not a breakup, it's a boundary. 💅

Options:

  • --no-reload — don't reload the daemon after disabling the unit files.

🍓 bluechictl list-unit-files [agent]

Fetches information about all the systemd unit files on the bluechi-agents. If [bluechi-agent] isn't specified, every agent gets queried. she's nosy like that, and honestly? valid.

Options:

  • --filter — use a glob filter for the unit file path.

⭐ bluechictl is-enabled [agent] [unit]

Fetches the current enablement status of that specific unit file on that specific bluechi-agent. the vibe check, but for unit files. 🔥

🧁 bluechictl list-units [agent]

Fetches information about all the systemd units on the bluechi-agents. If [bluechi-agent] isn't specified, all agents are queried. same energy as above, different list. 🫶

Options:

  • --filter — use a glob filter for the unit names.

👑 bluechictl monitor [agent] [unit1,unit2,...]

Creates a monitor on the given agent so you can observe changes in the specified units. Wildcards * to match all agents and/or units are also supported. she's watching. always watching. 💜

Example:

bluechictl monitor
bluechictl monitor node1
bluechictl monitor \* dbus.service,apache2.service

🔥 bluechictl daemon-reload [agent]

Performs daemon-reload for the bluechi-agent. quick lil refresh, she's hydrated, she's glowing. ✨

🌸 bluechictl status [agent]

Fetches the status of all the agents, or of one specific agent: state (online/offline) and when it was last seen. last seen, like a read receipt but for your nodes. 😭

Options:

  • --watch, -w — continuously displays agent(s) status, updating whenever a state change update is received.

Example:

bluechictl status
bluechictl status rpi
bluechictl status -w

💜 bluechictl status [agent] [unit1,...]

Fetches the status of the systemd units for the bluechi-agent. yes, status has range, she does both. 💅

🫧 bluechictl reset-failed [agent] [unit1,...]

Performs a reset-failed on the chosen bluechi-agent for the selected units. clean slate, fresh start, new era. ✨

🌟 bluechictl get-default [agent]

Fetches the default target on the chosen bluechi-agent. she's asking her what her goals are. 🎀

🦋 bluechictl set-default [agent] [TARGET]

Changes the default target to the TARGET file on the chosen bluechi-agent. main character arc: rewritten. 👑

⚠️ heads up bestie: everything here is described exactly as the page says it, so if a flag says it does a thing, it does that thing. no guessing, no vibes-based tech support. 💖

and that's the whole page, fr fr 🌈 — this one came from the bluechictl(1) manual, General Commands Manual section, and the footer was just the classic bluechictl(1) stamp with no extra source, version or date tucked in there, so that's all the lore we got. mwah, go forth and manage your units. 💅💖

📦 where this page comes from