The CLI is the human interface. It communicates with the daemon via IPC and dispatches commands using structured messages.

Commands

CommandIPC ActionPurpose
startstartStart a unit
stopstopStop a unit
showshowDisplay unit/state info
reload-unitsreload_unitsReload unit configs
logoutlogoutEnd user session
surun0Escalate privileges
permissiongrant_permission / revoke_permissionManage permissions
invoke(user-provided)Send arbitrary action
scopecreate_scope / destroy_scopeManage scopes
soft-rebootsoft_rebootSoft-reboot the daemon
rebootrebootReboot the system
shutdownshutdownShut down the system

Command Details

Each command maps to one or more IPC actions:

  • rind start <name>: sends a start request of a specified type
  • rind stop <name>: sends a stop request of a specified type
  • rind show <name>: sends show, returns unit metadata and current state
  • rind reload-units: sends reload_units, triggers a Collect cycle
  • rind su <cmd>: sends run0, escalates via privilege runtime
  • rind logout: sends logout, ends the current session
  • rind permission grant/revoke/show ...: manages ACL entries
  • rind scope create/destroy ...: manages runtime scopes
  • rind soft-reboot: sends soft_reboot, restarts runtime without exiting
  • rind reboot / rind shutdown: system-level power operations

See also: IPC, Transports, Runtimes