rcstaggerctl [-o host[:port]] [-c user_config_file] cmd
rcstaggerctl -h
rcstaggerctl -v
rcstaggerctl is a CLI tool to communicate with rcstaggerd. It communicates over TCP/IP to an instance of rcstaggerd, authenticates via openssl, sends a command, listens for a response, and reports to stdout (or stderr if there is a problem).
Argument Flag | Long Option | Description |
---|---|---|
-o | --host | Connect to the given host [at the given port]. Defaults to the compiled in default, which defaults to 'localhost:4811' |
-c | --config | Use the given user config file (defaults to $HOME/.rcstagger) |
-h | --help | Print help and exit |
-v | --version | Print version and exit |
Command Name | Description |
---|---|
listlocal | List local services |
listremote | List remote services |
start svc_name | Start the service called 'svc_name' |
stop svc_name | Stop the service called 'svc_name' |
restart svc_name | Restart the service called 'svc_name' |
The below example lists the local services on the compiled-in default host/port (defaults to localhost:4811) using the default user config file (defaults to $HOME/.rcstagger.conf):
rcstaggerctl listlocal
The below example lists the remote services on host examplehost on port 1492 using the user configuration file /etc/sysadmin/sysadmin.user.conf:
rcstaggerctl -o examplehost:1492 -c /etc/sysadmin/sysadmin.user.conf listremote