community.general.syspatch – Manage OpenBSD system patches

Note

This plugin is part of the community.general collection (version 4.2.0).

You might already have this collection installed if you are using the ansible package. It is not included in ansible-core. To check whether it is installed, run ansible-galaxy collection list.

To install it, use: ansible-galaxy collection install community.general.

To use it in a playbook, specify: community.general.syspatch.

Synopsis

  • Manage OpenBSD system patches using syspatch.

Parameters

Parameter Choices/Defaults Comments
revert
string
    Choices:
  • all
  • one
Revert system patches.

Examples

- name: Apply all available system patches
  community.general.syspatch:

- name: Revert last patch
  community.general.syspatch:
    revert: one

- name: Revert all patches
  community.general.syspatch:
    revert: all

# NOTE: You can reboot automatically if a patch requires it:
- name: Apply all patches and store result
  community.general.syspatch:
  register: syspatch

- name: Reboot if patch requires it
  ansible.builtin.reboot:
  when: syspatch.reboot_needed

Return Values

Common return values are documented here, the following are the fields unique to this module:

Key Returned Description
rc
integer
always
The command return code (0 means success)

reboot_needed
boolean
always
Whether or not a reboot is required after an update.

Sample:
True
stderr
string
always
syspatch standard error.

Sample:
syspatch: need root privileges
stdout
string
always
syspatch standard output.

Sample:
001_rip6cksum


Authors

  • Andrew Klaus (@precurse)