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.  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  C(Started)/C(stopped) are idempotent actions that will not run
              commands unless necessary.  C(restarted) will always bounce the
              service.  C(reloaded) will always reload.  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 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



0.9                               2012-11-30                ANSIBLE.SERVICE(3)
