salt.modules.linux_service

If Salt's OS detection does not identify a different virtual service module, the minion will fall back to using this basic module, which simply wraps sysvinit scripts.

salt.modules.linux_service.available(name)

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

CLI Example:

salt '*' service.available sshd
salt.modules.linux_service.get_all()

Return a list of all available services

CLI Example:

salt '*' service.get_all
salt.modules.linux_service.missing(name)

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

CLI Example:

salt '*' service.missing sshd
salt.modules.linux_service.reload_(name)

Refreshes config files by calling service reload. Does not perform a full restart.

CLI Example:

salt '*' service.reload <service name>
salt.modules.linux_service.restart(name)

Restart the specified service

CLI Example:

salt '*' service.restart <service name>
salt.modules.linux_service.run(name, action)

Run the specified service with an action.

New in version 2015.8.1.

name

Service name.

action

Action name (like start, stop, reload, restart).

CLI Example:

salt '*' service.run apache2 reload
salt '*' service.run postgresql initdb
salt.modules.linux_service.start(name)

Start the specified service

CLI Example:

salt '*' service.start <service name>
salt.modules.linux_service.status(name, sig=None)

Return the status for a service. If the name contains globbing, a dict mapping service name to PID or empty string is returned.

Changed in version 2018.3.0: The service name can now be a glob (e.g. salt*)

Parameters
  • name (str) -- The name of the service to check

  • sig (str) -- Signature to use to find the service via ps

Returns

PID if running, empty otherwise dict: Maps service name to PID if running, empty string otherwise

Return type

string

CLI Example:

salt '*' service.status <service name> [service signature]
salt.modules.linux_service.stop(name)

Stop the specified service

CLI Example:

salt '*' service.stop <service name>