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>