bluechictl(1)
NAME¶
bluechictl - 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.