bluechictl - Man Page
Simple command line tool to interact with the public D-Bus API of bluechi
Synopsis
bluechictl [options] command
Description
A simple command line tool that uses the public D-Bus API provided by Eclipse BlueChi™ to manage services on all connected bluechi-agents and retrieve information from them.
bluechictl [Options]
Options
--help, -h
Print usage statement and exit.
--version, -v
Print current bluechictl version
Commands
bluechictl [start|stop|freeze|thaw|restart|reload] [agent] [unit]
Performs one of the listed lifecycle operations on the given systemd unit for the bluechi-agent.
bluechictl [enable] [agent] [unit1,...]
Enable the list of systemd unit files for the bluechi-agent.
Options:
--force, -f
Override existing symlinks
--runtime
Enable unit files temporarily until next reboot
--no-reload
Don't reload daemon after enabling unit files
bluechictl [disable] [agent] [unit1,...]
Disable the list of systemd unit files for the bluechi-agent.
Options:
--no-reload
Don't reload daemon after disabling unit files
bluechictl list-units [agent]
Fetches information about all systemd units on the bluechi-agents. If [bluechi-agent] is not specified, all agents are queried.
Options:
--filter
Use glob filter for the unit names
bluechictl monitor [agent] [unit1,unit2,...]
Creates a monitor on the given agent to observe changes in the specified units. Wildcards * to match all agents and/or units are also supported.
Example:
bluechictl monitor
bluechictl monitor node1
bluechictl monitor \* dbus.service,apache2.service
bluechictl daemon-reload [agent]
Performs daemon-reload for the bluechi-agent.
bluechictl status [agent]
Fetches the status of all the agents or a specific agent: state (online/offline) and when was it last seen
Options:
--watch, -w
Continuously display agent(s) status, updating when state change update 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.