ANSIBLE.SERVICE(3)

NAME
service - Manage services.

DESCRIPTION

Controls services on remote hosts.

OPTIONS

arguments
    Additional arguments provided on the command line

enabled
    Whether the service should start on boot. At least one of state and enabled are required. Choices: yes,no.

name
    Name of the service.(required)

pattern
    If the service does not respond to the status command, name a substring to look for as would be found in the output of the ps command as a stand-in for a status result. If the string is found, the service will be assumed to be running.(Added in Ansible version 0.7.)

state
    started/stopped are idempotent actions that will not run commands unless necessary. restarted will always bounce the service. reloaded will always reload. At least one of state and enabled are required. Choices: started,stopped,restarted,reloaded.."

EXAMPLES

Example action to start service httpd, if not running
service: name=httpd state=started

Example action to stop service httpd, if running
service: name=httpd state=stopped

Example action to restart service httpd, in all cases
service: name=httpd state=restarted

Example action to reload service httpd, in all cases
service: name=httpd state=reloaded

Example action to enable service httpd, and not touch the running state
service: name=httpd enabled=yes

Example action to start service foo, based on running process /usr/bin/foo
service: name=foo pattern=/usr/bin/foo state=started

Example action to restart network service for interface eth0
service: name=network state=restarted args=eth0
None

AUTHOR
Michael DeHaan

SEE ALSO
ansible(1), http://ansible.github.com/modules.html#service