salt.modules.runit¶

runit service module

This module is compatible with the service states, so it can be used to maintain services using the provider argument:

myservice:
  service:
    - running
    - provider: runit

Note that the enabled argument is not available with this provider.

salt.modules.runit.available(name)¶

Returns True if the specified service is available, otherwise returns False.

CLI Example:

salt '*' runit.available foo

salt.modules.runit.full_restart(name)¶

Calls runit.restart() function

CLI Example:

salt '*' runit.full_restart <service name>

salt.modules.runit.get_all()¶

Return a list of all available services

CLI Example:

salt '*' runit.get_all

salt.modules.runit.missing(name)¶

The inverse of runit.available. Returns True if the specified service is not available, otherwise returns False.

CLI Example:

salt '*' runit.missing foo

salt.modules.runit.reload(name)¶

Send a HUP to service via runit

CLI Example:

salt '*' runit.reload <service name>

salt.modules.runit.restart(name)¶

Restart service via runit. This will stop/start service

CLI Example:

salt '*' runit.restart <service name>

salt.modules.runit.start(name)¶

Starts service via runit

CLI Example:

salt '*' runit.start <service name>

salt.modules.runit.status(name, sig=None)¶

Return the status for a service via runit, return pid if running

CLI Example:

salt '*' runit.status <service name>

salt.modules.runit.stop(name)¶

Stops service via runit

CLI Example:

salt '*' runit.stop <service name>

salt.modules.runit.term(name)¶

Send a TERM to service via runit

CLI Example:

salt '*' runit.term <service name>