kvarnctl is a binary available for UNIX systems. It commnicates with your Kvarn instances to execute commands with arguments.
These correspond to plugins.
Shut the Kvarn instance down.
graceful-shutdown cargo feature is enabled, this performs a graceful shutdown (no connections are abruptly terminated).
You can implement your own shutdown mechanism.
Pings Kvarn. The response will be all the arguments joined with spaces
Starts a new instance in place and performs a graceful shutdown.
Requires both the capabilities necessitated by
shutdown and that the OS is UNIX & !Solaris & !illumos.
This is also what is required by handover.
If handover isn’t available, there will be a small gap where no listener are online.
Waits for the Kvarn instance to shut down.
kvarnctl clear <method> (<host> <file/URI>)
Clears caches. Methods available are
responses, and two which clear a specific resource,
Waiting for Kvarn to turn off
If you want to wait for when Kvarn turns off, use the
--wait flag. The advantage of using the flag instead of the command
is that the command returns when an instance is shut down. The flag handles reloads, so it’ll still wait after a reload, for
shutdown (or anything else that makes Kvarn shut down).
This is accomplished by trying to reconnect once the
By default, Kvarn listens on
/run/user/<uid>/kvarn.sock for users and
/run/kvarn.sock for root users.
You can change this.
You can also disable the IPC altogether.