openbsd_pkg - Manage packages on OpenBSD
Synopsis
- Manage packages on OpenBSD using the pkg tools.
Requirements (on host that executes module)
- python >= 2.5
Options
parameter | required | default | choices | comments |
---|---|---|---|---|
build
(added in 2.1)
|
no | no |
|
Build the package from source instead of downloading and installing a binary. Requires that the port source tree is already installed. Automatically builds and installs the 'sqlports' package, if it is not already installed.
|
clean
(added in 2.3)
|
no | no |
|
When updating or removing packages, delete the extra configuration file(s) in the old packages which are annotated with @extra in the packaging-list.
|
name |
yes |
Name of the package.
|
||
ports_dir
(added in 2.1)
|
no | /usr/ports |
When used in combination with the
build option, allows overriding the default ports source directory.
|
|
quick
(added in 2.3)
|
no | no |
|
Replace or delete packages quickly; do not bother with checksums before removing normal files.
|
state |
no | present |
|
present will make sure the package is installed.
latest will make sure the latest version of the package is installed.
absent will make sure the specified package is not installed.
|
Examples
- name: Make sure nmap is installed openbsd_pkg: name: nmap state: present - name: Make sure nmap is the latest version openbsd_pkg: name: nmap state: latest - name: Make sure nmap is not installed openbsd_pkg: name: nmap state: absent - name: Make sure nmap is installed, build it from source if it is not openbsd_pkg: name: nmap state: present build: yes - name: Specify a pkg flavour with '--' openbsd_pkg: name: vim--no_x11 state: present - name: Specify the default flavour to avoid ambiguity errors openbsd_pkg: name: vim-- state: present - name: Specify a package branch (requires at least OpenBSD 6.0) openbsd_pkg: name: python%3.5 state: present - name: Update all packages on the system openbsd_pkg: name: '*' state: latest - name: Purge a package and it's configuration files openbsd_pkg: name: mpd clean: yes state: absent - name: Quickly remove a package without checking checksums openbsd_pkg: name: qt5 quick: yes state: absent
Status
This module is flagged as preview which means that it is not guaranteed to have a backwards compatible interface.
For help in developing on modules, should you be so inclined, please read Community Information & Contributing, Testing Ansible and Developing Modules.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.4/openbsd_pkg_module.html