Module for the management of MacOS systems that use launchd/launchctl
Important
If you feel that Salt should be using this module to manage services on a minion, and it is using a different module (or gives an error similar to 'service.start' is not available), see here.
depends: |
|
---|
Check that the given service is available.
CLI Example:
salt '*' service.available com.openssh.sshd
Return True if the named service is disabled, false otherwise
CLI Example:
salt '*' service.disabled <service label>
Return True if the named service is enabled, false otherwise
CLI Example:
salt '*' service.enabled <service label>
Return all installed services
CLI Example:
salt '*' service.get_all
The inverse of service.available Check that the given service is not available.
CLI Example:
salt '*' service.missing com.openssh.sshd
Restart the named service
CLI Example:
salt '*' service.restart <service label>
Start the specified service
CLI Example:
salt '*' service.start <service label> salt '*' service.start org.ntp.ntpd salt '*' service.start /System/Library/LaunchDaemons/org.ntp.ntpd.plist
Return the status for a service via systemd. If the name contains globbing, a dict mapping service name to True/False values is returned.
Changed in version 2018.3.0: The service name can now be a glob (e.g. salt*
)
Parameters: | |
---|---|
Returns: |
True if running, False otherwise dict: Maps service name to True if running, False otherwise |
Return type: |
CLI Example:
salt '*' service.status <service name>
Stop the specified service
CLI Example:
salt '*' service.stop <service label> salt '*' service.stop org.ntp.ntpd salt '*' service.stop /System/Library/LaunchDaemons/org.ntp.ntpd.plist
© 2019 SaltStack.
Licensed under the Apache License, Version 2.0.
https://docs.saltstack.com/en/latest/ref/modules/all/salt.modules.launchctl_service.html