ANSIBLE.SERVICE(3)              ANSIBLE MODULES             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.)


       runlevel
              For OpenRC init scripts (ex: Gentoo) only.  The runlevel that
              this service belongs to. (default: default)

       sleep  If the service is being restarted then sleep this many seconds
              between the stop and start command. This helps to workaround
              badly behaving init scripts that exit immediately after
              signaling a process to stop.(Added in Ansible version 1.3.)


       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



AUTHOR
       Michael DeHaan

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



1.4.5                             2014-02-12                ANSIBLE.SERVICE(3)
