Parameter |
Choices/Defaults |
Comments |
|---|---|---|
|
force
(added in 2.0) |
|
When removing package - force remove package, without any checks. When update_cache - force redownload repo databases.
|
|
name
|
|
Name or list of names of the packages to install, upgrade, or remove.
aliases: package, pkg |
|
recurse
(added in 1.3) |
|
When removing a package, also remove its dependencies, provided that they are not required by other packages and were not explicitly installed by a user.
|
|
state
|
|
Desired state of the package.
|
|
update_cache
|
|
Whether or not to refresh the master package lists. This can be run as part of a package installation or as a separate step.
aliases: update-cache |
|
upgrade
(added in 2.0) |
|
Whether or not to upgrade whole system.
|
Note
- name: Install package foo
pacman:
name: foo
state: present
- name: Upgrade package foo
pacman:
name: foo
state: latest
update_cache: yes
- name: Remove packages foo and bar
pacman:
name: foo,bar
state: absent
- name: Recursively remove package baz
pacman:
name: baz
state: absent
recurse: yes
- name: Run the equivalent of "pacman -Sy" as a separate step
pacman:
update_cache: yes
- name: Run the equivalent of "pacman -Su" as a separate step
pacman:
upgrade: yes
- name: Run the equivalent of "pacman -Syu" as a separate step
pacman:
update_cache: yes
upgrade: yes
- name: Run the equivalent of "pacman -Rdd", force remove package baz
pacman:
name: baz
state: absent
force: yes
Common return values are documented here, the following are the fields unique to this module:
Key |
Returned |
Description |
|---|---|---|
|
packages
list
|
when upgrade is set to yes |
a list of packages that have been changed
Sample:
['package', 'other-package']
|
This module is flagged as preview which means that it is not guaranteed to have a backwards compatible interface.
Hint
If you notice any issues in this documentation you can edit this document to improve it.