ansible.builtin.svc (v2.5.11) — module

Install Ansible via pip

Install with pip install ansible==2.5.11

Description

Controls daemontools services on remote hosts using the svc utility.

Usage examples

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

- name: Start svc dnscache, if not running
  svc:
    name: dnscache
    state: started

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

- name: Stop svc dnscache, if running
  svc:
    name: dnscache
    state: stopped

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

- name: Kill svc dnscache, in all cases
  svc:
    name: dnscache
    state: killed

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

- name: Restart svc dnscache, in all cases
  svc:
    name: dnscache
    state: restarted

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

- name: Reload svc dnscache, in all cases
  svc:
    name: dnscache
    state: reloaded

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

- name: Using alternative svc directory location
  svc:
    name: dnscache
    state: reloaded
    service_dir: /var/service

Inputs

    
name:
    description:
    - Name of the service to manage.
    required: true

state:
    choices:
    - killed
    - once
    - reloaded
    - restarted
    - started
    - stopped
    description:
    - C(Started)/C(stopped) are idempotent actions that will not run commands unless necessary.  C(restarted)
      will always bounce the svc (svc -t) and C(killed) will always bounce the svc (svc
      -k). C(reloaded) will send a sigusr1 (svc -1). C(once) will run a normally downed
      svc once (svc -o), not really an idempotent operation.

downed:
    default: 'no'
    description:
    - Should a 'down' file exist or not, if it exists it disables auto startup. defaults
      to no. Downed does not imply stopped.
    type: bool

enabled:
    description:
    - Wheater the service is enabled or not, if disabled it also implies stopped. Make
      note that a service can be enabled and downed (no auto restart).
    type: bool

service_dir:
    default: /service
    description:
    - directory svscan watches for services

service_src:
    description:
    - directory where services are defined, the source of symlinks to service_dir.